From: René Scharfe Date: Sun, 28 Feb 2021 11:22:34 +0000 (+0100) Subject: pretty: document multiple %(describe) being inconsistent X-Git-Tag: v2.32.0-rc0~145^2~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=273c9901c2ebfb2dae0c52de912bf3f57be19aac;p=thirdparty%2Fgit.git 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 --- diff --git a/Documentation/pretty-formats.txt b/Documentation/pretty-formats.txt index 231010e6ef..45133066e4 100644 --- a/Documentation/pretty-formats.txt +++ b/Documentation/pretty-formats.txt @@ -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=': Only consider tags matching the given `glob(7)` pattern, excluding the "refs/tags/" prefix.