~ruther/guix-local

5597b3ae0809abd9d94099ea5cd09c2a176e3f6f — Ludovic Courtès 9 years ago c8502d9
doc: "Nar" now means "normalized archive".

* doc/guix.texi (Invoking guix archive): Mention "normalized archive"
and add index entries.
1 files changed, 5 insertions(+), 3 deletions(-)

M doc/guix.texi
M doc/guix.texi => doc/guix.texi +5 -3
@@ 2403,10 2403,12 @@ profile as well as all of their dependencies are transferred (due to
target machine.  The @code{--missing} option can help figure out which
items are missing from the target store.

Archives are stored in the ``Nix archive'' or ``Nar'' format, which is
comparable in spirit to `tar', but with a few noteworthy differences
@cindex nar, archive format
@cindex normalized archive (nar)
Archives are stored in the ``normalized archive'' or ``nar'' format, which is
comparable in spirit to `tar', but with differences
that make it more appropriate for our purposes.  First, rather than
recording all Unix metadata for each file, the Nar format only mentions
recording all Unix metadata for each file, the nar format only mentions
the file type (regular, directory, or symbolic link); Unix permissions
and owner/group are dismissed.  Second, the order in which directory
entries are stored always follows the order of file names according to