aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-for-each-ref.txt
diff options
context:
space:
mode:
authorTaylor Blau <me@ttaylorr.com>2017-10-01 22:25:23 -0700
committerJunio C Hamano <gitster@pobox.com>2017-10-02 21:15:30 +0900
commit67a20a0010224255bbd5bb9fa4f95595c3e1ba7c (patch)
tree54015139e20f0cb39eba25ee2d9011aaa07f5356 /Documentation/git-for-each-ref.txt
parent624b44d3763bd10e51fdcf66a205535140ca8539 (diff)
downloadgit-67a20a0010224255bbd5bb9fa4f95595c3e1ba7c.tar.gz
ref-filter.c: use trailer_opts to format trailers
Fill trailer_opts with "unfold" and "only" to match the sub-arguments given to the "%(trailers)" atom. Then, let's use the filled trailer_opts instance with 'format_trailers_from_commit' in order to format trailers in the desired manner. Signed-off-by: Taylor Blau <me@ttaylorr.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-for-each-ref.txt')
-rw-r--r--Documentation/git-for-each-ref.txt5
1 files changed, 4 insertions, 1 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index 1279b97330..4a2c851e6c 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -218,7 +218,10 @@ blank line. The optional GPG signature is `contents:signature`. The
first `N` lines of the message is obtained using `contents:lines=N`.
Additionally, the trailers as interpreted by linkgit:git-interpret-trailers[1]
are obtained as `trailers` (or by using the historical alias
-`contents:trailers`).
+`contents:trailers`). Non-trailer lines from the trailer block can be omitted
+with `trailers:only`. Whitespace-continuations can be removed from trailers so
+that each trailer appears on a line by itself with its full content with
+`trailers:unfold`. Both can be used together as `trailers:unfold,only`.
For sorting purposes, fields with numeric values sort in numeric order
(`objectsize`, `authordate`, `committerdate`, `creatordate`, `taggerdate`).