Nous avons plusieurs balises annotées dans notre référentiel git. Les balises plus anciennes contiennent de faux messages que nous aimerions mettre à jour pour être dans notre nouveau style.

% git tag -n1
v1.0 message
v1.1 message
v1.2 message
v2.0 Version 2.0 built on 15 October 2011.

Dans cet exemple, nous aimerions faire ressembler les messages v1.x au message v2.0. Quelqu'un sait comment nous ferions cela?

git tag <tag name> <tag name>^{} -f -m "<new message>"

Cela créera une nouvelle balise du même nom (en écrasant l'original).

Pour mettre à jour un message complexe, spécifiez simplement l'option de balise annotée avec -aou l'option de balise signée avec -s:

git tag <tag name> <tag name>^{} -f -a

Cela ouvrira un éditeur avec le contenu de votre ancien message de balise .

git tag <tag name> <tag name>^{} -f -a

Ceci est une amélioration: sans ^{}cela, un nouvel objet tag sera créé qui référencera l'ancien objet tag, où les deux auront le même nom de tag.

<tag name>^{} résoudra la balise / référence jusqu'à ce qu'il trouve le premier hachage de validation.

TL; DR

Vous pouvez le faire en supprimant votre tag et en le recréant tout en usurpant la date et l'auteur:

> git tag -d <tag-name>
> [GIT_COMMITTER_DATE=<original-commit-date>] \
> [GIT_AUTHOR_NAME=<original-author-name>] \
> git tag <tag-name> [commit]

Histoire entière:

S'appuyant sur la réponse de Sungram (initialement proposée comme édition):

1. Réponse acceptée

C'est une amélioration par rapport aux réponses d' Andy et d' Eric Hu . Leurs réponses créeront un nouvel objet balise qui fait référence à l'ancien objet balise et les deux auront le même nom.

Pour illustrer cela, considérez ce qui suit:

> git tag tag1 tag1 -f -a  # accepted answer
> git rev-list --objects -g --no-walk --all
[ example output: ]
6bdcc347fca041a5138f89fdf5276b3ebf9095d5
260ab7928d986472895b8c55e54569b3f3cb9517 tag1
a5797673f610914a45ef7ac051e3ee831a6e7c25 tag1
f22d6308c3cd330a3b0d86b9bf05562faf6b6f17

> git show tag1
tag tag1
Tagger: [tagger]
Date:   [date of updated tag]
[Updated description]

tag tag1
Tagger: [tagger]
Date:   [date of original tag]
[Original description]

[tagged commit details]

2. L'amélioration de Sungram

Utiliser <tag name>^{}comme deuxième argument de git tagva à la place supprimer toutes les balises précédentes portant le même nom.

Considérez la poursuite de la session terminale précédente:

> git tag tag1 tag1^{} -f -a  # suggested improvement
> git rev-list --objects -g --no-walk --all
[ example output: ]
6bdcc347fca041a5138f89fdf5276b3ebf9095d5
75f02acacfd7d91d55b5bcfdfb1f00aebeed15e3 tag1
f22d6308c3cd330a3b0d86b9bf05562faf6b6f17 

> git show tag1
tag tag1
Tagger: [tagger]
Date:   [date of updated tag]
[Updated description]

[tagged commit details]

3. Enregistrez la date

Enfin, si vous souhaitez conserver la date de la balise d'origine comme date de la balise mise à jour, utilisez un peu de magie awk (ou similaire) ou collez simplement la date de votre choix à la place. Ce qui suit est un substitut pour le deuxième exemple (sinon la date d'origine serait perdue en raison d' une substitution ):

> GIT_COMMITTER_DATE="$(git show tag1 |                              # get info about the tag cascade including the date original of the original tag
> awk '{
>     if ($1 == "Date:") {
>         print substr($0, index($0,$3))
>     }
> }' |                                                               # extract all the dates from the info
> tail -2 | head -1)"                                               `# get the second to last date, as the last one is the commit date` \
> git tag tag1 tag1^{} -a -f                                         # finally, update the tag message, but save the date of the old one
>
> git rev-list --objects -g --no-walk --all
6bdcc347fca041a5138f89fdf5276b3ebf9095d5
e18c178f2a548b37799b100ab90ca785af1fede0 tag1
f22d6308c3cd330a3b0d86b9bf05562faf6b6f17
> git show tag1
tag tag1
Tagger: [tagger]
Date:   [date of original tag]
[Updated description]

