groff
[Top][All Lists]
Advanced

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

Lowercase in section names


From: Alejandro Colomar
Subject: Lowercase in section names
Date: Fri, 28 Apr 2023 16:57:49 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.10.0

Hi Ingo,

I got a lot of warnings due to using lowercase in section headings.
I remember we agreed to transition to true case in the title, but
don't remember if we reached the same agreement in section headings.

Do you agree to not use uppercase in section headings unnecessarily?
The rationale is more or less the same as in the title: not discard
information.  We already have bold for giving it more importance.

Anyway, here goes my little complain:


mandoc: man8/unitd.8:6:2: WARNING: first section is not "NAME": Sh Name
mandoc: man8/unitd.8:8:2: WARNING: description line outside NAME section: Nd
mandoc: man8/unitd.8:9:2: WARNING: first section is not "NAME": Sh Synopsis
mandoc: man8/unitd.8:21:2: WARNING: first section is not "NAME": Sh Description
mandoc: man8/unitd.8:28:2: WARNING: first section is not "NAME": Sh Options
mandoc: man8/unitd.8:55:2: WARNING: first section is not "NAME": Sh Exit status
mandoc: man8/unitd.8:57:2: WARNING: first section is not "NAME": Sh Files
mandoc: man8/unitd.8:64:2: WARNING: first section is not "NAME": Sh Sockets
mandoc: man8/unitd.8:69:2: WARNING: first section is not "NAME": Sh Copyright
mandoc: man8/unitd.8:73:2: WARNING: first section is not "NAME": Sh See also


Okay, I can understand the first two, and I can easily grep them
away, but does mandoc(1) really need to remind me about that minor
thing at every section?  :P


Cheers,
Alex


-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]