path: root/Documentation/git-tag.txt
diff options
authorMichael Olson <>2007-10-15 17:51:30 (GMT)
committerShawn O. Pearce <>2007-10-16 05:18:37 (GMT)
commit5040beff0bacac79b305fbfa4df71e99c2f13ed8 (patch)
tree71b8ca7cd1a2d5878657ebf1bab73960030d12cf /Documentation/git-tag.txt
parent2858028e1ab6c79f39ec0057d2034bcbe9f47cf9 (diff)
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 <> Signed-off-by: Shawn O. Pearce <>
Diffstat (limited to 'Documentation/git-tag.txt')
1 files changed, 21 insertions, 0 deletions
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index 22a23bf..10d3e3f 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
+An example follows.
+$ GIT_AUTHOR_DATE="2006-10-02 10:31" git tag -s v1.0.1
Written by Linus Torvalds <>,