path: root/Documentation/git-for-each-ref.txt
diff options
authorJacob Keller <>2016-11-19 00:58:15 (GMT)
committerJunio C Hamano <>2016-12-11 21:58:41 (GMT)
commitb1d31c8954f9c21b275f4fb7d872414b564c201c (patch)
tree58a8f8d36a5f9331a0e393e086f447ad65047af7 /Documentation/git-for-each-ref.txt
parentd9f31fbfe98e0e363a3c69aaf6badecc746afe6b (diff)
ref-filter: add support to display trailers as part of contents
Add %(trailers) and %(contents:trailers) to display the trailers as interpreted by trailer_info_get. Update documentation and add a test for the new feature. Signed-off-by: Jacob Keller <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-for-each-ref.txt')
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f57e69b..e5807ee 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -165,6 +165,8 @@ 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
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'.
For sorting purposes, fields with numeric values sort in numeric order
(`objectsize`, `authordate`, `committerdate`, `creatordate`, `taggerdate`).