Skip to content

Commit 83115ac

Browse files
sunshinecogitster
authored andcommitted
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 <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 5ba9a93 commit 83115ac

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

Documentation/git-hash-object.txt

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ git-hash-object - Compute object ID and optionally creates a blob from a file
99
SYNOPSIS
1010
--------
1111
[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>...
1313
'git hash-object' [-t <type>] [-w] --stdin-paths [--no-filters] < <list-of-paths>
1414

1515
DESCRIPTION
@@ -51,7 +51,13 @@ OPTIONS
5151
Hash the contents as is, ignoring any input filter that would
5252
have been chosen by the attributes mechanism, including the end-of-line
5353
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.
5561

5662
GIT
5763
---

0 commit comments

Comments
 (0)