Re: [PATCH v2] doc: add caveat about roundtripping format-patch

From: Kristoffer Haugsbakk <code@khaugsbakk.name>
Date: Feb 10, 2026, 18:20 UTC
Message-ID: <cd125186-dd81-43dd-a7f6-388b683d01ca@app.fastmail.com>
In-Reply-To: <V2_format-patch_caveats.34b@msgid.xyz>

Snipping all my verbiage here.

On Mon, Feb 9, 2026, at 23:37, kristofferhaugsbakk@fastmail.com wrote:

Show 21 quoted lines

>[snip]
> @@ -796,10 +796,14 @@ CAVEATS
>  Note that `format-patch` will omit merge commits from the output, even
>  if they are part of the requested range. A simple "patch" does not
>  include enough information for the receiving end to reproduce the same
>  merge commit.
>
> +'''
> +
> +include::format-patch-caveats.adoc[]
> +
>  SEE ALSO
>  --------
>[snip]
>     +
>     +    It seems that the section break in git-format-patch(1) does not get
>     +    applied in the man output (according to `Documentation/doc-diff`
>     +    apparently)? Maybe this is the wrong construct? I couldn’t find any
>     +    other thematic breaks here (though there are several variations).
>     +
>[snip]

I want to use a heading instead.

    === Patch application