From: Phrogz <gavin@...>
Date: 2006-10-19T23:50:14+09:00
Subject: Re: Why Class decls and API docs don't Match

gsm.beamon@gmail.com wrote:
> You can't have a system in which, despite MBs of fancy-smancy HTML API
> docs, you only know what you know because you spent the minutes (hours, days)
> playing around in the source code to see what's what.

Agreed.

> Ruby -- the language -- needs to do better here.

Disagreed. This has nothing to do with Ruby the language! RDoc is a
tool that tries to parse the language statically. It is not part of the
core of Ruby.

The only way Ruby the language could do better for what you want, I
think, would be to change into a system where everything about the
runtime state of the system could be determined at 'compile' time
without running the code.

How do *you* think that Ruby the language should do better?