doc: Connect "guix archive", "guix pack", and co.
authorLudovic Courtès <ludo@gnu.org>
Mon, 15 Jan 2018 13:44:55 +0000 (14:44 +0100)
committerLudovic Courtès <ludo@gnu.org>
Mon, 15 Jan 2018 22:29:33 +0000 (23:29 +0100)
* doc/guix.texi (Invoking guix pack): Add xrefs to "guix publish", "guix
copy", and "guix archive".
(Invoking guix archive): Add xref to "guix pack".

doc/guix.texi

index e32e032..59c354b 100644 (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
 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 bundle
 @cindex application bundle
@@ -2794,10 +2800,16 @@ options (@pxref{Package Transformation Options}).
 @cindex @command{guix archive}
 @cindex archive
 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
 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
 To export store files as an archive to standard output, run: