On Sat, 1 Nov 2008, Dan Fandrich wrote:

> How about converting the function and structure comments into Doxygen format
> (which is similar to JavaDoc)? Doxygen can do a pretty nice job of creating
> pretty documentation from comments in the source without greatly affecting
> its readability.

I wouldn't mind that as it is a fairly un-intrusive format, but I must confess
that I have yet to see some nice and handy output from doxygen. In my view,
its output still leaves out a lot - actually to the extent that I think
manually writing a document/description of how things are tied together often
is more readable and human parseable.

But maybe I've just had bad experiences...

-- 
  / daniel.haxx.se