X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-cat-file.txt;h=5e9cbf875d72ae4a537467197ddde98dbec3cf3b;hb=HEAD;hp=2131a29993405742fcc67ed81a578c06bf950f44;hpb=6b7242aa1acc3c7835f80522914ffc4b2e789a29;p=git.git diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index 2131a299..5e9cbf87 100644 --- a/Documentation/git-cat-file.txt +++ b/Documentation/git-cat-file.txt @@ -1,6 +1,5 @@ git-cat-file(1) =============== -v0.1, May 2005 NAME ---- @@ -9,12 +8,12 @@ git-cat-file - Provide content or type information for repository objects SYNOPSIS -------- -'git-cat-file' (-t | -s | ) +'git-cat-file' [-t | -s | -e | -p | ] DESCRIPTION ----------- Provides content or type of objects in the repository. The type -is required unless '-t' is used to find the object type, +is required unless '-t' or '-p' is used to find the object type, or '-s' is used to find the object size. OPTIONS @@ -30,9 +29,16 @@ OPTIONS Instead of the content, show the object size identified by . +-e:: + Suppress all output; instead exit with zero status if + exists and is a valid object. + +-p:: + Pretty-print the contents of based on its type. + :: Typically this matches the real type of but asking - for a type that can trivially dereferenced from the given + for a type that can trivially be dereferenced from the given is also permitted. An example is to ask for a "tree" with being a commit object that contains it, or to ask for a "blob" with being a tag object that @@ -40,8 +46,13 @@ OPTIONS OUTPUT ------ -If '-t' is specified, one of the . If '-s' is specified, -the size of the in bytes. +If '-t' is specified, one of the . + +If '-s' is specified, the size of the in bytes. + +If '-e' is specified, no output. + +If '-p' is specified, the contents of are pretty-printed. Otherwise the raw (though uncompressed) contents of the will be returned. @@ -57,5 +68,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list