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

["Thaddeus H. Black" <thb@debian.org>]

[-- 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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]