What tools do you prefer for writing manpages (e.g. for commands that lack one from upstream)?
A DocBook XML file is modern, maintainable, can be converted to other formats
as well, and is suggested by dh-make. But I don't quite like the output of
the docbook-xsl template: for example, the spaces on either side of the
vertical bar between <arg>s in <group>s can't readily be omitted. Moreover,
you have to write a *lot* of tags due to, IMHO, unnecessary limitations as to
which elements can be contained in which, and the autogenerated Authors
section clashes with the common "This manual page was written ... for the
Debian ..." Authors section.
So what other alternatives are there, not counting help2man and pod2man?
--
Magnus Holmgren [EMAIL PROTECTED]
(No Cc of list mail needed, thanks)
pgpgZArXZObt1.pgp
Description: PGP signature
