From: Dave Thomas <dave@...>
Date: 2008-03-17T01:55:01+09:00
Subject: Re: argh! more undocumented mysteries: to_yaml


On Mar 16, 2008, at 11:47 AM, James Britt wrote:

>
> It appears that the Ruby source code includes .document files that  
> direct which source files should be processed by rdoc
>
> What has happened is that there is no clear separation in the rdoc  
> settings between core classes and standard lib.
>
> The Yaml source files get pulled in by rdoc along with several other  
> std-lib files, as well as core files.  Rdoc stores what it finds and  
> emits an aggregate result.  Since yaml alters core classes, the  
> resulting rdoc falsely shows Array, String, etc as having to_yaml  
> methods as if they were built into the original code.    There is no  
> indication that those methods only exist if YAML is included.

James:

When you use all this stuff to build ruby-doc, why not override the  
defaults so you can present the information differently?


Regards


Dave Thomas