Re: [PATCH] intro.1: Revise

["Jeremy Baxter" <jtbx@disroot.org>]

On Sat Mar 16, 2024 at 12:45 PM NZDT, Alejandro Colomar wrote:
> This patch is too big, and changes too much, for a single patch, I
> think.  Please split the patch into smaller patches that do one thing,
> and document those more precisely in the commit messages, instead of
> something generic, if possible.  See <./CONTRIBUTING.d/patches>:
>
>        -  Send logically separate patches.  For unrelated pages, or for
>           logically-separate issues in the same page, send separate
>           emails.

Hi Alex, at the time of writing I considered it appropriate according
to that guideline but yes I agree it is too generic.

> Please use semantic newlines (see man-pages(7)):
>
> $ MANWIDTH=72 man man-pages | sed -n '/Use semantic newlines/,/^$/p'
>    Use semantic newlines
>      In  the  source of a manual page, new sentences should be started
>      on new lines, long sentences should be split into lines at clause
>      breaks (commas, semicolons, colons, and so on), and long  clauses
>      should be split at phrase boundaries.  This convention, sometimes
>      known  as  "semantic newlines", makes it easier to see the effect
>      of patches, which often operate at the level of  individual  sen‐
>      tences, clauses, or phrases.

Sweet, will do. Thanks!

 ~Jeremy