diff options
author | Tobias Geerinckx-Rice <me@tobias.gr> | 2020-08-09 17:53:58 +0200 |
---|---|---|
committer | Tobias Geerinckx-Rice <me@tobias.gr> | 2020-08-09 19:40:06 +0200 |
commit | 4cafdce2102e3ebc7b3a6152464a62a454b6be45 (patch) | |
tree | d8a1bdc9680e0f4c474da623f66fdf05427d35b0 | |
parent | 3de419b957e7ce4c294aaa09d94a0cc8779723e7 (diff) | |
download | guix-4cafdce2102e3ebc7b3a6152464a62a454b6be45.tar.gz |
doc: Explain how to select system package outputs.
* doc/guix.texi (operating-system Reference): Document that PACKAGES may contain traces of tuples and give an example.
-rw-r--r-- | doc/guix.texi | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 4b13d4a00e..7855983bf2 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -11962,8 +11962,15 @@ A string denoting the contents of the @file{/etc/issue} file, which is displayed when users log in on a text console. @item @code{packages} (default: @code{%base-packages}) -The set of packages installed in the global profile, which is accessible -at @file{/run/current-system/profile}. +A list of packages to be installed in the global profile, which is accessible +at @file{/run/current-system/profile}. Each element is either a package +variable or a package/output tuple. Here's a simple example of both: + +@lisp +(cons* git ; only the default "out" output + (git "send-email") ; another output of the git package + %base-packages) ; the default set +@end lisp The default set includes core utilities and it is good practice to install non-core utilities in user profiles (@pxref{Invoking guix |