I depotet mitt har jeg opprettet tagger ved hjelp av følgende kommandoer.
git tag v1.0.0 -m 'finally a stable release'
git tag v2.0.0 -m 'oops, there was still a major bug!'
Hvordan lister du opp alle taggene i depotet?
git tag
bør være nok. Se git tag
man page.
Det har du også:
git tag -l <pattern>
Liste tagger med navn som samsvarer med det angitte mønsteret (eller alle hvis det ikke er angitt noe mønster).
Å skrive "git tag" uten argumenter, viser også alle tagger.
Mer nylig ("Hvordan sortere git tags?", for Git 2.0+)
git tag --sort=<type>
Sorter i en bestemt rekkefølge.
Støttet type er:
- "
refname
" (leksikografisk rekkefølge),- "
versjon:refname
" eller "v:refname
" (tagnavn behandles som versjoner).
Prepend "-" for å snu sorteringsrekkefølgen.
Som viser begge deler:
Merk: git ready-artikkelen om tagging godkjenner ikke lettvektskoder.
Uten argumenter oppretter git tag en "lett" tag som i utgangspunktet er en gren som aldri beveger seg.
Lettvektskoder er imidlertid fortsatt nyttige, kanskje for å merke en kjent god (eller dårlig) versjon, eller en haug med forpliktelser du kanskje trenger å bruke i fremtiden.
Likevel, du ønsker sannsynligvis ikke å presse denne typen tagger.
Normalt vil du i det minste sende -a-alternativet for å opprette en usignert tag, eller signere taggen med GPG-nøkkelen din via alternativene -s eller -u
.
Når det er sagt, Charles Bailey påpeker at en ' git tag -m "..."
' faktisk innebærer en skikkelig (usignert kommentert) tag (alternativ ' -a
'), og ikke en lettvekt. Så du er god med din første kommando.
Dette skiller seg fra:
git show-ref --tags -d
Som viser tagger med deres commits (se "Git Tag list, display commit sha1 hashes").
Legg merke til -d
for å derefere det kommenterte tag-objektet (som har sin egen commit SHA1) og vise den faktiske taggede committen.
På samme måte vil git show --name-only <aTag>
vise taggen og tilhørende commit.
For å liste opp tagger jeg foretrekker:
git tag -n
Flagget -n
viser den første linjen i merknadsmeldingen sammen med taggen, eller den første linjen i overføringsmeldingen hvis taggen ikke er kommentert.
Du kan også gjøre git tag -n5
for å vise de første 5 linjene i merknaden.