git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] for-each-ref: document `creatordate` and `creator` fields

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 5, 2016, 17:43 UTC
Message-ID
<xmqqoaczkjm7.fsf@gitster.mtv.corp.google.com>
In-Reply-To
<20160105035157.GA1212@dcvr.yhbt.net>
Eric Wong <normalperson@yhbt.net> writes:
> These were introduced back in 2006 at 3175aa1ec28c but
> never documented.
Thanks, and I totally forgot about the feature ;-)
Show 37 quoted lines
> Signed-off-by: Eric Wong <normalperson@yhbt.net>
> ---
>  And I just found these very useful, today!
>
>  I also noticed creator{name,email} aren't supported, yet.
>  Perhaps they're worth implementing for consistency.
>
>  Documentation/git-for-each-ref.txt | 9 +++++++--
>  1 file changed, 7 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
> index c6f073c..06208c4 100644
> --- a/Documentation/git-for-each-ref.txt
> +++ b/Documentation/git-for-each-ref.txt
> @@ -142,6 +142,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.
> @@ -153,8 +158,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
Previous: Eric Wong
Message 2 of 2 in “for-each-ref: document `creatordate` and `creator` fields”
  1. for-each-ref: document `creatordate` and `creator` fieldsEric Wong, Jan 5, 2016
  2. Junio C HamanoJan 5, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.