diff options
author | Junio C Hamano <gitster@pobox.com> | 2016-02-06 01:54:19 +0300 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2016-02-06 01:54:20 +0300 |
commit | 01517bd26ff6ad179c0ea60161193aa4bac1bcb7 (patch) | |
tree | 0f62f12c85d136e1851eeb4157c9d98b7234974b | |
parent | 353f68557253c2e16fb1a790881cb915f31a0ccd (diff) | |
parent | e914ef0d03d189611fe02e0fd26f5f964594767e (diff) |
Merge branch 'ew/for-each-ref-doc' into maint
* ew/for-each-ref-doc:
for-each-ref: document `creatordate` and `creator` fields
-rw-r--r-- | Documentation/git-for-each-ref.txt | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt index d5e1781db7..2e3e96f663 100644 --- a/Documentation/git-for-each-ref.txt +++ b/Documentation/git-for-each-ref.txt @@ -146,6 +146,11 @@ In addition to the above, for commit and tag objects, the header field names (`tree`, `parent`, `object`, `type`, and `tag`) can be used to specify the value in the header field. +For commit and tag objects, the special `creatordate` and `creator` +fields will correspond to the appropriate date or name-email-date tuple +from the `committer` or `tagger` fields depending on the object type. +These are intended for working on a mix of annotated and lightweight tags. + Fields that have name-email-date tuple as its value (`author`, `committer`, and `tagger`) can be suffixed with `name`, `email`, and `date` to extract the named component. @@ -157,8 +162,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`. -For sorting purposes, fields with numeric values sort in numeric -order (`objectsize`, `authordate`, `committerdate`, `taggerdate`). +For sorting purposes, fields with numeric values sort in numeric order +(`objectsize`, `authordate`, `committerdate`, `creatordate`, `taggerdate`). All other fields are used to sort in their byte-value order. There is also an option to sort by versions, this can be done by using |