summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-11-14 14:17:56 +0100
committerLudovic Courtès <ludo@gnu.org>2014-11-14 14:17:56 +0100
commiteb59595ccdd1d58730e3d24da41ecacb27813666 (patch)
tree0b30732e734347bcb9819331d07917c291a040c4 /doc/guix.texi
parenta0e59dd80603b539469b788b7d3ebff02c18a277 (diff)
downloadguix-eb59595ccdd1d58730e3d24da41ecacb27813666.tar.gz
doc: Clarify use of the 'password' field for user accounts.
Suggested by Alex Sassmannshausen <alex.sassmannshausen@gmail.com>.

* doc/guix.texi (Using the Configuration System): Remove 'password'
  field in the example.
  (User Accounts): Clarify use of the 'password' field, with links to
  the libc and Guile manuals.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi11
1 files changed, 9 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 2a33cb50a2..d3b8542710 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -3301,7 +3301,6 @@ kernel, initial RAM disk, and boot loader looks like this:
                       %base-file-systems))
   (users (list (user-account
                 (name "alice")
-                (password "")
                 (uid 1000) (group 100)
                 (comment "Bob's sister")
                 (home-directory "/home/alice"))))
@@ -3703,7 +3702,15 @@ account.  System accounts are sometimes treated specially; for instance,
 graphical login managers do not list them.
 
 @item @code{password} (default: @code{#f})
-Unless @code{#f}, this is the password to be used for the account.
+You would normally leave this field to @code{#f}, initialize user
+passwords as @code{root} with the @command{passwd} command, and then let
+users change it with @command{passwd}.
+
+If you @emph{do} want to have a preset password for an account, then
+this field must contain the encrypted password, as a string.
+@xref{crypt,,, The GNU C Library Reference Manual}, for more information
+on password encryption, and @ref{Encryption,,, GNU Guile Reference
+Manual}, for information on Guile's @code{crypt} procedure.
 
 @end table
 @end deftp