why ; ?

[Michael Neumann]

Bruce Adams wrote:
 > On Fri, 09 May 2008 15:45:47 +0100, terranium <spam at here.lot> wrote:
 >
 >> Michael Neumann Wrote:
 >>
 >>> But hey, it's C!
 >>
 >> It's not an excuse for writing junk. The excuse is this was written by
 >> one man.
 >
 > That's no excuse either. Code for yourself as you would for others, if
 > not better.

Okay, it's not junk, definitvely not. It's just that some parts like
eval.c are not commented at all and for a newbie very hard to
understand. Another reason might be, because it origins from Japan, so
we wouldn't be able to read the comments anyway :).

To clarify: I'd actually call Ruby one of the best commented projects
I've ever seen, with the highest code/comment ratio. But only for the
parts that the programmer uses, not the very low-level implementation.

See this as just one example:

http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/object.c?revision=15758&view=markup

Btw, I'd like to see this style of documentation in languages like Java.
Java has a lot of documentation, but actually very little (if any)
examples in the documentation, so you have to figure out yourself how to
use it, which costs a lot of time. "An example is worth a 1000 words."

Regards,

   Michael