Re: gtk-docs [was: Updated libgnomecanvas docs]
- From: Biswapesh Chattopadhyay <biswapesh_chatterjee tcscal co in>
- To: Rich Burridge <Rich Burridge Sun COM>
- Cc: Josh Green <jgreen users sourceforge net>, GNOME Desktop <desktop-devel-list gnome org>
- Subject: Re: gtk-docs [was: Updated libgnomecanvas docs]
- Date: 02 May 2003 10:00:54 +0530
I've been working on SourceBase (http://sourcebase.sf.net/) which is a
generic parser library with support for pluggable storage backends and
parsers. The current set of parsers include C, C++, Java, M4, Python,
etc. The significant thing is that the parsers can handle comments,
cross-freference, inheritence and other goodies, so it should be pretty
easy to do everything Doxygen, gtk-doc, etc. can with a bit of effort.
If there is interest in replacing gtk-doc with something more generic
and extensible, please let me know. SourceBase is pretty small (Glib is
the only dependency) and the parsers are pretty good (based off source
navigator). I'm hoping to make a release by the end of this month.
> Hi Josh,
> > I don't know as to whether it supports C++ or not. My feeling is that it
> > probably doesn't support anything beyond just C with some stuff for
> > GObject hierarchy, properties and signals. Most of the work is done in
> > perl scripts, and that is often how I figured out its behavior is by
> > looking at the source. Good luck!
> Are you (or is anyone else) interested in doing some more work with
> the gtk-doc PERL scripts? I'm part of a group of people that have
> been putting together a proposed API for GNOME Speech v1.0. This API
> is heavily influenced by the Java Speech API which has extensive JavaDoc
> comments. We have used this to add extensive IDL style comments to the
> IDL files.
> It sure would be nice, for somebody knowledgeable in PERL and/or gtk-doc
> to be able to work out how to turn this into gtk-doc style documentation,
> rather than forcing the developers to have to browser .idl files. Note
> that this functionality would then be useful to several other GNOME modules
> that have IDL files.
> desktop-devel-list mailing list
> desktop-devel-list gnome org
] [Thread Prev