]> git.ipfire.org Git - thirdparty/git.git/commitdiff
docs/pretty-formats: add %(count) and %(total)
authorMirko Faina <mroik@delayed.space>
Mon, 23 Mar 2026 16:57:31 +0000 (17:57 +0100)
committerJunio C Hamano <gitster@pobox.com>
Mon, 23 Mar 2026 20:06:58 +0000 (13:06 -0700)
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>
Documentation/pretty-formats.adoc

index 5405e57a6079c518cfac0deadd3d0692aab19b18..2ae0eb11a97988803e2131c125380f6a996f9646 100644 (file)
@@ -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