On Tue, Oct 28, 2008 at 11:28:15PM +0100, Daniel Stenberg wrote:
> I agree. The INTERNALS document was an effort that never really got
> updated much and it's not detailed enough to help a lot. I think a more
> sensible approach is perhaps to make sure the comments in the source code
> are good enough to more or less explain the same things. They're easier to
> keep up-to-date and in sync with the code.

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.

>>> Dan

-- 
http://www.MoveAnnouncer.com              The web change of address service
          Let webmasters know that your web site has moved