[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
01/02: doc: Clarify how to choose a user account shell.
From: |
guix-commits |
Subject: |
01/02: doc: Clarify how to choose a user account shell. |
Date: |
Mon, 28 Sep 2020 05:59:23 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 09ffacd455e6e93651536321339e18b64a752233
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Mon Sep 28 11:32:35 2020 +0200
doc: Clarify how to choose a user account shell.
* doc/guix.texi (User Accounts): Add example with custom shell and
custom home directory. Add examples of shell gexps.
---
doc/guix.texi | 29 ++++++++++++++++++++++++++---
1 file changed, 26 insertions(+), 3 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 81f46cc..c600d57 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12830,8 +12830,19 @@ User accounts and groups are entirely managed through
the
"audio" ;sound card
"video" ;video devices such as webcams
"cdrom")) ;the good ol' CD-ROM
- (comment "Bob's sister")
- (home-directory "/home/alice"))
+ (comment "Bob's sister"))
+@end lisp
+
+Here's a user account that uses a different shell and a custom home
+directory (the default would be @file{"/home/bob"}):
+
+@lisp
+(user-account
+ (name "bob")
+ (group "users")
+ (comment "Alice's bro")
+ (shell (file-append zsh "/bin/zsh"))
+ (home-directory "/home/robert"))
@end lisp
When booting or upon completion of @command{guix system reconfigure},
@@ -12876,7 +12887,19 @@ if it does not exist yet.
@item @code{shell} (default: Bash)
This is a G-expression denoting the file name of a program to be used as
-the shell (@pxref{G-Expressions}).
+the shell (@pxref{G-Expressions}). For example, you would refer to the
+Bash executable like this:
+
+@lisp
+(file-append bash "/bin/bash")
+@end lisp
+
+@noindent
+... and to the Zsh executable like that:
+
+@lisp
+(file-append zsh "/bin/zsh")
+@end lisp
@item @code{system?} (default: @code{#f})
This Boolean value indicates whether the account is a ``system''