git describe
git
Syntaxe
git describe [--tags] [--dirty]Nomme le commit courant à partir de l'étiquette la plus proche, sous la forme v1.2.0-5-gabc1234 ; par défaut il ne voit que les étiquettes annotées, les légères exigent --tags et un dépôt sans étiquette exige --always.
Options courantes
| Option | Signification |
|---|---|
| --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 |
Exemples
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
Ce qui embrouille, c’est qu’annuler a plusieurs formes : déplacer là où pointe une branche n’est pas ajouter un commit qui l’inverse.
Comment lire
- Les crochets [ ] marquent une partie facultative.
- Les points de suspension … signifient qu’on peut en mettre plusieurs.
- Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.
Questions fréquentes
Q. Que fait git describe ?
Nomme le commit courant à partir de l'étiquette la plus proche, sous la forme v1.2.0-5-gabc1234 ; par défaut il ne voit que les étiquettes annotées, les légères exigent --tags et un dépôt sans étiquette exige --always.
Q. Comment l’écrire ?
git describe [--tags] [--dirty] — les crochets marquent ce qui est facultatif.
Q. Combien d’options valent la peine ?
Il y en a 6 ici ; la liste complète est dans man git. Cette commande relève de git.
Commandes liées
page man: man git-describe