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 holmgren@lysator.liu.se (No Cc of list mail needed, thanks)
Attachment:
pgpOTIFuxjwlF.pgp
Description: PGP signature