git-tag \- Create a tag object signed with GPG
.SH "SYNOPSIS"
-
-git\-tag [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg>] <name> [<head>]
+.nf
+\fIgit\-tag\fR [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg>] <name> [<head>]
+\fIgit\-tag\fR \-l [<pattern>]
+.fi
.SH "DESCRIPTION"
-Adds a tag reference in \&.git/refs/tags/
+Adds a \fItag\fR reference in \&.git/refs/tags/
Unless \-f is given, the tag must not yet exist in \&.git/refs/tags/ directory\&.
-If one of \-a, \-s, or \-u <key\-id> is passed, the command creates a tag object, and requires the tag message\&. Unless \-m <msg> is given, an editor is started for the user to type in the tag message\&.
+If one of \-a, \-s, or \-u <key\-id> is passed, the command creates a \fItag\fR object, and requires the tag message\&. Unless \-m <msg> is given, an editor is started for the user to type in the tag message\&.
Otherwise just the SHA1 object name of the commit object is written (i\&.e\&. a lightweight tag)\&.
\-d <tag> deletes the tag\&.
+
+\-l <pattern> lists tags that match the given pattern (or all if no pattern is given)\&.
+
.SH "OPTIONS"
.TP
\-d
Delete an existing tag with the given name
+.TP
+\-l <pattern>
+List tags that match the given pattern (or all if no pattern is given)\&.
+
.TP
\-m <msg>
Use the given tag message (instead of prompting)
projects / git.git / commitdiff