Re: idea on gobject-introspection / gtk-doc metadata

2005-09-26 Thread Damon Chaplin
On Wed, 2005-09-21 at 11:18 -0400, Dan Winship wrote: So, what if we made it so that the extra annotations needed to generate correct gobject-introspection metadata go into the gtk-doc comments (thus encouraging people to write API docs, because it's essentially necessary to get working

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-26 Thread Murray Cumming
Personally I'm not too sure this would be a good idea. I think it is asking a bit too much from developers to add all this stuff. So you'd probably have to rely on bindings people checking over all the comments. We'd do that. I also worry that the C documentation may contain references to

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-26 Thread Dan Winship
Damon Chaplin wrote: Maybe a better idea would be for bindings to grab all the gtk-doc documentation, and then just override the docs for particular functions if they need to. Yeah, I didn't mean to suggest that the bindings docs could be generated completely automatically from the C docs,

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-21 Thread Tristan Van Berkom
Dan Winship wrote: One of the gobject-introspection TODOs is: - Write a scanner to create XML from annotated headers AFAIK, no one has put forward any suggestions about what those annotations would be. gtk-sharp's parser already figures out a lot of things (by assuming that the code

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-21 Thread Torsten Schoenfeld
On Wed, 2005-09-21 at 12:48 -0400, Tristan Van Berkom wrote: One thing I'd like to see introspectable is versioninig information on properties signals, right now the doc notes include Since 2.6 on function calls and such (it would also be nice to introspect whether properties, signals

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-21 Thread Tristan Van Berkom
Torsten Schoenfeld wrote: On Wed, 2005-09-21 at 12:48 -0400, Tristan Van Berkom wrote: One thing I'd like to see introspectable is versioninig information on properties signals, right now the doc notes include Since 2.6 on function calls and such (it would also be nice to introspect whether

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-21 Thread Dan Winship
Tristan Van Berkom wrote: - Is there any kind of plan of enhancing GObject introspection ? (ofcourse including its internals such as pspecs etc). - Is it speced anywhere ? - Is there anyone working on it ? gobject-introspection module in GNOME CVS -- Dan

Re: idea on gobject-introspection / gtk-doc metadata

2005-09-21 Thread Osvaldo Santana
Hi Dan, On 9/21/05, Dan Winship [EMAIL PROTECTED] wrote: One of the gobject-introspection TODOs is: - Write a scanner to create XML from annotated headers I've started a Python script to parse GTK+ header files and generate a scheme-based definition files[1] used by PyGTK+ project. I'm