This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

generate man pages on Linux



[ 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.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]