Re: rdoc for 1.8.5 not creating Module docs?

Eric Hodel wrote:
> On Jan 10, 2007, at 10:54, James Britt wrote:
> 
>> When running rdoc over the current 1.8.5 source, the resulting HTML 
>> file set does not include docs for Module.
>>
>> If I run rdoc on just object.c, then Module appears in the class index 
>> and a Module.html file is created.  But rdoc'ing the entire source 
>> directory omits it.
>>
>> Oddly, I get a classes/Module.src/ directory, with numerous Module 
>> source HTML files, but no Module.html, and no listing for Module in 
>> the class list.
>>
>> Has anyone else seen this?
> 
> I've seen that adding the nodoc flag to a class will cause the class to 
> never by included no matter how many files it is split across.  The same 
> is probably true for stopdoc/startdoc.
> 
>> It appears  related to the :stopdoc directive in the Module definition 
>> in lib/yaml/tag.rb.
>>
>> Removing that directive brings back the Module.html file, though it 
>> ends  up including docs from tab.rb.
>>
>> What would be another  way to hide the documenting of the tag.rb file 
>> without boinking the main Module docs?
> 
> Either adding a :startdoc at the end of Module or adding :nodoc to all 
> the methods in tag.rb will probably fix it.

Thanks.  I'll try this out.

-- 
James Britt

http://www.ruby-doc.org    - Ruby Help & Documentation
http://www.rubystuff.com   - The Ruby Store for Ruby Stuff
http://www.jamesbritt.com  - Playing with Better Toys