From: James Britt <jamesUNDERBARb@...>
Date: 2005-01-23T08:40:11+09:00
Subject: Re: Documenting ruby.h and intern.h (was rb_const_get documentation)

E S wrote:
> 
>>BTW, has this:
> 
> 
>>http://www.ruby-doc.org/doxygen/1.8.1/index.html
> 
> 
>>been mentioned here yet?
> 
> 
> Yep. The problem is that there's no documentation as to
> /what/ the functions do (not to mention Doxygen's normal
> cumbersome navigation). One can look at the source but,
> witness my recent confusion about command-line arguments
> that Nakada-dono clarified, it may not be enough :)

Ah.  Well, then perhaps more comments are needed in the source code, 
and/or a way to annotate the Web pages.


James