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

* doc/guix.texi (Invoking guix pack): Properly document --format.
This commit is contained in:
Ludovic Courtès 2017-03-17 09:44:08 +01:00
parent 54d556bdd7
commit 708b54a992
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 19 additions and 5 deletions

View File

@ -2438,11 +2438,8 @@ guix pack -S /opt/gnu/bin=bin guile emacs geiser
@noindent @noindent
That way, users can happily type @file{/opt/gnu/bin/guile} and enjoy. 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 Alternatively, you can produce a pack in the Docker image format using
described in the following command:
@uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md,
version 1.2 of the specification}. This is what the following command
does:
@example @example
guix pack -f docker guile emacs geiser 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: Several command-line options allow you to customize your pack:
@table @code @table @code
@item --format=@var{format}
@itemx -f @var{format}
Produce a pack in the given @var{format}.
The available formats are:
@table @code
@item tarball
This is the default format. It produces a tarball containing all the
specifies binaries and symlinks.
@item docker
This produces a tarball that follows the
@uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md,
Docker Image Specification}.
@end table
@item --system=@var{system} @item --system=@var{system}
@itemx -s @var{system} @itemx -s @var{system}
Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of