From mboxrd@z Thu Jan 1 00:00:00 1970 From: Maxim Cournoyer Subject: bug#36785: Impossible to pull on foreign distro Date: Sat, 28 Sep 2019 00:23:34 +0900 Message-ID: <8736ghdaq1.fsf@gmail.com> References: <6733C9AB-E5C1-4B63-8F0E-04CD1BB32338@lepiller.eu> <874l39ra37.fsf@gnu.org> <3DC355B8-FE36-4C4E-BBC9-EEC5F580AF0D@lepiller.eu> <87tvb9qktd.fsf@gnu.org> <87woe6fune.fsf@gnu.org> <87pnjv73sg.fsf@gmail.com> <87woe3otut.fsf@gnu.org> <87pnjt6dbf.fsf@gmail.com> <87d0frl8js.fsf@gnu.org> <871rw7f6j3.fsf@gmail.com> <87d0fpkgz7.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:58848) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iDs6J-0001JL-So for bug-guix@gnu.org; Fri, 27 Sep 2019 11:24:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iDs6E-0003QO-1c for bug-guix@gnu.org; Fri, 27 Sep 2019 11:24:07 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:39606) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iDs6D-0003QH-TZ for bug-guix@gnu.org; Fri, 27 Sep 2019 11:24:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iDs6D-0002vr-MZ for bug-guix@gnu.org; Fri, 27 Sep 2019 11:24:01 -0400 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <87d0fpkgz7.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Tue, 24 Sep 2019 14:37:32 +0200") List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 36785@debbugs.gnu.org --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi! Ludovic Court=C3=A8s writes: [...] > It=E2=80=99s a paragraph that explains how to upgrade Guix System, so I t= hink > foreign distros should be discussed elsewhere. (I appreciate your > attempt to add proper documentation about that for foreign distros!) > >> what my commits aim to do is make them generally true regardless of >> In the commit message I wrote: >> >> Although this section is specific to Guix System, it is likely to be >> read by users of foreign GNU/Linux distributions as well. Remove the >> note, given that sudo doesn't preserve the user's PATH on foreign >> distributions such as Debian. > > But users of foreign distros would hopefully realize that =E2=80=98guix s= ystem > reconfigure=E2=80=99 (in the same snippet) is not for them. :-) I've been guilty myself of using C-s or 'i' in the manual and reading something that didn't apply to my system but *did* match my search... :-)=20 >> What about adding a section that we could call =E2=80=9CUpgrading Guix= =E2=80=9D > under =E2=80=9CApplication Setup=E2=80=9D, which is where setup on foreig= n distros is > discussed? > > The section could say: > > 1. Run =E2=80=98guix pull=E2=80=99 to upgrade Guix. > > 2. When you need to upgrade the build daemon, for instance, which runs > as root, run: > > sudo -i guix pull > > How does that sound? This sounds much simpler than attempting to twist some other section into something it wasn't really meant for ;-). I've attached a simple patch implementing the idea. Thanks for your patience! Maxim --=-=-= Content-Type: text/x-patch; charset=utf-8 Content-Disposition: attachment; filename=0001-doc-Add-a-Upgrading-Guix-section-to-the-Installation.patch Content-Transfer-Encoding: quoted-printable >From a289eb3fd6239287d4a802fbba69abf21604591f Mon Sep 17 00:00:00 2001 From: Maxim Cournoyer Date: Sat, 28 Sep 2019 00:11:28 +0900 Subject: [PATCH] doc: Add a 'Upgrading Guix' section to the 'Installation' chapter. MIME-Version: 1.0 Content-Type: text/plain; charset=3DUTF-8 Content-Transfer-Encoding: 8bit This follows a discussion regarding issue #36785 (see: https://bugs.gnu.org/36785). * doc/guix.texi (Upgrading Guix): New section. Co-authored-by: Ludovic Court=C3=A8s --- doc/guix.texi | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 9fcce27597..45e6dfc442 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -513,6 +513,7 @@ ready to use it. * Setting Up the Daemon:: Preparing the build daemon's environment. * Invoking guix-daemon:: Running the build daemon. * Application Setup:: Application-specific setup. +* Upgrading Guix:: Upgrading Guix and its build daemon. @end menu =20 @node Binary Installation @@ -1777,6 +1778,28 @@ invoke the actual linker with this new set of argume= nts. You can instruct the wrapper to refuse to link against libraries not in the store by setting the @code{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} environment variable to @code{no}. =20 +@node Upgrading Guix +@section Upgrading Guix + +@cindex Upgrading Guix, on a foreign distro + +To upgrade Guix, run: + +@example +guix pull +@end example + +@cindex Upgrading Guix for the root user, on a foreign distro +@cindex Upgrading the Guix daemon, on a foreign distro +@cindex @command{guix pull} for the root user, on a foreign distro + +When you need to upgrade the build daemon, for instance, which runs as +root, run: + +@example +sudo -i guix pull +@end example + @c TODO What else? =20 @c ********************************************************************* --=20 2.23.0 --=-=-=--