git tag

git

Aufruf

git tag [-a] <name> [<commit>]

Hängt einem Commit einen Namen wie eine Versionsnummer an; ein einfaches git push nimmt Tags nicht mit, der Tag muss namentlich gepusht werden.

Häufige Optionen

Option	Bedeutung
-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

Beispiele

git tag -a v1.2.0 -m "release 1.2.0"

marks the current commit as a release

git push origin v1.2.0

the separate step that puts the tag on the server

git tag -d v1.2.0

deletes it locally; the server keeps its copy

Verwirrend ist, dass Rückgängig mehrere Formen hat — den Zeiger eines Branch zu verschieben ist nicht dasselbe wie einen Gegen-Commit zu setzen.

So liest man das

Eckige Klammern [ ] markieren einen Teil, den man weglassen kann.
Drei Punkte … heißen: mehrere sind erlaubt.
Optionen achten auf Groß- und Kleinschreibung — bei manchen Befehlen sind -r und -R verschieden.

Q. Was macht git tag?

Hängt einem Commit einen Namen wie eine Versionsnummer an; ein einfaches git push nimmt Tags nicht mit, der Tag muss namentlich gepusht werden.

Q. Wie gibt man ihn ein?

git tag [-a] <name> [<commit>] — eckige Klammern markieren, was wegfallen darf.

Q. Wie viele Optionen lohnen sich?

Hier stehen 6; die vollständige Liste steht in man git. Der Befehl gehört zu git.