It would be fairly trivial to get texinfo to support automatically
generating man pages. All you need is:
(a) a one line "NAME" entry.
(b) some what of generating the synopsis. This might not even have to
come out of the texinfo documentation, you've usually already done this
twice in writing the program (once for getopt, again for --help).
(c) a way of marking nodes, or node ranges for particular sections
in the man page. Mostly you want the command line args documentation,
and the top level description of what the program does. Maybe if you
get fancy you support splitting off section 5 man page stuff from
section 1 (or whatever) manpage stuff -- but that's completely optional.
(d) [also optional] a way of listing cross references and/or significant
files.
Do this and you can still refer people to the info documentation for the
complete tutorial, but at least all the command line options will be
documented.
-- Raul
- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.rutgers.edu