doc: Connect "guix archive", "guix pack", and co.

* doc/guix.texi (Invoking guix pack): Add xrefs to "guix publish", "guix
copy", and "guix archive".
(Invoking guix archive): Add xref to "guix pack".
master
Ludovic Courtès 2018-01-15 14:44:55 +01:00
parent 309121a113
commit 9d4399b805
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 13 additions and 1 deletions

View File

@ -2659,6 +2659,12 @@ lucky enough to be using Guix. You'd tell them to run @command{guix
package -i @var{something}}, but that's not possible in this case. This package -i @var{something}}, but that's not possible in this case. This
is where @command{guix pack} comes in. is where @command{guix pack} comes in.
@quotation Note
If you are looking for ways to exchange binaries among machines that
already run Guix, @pxref{Invoking guix copy}, @ref{Invoking guix
publish}, and @ref{Invoking guix archive}.
@end quotation
@cindex pack @cindex pack
@cindex bundle @cindex bundle
@cindex application bundle @cindex application bundle
@ -2794,10 +2800,16 @@ options (@pxref{Package Transformation Options}).
@cindex @command{guix archive} @cindex @command{guix archive}
@cindex archive @cindex archive
The @command{guix archive} command allows users to @dfn{export} files The @command{guix archive} command allows users to @dfn{export} files
from the store into a single archive, and to later @dfn{import} them. from the store into a single archive, and to later @dfn{import} them on
a machine that runs Guix.
In particular, it allows store files to be transferred from one machine In particular, it allows store files to be transferred from one machine
to the store on another machine. to the store on another machine.
@quotation Note
If you're looking for a way to produce archives in a formatq suitable for
tools other than Guix, @pxref{Invoking guix pack}.
@end quotation
@cindex exporting store items @cindex exporting store items
To export store files as an archive to standard output, run: To export store files as an archive to standard output, run: