nixo
/
guix-devel
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

doc: Move paragraphs in description of guix archive. 

* doc/guix.texi ("invoking guix archive"): Move paragraph describing basic
  invocation from the end to the beginning of the section.
master
Andreas Enge 2016-02-13 20:04:10 +01:00
parent b736776255
commit 4d4c481601
1 changed files with 24 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
doc/guix.texi
View File

@ -2004,8 +2004,30 @@ useful to Guix developers.
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.
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. For example, to transfer the @code{emacs} to the store on another machine.
package to a machine connected over SSH, one would run:
To export store files as an archive to standard output, run:
@example
guix archive --export @var{options} @var{specifications}...
@end example
@var{specifications} may be either store file names or package
specifications, as for @command{guix package} (@pxref{Invoking guix
package}). For instance, the following command creates an archive
containing the @code{gui} output of the @code{git} package and the main
output of @code{emacs}:
@example
guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar
@end example
If the specified packages are not built yet, @command{guix archive}
automatically builds them. The build process may be controlled with the
common build options (@pxref{Common Build Options}).
To transfer the @code{emacs} package to a machine connected over SSH,
one would run:
@example @example
guix archive --export -r emacs | ssh the-machine guix archive --import guix archive --export -r emacs | ssh the-machine guix archive --import
@ -2127,26 +2149,6 @@ archive contents coming from possibly untrusted substitute servers.
@end table @end table
To export store files as an archive to standard output, run:
@example
guix archive --export @var{options} @var{specifications}...
@end example
@var{specifications} may be either store file names or package
specifications, as for @command{guix package} (@pxref{Invoking guix
package}). For instance, the following command creates an archive
containing the @code{gui} output of the @code{git} package and the main
output of @code{emacs}:
@example
guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar
@end example
If the specified packages are not built yet, @command{guix archive}
automatically builds them. The build process may be controlled with the
common build options (@pxref{Common Build Options}).
@c ********************************************************************* @c *********************************************************************
@include emacs.texi @include emacs.texi