83/155: doc: Make 'guix pull' more visible.

[John Darrington]

jmd pushed a commit to branch wip-installer
in repository guix.

commit 302f121385c324de1a4a73579d1f18a0f9a07b1f
Author: Ludovic Courtès <address@hidden>
Date:   Mon Dec 19 15:07:58 2016 +0100

    doc: Make 'guix pull' more visible.
    
    Suggested by Dave Love <address@hidden>.
    Fixes <http://bugs.gnu.org/25139>.
    
    * doc/guix.texi (Installation): Mention 'guix pull'.
    (Proceeding with the Installation): Mention updates with 'guix pull' and
    'guix system reconfigure'.
    (Invoking guix pull): Add "updating" to the concept index.
---
 doc/guix.texi |   12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index e3c4524..b5592e0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -359,6 +359,9 @@ without interference.  Its data lives exclusively in two 
directories,
 usually @file{/gnu/store} and @file{/var/guix}; other files on your
 system, such as @file{/etc}, are left untouched.
 
+Once installed, Guix can be updated by running @command{guix pull}
+(@pxref{Invoking guix pull}).
+
 @menu
 * Binary Installation::         Getting Guix running in no time!
 * Requirements::                Software needed to build and run Guix.
@@ -2308,6 +2311,7 @@ this option is primarily useful when the daemon was 
running with
 @section Invoking @command{guix pull}
 
 @cindex upgrading Guix
address@hidden updating Guix
 @cindex @command{guix pull}
 @cindex pull
 Packages are installed or upgraded to the latest version available in
@@ -6949,6 +6953,14 @@ initialized by running the @command{passwd} command as 
@code{root},
 unless your configuration specifies otherwise
 (@pxref{user-account-password, user account passwords}).
 
address@hidden upgrading GuixSD
+From then on, you can update GuixSD whenever you want by running
address@hidden pull} as @code{root} (@pxref{Invoking guix pull}), and
+then running @command{guix system reconfigure} to build 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}).
+
 Join us on @code{#guix} on the Freenode IRC network or on
 @file{guix-devel@@gnu.org} to share your experience---good or not so
 good.