threads / discuss / 10084

Script to backdate tags

Subject: Script to backdate tags

## tl;dr

7 messages between Sep 30, 2007 and Oct 15, 2007.

replies: 6people: 3as markdown or json

Michael Olson· Sep 30, 2007, 03:16 UTC · lore

After importing one of my projects from Arch, I wanted to add tags that indicated its major releases. Unfortunately, these tags for older releases would show up before the more recent releases in the gitweb output. I searched in vain for a way of backdating tags, and finally decided to make a script to do this for me. Here it is.

This may run into issues if someone uses the "\" character in their tag names, but I didn't want to bother fixing this until it was affirmed that this script would be considered generally useful.

#!/bin/sh # # git-backdate-tag: Change the date of an existing tag, replacing the # tag reference with the newly-generated tag object. # # Usage: git-backdate-tag TAG DATE

usage () {
    echo "Usage: git-backdate-tag TAG DATE"
}
if [ -n "$3" ]; then
    usage
    exit 1
elif [ -z "$2" ]; then
    usage
    exit 1
fi

# Set parameters tag="$1" date=$(date --date="$2" +%s)

if [ $? -ne 0 ]; then
    echo Could not parse date
    exit 1
fi
# Replace old date with new date
newtagobj=$(git cat-file tag "$tag" | \
    sed -r -e "s/^(tagger .+) ([^ \\n]+) ([^ \\n]+)\$/\1 $date \3/1" | \
    git mktag)
if [ $? -ne 0 ]; then
    echo Could not create replacement tag object
    exit 1
fi

# Set tag to new tag object git update-ref refs/tags/"$tag" $newtagobj

-- 
       Michael Olson -- FSF Associate Member #652     |
 http://mwolson.org/ -- Jabber: mwolson_at_hcoop.net  |  /` |\ | | |
            Sysadmin -- Hobbies: Lisp, GP2X, HCoop    | |_] | \| |_|
Projects: Emacs, Muse, ERC, EMMS, ErBot, DVC, Planner |
Michael Olson· Sep 30, 2007, 04:29 UTC · re: Michael Olson · lore

Re: Script to backdate tags

Michael Olson <mwolson@gnu.org> writes:
> This may run into issues if someone uses the "\" character in their
> tag names, [snip].
In fact, this isn't the case after all.
-- 
       Michael Olson -- FSF Associate Member #652     |
 http://mwolson.org/ -- Jabber: mwolson_at_hcoop.net  |  /` |\ | | |
            Sysadmin -- Hobbies: Lisp, GP2X, HCoop    | |_] | \| |_|
Projects: Emacs, Muse, ERC, EMMS, ErBot, DVC, Planner |
Junio C Hamano· Sep 30, 2007, 05:16 UTC · re: Michael Olson · lore

Re: Script to backdate tags

Michael Olson <mwolson@gnu.org> writes:
Show 6 quoted lines
> Michael Olson <mwolson@gnu.org> writes:
>
>> This may run into issues if someone uses the "\" character in their
>> tag names, [snip].
>
> In fact, this isn't the case after all.

Wouldn't it be easier to create the tag with the desired timestamp from the beginning, by exporting GIT_COMMITTER_DATE?

Michael Olson· Sep 30, 2007, 06:27 UTC · re: Junio C Hamano · lore

Re: Script to backdate tags

Junio C Hamano <gitster@pobox.com> writes:
Show 10 quoted lines
> Michael Olson <mwolson@gnu.org> writes:
>
>> After importing one of my projects from Arch, I wanted to add tags
>> that indicated its major releases.  Unfortunately, these tags for
>> older releases would show up before the more recent releases in the
>> gitweb output.  I searched in vain for a way of backdating tags, and
>> finally decided to make a script to do this for me.  Here it is.
>
> 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? Backdating tags is very handy for projects which are converting their entire history from another VCS to git, and wish to denote releases that were not previously tagged. (Making a separate Arch branch for every single release was such a hassle that I didn't bother with it. Git is much nicer in that area with its concept of tags and tag objects.)

-- 
       Michael Olson -- FSF Associate Member #652     |
 http://mwolson.org/ -- Jabber: mwolson_at_hcoop.net  |  /` |\ | | |
            Sysadmin -- Hobbies: Lisp, GP2X, HCoop    | |_] | \| |_|
Projects: Emacs, Muse, ERC, EMMS, ErBot, DVC, Planner |
Michael Olson· Oct 15, 2007, 17:51 UTC · lore

[PATCH] 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.

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
Jeff King· Oct 15, 2007, 20:35 UTC · re: Michael Olson · lore

Re: [PATCH] Documentation/git-tag.txt: Document how to backdate tags

On Mon, Oct 15, 2007 at 01:51:30PM -0400, Michael Olson wrote:
Show 5 quoted lines
> +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
s/you/your/
-Peff
Michael Olson· Oct 15, 2007, 22:53 UTC · re: Jeff King · lore

Re: [PATCH] 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.

Signed-off-by: Michael W. Olson <mwolson@gnu.org>
---
Jeff King <peff@peff.net> writes:
Show 9 quoted lines
> On Mon, Oct 15, 2007 at 01:51:30PM -0400, Michael Olson wrote:
>
>> +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
>
> s/you/your/
Fixed; thanks.
 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..5cc9da4 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>,
-- 
1.5.3.4

← back to recent threads