git tag
git
Syntaxe
git tag [-a] <name> [<commit>]Attache à un commit un nom, par exemple une version ; un git push ordinaire n'emporte pas les étiquettes, il faut pousser l'étiquette par son nom.
Options courantes
| Option | Signification |
|---|---|
| -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 |
Exemples
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
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 tag ?
Attache à un commit un nom, par exemple une version ; un git push ordinaire n'emporte pas les étiquettes, il faut pousser l'étiquette par son nom.
Q. Comment l’écrire ?
git tag [-a] <name> [<commit>] — 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-tag