Re: [PATCH v3] filename.7: new manual page

Thaddeus H. Black
2021-11-07T15:21:51Z

[-- Attachment #1: Type: text/plain, Size: 1464 bytes --]

On Tue, Oct 19, 2021 at 03:38:09PM +0200, Alejandro Colomar (man-pages) wrote:
> 'git format-patch' is the preferred method :)
>
> What I missed here is the long (and great) commit message from v1, which I'm
> going to save as the commit message. Please, when you send v4, include the
> original text.

Okay.

> Ephemeral stuff that should not go into the commit message (like changelogs
> between versions of the patch), you can put it above, in a "scissor patch"
> format (see git-format-patch(1) if necessary).
>
> Or if it's short/simple enough, below the '---' (and just above the patch
> itself; it is actually ignored by git, unless it's so complex that it is
> misinterpreted as part of the patch). This method is what I usually use,
> since it doesn't require specifying '--scissors', and I usually only write
> normal text that can't be confused with the patch. I don't know if this is
> documented anywhere, but it's very useful.

In view of feedback, v4 requires substantial rewriting. Rewritten text
wants polishing. Polishing takes time.

In short, I haven't forgotten, but v4 is not yet ready.

Note to other readers: if any latecomers to the conversation wish to
suggest further significant changes, now would be the time to suggest;
for once the draft has been reassembled and repolished, it will be too
late. Nonsubscribers can find v3 at [1].

1: https://www.spinics.net/lists/linux-man/msg21267.html