civodul pushed a commit to branch master
in repository guix.
commit 9d4399b805b461b9b607ac932061146807e6953c
Author: Ludovic Courtès <[email protected]>
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.
+@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:
