From: James Britt <james_b@...>
Date: 2005-08-24T13:38:55+09:00
Subject: Re: ri - what does it know?

Eric Hodel wrote:
> On 23 Aug 2005, at 17:56, James Britt wrote:
> ...
>>
>> What's the criteria?  I can think of two things offhand:
>>
>> * The code does not redefine any other classes (as this tends to boink
>> the original ri files.)  E.g., it is not adding or altering methods  in,
>> say, Array or String.  (Or, if it does redefine stuff, that part  does 
>> not get ri'ed.  I think nodoc can handle that.)
> 
> 
> I think if the documentation mentions where non-core methods come  from 
> that'd be enough.  There are a few non-core methods listed in ri  
> (Time#iso8601 comes from time.rb).  Maybe just adding "require 'foo'"  
> to the synopsis.
> 
> Personally, I'd rather see some documentation that confuses origin  over 
> no docs.

The issue is not user confusion, but rdoc/ri obliterating the proper ri 
yml files with some new file generated when processing a library that 
just happens to include something like

class Array
   def foo
      # ...
   end
end



James