[PATCH v4 3/6] doc: 'trailers' is the preferred way to format trailers
- From
Taylor Blau <me@ttaylorr.com>
- Date
- Oct 1, 2017, 16:18 UTC
- Message-ID
- <20171001161852.84571-3-me@ttaylorr.com>
- In-Reply-To
- <20171001161852.84571-1-me@ttaylorr.com>
The documentation makes reference to 'contents:trailers' as an example to dig the trailers out of a commit. 'trailers' is an unmentioned alternative, which is treated as an alias of 'contents:trailers'.
Since 'trailers' is easier to type, prefer that as the designated way to dig out trailers information.
Signed-off-by: Taylor Blau <me@ttaylorr.com> --- Documentation/git-for-each-ref.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt index 66b4e0a40..323ce07de 100644 --- a/Documentation/git-for-each-ref.txt +++ b/Documentation/git-for-each-ref.txt @@ -217,7 +217,8 @@ 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'). For sorting purposes, fields with numeric values sort in numeric order (`objectsize`, `authordate`, `committerdate`, `creatordate`, `taggerdate`).
-- 2.14.1.145.gb3622a4ee