[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

manpage tools

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

Reply to: