summaryrefslogtreecommitdiffstats
path: root/git-for-each-ref.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2023-12-09 17:43:11 -0800
committerJunio C Hamano <gitster@pobox.com>2023-12-09 17:43:11 -0800
commit9c919c74b7fda282913220a8f9af0f70d47a194c (patch)
treeef5a6d931bdfdaed6c82dc6faa0eca37857d0a53 /git-for-each-ref.html
parentcb119ab9d01a5ead330e94756b310ca384219570 (diff)
downloadgit-htmldocs-9c919c74b7fda282913220a8f9af0f70d47a194c.tar.gz
Autogenerated HTML docs for v2.43.0-76-g1a87c
Diffstat (limited to 'git-for-each-ref.html')
-rw-r--r--git-for-each-ref.html23
1 files changed, 11 insertions, 12 deletions
diff --git a/git-for-each-ref.html b/git-for-each-ref.html
index 6798e1129..a9d5256bc 100644
--- a/git-for-each-ref.html
+++ b/git-for-each-ref.html
@@ -822,18 +822,14 @@ host language allowing their direct evaluation in that language.</p></div>
</dt>
<dd>
<p>
- A string that interpolates <code>%(fieldname)</code> from a ref being shown
- and the object it points at. If <code>fieldname</code>
- is prefixed with an asterisk (<code>*</code>) and the ref points
- at a tag object, use the value for the field in the object
- which the tag object refers to (instead of the field in the tag object).
- When unspecified, <code>&lt;format&gt;</code> defaults to
- <code>%(objectname) SPC %(objecttype) TAB %(refname)</code>.
- It also interpolates <code>%%</code> to <code>%</code>, and <code>%xx</code> where <code>xx</code>
- are hex digits interpolates to character with hex code
- <code>xx</code>; for example <code>%00</code> interpolates to <code>\0</code> (NUL),
- <code>%09</code> to <code>\t</code> (TAB) and <code>%0a</code> to <code>\n</code> (LF).
+ A string that interpolates <code>%(fieldname)</code> from a ref being shown and
+ the object it points at. In addition, the string literal <code>%%</code>
+ renders as <code>%</code> and <code>%xx</code> - where <code>xx</code> are hex digits - renders as
+ the character with hex code <code>xx</code>. For example, <code>%00</code> interpolates to
+ <code>\0</code> (NUL), <code>%09</code> to <code>\t</code> (TAB), and <code>%0a</code> to <code>\n</code> (LF).
</p>
+<div class="paragraph"><p>When unspecified, <code>&lt;format&gt;</code> defaults to <code>%(objectname) SPC %(objecttype)
+TAB %(refname)</code>.</p></div>
</dd>
<dt class="hdlist1">
--color[=&lt;when&gt;]
@@ -1262,6 +1258,9 @@ Fields <code>tree</code> and <code>parent</code> can also be used with modifier
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>For tag objects, a <code>fieldname</code> prefixed with an asterisk (<code>*</code>) expands to
+the <code>fieldname</code> value of the peeled object, rather than that of the tag
+object itself.</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. For email fields (<code>authoremail</code>,
@@ -1498,7 +1497,7 @@ commits and from none of the <code>--no-merged</code> commits are shown.</p></di
<div id="footer">
<div id="footer-text">
Last updated
- 2023-10-05 07:43:56 JST
+ 2023-12-09 17:40:53 PST
</div>
</div>
</body>