summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2013-09-22 22:03:15 +0200
committerLudovic Courtès <ludo@gnu.org>2013-09-23 00:33:50 +0200
commitf566d765a1494e6c1194a5d7c84f4f16ae8fb81b (patch)
tree1684d1184c89792b82d26a4910e0973688d83e44
parentbd9bde1cba7190ed8b87aefbd09b1e25c5acbf31 (diff)
downloadgnu-guix-f566d765a1494e6c1194a5d7c84f4f16ae8fb81b.tar
gnu-guix-f566d765a1494e6c1194a5d7c84f4f16ae8fb81b.tar.gz
doc: Document '--list-generations' among the query options.
* doc/guix.texi (Invoking guix package): Move '--list-generations' below "In addition to these actions".
-rw-r--r--doc/guix.texi70
1 files changed, 35 insertions, 35 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 9eb67ecd01..90016a4496 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -606,41 +606,6 @@ library are installed in the profile, then @code{--search-paths} will
suggest setting these variables to @code{@var{profile}/include} and
@code{@var{profile}/lib}, respectively.
-@item --list-generations[=@var{pattern}]
-@itemx -l [@var{pattern}]
-Return a list of generations along with their creation dates; for each
-generation, show the installed packages, with the most recently
-installed packages shown last.
-
-For each installed package, print the following items, separated by
-tabs: the name of a package, its version string, the part of the package
-that is installed (@pxref{Packages with Multiple Outputs}), and the
-location of this package in the store.
-
-When @var{pattern} is used, the command returns only matching
-generations. Valid patterns include:
-
-@itemize
-@item @emph{Integers and comma-separated integers}. Both patterns denote
-generation numbers. For instance, @code{--list-generations=1} returns
-the first one.
-
-And @code{--list-generations=1,8,2} outputs three generations in the
-specified order. Neither spaces nor trailing commas are allowed.
-
-@item @emph{Ranges}. @code{--list-generations=2..9} prints the
-specified generations and everything in between. Note that the start of
-a range must be lesser than its end.
-
-It is also possible to omit the endpoint. For example,
-@code{--list-generations=2..}, returns all generations starting from the
-second one.
-
-@item @emph{Durations}. You can also get the last @emph{N}@tie{}days, weeks,
-or months by passing an integer along with the first letter of the
-duration, e.g., @code{--list-generations=20d}.
-@end itemize
-
@item --profile=@var{profile}
@itemx -p @var{profile}
Use @var{profile} instead of the user's default profile.
@@ -714,6 +679,41 @@ For each package, print the following items separated by tabs: its name,
its version string, the parts of the package (@pxref{Packages with
Multiple Outputs}), and the source location of its definition.
+@item --list-generations[=@var{pattern}]
+@itemx -l [@var{pattern}]
+Return a list of generations along with their creation dates; for each
+generation, show the installed packages, with the most recently
+installed packages shown last.
+
+For each installed package, print the following items, separated by
+tabs: the name of a package, its version string, the part of the package
+that is installed (@pxref{Packages with Multiple Outputs}), and the
+location of this package in the store.
+
+When @var{pattern} is used, the command returns only matching
+generations. Valid patterns include:
+
+@itemize
+@item @emph{Integers and comma-separated integers}. Both patterns denote
+generation numbers. For instance, @code{--list-generations=1} returns
+the first one.
+
+And @code{--list-generations=1,8,2} outputs three generations in the
+specified order. Neither spaces nor trailing commas are allowed.
+
+@item @emph{Ranges}. @code{--list-generations=2..9} prints the
+specified generations and everything in between. Note that the start of
+a range must be lesser than its end.
+
+It is also possible to omit the endpoint. For example,
+@code{--list-generations=2..}, returns all generations starting from the
+second one.
+
+@item @emph{Durations}. You can also get the last @emph{N}@tie{}days, weeks,
+or months by passing an integer along with the first letter of the
+duration, e.g., @code{--list-generations=20d}.
+@end itemize
+
@end table
@node Packages with Multiple Outputs