git-hash-object.txt: document --literally option
Document the git-hash-object --literally option added by 5ba9a93 (hash-object: add --literally option, 2014-09-11). While here, also correct a minor typesetting oversight. Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Eric Sunshine committed
May 4, 2015 at 03:25 UTC
83115ac4a811ef37318bc0e68a5e8b229751a88f
1 file changed
+8
-2
Documentation/git-hash-object.txt
+8
-2
@@ -9,7 +9,7 @@ git-hash-object - Compute object ID and optionally creates a blob from a file
9
SYNOPSIS
10
--------
11
[verse]
12
-'git hash-object' [-t <type>] [-w] [--path=<file>|--no-filters] [--stdin] [--] <file>...
12
+'git hash-object' [-t <type>] [-w] [--path=<file>|--no-filters] [--stdin [--literally]] [--] <file>...
13
'git hash-object' [-t <type>] [-w] --stdin-paths [--no-filters] < <list-of-paths>
14
15
DESCRIPTION
@@ -51,7 +51,13 @@ OPTIONS
51
Hash the contents as is, ignoring any input filter that would
52
have been chosen by the attributes mechanism, including the end-of-line
53
conversion. If the file is read from standard input then this
54
- is always implied, unless the --path option is given.
54
+ is always implied, unless the `--path` option is given.
55
+
56
+--literally::
57
+ Allow `--stdin` to hash any garbage into a loose object which might not
58
+ otherwise pass standard object parsing or git-fsck checks. Useful for
59
+ stress-testing Git itself or reproducing characteristics of corrupt or
60
+ bogus objects encountered in the wild.
61
62
GIT
63
---