DOCBOOK: generate man pages on Linux

[davidw@linuxcare.com (David N. Welton)]

[ please CC replies to me ]

Hello, I have just begun having a look at DocBook for use with
documenting a library I have written.  I would like to produce a man
page, and also HTML from one document.  

I quickly found docbook-to-man, however, it seems to have some
problems:

It assumes you are working with C functions. I am, but I also want to
document the Tcl and Python interfaces, and have them displayed
correctly.

It produces some output which is just plain bad or ugly:

some_function(
);

It seems to use a '.ts' file to define how to do these
transformations, and a lot of stuff is hard coded into it (the
parentheses for functions, for instance).

Can anyone advise me on a better efficient tool to use for this?

How can I make the distinction between Tcl and Python code?

Thankyou,
-- 
David N. Welton, Responsabile Progetti Open Source, Linuxcare Italia spa
tel +39.049.8043411 fax +39.049.8043412 cel +39.348.2879508
davidw@linuxcare.com, http://www.linuxcare.com/
Linuxcare. Support for the revolution.