kh/doc-trailers

On Fri, Aug 21, 2026, at 03:29, Junio C Hamano wrote:
> * kh/doc-trailers (2026-08-09) 11 commits
>   (merged to 'next' on 2026-08-13 at 2966f0265a)
>  + doc: interpret-trailers: document comment line treatment
>  + doc: interpret-trailers: rewrite new-trailers paragraphs
>  + doc: interpret-trailers: commit to “trailer block” term
>  + doc: interpret-trailers: join new-trailers again
>  + doc: interpret-trailers: add key format example
>  + doc: interpret-trailers: explain key format
>  + doc: interpret-trailers: explain the format after the intro
>  + doc: interpret-trailers: not just for commit messages
>  + doc: interpret-trailers: use “metadata” in Name as well
>  + doc: interpret-trailers: replace “lines” with “metadata”
>  + doc: interpret-trailers: stop fixating on RFC 822
>  (this branch is used by kh/trailers-no-urls.)
>
>  Documentation for 'git interpret-trailers' has been updated to explain
>  the format of trailer keys (alphanumeric characters and hyphens),
>  replace outdated terminology, define key terms upfront, and document
>  how comment lines in the input are treated.

Thanks for improving the topic summary by the way. I feel like after I
added more changes on top of explaining the trailer keys format, it just
got bunched into “Also replace some terms [and a bunch of stuff]”... ;)

>
>  Graduated to 'master'.
>  cf. <[email protected]>
>  source: <[email protected]>

Kris