Temos várias tags anotadas em nosso repositório git. As tags mais antigas têm mensagens falsas que gostaríamos de atualizar para estar em nosso novo estilo.

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

Neste exemplo, gostaríamos de fazer com que as mensagens v1.x se pareçam com a mensagem v2.0. Alguém sabe como faríamos isso?

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

Isso criará uma nova tag com o mesmo nome (substituindo o original).

Para atualizar uma mensagem complexa, basta especificar a opção de marca anotada com -aou a opção de marca assinada com -s:

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

Isso abrirá um editor com o conteúdo da sua mensagem de tag antiga .

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

Isso é uma melhoria: sem ^{}ele, será criado um novo objeto de tag que faz referência ao objeto de tag antigo, onde os dois terão o mesmo nome de tag.

<tag name>^{} resolverá a tag / referência até encontrar o primeiro hash de confirmação.

TL; DR

Você pode fazer isso excluindo sua tag e recriando-a enquanto falsifica a data e o autor:

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

Toda a história:

Com base na resposta da Sungram (originalmente proposta como uma edição):

1. Resposta Aceita

Esta é uma melhoria em relação às respostas de Andy e Eric Hu . Suas respostas criarão um novo objeto de tag que faz referência ao objeto de tag antigo e ambos terão o mesmo nome.

Para ilustrar isso, considere o seguinte:

> 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. Melhoria do Sungram

Usar <tag name>^{}como o segundo argumento de git tagexcluirá todas as tags anteriores com o mesmo nome.

Considere a continuação da sessão anterior do terminal:

> 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. Salve a data

Por fim, se você quiser manter a data da tag original como a data da tag atualizada, use alguma mágica awk (ou similar) ou apenas cole a data desejada. A seguir, substitui o segundo exemplo (caso contrário, a data original seria perdida devido à substituição):

> 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]

Referências:

• SO: Listagem rápida de objetos no banco de dados git

• SO: altere a data do commit de uma tag git

• Awk: Um tutorial e introdução

• SO: Filtre a saída pelo primeiro token de linha e extraia o restante da linha com awk

• SO: Como colocar um comentário de linha bash em um comando de várias linhas

4. DIY

Como alternativa, para atualizar as tags, você pode excluí-las e criá-las novamente. Como se vê, a atualização apenas adiciona uma nova tag e faz com que ela aponte para a antiga, ou, como alternativa, exclui implicitamente a antiga e cria uma nova para apontar para o mesmo commit de qualquer maneira.

Você pode conseguir isso emitindo:

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

Aqui [optional]está um campo opcional; <required>é um campo obrigatório. Obviamente, você pode adicionar qualquer sinalizador após o git tagcomando que normalmente faria.

A solução da @Andy

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

está errado . Depois disso, com

git show

comando, veremos tags de pilha com o mesmo nome.

Ele adiciona uma nova marca com o mesmo nome e nova mensagem na confirmação <tag-name>. Mas não remove a tag antiga. É um caso especial deste comando:

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

Mas <old-tag>é o mesmo com <tag-name>.

A solução correta é simples, basta atualizar a tag.

git tag <tag-name> -f -a

Lembre-se, apenas um aqui.

Se queremos alterar a tag, o que não é HEAD, precisamos de um <commit>argumento extra .

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

gostaríamos de fazer com que as mensagens v1.x se pareçam com a mensagem v2.0

Com o Git 2.17 (Q2 2018), haverá uma alternativa para a criação de uma nova tag git tag <tag name> <tag name> -f -m "<new message>", já que a opção " git tag" aprendeu um explícito " --edit" que permite que a mensagem fornecida por " -m" e " -F" seja editada posteriormente.

Veja commit 9eed6e4 (06 fev 2018) por Nicolas Morey-Chaisemartin ( nmorey) .
^{(Incorporado por Junio ​​C Hamano - gitster- in commit 05d290e , 06 mar 2018)}

tag: adicionar --editopção

Adicione uma --editopção que permita modificar as mensagens fornecidas por -mou -F, da mesma forma git commit --edit.

Você precisará marcar novamente, usando o -fsinalizador de força.

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

Usando as respostas acima, este é o meu apelido para one-liner .gitconfig. Substitui a tag existente e preserva a data de confirmação.

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

Melhorias?

Se você estiver usando uma GUI como smartgit apenas

1. crie a mesma tag novamente na mesma posição com a nova mensagem
2. escolha "substituir tag existente"
3. forçar o push da tag para o repositório upstream