Re: Access to "javadoc"?

[Hans Breuer <hans breuer org>]

Am 30.07.2008 21:05, Don Blaheta schrieb:
> I've noticed that the code is fairly well-commented using a modified
> javadoc format; is there a particular program you have for compiling it
> into browsable html (as with javadoc)?  
Doxygen works for me. Unfortunately doxygen does not understand OO in C, so
the output is not that well structured. (The only documentation tool I know
which grasps that concept is gtk-doc, but it has a less common markup
language and may fail )

> Or is it just in this careful
> format for code legibility reasons?  Apologies if this is answered
> somewhere, but I didn't see it in the FAQ, on the Wiki, or in the
> tarball (but could have missed it...)
There are references to Dia's doxygen 'usage' in the ChangeLog and (at
least now;)) on the mailing-list.

To get an overview of the most important objects - at least from the 
plug-in authors point of view - you may want to take a look at the C++ 
wrapper written for Dia bindings: http://hans.breuer.org/dia/bindings/

It is documented with doxygen as well and gives an idealized view of the 
collabroations between Dia's C objects.

Further documentation of concepts is a available in the samples/Self 
directory: http://svn.gnome.org/viewvc/dia/trunk/samples/Self/

-------- Hans "at" Breuer "dot" Org -----------
Tell me what you need, and I'll tell you how to
get along without it.                -- Dilbert