X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-cat-file.txt;h=5e9cbf875d72ae4a537467197ddde98dbec3cf3b;hb=ae448e3854d8b6e7e37aa88fa3917f5dd97f3210;hp=48fb37769c2f4e528f143713125b3d6593d57c7d;hpb=5569bf9bbedd63a00780fc5c110e0cfab3aa97b9;p=git.git diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index 48fb3776..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,13 @@ git-cat-file - Provide content or type information for repository objects SYNOPSIS -------- -'git-cat-file' (-t | ) +'git-cat-file' [-t | -s | -e | -p | ] DESCRIPTION ----------- Provides content or type of objects in the repository. The type -is required if '-t' is not being 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 ------- @@ -25,9 +25,20 @@ OPTIONS Instead of the content, show the object type identified by . +-s:: + 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 @@ -37,6 +48,12 @@ OUTPUT ------ 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. @@ -51,5 +68,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list