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.
This commit is contained in:
Efraim Flashner 2023-09-28 12:31:44 +03:00
parent 08a1126428
commit 4ec6fd7817
No known key found for this signature in database
GPG Key ID: 41AAE7DCCA3D8351
1 changed files with 17 additions and 0 deletions

View File

@ -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