groff
[Top][All Lists]
Advanced

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

[mdoc] .Os: What should the argument be?


From: Alejandro Colomar
Subject: [mdoc] .Os: What should the argument be?
Date: Tue, 6 Sep 2022 19:08:37 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.0

Hi Ingo,

The current man page for NGINX Unit uses an empty .Os call, probably because who wrote it didn't know what better to write there, and since it works with it empty, why not.

The current mdoc(7) documentation says this should be the operating system and release, but of course, portable programs don't have a "operating system", but rather multiple. So if this is to be used for the OS version, it should be empty, and let the OS fill that with the default, but that would be useless, the same as Doug pointed out of the 5th arg to TH. Then, the only useful thing that this can be used for is the project and release, as Branden told me recently for the 4th arg to TH; that does make sense.

Could we change the documentation to note that?

Cheers,

Alex

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

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


reply via email to

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