@matheusbsbs / matheus-bagliano / commits / df1c5d7ed7

doc: shortlog: put back trailer paragraphs

47beb37b (shortlog: match commit trailers with --group, 2020-09-27) added the `trailer` bullet point with three paragraphs.[1] Later, 3dc95e09 (shortlog: support arbitrary commit format `--group`s, 2022-10-24) put the single-paragraph bullet point about `format` right after the first paragraph about `trailer`. That meant that the second and third paragraphs for `trailer` got moved to `format`. Move the two paragraphs back to `trailer`. We now also need one blank line before the final bullet point so that it does not get joined with the second bullet point. † 1: Technically the bullet list formatting was immediately fixed to include all three paragraphs in 63d24fa0 (shortlog: allow multiple groups to be specified, 2020-09-27) Acked-by: Jeff King <peff@peff.net> Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Kristoffer Haugsbakk committed Feb 3, 2026 at 10:48 UTC df1c5d7ed76e8ff0c49906224cd336875d9f0a66
1 file changed +4 -3
Documentation/git-shortlog.adoc
+4 -3
@@ -64,9 +64,6 @@ OPTIONS
64 example, if your project uses `Reviewed-by` trailers, you might want
65 to see who has been reviewing with
66 `git shortlog -ns --group=trailer:reviewed-by`.
67 - - `format:<format>`, any string accepted by the `--format` option of
68 - 'git log'. (See the "PRETTY FORMATS" section of
69 - linkgit:git-log[1].)
67 +
68 Note that commits that do not include the trailer will not be counted.
69 Likewise, commits with multiple trailers (e.g., multiple signoffs) may
@@ -77,6 +74,10 @@ Shortlog will attempt to parse each trailer value as a `name <email>`
74 identity. If successful, the mailmap is applied and the email is omitted
75 unless the `--email` option is specified. If the value cannot be parsed
76 as an identity, it will be taken literally and completely.
77 +
78 + - `format:<format>`, any string accepted by the `--format` option of
79 + 'git log'. (See the "PRETTY FORMATS" section of
80 + linkgit:git-log[1].)
81 --
82 +
83 If `--group` is specified multiple times, commits are counted under each