git-cat-file.txt: Document --textconv
Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Michael J Gruber committed
Jun 24, 2010 at 14:56 UTC
9f77fe022425360dced8b1f19275852e89d2351c
1 file changed
+8
-2
Documentation/git-cat-file.txt
+8
-2
@@ -9,14 +9,15 @@ git-cat-file - Provide content or type and size information for repository objec
9
SYNOPSIS
10
--------
11
[verse]
12
-'git cat-file' (-t | -s | -e | -p | <type>) <object>
12
+'git cat-file' (-t | -s | -e | -p | <type> | --textconv ) <object>
13
'git cat-file' (--batch | --batch-check) < <list-of-objects>
14
15
DESCRIPTION
16
-----------
17
In its first form, the command provides the content or the type of an object in
18
the repository. The type is required unless '-t' or '-p' is used to find the
19
-object type, or '-s' is used to find the object size.
19
+object type, or '-s' is used to find the object size, or '--textconv' is used
20
+(which implies type "blob").
21
22
In the second form, a list of objects (separated by linefeeds) is provided on
23
stdin, and the SHA1, type, and size of each object is printed on stdout.
@@ -51,6 +52,11 @@ OPTIONS
52
or to ask for a "blob" with <object> being a tag object that
53
points at it.
54
55
+--textconv::
56
+ Show the content as transformed by a textconv filter. In this case,
57
+ <object> has be of the form <treeish>:<path>, or :<path> in order
58
+ to apply the filter to the content recorded in the index at <path>.
59
+
60
--batch::
61
Print the SHA1, type, size, and contents of each object provided on
62
stdin. May not be combined with any other options or arguments.