git describe
git
Uso
git describe [--tags] [--dirty]Nomeia o commit atual a partir da tag mais próxima, como v1.2.0-5-gabc1234; por padrão só vê tags anotadas, então as leves pedem --tags e um repositório sem tag pede --always.
Opções comuns
| Opção | Significado |
|---|---|
| --tags | use lightweight tags too, not just annotated ones |
| --dirty | append -dirty when the working tree has changes |
| --always | fall back to a bare hash when no tag is found |
| --long | always the full tag-count-hash form |
| --abbrev=<n> | how many hash digits to print |
| --match <pattern> | only consider matching tags |
Exemplos
git describe --tags --dirtyprints something like v1.2.0-5-gabc1234-dirty
git describe --alwaysnever fails, even in a repository with no tags
git describe --match "v*" --longignores tags that are not versions
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 describe faz?
Nomeia o commit atual a partir da tag mais próxima, como v1.2.0-5-gabc1234; por padrão só vê tags anotadas, então as leves pedem --tags e um repositório sem tag pede --always.
Q. Como se digita?
git describe [--tags] [--dirty] — 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-describe