git tag [-a] [ ] — os colchetes marcam o que você pode omitir.

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.0

the separate step that puts the tag on the server

git tag -d v1.2.0

deletes 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.

QO 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.

QComo se digita?

git tag [-a] <name> [<commit>] — os colchetes marcam o que você pode omitir.

QQuantas opções vale a pena saber?

Aqui estão 6; a lista completa está em man git. Este comando fica em git.

página man: man git-tag