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: