02/04: doc: Clarify 'sudo' vs. 'guix pull' and 'guix system reconfigure'.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 796a4491fdaa4a0a3d669457b89356f9fbfc966e
Author: Ludovic Courtès <address@hidden>
Date:   Mon Jan 28 14:31:05 2019 +0100

    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".
---
 doc/guix.texi | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 22fc03b..972a6a7 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
address@hidden 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:
+
address@hidden
+guix pull
+sudo guix system reconfigure /etc/config.scm
address@hidden example
+
address@hidden
+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}).
 
address@hidden See 
<https://lists.gnu.org/archive/html/guix-devel/2019-01/msg00268.html>.
address@hidden Note
address@hidden sudo vs. @command{guix pull}
+Note that @command{sudo guix} runs your user's @command{guix} command and
address@hidden root's, because @command{sudo} leaves @code{PATH} unchanged.  To
+explicitly run root's @command{guix}, type @command{sudo -i guix @dots{}}.
address@hidden 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.