Re: How to port applets to GNOME2 (again)

[Malcolm Tredinnick <malcolm commsecure com au>]

On Sun, Mar 16, 2003 at 10:10:47PM +0000, Azrael wrote:
> On Sun, 2003-03-16 at 21:03, Ole Laursen wrote:
> > John Fleck <jfleck inkstain net> writes:
> > People contribute because it is fun. Writing documentation for your
> > own library is much easier and much more fun (yes, writing reference
> > documentation _is_ fun) than writing documentation for someone else's
> > library.
> 
> I always enjoy writing the javadoc documentation for any java code I
> write.

All these people who feel writing API documentation is fun should mean
it all gets done for 2.4, then. As somebody who has written a fair bit
of API doco and finds it anything but fun, I'll await the results
eagerly.

> I'm probably showing my ignorance here, but is there anything similar in
> purpose & function to javadoc for c/c++ code, that could generate good
> GNOME documentation? I know that still requires coders to write
> documentation, but then it could be written inline with the code.. and
> perhaps be less troublesome to do.

Yes there is. It's called gtk-doc.

Malcolm

-- 
Tolkien is hobbit-forming.