doc: Mention default for `aliases' field of home-bash-configuration.

a809ff20 · Maxim Cournoyer <[email protected]> · 2026-06-01 15:43:21 +09:00

* doc/guix.texi (Shells Home Services): Mention default for `aliases' field of
home-bash-configuration, and how to extend.

Change-Id: I939a6d24f5bbfc7071d8ecb0777222fc3d26b59b

Commit: a809ff20a07045b40944435aaa3cd42c07ccfeee
Parents: 090eb8c8

Changes

1 files changed · +7 −5

File	Status	Add	Del	Content
doc/guix.texi	modified	+7	−5	View file

doc/guix.texi

View file

diff --git a/doc/guix.texi b/doc/guix.texi
index 1e3c6ff..f5efd34 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -53164,11 +53164,13 @@ in @file{.bashrc} for use by interactive shells.  A typical example of
 such variables is @code{HISTSIZE} and related history variables
 (@pxref{Bash Variables,,, bash,Bash Reference Manual}).
 
-@item @code{aliases} (type: alist)
-Association list of aliases to set for the Bash session.  The aliases
-will be defined after the contents of the @code{bashrc} field has been
-put in the @file{.bashrc} file.  The alias will automatically be quoted,
-so something like this:
+@item @code{aliases} (default: %default-bash-aliases) (type: alist)
+Association list of aliases to set for the Bash session.  If you want to
+preserve the default ones, you should append your alist to
+@code{%default-bash-aliases}, a variable from the @code{(gnu system
+shadow)} module.  The aliases will be defined after the contents of the
+@code{bashrc} field has been put in the @file{.bashrc} file.  The alias
+will automatically be quoted, so something like this:
 
 @lisp
 '(("ls" . "ls -alF"))