git tag
git
Uso
git tag [-a] <name> [<commit>]Coloca um nome, como uma versão, em um commit; um git push comum não leva as tags, é preciso enviar a tag pelo nome.
Opções comuns
| Opção | Significado |
|---|---|
| -a | annotated tag with a message, author and date |
| -m "<msg>" | the message for -a |
| -l "<pattern>" | list tags matching a pattern |
| -d <name> | delete a tag locally |
| -f | move an existing tag |
| --sort=-creatordate | newest tag first |
Exemplos
git tag -a v1.2.0 -m "release 1.2.0"marks the current commit as a release
git push origin v1.2.0the separate step that puts the tag on the server
git tag -d v1.2.0deletes it locally; the server keeps its copy
O confuso é que desfazer tem várias formas: mover para onde um branch aponta não é o mesmo que criar um commit que reverte.
Como ler
- Os colchetes [ ] marcam uma parte que você pode omitir.
- As reticências … indicam que você pode listar vários.
- As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.
Perguntas
Q. O que git tag faz?
Coloca um nome, como uma versão, em um commit; um git push comum não leva as tags, é preciso enviar a tag pelo nome.
Q. Como se digita?
git tag [-a] <name> [<commit>] — os colchetes marcam o que você pode omitir.
Q. Quantas opções vale a pena saber?
Aqui estão 6; a lista completa está em man git. Este comando fica em git.
Comandos relacionados
página man: man git-tag