In mijn repository heb ik tags aangemaakt met de volgende commando's.
git tag v1.0.0 -m 'finally a stable release'
git tag v2.0.0 -m 'oops, there was still a major bug!'
Hoe maak je een lijst van alle tags in de repository?
git tag
zou genoeg moeten zijn. Zie git tag
man page
Je hebt ook:
git tag -l <pattern>
Lijst tags met namen die overeenkomen met het gegeven patroon (of alle als er geen patroon is gegeven).
Het typen van "git tag" zonder argumenten, somt ook alle tags op.
Recenter ("Hoe git tags sorteren?", voor Git 2.0+)
git tag --sort=<type>
Sorteren in een specifieke volgorde.
Ondersteunde type is:
- "
refname
" (lexicografische volgorde),- "
version:refname
" of "v:refname
" (tag namen worden behandeld als versies).
Prepend "-" om de sorteervolgorde om te keren.
Dat somt beide op:
Opmerking: het git ready artikel over taggen keurt lichtgewicht tags af.
Zonder argumenten, creëert git tag een "lightweight" tag die in principe een branch is die nooit verplaatst.
Lichtgewicht tags zijn echter nog steeds bruikbaar, misschien voor het markeren van een bekende goede (of slechte) versie, of een stel commits die je misschien in de toekomst nodig hebt.
Desalniettemin wil je dit soort tags waarschijnlijk niet pushen.
Normaal gezien wil je op zijn minst de -a optie doorgeven om een niet-ondertekende tag te maken, of de tag ondertekenen met je GPG sleutel via de -s of -u
opties.
Dat gezegd hebbende, Charles Bailey wijst erop dat een 'git tag -m "..."
' eigenlijk een echte (unsigned annotated) tag impliceert (optie '-a
'), en niet een lichtgewicht. Dus je zit goed met je initiële commando.
Dit verschilt van:
git show-ref --tags -d
Die tags opsomt met hun commits (zie "Git Tag lijst, toon commit sha1 hashes").
Let op de -d
om het geannoteerde tag object (die hun eigen commit SHA1 hebben) te dereferenten en de daadwerkelijke tag commit weer te geven.
Op dezelfde manier zou git show --name-only <aTag>
de tag en bijbehorende commit weergeven.
Om tags op te sommen geef ik de voorkeur aan:
git tag -n
De -n
vlag toont de eerste regel van het annotatie bericht samen met de tag, of de eerste regel van het commit bericht als de tag niet geannoteerd is.
Je kunt ook git tag -n5
doen om de eerste 5 regels van de annotatie te tonen.