mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-12-24 21:38:07 -05:00
doc: Format 'guix hash -S' values as a table.
* doc/guix.texi (Invoking guix hash): Format serializer types as a table.
This commit is contained in:
parent
28ffdc5cc8
commit
4204156eb4
1 changed files with 13 additions and 4 deletions
|
@ -11758,18 +11758,27 @@ legacy alias for @var{type} sets to @code{nar}.
|
|||
@itemx -S
|
||||
Compute the hash on @var{file} using @var{type} serialization.
|
||||
|
||||
Supported types: @code{none}, @code{nar} and @code{git}.
|
||||
@var{type} may be one of the following:
|
||||
|
||||
When using @code{nar}, the hash is computed on an archive containing
|
||||
@table @code
|
||||
@item none
|
||||
This is the default: it computes the hash of a file's contents.
|
||||
|
||||
@item nar
|
||||
Compute the hash of a ``normalized archive'' (or ``nar'') containing
|
||||
@var{file}, including its children if it is a directory. Some of the
|
||||
metadata of @var{file} is part of the archive; for instance, when
|
||||
@var{file} is a regular file, the hash is different depending on whether
|
||||
@var{file} is executable or not. Metadata such as time stamps has no
|
||||
impact on the hash (@pxref{Invoking guix archive}).
|
||||
impact on the hash (@pxref{Invoking guix archive}, for more info on the
|
||||
nar format).
|
||||
@c FIXME: Replace xref above with xref to an ``Archive'' section when
|
||||
@c it exists.
|
||||
|
||||
Using @code{git} serializes the file or directory as a Git tree.
|
||||
@item git
|
||||
Compute the has of the file or directory as a Git ``tree'', following
|
||||
the same method as the Git version control system.
|
||||
@end table
|
||||
|
||||
@item --exclude-vcs
|
||||
@itemx -x
|
||||
|
|
Loading…
Reference in a new issue