Dave Thomas wrote:

>
> 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
>
>
Hello Dave,

that would certainly be a solution.

As I like shoving work to the computer, I'd propose the following:

If there is a tag

# :require_as: yaml

for the (file, module, class, function) output for everything that is in 
the scope of the tag as

defined in: filename
require as: yaml

otherwise output

defined in: filename
require as: filename

what do you think?

Regards,

Brian