]> git.ipfire.org Git - thirdparty/git.git/commit
doc: am: revert Message-ID trailer claim
authorKristoffer Haugsbakk <code@khaugsbakk.name>
Sat, 11 Apr 2026 20:15:50 +0000 (22:15 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 13 Apr 2026 15:26:43 +0000 (08:26 -0700)
commit444e423f81087e71d396ba11c6734e66a40206cb
tree028f5f9a337b8d76673d595dac6b0882e56f9b7c
parentb10e0cb1f391a4466f8d7c4b2550a8b89fda3573
doc: am: revert Message-ID trailer claim

I claimed in 3c18135b (doc: am: say that --message-id adds a trailer,
2026-02-09) that `git am --message-id` adds a Git trailer. But that
isn’t the case; for the case of a commit message with a subject, body,
and no trailer block:

    <subject>

    <paragrah>

It just appends the line right after `paragraph`:

    <subject>

    <paragraph>
    Message-ID: <message-id_trailer.323@msgid.xyz>

It does work for two other cases though, namely subject-only and with an
existing trailer block.

This is at best an inconsistency and arguably a bug, but we’re at the
trailing end of the release cycle now. So reverting the doc is safer
than making msg-id act as a trailer, for now.

Revert this hunk from commit 3c18135b except the only useful
change (“Also use inline-verbatim for `Message-ID`”).

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-am.adoc