summaryrefslogtreecommitdiffstats
path: root/git-for-each-ref.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-01-18 15:16:05 -0800
committerJunio C Hamano <gitster@pobox.com>2019-01-18 15:16:05 -0800
commitace33e4fa1aa5ba14bafe92218bf07dea068791f (patch)
tree0ad7636f0f64e4f949fd65f468e206bc0a5d969b /git-for-each-ref.html
parentde48f457367f37c28229ebe8e6cef849dd6e430a (diff)
downloadgit-htmldocs-ace33e4fa1aa5ba14bafe92218bf07dea068791f.tar.gz
Autogenerated HTML docs for v2.20.1-309-g16a465
Diffstat (limited to 'git-for-each-ref.html')
-rw-r--r--git-for-each-ref.html28
1 files changed, 27 insertions, 1 deletions
diff --git a/git-for-each-ref.html b/git-for-each-ref.html
index 8277e2fc4..9d195ad10 100644
--- a/git-for-each-ref.html
+++ b/git-for-each-ref.html
@@ -956,6 +956,8 @@ objectsize
<dd>
<p>
The size of the object (the same as <em>git cat-file -s</em> reports).
+ Append <code>:disk</code> to get the size, in bytes, that the object takes up on
+ disk. See the note about on-disk sizes in the <code>CAVEATS</code> section below.
</p>
</dd>
<dt class="hdlist1">
@@ -971,6 +973,16 @@ objectname
</p>
</dd>
<dt class="hdlist1">
+deltabase
+</dt>
+<dd>
+<p>
+ 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).
+</p>
+</dd>
+<dt class="hdlist1">
upstream
</dt>
<dd>
@@ -1216,6 +1228,20 @@ This prints the authorname, if present.</p></div>
</div>
</div>
<div class="sect1">
+<h2 id="_caveats">CAVEATS</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>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.</p></div>
+<div class="paragraph"><p>Note also that multiple copies of an object may be present in the object
+database; in this case, it is undefined which copy&#8217;s size or delta base
+will be reported.</p></div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
<div class="paragraph"><p><a href="git-show-ref.html">git-show-ref(1)</a></p></div>
@@ -1232,7 +1258,7 @@ This prints the authorname, if present.</p></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2018-08-18 07:20:20 JST
+ 2019-01-18 15:15:21 PST
</div>
</div>
</body>