From: James Gray <james@...>
Date: 2008-03-17T12:05:34+09:00
Subject: Re: argh! more undocumented mysteries: to_yaml

On Mar 16, 2008, at 6:56 PM, James Britt wrote:

> Unfortunately, the conventional description for creating ri and rdoc  
> for ruby, and the way the Ruby source code installation handles it,  
> is to simply process the entire source folder.  More and more files  
> have been added to .document files, with the default ri and rdoc  
> output showing, for example, to_yaml as a method of Array.  So,
>
>  $ ri Array
>
> can be misleading.
>
> Basically, what is now appearing on ruby-doc.org are the results of  
> the canonical rdoc'ing of the Ruby source.

The main issue though is just that ruby-doc.org should only show core  
documentation in that section though, right?

Surely we could script that.  What happens if we replace the .document  
files in lib/ and ext/ with empty files before we build the docs, or  
just erase those two directories before we build?

The standard library documentation is build by an altogether different  
process Gavin Kistner manages (or at least did), right?

I'm happy to help if I can.  Just let me know if you need anything.

James Edward Gray II