Skip to content

Commit e914ef0

Browse files
Eric Wonggitster
authored andcommitted
for-each-ref: document creatordate and creator fields
These were introduced back in 2006 at 3175aa1 but never documented. Signed-off-by: Eric Wong <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 282616c commit e914ef0

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

Documentation/git-for-each-ref.txt

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,11 @@ In addition to the above, for commit and tag objects, the header
109109
field names (`tree`, `parent`, `object`, `type`, and `tag`) can
110110
be used to specify the value in the header field.
111111

112+
For commit and tag objects, the special `creatordate` and `creator`
113+
fields will correspond to the appropriate date or name-email-date tuple
114+
from the `committer` or `tagger` fields depending on the object type.
115+
These are intended for working on a mix of annotated and lightweight tags.
116+
112117
Fields that have name-email-date tuple as its value (`author`,
113118
`committer`, and `tagger`) can be suffixed with `name`, `email`,
114119
and `date` to extract the named component.
@@ -119,8 +124,8 @@ of all lines of the commit message up to the first blank line. The next
119124
line is 'contents:body', where body is all of the lines after the first
120125
blank line. Finally, the optional GPG signature is `contents:signature`.
121126

122-
For sorting purposes, fields with numeric values sort in numeric
123-
order (`objectsize`, `authordate`, `committerdate`, `taggerdate`).
127+
For sorting purposes, fields with numeric values sort in numeric order
128+
(`objectsize`, `authordate`, `committerdate`, `creatordate`, `taggerdate`).
124129
All other fields are used to sort in their byte-value order.
125130

126131
In any case, a field name that refers to a field inapplicable to

0 commit comments

Comments
 (0)