01/01: doc: Really document 'guix pack --format'.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 708b54a99252d3929b8062bc57167cc6d097a126
Author: Ludovic Courtès <address@hidden>
Date:   Fri Mar 17 09:44:08 2017 +0100

    doc: Really document 'guix pack --format'.
    
    * doc/guix.texi (Invoking guix pack): Properly document --format.
---
 doc/guix.texi | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 93640df..3db6dad 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2438,11 +2438,8 @@ guix pack -S /opt/gnu/bin=bin guile emacs geiser
 @noindent
 That way, users can happily type @file{/opt/gnu/bin/guile} and enjoy.
 
-Alternatively, you can produce a pack in the Docker image format, as
-described in
address@hidden://github.com/docker/docker/blob/master/image/spec/v1.2.md,
-version 1.2 of the specification}.  This is what the following command
-does:
+Alternatively, you can produce a pack in the Docker image format using
+the following command:
 
 @example
 guix pack -f docker guile emacs geiser
@@ -2457,6 +2454,23 @@ documentation} for more information.
 Several command-line options allow you to customize your pack:
 
 @table @code
address@hidden address@hidden
address@hidden -f @var{format}
+Produce a pack in the given @var{format}.
+
+The available formats are:
+
address@hidden @code
address@hidden tarball
+This is the default format.  It produces a tarball containing all the
+specifies binaries and symlinks.
+
address@hidden docker
+This produces a tarball that follows the
address@hidden://github.com/docker/docker/blob/master/image/spec/v1.2.md,
+Docker Image Specification}.
address@hidden table
+
 @item address@hidden
 @itemx -s @var{system}
 Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of