diff options
author | René Scharfe <l.s.r@web.de> | 2021-02-28 11:22:34 (GMT) |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2021-03-01 17:50:27 (GMT) |
commit | 273c9901c2ebfb2dae0c52de912bf3f57be19aac (patch) | |
tree | f2ff575c1cf41f8ea0a83bda0c355e65a1a7c2ea /Documentation/pretty-formats.txt | |
parent | 09fe8ca92e4f0269bd7914b5010731a09948abf0 (diff) | |
download | git-273c9901c2ebfb2dae0c52de912bf3f57be19aac.zip git-273c9901c2ebfb2dae0c52de912bf3f57be19aac.tar.gz git-273c9901c2ebfb2dae0c52de912bf3f57be19aac.tar.bz2 |
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 <avarab@gmail.com>
Signed-off-by: René Scharfe <l.s.r@web.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/pretty-formats.txt')
-rw-r--r-- | Documentation/pretty-formats.txt | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/Documentation/pretty-formats.txt b/Documentation/pretty-formats.txt index 231010e..4513306 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=<pattern>': Only consider tags matching the given `glob(7)` pattern, excluding the "refs/tags/" prefix. |