pretty: document multiple %(describe) being inconsistent

Each %(describe) placeholder is expanded using a separate git describe
call.  Their outputs depend on the tags present at the time, so there's
no consistency guarantee.  Document that fact.

Reported-by: Ævar Arnfjörð Bjarmason <>
Signed-off-by: René Scharfe <>
Signed-off-by: Junio C Hamano <>
René Scharfe 2 years ago committed by Junio C Hamano
parent 09fe8ca92e
commit 273c9901c2
  1. 4

@ -212,7 +212,9 @@ The placeholders are:
linkgit:git-describe[1]; empty string for
undescribable commits. The `describe` string
may be followed by a colon and zero or more
comma-separated options.
comma-separated options. Descriptions can be
inconsistent when tags are added or removed at
the same time.
** 'match=<pattern>': Only consider tags matching the given
`glob(7)` pattern, excluding the "refs/tags/" prefix.