X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-cat-file.txt;h=f21a6e06aa2ca762ad3ae20d756c569f4210652e;hb=ab1630a3ed31d6ec5ae83769c78ed542fe3c4a28;hp=48fb37769c2f4e528f143713125b3d6593d57c7d;hpb=5569bf9bbedd63a00780fc5c110e0cfab3aa97b9;p=git.git diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index 48fb3776..f21a6e06 100644 --- a/Documentation/git-cat-file.txt +++ b/Documentation/git-cat-file.txt @@ -9,12 +9,13 @@ git-cat-file - Provide content or type information for repository objects SYNOPSIS -------- -'git-cat-file' (-t | ) +'git-cat-file' (-t | -s | ) 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' is used to find the object type, +or '-s' is used to find the object size. OPTIONS ------- @@ -25,9 +26,13 @@ OPTIONS Instead of the content, show the object type identified by . +-s:: + Instead of the content, show the object size identified by + . + :: 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 @@ -35,7 +40,8 @@ OPTIONS OUTPUT ------ -If '-t' is specified, one of the . +If '-t' is specified, one of the . If '-s' is specified, +the size of the in bytes. Otherwise the raw (though uncompressed) contents of the will be returned. @@ -51,5 +57,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list