This is an automated email from the git hooks/post-receive script.
efraim pushed a commit to branch master
in repository guix.
The following commit(s) were added to refs/heads/master by this push:
new 4ec6fd7817 doc: Document specification->package+output.
4ec6fd7817 is described below
commit 4ec6fd7817ec4073547fd71309374a293d7c436c
Author: Efraim Flashner <[email protected]>
AuthorDate: Thu Sep 28 12:31:44 2023 +0300
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(+)
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
