diff options
author | Junio C Hamano <gitster@pobox.com> | 2019-01-18 15:16:05 -0800 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2019-01-18 15:16:05 -0800 |
commit | ace33e4fa1aa5ba14bafe92218bf07dea068791f (patch) | |
tree | 0ad7636f0f64e4f949fd65f468e206bc0a5d969b /git-for-each-ref.txt | |
parent | de48f457367f37c28229ebe8e6cef849dd6e430a (diff) | |
download | git-htmldocs-ace33e4fa1aa5ba14bafe92218bf07dea068791f.tar.gz |
Autogenerated HTML docs for v2.20.1-309-g16a465
Diffstat (limited to 'git-for-each-ref.txt')
-rw-r--r-- | git-for-each-ref.txt | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/git-for-each-ref.txt b/git-for-each-ref.txt index 901faef1b..774cecc7e 100644 --- a/git-for-each-ref.txt +++ b/git-for-each-ref.txt @@ -128,13 +128,18 @@ objecttype:: objectsize:: The size of the object (the same as 'git cat-file -s' reports). - + Append `:disk` to get the size, in bytes, that the object takes up on + disk. See the note about on-disk sizes in the `CAVEATS` section below. objectname:: The object name (aka SHA-1). For a non-ambiguous abbreviation of the object name append `:short`. For an abbreviation of the object name with desired length append `:short=<length>`, where the minimum length is MINIMUM_ABBREV. The length may be exceeded to ensure unique object names. +deltabase:: + This expands to the object name of the delta base for the + given object, if it is stored as a delta. Otherwise it + expands to the null object name (all zeroes). upstream:: The name of a local ref which can be considered ``upstream'' @@ -361,6 +366,20 @@ This prints the authorname, if present. git for-each-ref --format="%(refname)%(if)%(authorname)%(then) Authored by: %(authorname)%(end)" ------------ +CAVEATS +------- + +Note that the sizes of objects on disk are reported accurately, but care +should be taken in drawing conclusions about which refs or objects are +responsible for disk usage. The size of a packed non-delta object may be +much larger than the size of objects which delta against it, but the +choice of which object is the base and which is the delta is arbitrary +and is subject to change during a repack. + +Note also that multiple copies of an object may be present in the object +database; in this case, it is undefined which copy's size or delta base +will be reported. + SEE ALSO -------- linkgit:git-show-ref[1] |