X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-cat-file.txt;h=075c0d05efca85c2357e09aa640aa4b7f0305419;hb=2dc53617a43fda3df12e51e765fe4043935cfc22;hp=ab4dcae21caa190a41c19ec24b4dc2d71a5a73fb;hpb=f51248eb482a7a0feacb04d02119c94d35845975;p=git.git diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index ab4dcae21..075c0d05e 100644 --- a/Documentation/git-cat-file.txt +++ b/Documentation/git-cat-file.txt @@ -3,23 +3,25 @@ git-cat-file(1) NAME ---- -git-cat-file - Provide content or type information for repository objects +git-cat-file - Provide content or type/size 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 ------- :: - The sha1 identifier of the object. + The name of the object to show. + For a more complete list of ways to spell object names, see + "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1]. -t:: Instead of the content, show the object type identified by @@ -29,6 +31,13 @@ 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 be dereferenced from the given @@ -39,8 +48,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.