summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorEfraim Flashner <efraim@flashner.co.il>2023-09-28 12:31:44 +0300
committerEfraim Flashner <efraim@flashner.co.il>2023-10-13 11:48:43 +0300
commit4ec6fd7817ec4073547fd71309374a293d7c436c (patch)
tree89c0c80a9b4c40a392c51f27e07493a8d1fd88a9 /doc/guix.texi
parent08a1126428afe69655d67847c15353a2ffc6b2a7 (diff)
downloadguix-4ec6fd7817ec4073547fd71309374a293d7c436c.tar.gz
doc: Document specification->package+output.
Reported by nutcase on IRC.

* doc/guix.texi (Using the Configuration System): Add a section about
using specification->package+output.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 9be321661b..083504dcb8 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16944,6 +16944,23 @@ version:
                     %base-packages)))
 @end lisp
 
+@findex specification->package+output
+When a package has more than one output it can be a challenge to refer to a
+specific output instead of just to the standard @code{out} output.  For these
+situations one can use the @code{specification->package+output} procedure from
+the @code{(gnu packages)} module.  For example:
+
+@lisp
+(use-modules (gnu packages))
+
+(operating-system
+  ;; ...
+  (packages (append (map specification->package+output
+                         '("nss-certs" "git" "git:send-email"))
+                    %base-packages)))
+
+@end lisp
+
 @unnumberedsubsec System Services
 
 @cindex services