From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id qzWmGw71UWC8HgAA0tVLHw (envelope-from ) for ; Wed, 17 Mar 2021 12:24:46 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id wCYRFw71UWCbaAAA1q6Kng (envelope-from ) for ; Wed, 17 Mar 2021 12:24:46 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 1BF95E5DE for ; Wed, 17 Mar 2021 13:24:46 +0100 (CET) Received: from localhost ([::1]:60882 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lMVED-0008JQ-A2 for larch@yhetil.org; Wed, 17 Mar 2021 08:24:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58540) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lMVDW-0008I6-IO for guix-patches@gnu.org; Wed, 17 Mar 2021 08:24:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:58973) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lMVDW-00036M-Bi for guix-patches@gnu.org; Wed, 17 Mar 2021 08:24:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lMVDW-0003E2-8g for guix-patches@gnu.org; Wed, 17 Mar 2021 08:24:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#47213] [PATCH v2] doc: Add snippet for running 'guix refresh' on installed Resent-From: Xinglu Chen Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 17 Mar 2021 12:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 47213 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 47213@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.161598381812362 (code B ref -1); Wed, 17 Mar 2021 12:24:02 +0000 Received: (at submit) by debbugs.gnu.org; 17 Mar 2021 12:23:38 +0000 Received: from localhost ([127.0.0.1]:42286 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lMVD8-0003DJ-1K for submit@debbugs.gnu.org; Wed, 17 Mar 2021 08:23:38 -0400 Received: from lists.gnu.org ([209.51.188.17]:33528) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lMVD4-0003DA-Qb for submit@debbugs.gnu.org; Wed, 17 Mar 2021 08:23:37 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58434) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lMVD2-0007zN-3x for guix-patches@gnu.org; Wed, 17 Mar 2021 08:23:34 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:50674 helo=mail.yoctocell.xyz) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lMVCz-0002iN-WF for guix-patches@gnu.org; Wed, 17 Mar 2021 08:23:31 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1615983804; bh=Ag8UKrQheQvnnZzNo0dlXbKoxHRGXRXdc+z19mRSswo=; h=From:To:Subject:In-Reply-To:References:Date; b=qiIMtkAsPzEQsJVYwv0ydeL0z4LHIwRszTaeLMSNzijxXsMo5ObFbaqIaRux8/Zzf +SfNYsVt6nXOE4tqZZO4+XbqnVALzUghxJRWE5FFwjGKb98jZvSOzvVk3xW6DTJ+mA YfMc63UO++siK7we9xVpRPXdYgw7Cr5to3x1bEC0= In-Reply-To: <1b75951ffc583006980d809718e5cdc4fd1c3d37.1615911469.git.public@yoctocell.xyz> References: <1b75951ffc583006980d809718e5cdc4fd1c3d37.1615911469.git.public@yoctocell.xyz> Message-Id: <239f5ab21f9d39a00b71963b127e2745969e44cf.1615983540.git.public@yoctocell.xyz> Date: Wed, 17 Mar 2021 13:23:23 +0100 MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=87.96.130.155; envelope-from=public@yoctocell.xyz; helo=mail.yoctocell.xyz X-Spam_score_int: 14 X-Spam_score: 1.4 X-Spam_bar: + X-Spam_report: (1.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FROM_SUSPICIOUS_NTLD=0.499, PDS_OTHER_BAD_TLD=1.999, RDNS_DYNAMIC=0.982, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1615983886; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=V0mG6en+pBTiq0LkE0uqWaE4vuIX7MmhlhFvBWEHugQ=; b=Gz8C56DQCIXuBGRbEqYyLdkIgyL8f0CYONXLUuB6RTbO16r2ll2G7icNfONMKRVWypuzDA fCOftlxW4YkbgEcbZn5BaQ+h4CgF/ZSETlhTa3rCv1A9thHpZCflwmC2JlsjZWMaZtjRaM 5AVwNWFWMTKJDh7HGAbMgk2Ul10NbWl2BXI4u2zPJeT04qeNBHXwPe/ysh9YYhgJyZ8QUu AFraSE1sCbQuW7sD25mKFp82Shc2QmN5w/EA9CNPnY+hTiHdhk3hz3CN8ihDvucAOvpyDU kTTfH0W23wpYU0xNodVWz0KrQecSclPD0BL15SuM0DZ59jWdbRuV23mTa04uSw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1615983886; a=rsa-sha256; cv=none; b=BCrd8hAkgrOl3/FH39M/mDIXJq5b3iwNwRLiPkXNRPMTlqBy2zFKb9uKGicMYWAy/a8N5L ZSriv2syvSUstkZxY0KNm+vjI0LiwhDcV3YwnRAWyZCov6dO0ihz9177oyQ8RfaHPUd1QE g3Xaj2cs9tHhoFz9pXa/SRP/IoOTj74PSGSxwtgDOXh3F1g1fkF+a9cJ6n36UTiK26BGQi 51VAqxKy8RcjIGWtnayRBmKw/JjvmSrwVPlAsCuuoxEHKgWVD4p+ibRqZ4q7fz+CW68e5g XL2mjS7JO+WzJ83LEjxh2rkCiwujMpdhcbcrwe3F76tG4Uq9qqgn1m1GKwK2GQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=yoctocell.xyz header.s=mail header.b=qiIMtkAs; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: -0.83 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=yoctocell.xyz header.s=mail header.b=qiIMtkAs; dmarc=fail reason="SPF not aligned (relaxed)" header.from=yoctocell.xyz (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: 1BF95E5DE X-Spam-Score: -0.83 X-Migadu-Scanner: scn0.migadu.com X-TUID: 90Wo0fM/BZLD * doc/guix.texi (Invoking guix refresh): Add snippet that runs 'guix refresh' on all the packages installed in the current profile. --- Changes since v1: - Correct the example snippet. - Refer the reader to "Running Guix Before It Is Installed". - Add suggestion to run `guix package -i --with-latest`. doc/guix.texi | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 410670e639..d94772d5be 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -87,6 +87,7 @@ Copyright @copyright{} 2020 John Soo@* Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* +Copyright @copyright{} 2021 Xinglu Chen@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -11719,8 +11720,21 @@ @noindent The command above specifically updates the @code{emacs} and -@code{idutils} packages. The @option{--select} option would have no -effect in this case. +@code{idutils} packages (see @pxref{Running Guix Before It Is +Installed}). The @option{--select} option would have no effect in this +case. + +You can also quickly update all the packages installed in the current +profile with the following snippet: + +@example +$ ./pre-inst-env guix refresh -u $(guix package --list-installed | cut -f1) +@end example + +This is handy if you don't use manifests for installing packages into +your profile. If you just want to install the latest version of a +package, run @command{guix package -i --with-latest} (see @pxref{Package +Transformation Options}). When considering whether to upgrade a package, it is sometimes convenient to know which packages would be affected by the upgrade and base-commit: 109f58444beecd1b9b7c502f2a687a6b91c62dc0 -- 2.30.2