doc: "Nar" now means "normalized archive".
* doc/guix.texi (Invoking guix archive): Mention "normalized archive" and add index entries.
This commit is contained in:
		
							parent
							
								
									c8502d9ec1
								
							
						
					
					
						commit
						5597b3ae08
					
				
					 1 changed files with 5 additions and 3 deletions
				
			
		| 
						 | 
					@ -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
 | 
					target machine.  The @code{--missing} option can help figure out which
 | 
				
			||||||
items are missing from the target store.
 | 
					items are missing from the target store.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Archives are stored in the ``Nix archive'' or ``Nar'' format, which is
 | 
					@cindex nar, archive format
 | 
				
			||||||
comparable in spirit to `tar', but with a few noteworthy differences
 | 
					@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
 | 
					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
 | 
					the file type (regular, directory, or symbolic link); Unix permissions
 | 
				
			||||||
and owner/group are dismissed.  Second, the order in which directory
 | 
					and owner/group are dismissed.  Second, the order in which directory
 | 
				
			||||||
entries are stored always follows the order of file names according to
 | 
					entries are stored always follows the order of file names according to
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Reference in a new issue