Antônio Medeiros

Git: como escrever uma mensagem de tag anotada com várias linhas

TL;DR (resumo): use o comando git tag -a v3.0.0 (sem a opção -m) e o editor de texto será aberto, então você poderá escrever uma mensagem de tag com quantas linhas você quiser.

Versão completa:

Sempre que lanço uma nova versão de um projeto cujo código-fonte é controlado pelo Git, costumo criar uma tag anotada para marcar o commit daquela versão, e geralmente essa tag contém uma mensagem curta de apenas uma linha. Veja, por exemplo, as tags do projeto material-jekyll, que é o modelo que eu uso para fazer este site e o site do Linux Kamarada:

Mas, para o lançamento da versão 3.0, eu queria escrever uma mensagem mais longa, em algumas linhas, que resumisse as principais alterações e explicasse o porquê do incremento da versão maior.

Todos os exemplos da documentação do Git usam a opção -m, que define a mensagem da tag, mas em todos esses exemplos a mensagem é curta.

Por exemplo, para criar uma tag anotada:

1
$ git tag -a v3.0.0 -m "Version 3.0.0"

Para criar uma tag leve:

1
$ git tag v3.0.0

Eis que me veio a pergunta que dá título a este post: como escrever uma mensagem de tag anotada com várias linhas?

Como bom programador que sou, fiz uma pesquisa no Google e achei alguém com a mesma dúvida no Stack Overflow. Mas, depois, voltando na documentação do Git e lendo-a mais atentamente, percebi que a solução também era dita lá, só não tinha um exemplo acompanhando:

Se você não especificar uma mensagem para uma tag anotada, o Git abre seu editor para que você possa digitar nele.

Portanto, o que fiz foi simplesmente:

1
$ git tag -a v3.0.0

(mesmo comando que antes, mas sem a opção -m)

Com esse comando, o Git abriu meu editor de texto (o padrão do Linux, o Vim) e pude digitar minha mensagem com várias linhas:

Depois, enviei essa tag para o servidor remoto:

1
$ git push origin v3.0.0

E agora você pode vê-la listada nas tags do projeto material-jekyll:

Comentários

Sobre mim

Anúncio