02/07: doc: Connect "guix archive", "guix pack", and co.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit 9d4399b805b461b9b607ac932061146807e6953c
Author: Ludovic Courtès <address@hidden>
Date:   Mon Jan 15 14:44:55 2018 +0100

    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".
---
 doc/guix.texi | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index e32e032..59c354b 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -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.
 
address@hidden 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}.
address@hidden 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.
 
address@hidden Note
+If you're looking for a way to produce archives in a formatq suitable for
+tools other than Guix, @pxref{Invoking guix pack}.
address@hidden quotation
+
 @cindex exporting store items
 To export store files as an archive to standard output, run: