>> * Move the man page to a better format than the pure man page format.
>> Are there some good tools/formats like ascii2man or DocBookXML which
>> could help easing the maintenance of our documentation?
> Docbook XML for sure is a lot more verbose than asciidoc or roff.
> I would tend to avoid Docbook, the toolchains are lacking a bit --
> still :-( although xmlto + fop can yield reasonable PDF results.
I'd recommend Texinfo: its man output is not too bad (especially if you
write the Texinfo with "man" in your mind), it can be turned into
many other formats (including Docbook) and it's not verbose.
Stefan
