summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2015-07-22 18:28:20 +0200
committerLudovic Courtès <ludo@gnu.org>2015-07-22 22:56:41 +0200
commit1bd4e6db15025ea7c2caf97bb77cca4eddf5ebea (patch)
tree5b5f3de2cedd8d2bc5fd2d6a1d2322c8db40d787
parent2c59cbc26ae8c6cd24df728adc0c97e330c7bc3f (diff)
downloadguix-1bd4e6db15025ea7c2caf97bb77cca4eddf5ebea.tar.gz
doc: Mention initial passwords in "System Installation".
Suggested by remo_ on IRC.

* doc/guix.texi (System Installation): Explicitly mention user account
  passwords.
  (User Accounts): Add 'user-account-password' anchor.
-rw-r--r--doc/guix.texi12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 822aefa3a8..8c51db8c0c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4672,9 +4672,14 @@ This will copy all the necessary files, and install GRUB on
 more information, @pxref{Invoking guix system}.  This command may trigger
 downloads or builds of missing packages, which can take some time.
 
-Once that command has completed---and hopefully succeeded!---you can
-run @command{reboot} and boot into the new system.  Cross fingers, and
-join us on @code{#guix} on the Freenode IRC network or on
+Once that command has completed---and hopefully succeeded!---you can run
+@command{reboot} and boot into the new system.  The @code{root} password
+in the new system is initially empty; other users' passwords need to be
+initialized by running the @command{passwd} command as @code{root},
+unless your configuration specifies otherwise
+(@pxref{user-account-password, user account passwords}).
+
+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.
 
@@ -5217,6 +5222,7 @@ This Boolean value indicates whether the account is a ``system''
 account.  System accounts are sometimes treated specially; for instance,
 graphical login managers do not list them.
 
+@anchor{user-account-password}
 @item @code{password} (default: @code{#f})
 You would normally leave this field to @code{#f}, initialize user
 passwords as @code{root} with the @command{passwd} command, and then let