[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
01/02: doc: "Nar" now means "normalized archive".
From: |
Ludovic Courtès |
Subject: |
01/02: doc: "Nar" now means "normalized archive". |
Date: |
Fri, 16 Dec 2016 13:47:26 +0000 (UTC) |
civodul pushed a commit to branch master
in repository guix.
commit 5597b3ae0809abd9d94099ea5cd09c2a176e3f6f
Author: Ludovic Courtès <address@hidden>
Date: Thu Dec 15 22:46:09 2016 +0100
doc: "Nar" now means "normalized archive".
* doc/guix.texi (Invoking guix archive): Mention "normalized archive"
and add index entries.
---
doc/guix.texi | 8 +++++---
1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 46ed451..bd782ca 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -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
address@hidden nar, archive format
address@hidden 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