summaryrefslogtreecommitdiffstats
path: root/git-rev-list.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2019-03-07 12:17:00 +0900
committerJunio C Hamano <gitster@pobox.com>2019-03-07 12:17:00 +0900
commit11f1537a82c84e620d742b3bc4256952defb28df (patch)
tree2923ff40fbf10f29b7eaa506c2deb52e00e08dde /git-rev-list.html
parent9149123b58ede4ca92a71abd3c09e3e2ad205b55 (diff)
downloadgit-htmldocs-11f1537a82c84e620d742b3bc4256952defb28df.tar.gz
Autogenerated HTML docs for v2.21.0-135-g6e0cc
Diffstat (limited to 'git-rev-list.html')
-rw-r--r--git-rev-list.html713
1 files changed, 490 insertions, 223 deletions
diff --git a/git-rev-list.html b/git-rev-list.html
index 8513655d2..70d26a2bf 100644
--- a/git-rev-list.html
+++ b/git-rev-list.html
@@ -2499,368 +2499,635 @@ The title was &gt;&gt;t4119: test autocomputing -p&lt;n&gt; for traditional diff
<div class="ulist"><ul>
<li>
<p>
-<em>%H</em>: commit hash
+Placeholders that expand to a single literal character:
</p>
-</li>
-<li>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<em>%n</em>
+</dt>
+<dd>
<p>
-<em>%h</em>: abbreviated commit hash
+newline
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%%</em>
+</dt>
+<dd>
<p>
-<em>%T</em>: tree hash
+a raw <em>%</em>
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%x00</em>
+</dt>
+<dd>
<p>
-<em>%t</em>: abbreviated tree hash
+print a byte from a hex code
</p>
+</dd>
+</dl></div>
</li>
<li>
<p>
-<em>%P</em>: parent hashes
+Placeholders that affect formatting of later placeholders:
</p>
-</li>
-<li>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<em>%Cred</em>
+</dt>
+<dd>
<p>
-<em>%p</em>: abbreviated parent hashes
+switch color to red
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%Cgreen</em>
+</dt>
+<dd>
<p>
-<em>%an</em>: author name
+switch color to green
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%Cblue</em>
+</dt>
+<dd>
<p>
-<em>%aN</em>: author name (respecting .mailmap, see <a href="git-shortlog.html">git-shortlog(1)</a>
- or <a href="git-blame.html">git-blame(1)</a>)
+switch color to blue
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%Creset</em>
+</dt>
+<dd>
<p>
-<em>%ae</em>: author email
+reset color
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%C(&#8230;)</em>
+</dt>
+<dd>
<p>
-<em>%aE</em>: author email (respecting .mailmap, see
- <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+color specification, as described under Values in the
+ "CONFIGURATION FILE" section of <a href="git-config.html">git-config(1)</a>. By
+ default, colors are shown only when enabled for log output
+ (by <code>color.diff</code>, <code>color.ui</code>, or <code>--color</code>, and respecting
+ the <code>auto</code> settings of the former if we are going to a
+ terminal). <code>%C(auto,...)</code> is accepted as a historical
+ synonym for the default (e.g., <code>%C(auto,red)</code>). Specifying
+ <code>%C(always,...)</code> will show the colors even when color is
+ not otherwise enabled (though consider just using
+ <code>--color=always</code> to enable color for the whole output,
+ including this format and anything else git might color).
+ <code>auto</code> alone (i.e. <code>%C(auto)</code>) will turn on auto coloring
+ on the next placeholders until the color is switched
+ again.
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%m</em>
+</dt>
+<dd>
<p>
-<em>%ad</em>: author date (format respects --date= option)
+left (<code>&lt;</code>), right (<code>&gt;</code>) or boundary (<code>-</code>) mark
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%w([&lt;w&gt;[,&lt;i1&gt;[,&lt;i2&gt;]]])</em>
+</dt>
+<dd>
<p>
-<em>%aD</em>: author date, RFC2822 style
+switch line wrapping, like the -w option of
+ <a href="git-shortlog.html">git-shortlog(1)</a>.
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%&lt;(&lt;N&gt;[,trunc|ltrunc|mtrunc])</em>
+</dt>
+<dd>
<p>
-<em>%ar</em>: author date, relative
+make the next placeholder take at
+ least N columns, padding spaces on
+ the right if necessary. Optionally
+ truncate at the beginning (ltrunc),
+ the middle (mtrunc) or the end
+ (trunc) if the output is longer than
+ N columns. Note that truncating
+ only works correctly with N &gt;= 2.
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%&lt;|(&lt;N&gt;)</em>
+</dt>
+<dd>
<p>
-<em>%at</em>: author date, UNIX timestamp
+make the next placeholder take at least until Nth
+ columns, padding spaces on the right if necessary
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
+</dt>
+<dd>
<p>
-<em>%ai</em>: author date, ISO 8601-like format
+similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em> respectively,
+ but padding spaces on the left
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%&gt;&gt;(&lt;N&gt;)</em>, <em>%&gt;&gt;|(&lt;N&gt;)</em>
+</dt>
+<dd>
<p>
-<em>%aI</em>: author date, strict ISO 8601 format
+similar to <em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
+ respectively, except that if the next
+ placeholder takes more spaces than given and
+ there are spaces on its left, use those
+ spaces
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%&gt;&lt;(&lt;N&gt;)</em>, <em>%&gt;&lt;|(&lt;N&gt;)</em>
+</dt>
+<dd>
<p>
-<em>%cn</em>: committer name
+similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em>
+ respectively, but padding both sides
+ (i.e. the text is centered)
</p>
+</dd>
+</dl></div>
</li>
<li>
<p>
-<em>%cN</em>: committer name (respecting .mailmap, see
- <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+Placeholders that expand to information extracted from the commit:
</p>
-</li>
-<li>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<em>%H</em>
+</dt>
+<dd>
<p>
-<em>%ce</em>: committer email
+commit hash
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%h</em>
+</dt>
+<dd>
<p>
-<em>%cE</em>: committer email (respecting .mailmap, see
- <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+abbreviated commit hash
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%T</em>
+</dt>
+<dd>
<p>
-<em>%cd</em>: committer date (format respects --date= option)
+tree hash
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%t</em>
+</dt>
+<dd>
<p>
-<em>%cD</em>: committer date, RFC2822 style
+abbreviated tree hash
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%P</em>
+</dt>
+<dd>
<p>
-<em>%cr</em>: committer date, relative
+parent hashes
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%p</em>
+</dt>
+<dd>
<p>
-<em>%ct</em>: committer date, UNIX timestamp
+abbreviated parent hashes
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%an</em>
+</dt>
+<dd>
<p>
-<em>%ci</em>: committer date, ISO 8601-like format
+author name
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%aN</em>
+</dt>
+<dd>
<p>
-<em>%cI</em>: committer date, strict ISO 8601 format
+author name (respecting .mailmap, see <a href="git-shortlog.html">git-shortlog(1)</a>
+ or <a href="git-blame.html">git-blame(1)</a>)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ae</em>
+</dt>
+<dd>
<p>
-<em>%d</em>: ref names, like the --decorate option of <a href="git-log.html">git-log(1)</a>
+author email
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%aE</em>
+</dt>
+<dd>
<p>
-<em>%D</em>: ref names without the " (", ")" wrapping.
+author email (respecting .mailmap, see <a href="git-shortlog.html">git-shortlog(1)</a>
+ or <a href="git-blame.html">git-blame(1)</a>)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ad</em>
+</dt>
+<dd>
<p>
-<em>%S</em>: ref name given on the command line by which the commit was reached
- (like <code>git log --source</code>), only works with <code>git log</code>
+author date (format respects --date= option)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%aD</em>
+</dt>
+<dd>
<p>
-<em>%e</em>: encoding
+author date, RFC2822 style
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ar</em>
+</dt>
+<dd>
<p>
-<em>%s</em>: subject
+author date, relative
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%at</em>
+</dt>
+<dd>
<p>
-<em>%f</em>: sanitized subject line, suitable for a filename
+author date, UNIX timestamp
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ai</em>
+</dt>
+<dd>
<p>
-<em>%b</em>: body
+author date, ISO 8601-like format
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%aI</em>
+</dt>
+<dd>
<p>
-<em>%B</em>: raw body (unwrapped subject and body)
+author date, strict ISO 8601 format
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cn</em>
+</dt>
+<dd>
<p>
-<em>%GG</em>: raw verification message from GPG for a signed commit
+committer name
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cN</em>
+</dt>
+<dd>
<p>
-<em>%G?</em>: show "G" for a good (valid) signature,
- "B" for a bad signature,
- "U" for a good signature with unknown validity,
- "X" for a good signature that has expired,
- "Y" for a good signature made by an expired key,
- "R" for a good signature made by a revoked key,
- "E" if the signature cannot be checked (e.g. missing key)
- and "N" for no signature
+committer name (respecting .mailmap, see
+ <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ce</em>
+</dt>
+<dd>
<p>
-<em>%GS</em>: show the name of the signer for a signed commit
+committer email
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cE</em>
+</dt>
+<dd>
<p>
-<em>%GK</em>: show the key used to sign a signed commit
+committer email (respecting .mailmap, see
+ <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cd</em>
+</dt>
+<dd>
<p>
-<em>%GF</em>: show the fingerprint of the key used to sign a signed commit
+committer date (format respects --date= option)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cD</em>
+</dt>
+<dd>
<p>
-<em>%GP</em>: show the fingerprint of the primary key whose subkey was used
- to sign a signed commit
+committer date, RFC2822 style
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cr</em>
+</dt>
+<dd>
<p>
-<em>%gD</em>: reflog selector, e.g., <code>refs/stash@{1}</code> or
- <code>refs/stash@{2 minutes ago</code>}; the format follows the rules described
- for the <code>-g</code> option. The portion before the <code>@</code> is the refname as
- given on the command line (so <code>git log -g refs/heads/master</code> would
- yield <code>refs/heads/master@{0}</code>).
+committer date, relative
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ct</em>
+</dt>
+<dd>
<p>
-<em>%gd</em>: shortened reflog selector; same as <code>%gD</code>, but the refname
- portion is shortened for human readability (so <code>refs/heads/master</code>
- becomes just <code>master</code>).
+committer date, UNIX timestamp
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%ci</em>
+</dt>
+<dd>
<p>
-<em>%gn</em>: reflog identity name
+committer date, ISO 8601-like format
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%cI</em>
+</dt>
+<dd>
<p>
-<em>%gN</em>: reflog identity name (respecting .mailmap, see
- <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+committer date, strict ISO 8601 format
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%d</em>
+</dt>
+<dd>
<p>
-<em>%ge</em>: reflog identity email
+ref names, like the --decorate option of <a href="git-log.html">git-log(1)</a>
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%D</em>
+</dt>
+<dd>
<p>
-<em>%gE</em>: reflog identity email (respecting .mailmap, see
- <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+ref names without the " (", ")" wrapping.
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%S</em>
+</dt>
+<dd>
<p>
-<em>%gs</em>: reflog subject
+ref name given on the command line by which the commit was reached
+ (like <code>git log --source</code>), only works with <code>git log</code>
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%e</em>
+</dt>
+<dd>
<p>
-<em>%Cred</em>: switch color to red
+encoding
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%s</em>
+</dt>
+<dd>
<p>
-<em>%Cgreen</em>: switch color to green
+subject
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%f</em>
+</dt>
+<dd>
<p>
-<em>%Cblue</em>: switch color to blue
+sanitized subject line, suitable for a filename
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%b</em>
+</dt>
+<dd>
<p>
-<em>%Creset</em>: reset color
+body
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%B</em>
+</dt>
+<dd>
<p>
-<em>%C(&#8230;)</em>: color specification, as described under Values in the
- "CONFIGURATION FILE" section of <a href="git-config.html">git-config(1)</a>.
- By default, colors are shown only when enabled for log output (by
- <code>color.diff</code>, <code>color.ui</code>, or <code>--color</code>, and respecting the <code>auto</code>
- settings of the former if we are going to a terminal). <code>%C(auto,...)</code>
- is accepted as a historical synonym for the default (e.g.,
- <code>%C(auto,red)</code>). Specifying <code>%C(always,...)</code> will show the colors
- even when color is not otherwise enabled (though consider
- just using <code>--color=always</code> to enable color for the whole output,
- including this format and anything else git might color). <code>auto</code>
- alone (i.e. <code>%C(auto)</code>) will turn on auto coloring on the next
- placeholders until the color is switched again.
+raw body (unwrapped subject and body)
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%GG</em>
+</dt>
+<dd>
<p>
-<em>%m</em>: left (<code>&lt;</code>), right (<code>&gt;</code>) or boundary (<code>-</code>) mark
+raw verification message from GPG for a signed commit
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%G?</em>
+</dt>
+<dd>
<p>
-<em>%n</em>: newline
+show "G" for a good (valid) signature,
+ "B" for a bad signature,
+ "U" for a good signature with unknown validity,
+ "X" for a good signature that has expired,
+ "Y" for a good signature made by an expired key,
+ "R" for a good signature made by a revoked key,
+ "E" if the signature cannot be checked (e.g. missing key)
+ and "N" for no signature
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%GS</em>
+</dt>
+<dd>
<p>
-<em>%%</em>: a raw <em>%</em>
+show the name of the signer for a signed commit
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%GK</em>
+</dt>
+<dd>
<p>
-<em>%x00</em>: print a byte from a hex code
+show the key used to sign a signed commit
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%GF</em>
+</dt>
+<dd>
<p>
-<em>%w([&lt;w&gt;[,&lt;i1&gt;[,&lt;i2&gt;]]])</em>: switch line wrapping, like the -w option of
- <a href="git-shortlog.html">git-shortlog(1)</a>.
+show the fingerprint of the key used to sign a signed commit
</p>
-</li>
-<li>
+</dd>
+<dt class="hdlist1">
+<em>%GP</em>
+</dt>
+<dd>
<p>
-<em>%&lt;(&lt;N&gt;[,trunc|ltrunc|mtrunc])</em>: make the next placeholder take at
- least N columns, padding spaces on the right if necessary.
- Optionally truncate at the beginning (ltrunc), the middle (mtrunc)
- or the end (trunc) if the output is longer than N columns.
- Note that truncating only works correctly with N &gt;= 2.
+show the fingerprint of the primary key whose subkey was used
+ to sign a signed commit
</p>
-</li>
+</dd>
+<dt class="hdlist1">
+<em>%gD</em>
+</dt>
+<dd>
+<p>
+reflog selector, e.g., <code>refs/stash@{1}</code> or <code>refs/stash@{2
+ minutes ago</code>}; the format follows the rules described for the
+ <code>-g</code> option. The portion before the <code>@</code> is the refname as
+ given on the command line (so <code>git log -g refs/heads/master</code>
+ would yield <code>refs/heads/master@{0}</code>).
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%gd</em>
+</dt>
+<dd>
+<p>
+shortened reflog selector; same as <code>%gD</code>, but the refname
+ portion is shortened for human readability (so
+ <code>refs/heads/master</code> becomes just <code>master</code>).
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%gn</em>
+</dt>
+<dd>
+<p>
+reflog identity name
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%gN</em>
+</dt>
+<dd>
+<p>
+reflog identity name (respecting .mailmap, see
+ <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%ge</em>
+</dt>
+<dd>
+<p>
+reflog identity email
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%gE</em>
+</dt>
+<dd>
+<p>
+reflog identity email (respecting .mailmap, see
+ <a href="git-shortlog.html">git-shortlog(1)</a> or <a href="git-blame.html">git-blame(1)</a>)
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%gs</em>
+</dt>
+<dd>
+<p>
+reflog subject
+</p>
+</dd>
+<dt class="hdlist1">
+<em>%(trailers[:options])</em>
+</dt>
+<dd>
+<p>
+display the trailers of the body as
+ interpreted by
+ <a href="git-interpret-trailers.html">git-interpret-trailers(1)</a>. The
+ <code>trailers</code> string may be followed by a colon
+ and zero or more comma-separated options:
+</p>
+<div class="ulist"><ul>
<li>
<p>
-<em>%&lt;|(&lt;N&gt;)</em>: make the next placeholder take at least until Nth
- columns, padding spaces on the right if necessary
+<em>key=&lt;K&gt;</em>: only show trailers with specified key. Matching is done
+ case-insensitively and trailing colon is optional. If option is
+ given multiple times trailer lines matching any of the keys are
+ shown. This option automatically enables the <code>only</code> option so that
+ non-trailer lines in the trailer block are hidden. If that is not
+ desired it can be disabled with <code>only=false</code>. E.g.,
+ <code>%(trailers:key=Reviewed-by)</code> shows trailer lines with key
+ <code>Reviewed-by</code>.
</p>
</li>
<li>
<p>
-<em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>: similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em>
- respectively, but padding spaces on the left
+<em>only[=val]</em>: select whether non-trailer lines from the trailer
+ block should be included. The <code>only</code> keyword may optionally be
+ followed by an equal sign and one of <code>true</code>, <code>on</code>, <code>yes</code> to omit or
+ <code>false</code>, <code>off</code>, <code>no</code> to show the non-trailer lines. If option is
+ given without value it is enabled. If given multiple times the last
+ value is used.
</p>
</li>
<li>
<p>
-<em>%&gt;&gt;(&lt;N&gt;)</em>, <em>%&gt;&gt;|(&lt;N&gt;)</em>: similar to <em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
- respectively, except that if the next placeholder takes more spaces
- than given and there are spaces on its left, use those spaces
+<em>separator=&lt;SEP&gt;</em>: specify a separator inserted between trailer
+ lines. When this option is not given each trailer line is
+ terminated with a line feed character. The string SEP may contain
+ the literal formatting codes described above. To use comma as
+ separator one must use <code>%x2C</code> as it would otherwise be parsed as
+ next option. If separator option is given multiple times only the
+ last one is used. E.g., <code>%(trailers:key=Ticket,separator=%x2C )</code>
+ shows all trailer lines whose key is "Ticket" separated by a comma
+ and a space.
</p>
</li>
<li>
<p>
-<em>%&gt;&lt;(&lt;N&gt;)</em>, <em>%&gt;&lt;|(&lt;N&gt;)</em>: similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em>
- respectively, but padding both sides (i.e. the text is centered)
+<em>unfold[=val]</em>: make it behave as if interpret-trailer&#8217;s <code>--unfold</code>
+ option was given. In same way as to for <code>only</code> it can be followed
+ by an equal sign and explicit value. E.g.,
+ <code>%(trailers:only,unfold=true)</code> unfolds and shows all trailer lines.
</p>
</li>
<li>
<p>
-%(trailers[:options]): display the trailers of the body as interpreted
- by <a href="git-interpret-trailers.html">git-interpret-trailers(1)</a>. The <code>trailers</code> string may be
- followed by a colon and zero or more comma-separated options. If the
- <code>only</code> option is given, omit non-trailer lines from the trailer block.
- If the <code>unfold</code> option is given, behave as if interpret-trailer&#8217;s
- <code>--unfold</code> option was given. E.g., <code>%(trailers:only,unfold)</code> to do
- both.
+<em>valueonly[=val]</em>: skip over the key part of the trailer line and only
+ show the value part. Also this optionally allows explicit value.
</p>
</li>
</ul></div>
+</dd>
+</dl></div>
+</li>
+</ul></div>
</li>
</ul></div>
<div class="admonitionblock">
@@ -2932,7 +3199,7 @@ $ git log -2 --pretty=%h 4da45bef</code></pre>
<div id="footer">
<div id="footer-text">
Last updated
- 2018-01-26 15:11:04 PST
+ 2018-01-27 08:11:04 JST
</div>
</div>
</body>