From 4ec6fd7817ec4073547fd71309374a293d7c436c Mon Sep 17 00:00:00 2001 From: Efraim Flashner Date: Thu, 28 Sep 2023 12:31:44 +0300 Subject: 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. --- doc/guix.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'doc') 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 -- cgit v1.2.3