From 299112d36e872d98896bf8dec281c34d9adad06e Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Fri, 1 Feb 2013 13:16:27 +0100 Subject: guix-package: Report `--search' matches in recutils format. * guix/ui.scm (fill-paragraph, string->recutils, package->recutils): New procedures. * guix-package.in (guix-package)[process-query]: Use `package->recutils' to display package meta-data. * tests/guix-package.sh: Adjust test. * tests/ui.scm: New file. * Makefile.am (TESTS): Add it. * doc/guix.texi (Invoking guix-package): Adjust `--search' documentation, and give an example. --- doc/guix.texi | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/guix.texi b/doc/guix.texi index 410e6fa37c..3fee24db50 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -546,10 +546,21 @@ availability of packages: @item --search=@var{regexp} @itemx -s @var{regexp} List the available packages whose synopsis or description matches -@var{regexp}. +@var{regexp}. Print all the meta-data of matching packages in +@code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, +GNU recutils manual}). -For each package, print the following items, separated by tabs: its -name, version, and the source location of its definition. +This allows specific fields to be extracted using the @command{recsel} +command, for instance: + +@example +$ guix-package -s malloc | recsel -p name,version +name: glibc +version: 2.17 + +name: libgc +version: 7.2alpha6 +@end example @item --list-installed[=@var{regexp}] @itemx -I [@var{regexp}] -- cgit 1.4.1