From: why the lucky stiff <ruby-core@...>
Date: 2005-10-19T02:00:24+09:00
Subject: YAML RDoc problem (was Re: Kernel rdoc HTML file not being created when rdoc is run on 1.8.3)

H.Yamamoto wrote:

>>>>When 1.8.3 came out, I grabbed the source and ran rdoc on it.  After 
>>>>updating the API docs on ruby-doc.org, people started writing to tell me 
>>>>that Kernel.html was missing, and indeed it is.
>>>>
>>>>I've tried running rdoc over the source again, but no Kernel rdoc file 
>>>>shows up.
>>>>
>>>>Has anyone else seen this?
>>>>        
>>>>
>I think this change is most doubtful. But still don't know why.
>
>Tue Sep 13 12:33:05 2005  why the lucky stiff  <why@ruby-lang.org>
>
>	* lib/yaml.rb: reworking YAML::Stream to use the new
>	  emitter.
>
>	* lib/yaml/stream.rb: ditto.
>
>	* lib/yaml/rubytypes.rb: added Object#yaml_new.
>  
>
This could be caused by the :nodoc: I have on Kernel in lib/yaml.rb.  Is 
this causing destruction of Kernel docs generated elsewhere?  How do I 
get RDoc to add docs for Kernel::y, but avoid overwriting the Kernel 
definition itself?  Maybe JEGII or Gavin knows more?

_why