From: Chris Gehlker <canyonrat@...>
Date: 2006-08-06T00:30:29+09:00
Subject: Re: Problem with RDoc


On Aug 5, 2006, at 7:34 AM, Dave Thomas wrote:

> RDoc documents the files you give it--it doesn't execute the code  
> to find out what files you use. You have two files, each of which  
> adds methods to My_Class, so it documents both sets of definitions.

Exactly.

I think one could make a good argument that this is the *right*  
behavior. It can be a bit surprising though, given the practice of  
some Ruby developers of distributing files that are 'in progress'  
along with the files are actually required in their projects.  
Sometimes these 'in progress' files actually contain more extensive  
RDoc documentation than the files that are actually required into the  
main class.

--
And those who were seen dancing were thought to be insane by those  
who could not hear the music.
-Friedrich Wilhelm Nietzsche, philosopher (1844-1900)