git-clone --reference: saner handling of borrowed symrefs.
[gitweb.git] / Documentation / git-tag.txt
index 48b82b86f83df4e3fb381da329b48fe12a4ce82d..3f01e0bfc5eb72bfbd8c3ab97e4b9ac495463edb 100644 (file)
@@ -3,14 +3,14 @@ git-tag(1)
 
 NAME
 ----
-git-tag - Create a tag object signed with GPG
+git-tag - Create, list, delete or verify a tag object signed with GPG
 
 
 SYNOPSIS
 --------
 [verse]
-'git-tag' [-a | -s | -u <key-id>] [-f | -d] [-m <msg> | -F <file>]
-        <name> [<head>]
+'git-tag' [-a | -s | -u <key-id>] [-f | -v] [-m <msg> | -F <file>]  <name> [<head>]
+'git-tag' -d <name>...
 'git-tag' -l [<pattern>]
 
 DESCRIPTION
@@ -35,6 +35,8 @@ GnuPG key for signing.
 
 `-d <tag>` deletes the tag.
 
+`-v <tag>` verifies the gpg signature of the tag.
+
 `-l <pattern>` lists tags that match the given pattern (or all
 if no pattern is given).
 
@@ -53,7 +55,10 @@ OPTIONS
        Replace an existing tag with the given name (instead of failing)
 
 -d::
-       Delete an existing tag with the given name
+       Delete existing tags with the given names.
+
+-v::
+       Verify the gpg signature of given the tag
 
 -l <pattern>::
        List tags that match the given pattern (or all if no pattern is given).
@@ -65,6 +70,16 @@ OPTIONS
        Take the tag message from the given file.  Use '-' to
        read the message from the standard input.
 
+CONFIGURATION
+-------------
+By default, git-tag in sign-with-default mode (-s) will use your
+committer identity (of the form "Your Name <your@email.address>") to
+find a key.  If you want to use a different default key, you can specify
+it in the repository configuration as follows:
+
+[user]
+    signingkey = <gpg-key-id>
+
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>,