[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Bug#1018737: /usr/bin/rst2man: rst2man: .TH 5th field shouldn't be e
Re: Bug#1018737: /usr/bin/rst2man: rst2man: .TH 5th field shouldn't be empty
Mon, 5 Sep 2022 18:48:27 +0200
Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.0
On 9/5/22 18:42, Dmitry Shachnev wrote:
On Mon, Aug 29, 2022 at 09:14:26PM +0200, Alejandro Colomar wrote:
X-Debbugs-Cc: firstname.lastname@example.org, email@example.com, Quentin Monnet
When rst2man has no information to generate the 5th field to the
.TH macro (the one that sets the title line, i.e., the header and
footer of the manual page), it generates it as an empty argument,
that is "". groff(1) and mandoc(1) have good defaults for the 5th
field of .TH when it is not specified, so that most manual pages
should need to specify it, but to use that default, the field has
to be missing, and an empty argument is an existing argument.
Regarding this bug, upstream wants to know  whether omitting the 5th
argument will work with all troff/manpage writers.
I believe it is the case, but can you confirm?
AFAIK, it will work. The behavior may differ, in that groff(1) and
mandoc(1) produce a default text, while others may not produce any text
at all, but it should work.
Description: OpenPGP digital signature
- Re: Bug#1018737: /usr/bin/rst2man: rst2man: .TH 5th field shouldn't be empty,
Alejandro Colomar <=