[PATCH v3 11/11] doc: interpret-trailers: document comment line treatment
- From
- kristofferhaugsbakk@fastmail.com <kristofferhaugsbakk@fastmail.com>
- Date
- Jun 10, 2026, 21:21 UTC
- Message-ID
- <V3_trailer_comment_lines.8ad@msgid.xyz>
- In-Reply-To
- <V3_CV_doc_int-tr_key_format.8a3@msgid.xyz>
From: Kristoffer Haugsbakk <code@khaugsbakk.name>
Comment lines have always been ignored but this is not documented.
This is mostly for completeness since this is unlikely to catch anyone by surprise. But we really ought to be reasonably complete here since it’s the only documentation page that documents trailers.
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name> ---
Notes (series):
v3:
• Msg: finally fix area
• Demote this point to its own “other rules” section, out of the main
running text. It is not important enough for the main text.
• Since writing this I have realized that we can go into that long
# ----- >8 ----
Commit message separator scissor line, maybe other things. But I stop
short here. These things are even less likely to become a problem for
anyone. And maybe we’ll add them later?
v2: [new]Documentation/git-interpret-trailers.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+)
diff --git a/Documentation/git-interpret-trailers.adoc b/Documentation/git-interpret-trailers.adoc index fb9b1e94dd7..d5e856f5d68 100644 --- a/Documentation/git-interpret-trailers.adoc +++ b/Documentation/git-interpret-trailers.adoc @@ -117,6 +117,16 @@ key: This is a very long value, with spaces and newlines in it. ------------------------------------------------ +OTHER RULES +----------- + +What was covered in the previous section are the rules that are relevant +for regular use. The following points are included for completeness. + +This command ignores comment lines (see `core.commentString` in +linkgit:git-config[1]). This is for use with the `prepare-commit-msg` +and `commit-msg` hooks. + OPTIONS ------- `--in-place`::
-- 2.54.0.22.g9e26862b904