Reuben Thomas wrote:
> There's one final thing that would be useful for
> recode: to make the .x file optional. Recode (unlike all the other programs
> I use with help2man) does not need any extra information. I tried simply
> creating an empty .x file, but help2man gives an error.
I got the impression that without a .x file, the NAME section of the output
is too silly. Example:
-----------------------------------------------------------------------------
$ help2man envsubst | groff -Tutf8 -mandoc
ENVSUBST(1) User Commands ENVSUBST(1)
NAME
envsubst - manual page for envsubst <version>
SYNOPSIS
envsubst [OPTION] [SHELL-FORMAT]
...
-----------------------------------------------------------------------------
Saying "PROG - manual page for PROG" is not adequate.
You can, in theory, pass that part of the NAME section through a --name option,
but then you need to have textual descriptions of programs in the Makefile.am.
Which is the wrong place. Makefiles are for defining rules for building files,
not for storing documentation.
Bruno
