From: Mauricio Fernandez <mfp@...>
Date: 2006-12-04T22:43:55+09:00
Subject: Re: FastRI, handling identical class names and methods

On Mon, Dec 04, 2006 at 11:47:44AM +0900, Daniel Berger wrote:
> With FastRI (or rather, fri) how do you distinguish a lookup on classes 
> with identical names and methods (and no namespace to distinguish them)?
> 
> For example, I have the Pathname class from the stdlib and my own 
> Pathname class from the 'pathname2' package.  If I do 'fri 
> Pathname#descend' I get the documentation from the Pathname class in the 
> stdlib instead of my own.  Is there a way to force the issue?

What you're getting is the result of merging the documentation from the
Pathname class in the stdlib and that in the gem package, so you'll see
methods defined in both, but for a given method only the description from the
stdlib IIRC (that depends on the way RDoc defines "merging", which is not
commutative). Internally, FastRI knows where a class/module/method came from,
but there's no way to specify the scope of the search at the moment. Once that
functionality is exposed, you'll be able to do
  fri --scope pathname2 Pathname

> I tried using the -S and -F options, but I received the following error 
> (with -S):
> 
> Couldn't open the full-text index:
> C:\Documents and Settings\djberge/.fastri-fulltext/full_text.dat
> C:\Documents and Settings\djberge/.fastri-fulltext/suffixes.dat
> 
> The index needs to be rebuilt with fastri-server -B
> 
> Since I'm runnng FastRI as a service, rebuilding the index may be 
> problematic at the moment. :)  But, even if that did work, I presume it 
> would give me all the results instead of just the one I'm looking for.

It should work since fastri-server doesn't access the full-text index itself
at the moment. But it would show all the matches (and only the matching lines,
it doesn't show full entries).

-- 
Mauricio Fernandez  -   http://eigenclass.org   -  singular Ruby