Re: capitalization of man(7) section headings (was: ripgrep author seems happy with groff_man_style(7)

[onf]

On Sun Nov 3, 2024 at 9:44 AM CET, G. Branden Robinson wrote:
> At 2024-11-03T05:20:13+0100, onf wrote:
> > Speaking of which, I noticed just recently that all of groff's
> > manpages don't use all caps for subheadings (.SH)... which is about
> > the first time I've seen manpage subheadings that weren't in all caps.
>
> Yes.  This decision was discussed and taken a little over 5 years ago.
>
> https://lists.gnu.org/archive/html/groff/2019-07/msg00026.html
>
> You may be interested in:
>
> groff_man(7):
>
> Options
>      The following groff options set registers (with -r) and strings
>      (with -d) recognized and used by the man macro package.  To ensure
>      rendering consistent with output device capabilities and reader
>      preferences, man pages should never manipulate them.
> ...
>      -rCS=1   Set section headings (the argument(s) to .SH) in full
>               capitals.  This transformation is off by default because
>               it discards case distinction information.

I see, thanks for the explanation. What I forgot to mention is that my
distribution uses BSD mandoc for manpages and I haven't changed that,
so it just seems that mandoc's man hasn't caught up to that change
(at least I haven't found anything like it in their manpages, and
their man(7) recommends use of all caps with SH).

~ onf