aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMirko Faina <mroik@delayed.space>2026-03-23 17:57:31 +0100
committerJunio C Hamano <gitster@pobox.com>2026-03-23 13:06:58 -0700
commit344f00ef9d0863f8b05e26253664fa6993ac5ac9 (patch)
tree8ea0196d8a6c9488a8d2ed554c5f90f43ea095e7
parent67ea2ad7d1b006194762cbfcc0b7801ffe652ca4 (diff)
downloadgit-344f00ef9d0863f8b05e26253664fa6993ac5ac9.tar.xz
docs/pretty-formats: add %(count) and %(total)
When --commit-list-format was introduced to format-patch, two new placeholders were added to the PRETTY FORMATS code without being documented. Do so now. Signed-off-by: Mirko Faina <mroik@delayed.space> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--Documentation/pretty-formats.adoc4
1 files changed, 4 insertions, 0 deletions
diff --git a/Documentation/pretty-formats.adoc b/Documentation/pretty-formats.adoc
index 5405e57a60..2ae0eb11a9 100644
--- a/Documentation/pretty-formats.adoc
+++ b/Documentation/pretty-formats.adoc
@@ -253,6 +253,10 @@ The placeholders are:
linkgit:git-rev-list[1])
+%d+:: ref names, like the --decorate option of linkgit:git-log[1]
+%D+:: ref names without the " (", ")" wrapping.
++%(count)+:: the number of a patch within a patch series. Used only in
+ `--commit-list-format` in `format-patch`
++%(total)+:: the total number of patches in a patch series. Used only in
+ `--commit-list-format` in `format-patch`
++%(decorate++`[:<option>,...]`++)++::
ref names with custom decorations. The `decorate` string may be followed by a
colon and zero or more comma-separated options. Option values may contain