This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
generate man pages on Linux
- To: docbook at lists dot oasis-open dot org
- Subject: DOCBOOK: generate man pages on Linux
- From: davidw at linuxcare dot com (David N. Welton)
- Date: Wed, 11 Oct 2000 15:18:23 +0200
[ 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.