Re: Feature request, generating a man page from a node

[Karl Berry]

    I think it would be even better to get output in *roff, using
    formatting that follows the conventions for man pages more closely
    (I.e. headings in uppercase in the left margin, boldface for @sample
    and @command, underline for @var, etc).

Niels, the fundamental problem is that way one writes texinfo manuals
and the way one writes man pages are quite different.  At least I could
never accomplish it -- one or the other always suffered.

My strong recommendation is to use help2man.  It has sufficient hooks to
create excellent man pages.  It also encourages better and more standard
--help output, which I would bet far more people read than anything else.
And by reusing the --help output, it's more likely to be up to date than
if the man page is written completely on its own.

This is the best solution I know of.  It is far more practical than the
dreams of converting texinfo usage nodes into man pages, in my
(not-so-humble-in-this-case) opinion.  It is being used in all the GNU
*utils distributions and the texinfo distribution, maybe others.

Thanks,
Karl