01/01: doc: Document (list package output) syntax in operanting-system-packages.

[julien lepiller]

roptat pushed a commit to branch master
in repository guix.

commit fe0915cf24a2bd2edd2b7d38d4ba85998e486f20
Author: Julien Lepiller <address@hidden>
Date:   Mon May 1 15:44:31 2017 +0200

    doc: Document (list package output) syntax in operanting-system-packages.
    
    * doc/guix.texi (Globally-Visible Packages): Document (PACKAGE OUTPUT) 
syntax.
---
 doc/guix.texi | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 79942d7..4446909 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -7761,7 +7761,19 @@ provides all the tools one would expect for basic user 
and administrator
 tasks---including the GNU Core Utilities, the GNU Networking Utilities,
 the GNU Zile lightweight text editor, @command{find}, @command{grep},
 etc.  The example above adds tcpdump to those, taken from the @code{(gnu
-packages admin)} module (@pxref{Package Modules}).
+packages admin)} module (@pxref{Package Modules}).  The
address@hidden(list package output)} syntax can be used to add a specific output
+of a package:
+
address@hidden
+(use-modules (gnu packages))
+(use-modules (gnu packages dns))
+
+(operating-system
+  ;; ...
+  (packages (cons (list bind "utils")
+                  %base-packages)))
address@hidden lisp
 
 @findex specification->package
 Referring to packages by variable name, like @var{tcpdump} above, has