On Sep 28, 2004, at 16:31, Brian Schröäer wrote:

> It would be nice to have something like:
>
>   defined in: namespace/xyz.rb
>
> included in the ri output.

Excellent idea. The only problem is that, as things stand, this isn't 
easily knowable, as the file containing the method definition may not 
be the one that you end up requiring into your Ruby source. For 
example, the various YAML methods are defined in files in the yaml/ 
directory, but you don't require these into your code. Instead you say

   require "yaml"

and it drags them in for you.

Perhaps the solution might be to extend the code examples in the 
documentation to include any necessary 'require' statements, so your 
abbrev example would become:

----------------------------------------------------------- Array#abbrev
      abbrev(pattern = nil)
------------------------------------------------------------------------
      Calculates the set of unambiguous abbreviations for the strings in
      self. If passed a pattern or a string, only the strings matching
      the pattern or starting with the string are considered.

        require 'abbrev'
        %w{ car cone }.abbrev   #=> { "ca" => "car", "car" => "car",
                                      "co" => "cone", "con" => cone",
                                      "cone" => "cone" }


Cheers

Dave