Re: gtk-doc scanning of IDL

[Damon Chaplin <damon ximian com>]

On Fri, 2001-11-23 at 21:28, Bill Haneman wrote:
> Hi Folks:
> 
> I have a bunch of IDL with inline comments, gtk-doc-style.  Since the
> IDL is actually the public interface in this case, I'd like to generate
> API docs from it.  Has anybody written any perl scripts of know of any
> utilities that will help me do this with gtk-doc?  I take it that
> gtk-doc can't already scan IDL...

No, it can't scan IDL at present. It has been mentioned a few times, but
I don't think anyone has written anything.

You'd need to update the scanning code to handle Corba arguments of
methods, e.g. the 'in' and 'out' modifiers. You'd probably also want to
handle modules and interfaces, and things like structs, enums and
attributes. So it isn't trivial.

 
> If anyone is interested in the least in trying to hack up such a script
> please let me know, as I am not a perl hacker.  This work is for the
> Gnome Accessibility Project module at-spi (the files are in at-spi/idl).



Damon