[PATCH] Documentation/git-tag.txt: Document how to backdate tags
- From
Michael Olson <mwolson@gnu.org>
- Date
- Oct 15, 2007, 17:51 UTC
- Message-ID
- <87lka4cllp.fsf@hariken.mwolson.org>
- In-Reply-To
- <7vd4w0iqd5.fsf@gitster.siamese.dyndns.org>
Added a new section beneath "On Automatic following" called "On Backdating Tags". This includes an explanation of when to use this method, a brief explanation of the kind of date that can be used in GIT_AUTHOR_DATE, and an example invocation of git-tag using a custom setting of GIT_AUTHOR_DATE.
Signed-off-by: Michael W. Olson <mwolson@gnu.org> ---
[Resending, this time without trying to send through Gmane and munge Reply-To.]
Junio C Hamano <gitster@pobox.com> writes:
Show 13 quoted lines
> Michael Olson <mwolson@gnu.org> writes: > >> Junio C Hamano <gitster@pobox.com> writes: >> >>> Wouldn't it be easier to create the tag with the desired >>> timestamp from the beginning, by exporting GIT_COMMITTER_DATE? >> >> Ah, I didn't know about that environment variable. >> >> Would it be possible to mention that option on the git-tag manpage? > > Surely, I am kind of surprised if it weren't, but apparently you > did not find it. Please make it so.
Documentation/git-tag.txt | 21 +++++++++++++++++++++ 1 files changed, 21 insertions(+), 0 deletions(-)
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 990ae4f..2966aa2 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -214,6 +214,27 @@ having tracking branches. Again, the heuristic to automatically follow such tags is a good thing. +On Backdating Tags +~~~~~~~~~~~~~~~~~~ + +If you have imported some changes from another VCS and would like +to add tags for major releases of you work, it is useful to be able +to specify the date to embed inside of the tag object. The data in +the tag object affects, for example, the ordering of tags in the +gitweb interface. + +To set the date used in future tag objects, set the environment +variable GIT_AUTHOR_DATE to one or more of the date and time. The +date and time can be specified in a number of ways; the most common +is "YYYY-MM-DD HH:MM". + +An example follows. + +------------ +$ GIT_AUTHOR_DATE="2006-10-02 10:31" git tag -s v1.0.1 +------------ + + Author ------ Written by Linus Torvalds <torvalds@osdl.org>,
-- 1.5.3.4