A patch to address issues raised in bug#22695.
>From 4f4f2ddd383e9a07a906f4da375a5b53fe792ab0 Mon Sep 17 00:00:00 2001
From: George Clemmer <myg...@gmail.com>
Date: Thu, 18 Feb 2016 11:48:28 -0500
Subject: [PATCH] doc: more on binary installation
* doc/guix.texi (Binary Installation): automatically start on boot, what
users need to do next, confirm guix is working, don't uninstall guix,
drop tarbar (re)production.
---
doc/guix.texi | 46 ++++++++++++++++++++++++++++------------------
1 file changed, 28 insertions(+), 18 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index c5a7de7..73dc401 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -377,19 +377,22 @@ 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:
@example
-# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
+# cp ~root/.guix-profile/lib/systemd/system/guix-daemon.service \
+ /etc/systemd/system/
+# systemctl start guix-daemon && systemctl enable guix-daemon
@end example
-On hosts using the systemd init system, drop
-@file{~root/.guix-profile/lib/systemd/system/guix-daemon.service} in
-@file{/etc/systemd/system}.
+If your host distro uses the Upstart init system:
-Likewise, on hosts using the Upstart init system, drop
-@file{~root/.guix-profile/lib/upstart/system/guix-daemon.conf} in
-@file{/etc/init}.
+@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
@item
Make the @command{guix} command available to other users on the machine,
@@ -425,21 +428,28 @@ authorize them:
@end example
@end enumerate
-And that's it! For additional tips and tricks, @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.
+This completes root-level install of Guix. Each user will need to
+perform additional steps to make their Guix envionment ready for use,
+@pxref{Application Setup}.
-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 guix-binary.@var{system}.tar.xz
+# guix package -i hello
@end example
+If your host distro uses @code{locales} that are incompatible with the
+@code{glibc} 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
--
2.6.3
