diff options
| author | Michael Olson <mwolson@gnu.org> | 2007-10-15 13:51:30 -0400 |
|---|---|---|
| committer | Shawn O. Pearce <spearce@spearce.org> | 2007-10-16 01:18:37 -0400 |
| commit | 5040beff0bacac79b305fbfa4df71e99c2f13ed8 (patch) | |
| tree | 71b8ca7cd1a2d5878657ebf1bab73960030d12cf /Documentation | |
| parent | 2858028e1ab6c79f39ec0057d2034bcbe9f47cf9 (diff) | |
| download | git-5040beff0bacac79b305fbfa4df71e99c2f13ed8.tar.gz git-5040beff0bacac79b305fbfa4df71e99c2f13ed8.tar.xz | |
Documentation/git-tag.txt: Document how to backdate tags
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.
[sp: Corrected s/you/your/, noticed by Jeff King]
Signed-off-by: Michael W. Olson <mwolson@gnu.org>
Signed-off-by: Shawn O. Pearce <spearce@spearce.org>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | 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 22a23bf96..10d3e3fa9 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 your 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>, |