summaryrefslogtreecommitdiffstats
path: root/git-for-each-ref.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2017-10-11 15:33:37 +0900
committerJunio C Hamano <gitster@pobox.com>2017-10-11 15:33:37 +0900
commit1171ab4652351c5e6fed9f3a08056ef6aabddb92 (patch)
treebdd43ea04fa5c06ced83504dbe6c6d3c6262626d /git-for-each-ref.txt
parentd8dc0b56b66fea3957211f032039c350d72131b9 (diff)
downloadgit-htmldocs-1171ab4652351c5e6fed9f3a08056ef6aabddb92.tar.gz
Autogenerated HTML docs for v2.15.0-rc1
Diffstat (limited to 'git-for-each-ref.txt')
-rw-r--r--git-for-each-ref.txt8
1 files changed, 6 insertions, 2 deletions
diff --git a/git-for-each-ref.txt b/git-for-each-ref.txt
index cbd0a6212..1d420e4cd 100644
--- a/git-for-each-ref.txt
+++ b/git-for-each-ref.txt
@@ -218,11 +218,15 @@ and `date` to extract the named component.
The complete message in a commit and tag object is `contents`.
Its first line is `contents:subject`, where subject is the concatenation
of all lines of the commit message up to the first blank line. The next
-line is 'contents:body', where body is all of the lines after the first
+line is `contents:body`, where body is all of the lines after the first
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 'contents:trailers'.
+are obtained as `trailers` (or by using the historical alias
+`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`).