Re: Bug#1018737: /usr/bin/rst2man: rst2man: .TH 5th field shouldn't be empty

[Alejandro Colomar]

Hi Doug,

On 8/30/22 23:14, Douglas McIlroy wrote:
> An empty field conveys as much information as the uninformative
> default, "Miscellaneous Information Manual", with less clutter. I
> recommend abolishing the default.

Agree, the section number already provides a good default information 
(and for more details, consult man(1)).  The text is mostly useless.

BTW, I just noticed that if you write a mdoc(7) page, the defaults are 
worse than uninformative; they are misinformation:


alx@asus5775:/opt/local/unit/share/man$ cat man8/unitd.8
.\" (C) 2017-2021, NGINX, Inc.
.\"
.Dd March 16, 2021
.Dt UNITD 1
.Os "NGINX Unit" 1.26
.Sh NAME
.Nm unitd
.Nd "runs the NGINX Unit daemon"
alx@asus5775:/opt/local/unit/share/man$ man -Pcat ./man8/unitd.8
UNITD(1)           BSD General Commands Manual          UNITD(1)

NAME
     unitd — runs the NGINX Unit daemon

NGINX Unit 1.26          March 16, 2021          NGINX Unit 1.26


Where did that BSD come from?
That seems like a bug to me.

I like the removal of the default.

Cheers,

Alex

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

OpenPGP_signature
Description: OpenPGP digital signature