summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2019-01-28 14:31:05 +0100
committerLudovic Courtès <ludo@gnu.org>2019-01-28 15:45:48 +0100
commit796a4491fdaa4a0a3d669457b89356f9fbfc966e (patch)
tree33770ade3a07a641456f9e19b137444e09f970bb /doc
parent10b507b234b627cb076f58c8e21a8b4088593b3e (diff)
doc: Clarify 'sudo' vs. 'guix pull' and 'guix system reconfigure'.
* doc/guix.texi (Proceeding with the Installation): Clarify use of "sudo" with "guix pull" and "guix system reconfigure".
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi21
1 files changed, 17 insertions, 4 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 22fc03b8fa..972a6a7762 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2289,13 +2289,26 @@ unless your configuration specifies otherwise
(@pxref{user-account-password, user account passwords}).
@cindex upgrading Guix System
-From then on, you can update the system whenever you want by running @command{guix
-pull} as @code{root} (@pxref{Invoking guix pull}), and then running
-@command{guix system reconfigure /etc/config.scm}, as @code{root} too, to
-build a new system generation with the latest packages and services
+From then on, you can update the system whenever you want by running, say:
+
+@example
+guix pull
+sudo guix system reconfigure /etc/config.scm
+@end example
+
+@noindent
+This builds a new system generation with the latest packages and services
(@pxref{Invoking guix system}). We recommend doing that regularly so that
your system includes the latest security updates (@pxref{Security Updates}).
+@c See <https://lists.gnu.org/archive/html/guix-devel/2019-01/msg00268.html>.
+@quotation Note
+@cindex sudo vs. @command{guix pull}
+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{}}.
+@end quotation
+
Join us on @code{#guix} on the Freenode IRC network or on
@email{guix-devel@@gnu.org} to share your experience---good or not so
good.