01/01: doc: Add details for binary installation.

[Andreas Enge]

andreas pushed a commit to branch master
in repository guix.

commit c8e26887eda99d1cd7b89772ff642854a6b78ebd
Author: George Clemmer <address@hidden>
Date:   Thu Feb 18 11:48:28 2016 -0500

    doc: Add details for binary installation.
    
    * doc/guix.texi (Binary Installation): Provide some more details for binary
      installation, in particular automatic starting of the daemon.
    
    Signed-off-by: Andreas Enge <address@hidden>
---
 doc/guix.texi |   51 ++++++++++++++++++++++++++++++++++-----------------
 1 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index d2fa22a..ccbab2c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -377,19 +377,29 @@ Create the group and user accounts for build users as 
explained below
 (@pxref{Build Environment Setup}).
 
 @item
-Run the daemon:
+Run and set the Guix daemon to automatically start on boot.
+
+If your host distro uses the systemd init system:
+
address@hidden
+# cp ~root/.guix-profile/lib/systemd/system/guix-daemon.service \
+        /etc/systemd/system/
+# systemctl start guix-daemon && systemctl enable guix-daemon
address@hidden example
+
+If your host distro uses the Upstart init system:
 
 @example
 # ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
+# cp ~root/.guix-profile/lib/upstart/system/guix-daemon.conf /etc/init/
 @end example
 
-On hosts using the systemd init system, drop
address@hidden/.guix-profile/lib/systemd/system/guix-daemon.service} in
address@hidden/etc/systemd/system}.
+Otherwise, you can still start the daemon manually with:
+
address@hidden
+# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
address@hidden example
 
-Likewise, on hosts using the Upstart init system, drop
address@hidden/.guix-profile/lib/upstart/system/guix-daemon.conf} in
address@hidden/etc/init}.
 
 @item
 Make the @command{guix} command available to other users on the machine,
@@ -425,21 +435,28 @@ authorize them:
 @end example
 @end enumerate
 
-And that's it!  For additional tips and tricks, @pxref{Application
-Setup}.
+This completes root-level install of Guix. Each user will need to
+perform additional steps to make their Guix envionment ready for use,
address@hidden Setup}.
 
-The @code{guix} package must remain available in @code{root}'s
-profile, or it would become subject to garbage collection---in which
-case you would find yourself badly handicapped by the lack of the
address@hidden command.
-
-The tarball in question can be (re)produced and verified simply by
-running the following command in the Guix source tree:
+You can confirm that Guix is working by installing a sample package into
+the root profile:
 
 @example
-make address@hidden
+# guix package -i hello
 @end example
 
+If your host distro uses @code{locales} that are incompatible with the
address@hidden that Guix uses, you will see @code{warning: failed to
+install locale: Invalid argument}.  This may be ignored, or remedied by
+installing Locales as root, @pxref{Application Setup}.
+
+The @code{guix} package must remain available in @code{root}'s profile,
+or it would become subject to garbage collection---in which case you
+would find yourself badly handicapped by the lack of the @command{guix}
+command. In other words, don't remove @code{guix} by running @code{guix
+package -r guix}.
+
 
 @node Requirements
 @section Requirements