aboutsummaryrefslogtreecommitdiff
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)
downloadgnu-guix-6cd1059340758669a7d98c4611f5d418b51899f2.tar
gnu-guix-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