Re: Documentation for GNOME API

[philippe truth enit fr]

>martin@home-of-linux.org said:
>// And that's what DocBook currently provides (randomly copied out of
>// gnome-libs/devel-doc/libgnorba.sgml): 

>No Martin, I think Scott was talking about some tags that would allow to
>add a text description of the parameters and of the return value. 

>I experience the same problem with my automatic documentation package.



What autodoc package do you use ??

I heavily customized PERCEPS (perl script) so it produces Docbook format. 

You have control on arguments to functions and can define the format of the uotput as you wish.

you can find it at :


http://friga.mer.utexas.edu/mark/perl/perceps


The original version produces rtf, latex and html but if you are interested in getting my docbook format, I can send it to you (and some fixes).

I also modify the perl script so you can also reproduce the whole code (body included) with automatic cross-references to function calls.

Philippe