[ruby-core:24135] Re: [Bug #1718] RDoc directive in lib/yaml/tags.rb prevents rdoc'ing of Module

On Jul 2, 2009, at 14:06, James Britt <[e-mail]> wrote:

> Bug #1718: RDoc directive in lib/yaml/tags.rb prevents rdoc'ing of  
> Module
> http://redmine.ruby-lang.org/issues/show/1718
>
> Author: James Britt
> Status: Open, Priority: Normal
> ruby -v: ruby 1.8.6 (2009-03-27 patchlevel 367) [i686-darwin9.7.0]
>
> This appears to be a regression.    There is a :stopdoc: directive  
> in lib/yaml/tags.rb  that modifies Module.
>
> When running rdoc over the Ruby  source tree, this stops the  
> rdoc'ing of the entire Module code; no docs page for Module is  
> created.
>
> This was a problem once before, and was fixed (I submitted a patch,  
> which was accepted), but now seems to have returned.  Removing that  
> rdoc directive allows for Module to be doc'ed (though there is still  
> the larger issue of RDoc pollution with Yaml methods now appearing  
> as part of Module in the resulting RDoc files).

Pairing the stopdoc with a startdoc after the YAML methods should keep  
the Module documentation without the YAML additions.