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>
Michael Olson committed
Oct 15, 2007 at 13:51 UTC
5040beff0bacac79b305fbfa4df71e99c2f13ed8
1 file changed
+21
Documentation/git-tag.txt
+21
@@ -214,6 +214,27 @@ having tracking branches. Again, the heuristic to automatically
214
follow such tags is a good thing.
215
216
217
+On Backdating Tags
218
+~~~~~~~~~~~~~~~~~~
219
+
220
+If you have imported some changes from another VCS and would like
221
+to add tags for major releases of your work, it is useful to be able
222
+to specify the date to embed inside of the tag object. The data in
223
+the tag object affects, for example, the ordering of tags in the
224
+gitweb interface.
225
+
226
+To set the date used in future tag objects, set the environment
227
+variable GIT_AUTHOR_DATE to one or more of the date and time. The
228
+date and time can be specified in a number of ways; the most common
229
+is "YYYY-MM-DD HH:MM".
230
+
231
+An example follows.
232
+
233
+------------
234
+$ GIT_AUTHOR_DATE="2006-10-02 10:31" git tag -s v1.0.1
235
+------------
236
+
237
+
238
Author
239
------
240
Written by Linus Torvalds <torvalds@osdl.org>,