verify_lock(): return 0/-1 rather than struct ref_lock *

diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index 303de8eee55be473b3e76abde6373391c5a80fdf..034d10d633c343b17a83879b00aae3ba2a98a388 100644 (file)
--- a/Documentation/git-tag.txt
+++ b/Documentation/git-tag.txt
@@ -98,8 +98,13 @@ OPTIONS
 --sort=<type>::
        Sort in a specific order. Supported type is "refname"
        (lexicographic order), "version:refname" or "v:refname" (tag
-       names are treated as versions). Prepend "-" to reverse sort
-       order.
+       names are treated as versions). The "version:refname" sort
+       order can also be affected by the
+       "versionsort.prereleaseSuffix" configuration variable. Prepend
+       "-" to reverse sort order. When this option is not given, the
+       sort order defaults to the value configured for the 'tag.sort'
+       variable if it exists, or lexicographic order otherwise. See
+       linkgit:git-config[1].
 
 --column[=<options>]::
 --no-column::
@@ -153,13 +158,13 @@ This option is only applicable when listing tags without annotation lines.
 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
+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>
+    signingKey = <gpg-key-id>
 -------------------------------------
 
 
@@ -317,6 +322,7 @@ include::date-formats.txt[]
 SEE ALSO
 --------
 linkgit:git-check-ref-format[1].
+linkgit:git-config[1].
 
 GIT
 ---