summaryrefslogtreecommitdiffstats
path: root/git-for-each-ref.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-09-09 15:27:44 -0700
committerJunio C Hamano <gitster@pobox.com>2020-09-09 15:27:44 -0700
commita65d8e6d1bb62324eb42aa11f71b3d3a02fc8523 (patch)
tree412f8218550a718e86ad46906047ac415c4af7e0 /git-for-each-ref.html
parent558abd28b6851f370edc902b483e079a3ac255ab (diff)
downloadgit-htmldocs-a65d8e6d1bb62324eb42aa11f71b3d3a02fc8523.tar.gz
Autogenerated HTML docs for v2.28.0-497-g54e85e
Diffstat (limited to 'git-for-each-ref.html')
-rw-r--r--git-for-each-ref.html14
1 files changed, 11 insertions, 3 deletions
diff --git a/git-for-each-ref.html b/git-for-each-ref.html
index 54a877609..2f59c3058 100644
--- a/git-for-each-ref.html
+++ b/git-for-each-ref.html
@@ -1101,14 +1101,19 @@ worktreepath
</dl></div>
<div class="paragraph"><p>In addition to the above, for commit and tag objects, the header
field names (<code>tree</code>, <code>parent</code>, <code>object</code>, <code>type</code>, and <code>tag</code>) can
-be used to specify the value in the header field.</p></div>
+be used to specify the value in the header field.
+Fields <code>tree</code> and <code>parent</code> can also be used with modifier <code>:short</code> and
+<code>:short=&lt;length&gt;</code> just like <code>objectname</code>.</p></div>
<div class="paragraph"><p>For commit and tag objects, the special <code>creatordate</code> and <code>creator</code>
fields will correspond to the appropriate date or name-email-date tuple
from the <code>committer</code> or <code>tagger</code> fields depending on the object type.
These are intended for working on a mix of annotated and lightweight tags.</p></div>
<div class="paragraph"><p>Fields that have name-email-date tuple as its value (<code>author</code>,
<code>committer</code>, and <code>tagger</code>) can be suffixed with <code>name</code>, <code>email</code>,
-and <code>date</code> to extract the named component.</p></div>
+and <code>date</code> to extract the named component. For email fields (<code>authoremail</code>,
+<code>committeremail</code> and <code>taggeremail</code>), <code>:trim</code> can be appended to get the email
+without angle brackets, and <code>:localpart</code> to get the part before the <code>@</code> symbol
+out of the trimmed email.</p></div>
<div class="paragraph"><p>The message in a commit or a tag object is <code>contents</code>, from which
<code>contents:&lt;part&gt;</code> can be used to extract various parts out of:</p></div>
<div class="dlist"><dl>
@@ -1128,6 +1133,9 @@ contents:subject
The first paragraph of the message, which typically is a
single line, is taken as the "subject" of the commit or the
tag message.
+ Instead of <code>contents:subject</code>, field <code>subject</code> can also be used to
+ obtain same results. <code>:sanitize</code> can be appended to <code>subject</code> for
+ subject line suitable for filename.
</p>
</dd>
<dt class="hdlist1">
@@ -1309,7 +1317,7 @@ will be reported.</p></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2020-07-30 14:18:13 PDT
+ 2020-09-09 15:23:32 PDT
</div>
</div>
</body>