summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2017-01-17 22:58:37 +0100
committerLudovic Courtès <ludo@gnu.org>2017-01-17 23:57:15 +0100
commit6cd1059340758669a7d98c4611f5d418b51899f2 (patch)
tree6a0426cf9b04cba104da72e5180599dc76236461
parent1f4f2360ad70b62cd210501ba4c8b49dd7b37864 (diff)
downloadguix-6cd1059340758669a7d98c4611f5d418b51899f2.tar.gz
doc: Add '--manifest' example using 'specification->package+output'.
* doc/guix.texi (Invoking guix package): Add --manifest example using
'specification->package+output'.
-rw-r--r--doc/guix.texi14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index bf9dbaa726..a212666af0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1685,6 +1685,20 @@ of packages:
        (list guile-2.0 "debug")))
 @end example
 
+@findex specification->package+output
+In this example we have to know which modules define the @code{emacs}
+and @code{guile-2.0} variables to provide the right
+@code{use-package-modules} line, which can be cumbersome.  We can
+instead provide regular package specifications and let
+@code{specification->package-output} look up the corresponding package
+objects, like this:
+
+@example
+(packages->manifest
+ (map (compose list specification->package+output)
+      '("emacs" "guile@@2.0" "guile@@2.0:debug")))
+@end example
+
 @item --roll-back
 @cindex rolling back
 @cindex undoing transactions