Re: [PATCH v2] memmem.3: Add list of known systems where this is available

[Alejandro Colomar <alx.manpages@gmail.com>]

[-- Attachment #1.1: Type: text/plain, Size: 1273 bytes --]



On 11/11/22 01:04, Andrew Clayton wrote:
> On Fri, 11 Nov 2022 00:59:59 +0100
> Alejandro Colomar <alx.manpages@gmail.com> wrote:
> 
>>> +but is present on a number of other systems,
>>> +including: musl libc 0.9.7; FreeBSD 6.0, OpenBSD 5.4,
>>> +NetBSD, and Illumos.
>>
>> I've been thinking about the line breaks.  I'm not sure how I'd split them, but
>> I'm not happy with the current suggestion.
>>
>> Please see man-pages(7) about semantic newlines, and see if you come up with
>> something nicer.
>>
>> man-pages(7):
>>      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 bound‐
>>          aries.   This  convention,  sometimes  known as "semantic
>>          newlines", makes it easier to see the effect of  patches,
>>          which often operate at the level of individual sentences,
>>          clauses, or phrases.
> 
> I guess the best thing then is to just break it on the semi-colon.

Yeah, either semicolon or ':'.

> 
> Andrew

-- 
<http://www.alejandro-colomar.es/>

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