[tagged commit details]

Références:

• SO: Liste rapide des objets dans la base de données git

• SO: modifier la date de validation d'un tag git

• Awk: un tutoriel et une introduction

• SO: filtrer la sortie par le premier jeton de ligne et extraire le reste de la ligne avec awk

• SO: Comment mettre un commentaire de ligne bash dans une commande multi-ligne

4. DIY

Alternativement à la mise à jour des balises, vous pouvez simplement les supprimer et les recréer. Comme il s'avère que la mise à jour ajoute simplement une nouvelle balise et la fait pointer vers l'ancienne, ou alternativement, supprime implicitement l'ancienne et crée une nouvelle pour pointer vers le même commit de toute façon.

Vous pouvez y parvenir en émettant:

> git tag -d <tag-name>
> [GIT_COMMITTER_DATE=<original-commit-date>] \
> [GIT_AUTHOR_NAME=<original-author-name>] \
> git tag <tag-name> [commit]

Voici [optional]un champ facultatif; <required>est un champ obligatoire. Bien sûr, vous pouvez ajouter des indicateurs après la git tagcommande comme vous le feriez normalement.

La solution de @Andy

git tag <tag-name> <tag-name> -f -a

est faux . Après, avec

git show

, nous verrons des balises de pile portant le même nom.

Il ajoute une nouvelle balise avec le même nom de balise et un nouveau message lors de la validation <tag-name>. Mais cela ne supprime pas l'ancienne balise. C'est un cas particulier de cette commande:

git tag [<commit> | <old-tag>] <tag-name>

Mais <old-tag>c'est pareil avec <tag-name>.

La solution correcte est simple, il suffit de mettre à jour la balise est OK.

git tag <tag-name> -f -a

Rappelez - vous, seulement UN ici.

Si nous voulons changer de balise, ce qui n'est pas le cas HEAD, nous avons besoin d'un <commit>argument supplémentaire .

git tag <commit> <tag-name> -f -a

nous aimerions que les messages v1.x ressemblent au message v2.0

Avec Git 2.17 (Q2 2018), il y aura une alternative à la création d'une nouvelle balise git tag <tag name> <tag name> -f -m "<new message>", car l' option " git tag" a appris une explicite " --edit" qui permet de modifier davantage le message donné via " -m" et " -F".

Voir commit 9eed6e4 (06 février 2018) par Nicolas Morey-Chaisemartin ( nmorey) .
^{(Fusionné par Junio ​​C Hamano - gitster- en commit 05d290e , 06 mars 2018)}

tag: ajouter une --editoption

Ajoutez une --editoption qui permet de modifier les messages fournis par -mou -F, de la même manière git commit --edit.

Vous devrez à nouveau marquer, en utilisant le -fdrapeau de force.

git tag v1.0 -f -m "actual message"

En utilisant les réponses ci-dessus, c'est mon alias one-liner pour .gitconfig. Remplace la balise existante et préserve la date de validation.

[alias]
    tm = "!sh -c 'f() { export GIT_COMMITTER_DATE=$(git log -1 --format=%ci $0); git tag -f -a $0 $0^{}; }; f '"

Des améliorations?

Si vous utilisez une interface graphique comme SmartGit juste

1. recréez la même balise au même endroit avec le nouveau message
2. choisissez "écraser la balise existante"
3. forcer la balise vers le référentiel en amont