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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux