From: Tim Hunter <TimHunter@...>
Date: 2008-03-17T01:48:38+09:00
Subject: Re: argh! more undocumented mysteries: to_yaml

Stefano Crocco wrote:
> On Sunday 16 March 2008, Tim Hunter wrote:
>> The ri command shows the documentation for the merged core and standard
>> libraries. It's sad but it's true. However, it isn't hard to find out
>> what's the the core and what isn't.
>>
>> This link http://www.ruby-lang.org/en/documentation/ has a link to the
>> top-level www.ruby-doc.org as well as individual links to the core and
>> standard API sections of ruby-doc.
>>
>> When I go to www.ruby-doc.org right now, the documentation for the Core
>> API is clearly separated from the documentation for the Standard API.
>> The yaml library is documented in the Standard API documentation.
> 
> As far as I can see, the links to the 'Core documentation' on both www.ruby-
> doc.org and http://www.ruby-lang.org/en/documentation/ point to the same 
> documentation, which sadly contains both the core and the standard library. As 
> you say, the standard library is also documented in its own section, which is 
> much more organized, and easy to use.
> 

So it does. Thanks for pointing this out. It would be nice if some 
talented Rubyist were to upgrade rdoc so that this didn't happen. Until 
then I'll have to refer to my paper documentation when my memory fails 
me. (Which it frequently does.)

-- 
RMagick: http://rmagick.rubyforge.org/
RMagick 2: http://rmagick.rubyforge.org/rmagick2.html