From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
To: "Ludovic Courtès" <ludo@gnu.org>
Cc: 36785@debbugs.gnu.org
Subject: bug#36785: Impossible to pull on foreign distro
Date: Sat, 28 Sep 2019 00:23:34 +0900 [thread overview]
Message-ID: <8736ghdaq1.fsf@gmail.com> (raw)
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")
[-- Attachment #1: Type: text/plain, Size: 1560 bytes --]
Hi!
Ludovic Courtès <ludo@gnu.org> writes:
[...]
> It’s a paragraph that explains how to upgrade Guix System, so I think
> 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 ‘guix system
> reconfigure’ (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... :-)
>> What about adding a section that we could call “Upgrading Guix”
> under “Application Setup”, which is where setup on foreign distros is
> discussed?
>
> The section could say:
>
> 1. Run ‘guix pull’ 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
[-- Attachment #2: 0001-doc-Add-a-Upgrading-Guix-section-to-the-Installation.patch --]
[-- Type: text/x-patch, Size: 1966 bytes --]
From a289eb3fd6239287d4a802fbba69abf21604591f Mon Sep 17 00:00:00 2001
From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
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=UTF-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ès <ludo@gnu.org>
---
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
@node Binary Installation
@@ -1777,6 +1778,28 @@ invoke the actual linker with this new set of arguments. 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}.
+@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?
@c *********************************************************************
--
2.23.0
next prev parent reply other threads:[~2019-09-27 15:24 UTC|newest]
Thread overview: 21+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-07-24 14:40 bug#36785: Impossible to pull on foreign distro Julien Lepiller
2019-07-25 23:03 ` Ludovic Courtès
2019-07-26 6:22 ` Julien Lepiller
2019-07-26 8:09 ` Ludovic Courtès
2019-09-17 22:03 ` Ludovic Courtès
2019-09-17 23:33 ` Gábor Boskovits
2019-09-18 8:48 ` Ludovic Courtès
2019-09-20 8:47 ` Maxim Cournoyer
2019-09-20 15:44 ` Ludovic Courtès
2019-09-21 12:31 ` Maxim Cournoyer
2019-09-23 8:29 ` Ludovic Courtès
2019-09-23 9:00 ` Gábor Boskovits
2019-09-23 12:48 ` Ludovic Courtès
2019-09-23 14:09 ` Maxim Cournoyer
2019-09-24 12:37 ` Ludovic Courtès
2019-09-27 15:23 ` Maxim Cournoyer [this message]
2019-09-28 17:49 ` Ludovic Courtès
2019-09-29 1:36 ` Maxim Cournoyer
2019-09-21 12:32 ` Maxim Cournoyer
2019-09-18 18:35 ` Ricardo Wurmus
2019-09-19 8:24 ` Ludovic Courtès
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=8736ghdaq1.fsf@gmail.com \
--to=maxim.cournoyer@gmail.com \
--cc=36785@debbugs.gnu.org \
--cc=ludo@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/guix.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.