branch master updated: doc: Clarify how sudo and guix interact when updating

[guix-commits]

This is an automated email from the git hooks/post-receive script.

niedzejkob pushed a commit to branch master
in repository guix.

The following commit(s) were added to refs/heads/master by this push:
     new 6a7f4d8  doc: Clarify how sudo and guix interact when updating
6a7f4d8 is described below

commit 6a7f4d89b2029b43b766217d71d5dbbdfcc5fa09
Author: Jakub Kądziołka <address@hidden>
AuthorDate: Fri Feb 7 22:47:10 2020 +0100

    doc: Clarify how sudo and guix interact when updating
    
    * doc/guix.texi (After System Installation): Explicitly explain the
      mechanics of how sudo differs from a login shell.
    
    Some recent discussions on IRC suggest that the existing wording wasn't
    entirely clear.
---
 doc/guix.texi | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 282f957..25b50ba 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -73,6 +73,7 @@ Copyright @copyright{} 2020 Leo Prikler@*
 Copyright @copyright{} 2019, 2020 Simon Tournier@*
 Copyright @copyright{} 2020 Wiktor Żelazny@*
 Copyright @copyright{} 2020 Damien Cassou@*
+Copyright @copyright{} 2020 Jakub Kądziołka@*
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -2440,6 +2441,11 @@ your system includes the latest security updates 
(@pxref{Security Updates}).
 Note that @command{sudo guix} runs your user's @command{guix} command and
 @emph{not} root's, because @command{sudo} leaves @code{PATH} unchanged.  To
 explicitly run root's @command{guix}, type @command{sudo -i guix @dots{}}.
+
+The difference matters here, because @command{guix pull} updates
+the @command{guix} command and package definitions only for the user it is ran
+as.  This means that if you choose to use @command{guix system reconfigure} in
+root's login shell, you'll need to @command{guix pull} separately.
 @end quotation
 
 Join us on @code{#guix} on the Freenode IRC network or on