X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-cat-file.txt;h=ab4dcae21caa190a41c19ec24b4dc2d71a5a73fb;hb=650e4be59b9f385f56e5829d97d09e8440f174b8;hp=48fb37769c2f4e528f143713125b3d6593d57c7d;hpb=85c1f337be49eaa9a22e42a1c9958deef5ab57c3;p=git.git diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt index 48fb3776..ab4dcae2 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 | ) 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 +25,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 +39,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 +56,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list