summary refs log tree commit diff
diff options
context:
space:
mode:
authorJakub Kądziołka <kuba@kadziolka.net>2020-02-07 22:47:10 +0100
committerJakub Kądziołka <kuba@kadziolka.net>2020-02-14 19:05:59 +0100
commit6a7f4d89b2029b43b766217d71d5dbbdfcc5fa09 (patch)
tree5747cc8dd8abf5a2cd704d5efee16249d9dcbd21
parent64fc4f3705423c83c680a95d8dea81a39fce9a70 (diff)
downloadguix-6a7f4d89b2029b43b766217d71d5dbbdfcc5fa09.tar.gz
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.
-rw-r--r--doc/guix.texi6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 282f9578bf..25b50bad9e 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