X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-describe.txt;h=d9aa2f29809eb07385468edd2587daf55339389a;hb=179c94b24ae87e28328f9b311489417b66bd62c9;hp=1c3dfb40c63350651efb570ed540b69c34ccbc81;hpb=378b2607f07bd2fa0eaa8648e7dc8db636708d74;p=git.git diff --git a/Documentation/git-describe.txt b/Documentation/git-describe.txt index 1c3dfb40c..d9aa2f298 100644 --- a/Documentation/git-describe.txt +++ b/Documentation/git-describe.txt @@ -45,12 +45,26 @@ OPTIONS candidates to describe the input committish consider up to candidates. Increasing above 10 will take slightly longer but may produce a more accurate result. + An of 0 will cause only exact matches to be output. + +--exact-match:: + Only output exact matches (a tag directly references the + supplied commit). This is a synonym for --candidates=0. --debug:: Verbosely display information about the searching strategy being employed to standard error. The tag name will still be printed to standard out. +--long:: + Always output the long format (the tag, the number of commits + and the abbreviated commit name) even when it matches a tag. + This is useful when you want to see parts of the commit object name + in "describe" output, even when the commit in question happens to be + a tagged version. Instead of just emitting the tag name, it will + describe such a commit as v1.2-0-deadbeef (0th commit since tag v1.2 + that points at object deadbeef....). + --match :: Only consider tags matching the given pattern (can be used to avoid leaking private tags made from the repository).