From: Mauricio Fernandez <mfp@...>
Date: 2006-11-09T04:33:21+09:00
Subject: Re: [ANN] FastRI 0.1.0: faster, smarter RI docs for Ruby, DRb-enabled

On Thu, Nov 09, 2006 at 12:31:29AM +0900, Leslie Viljoen wrote:
> Thanks for this. I see it's not working so well on Windows yet.
> The script is looking for directory '~' and there are some display problems.

I have pushed a patch to the 0.1 branch
(http://eigenclass.org/repos/fastri/0.1/ ) that solves the HOME issue. Until
that gets released, specifying the file as in 
  fastri-server --index-file c:/tmp/fastri-index
should work.

As for the "display problems", are they due to ANSI escape sequences?  If so,
fri -f plain  should do. If win32 can't handle ANSI escape codes, I can set
the default format based on the platform at runtime.

BTW, I'd appreciate feedback regarding execution times, both for indexing and
lookups (and if possible, both with cold & hot cache).

On an older K7 XP 1800+ running Linux, it takes under 10 seconds to index 36
gems (out of 88 installed ones --- I grabbed a bunch for testing purposes;
multiple versions are coalesced and some packages have no documentation) with
over 13000 entries (classes/modules & methods), and under 2 seconds when the
OS' cache is doing its work. I bet it'll be slower on win32, IO is much slower
in general (ri+RubyGems must be The Pain).

(note: the docs will only be indexed once, unless you remove the index file or
specify another one; otherwise it will be reused in successive runs)

  $ fastri-server
  Indexing RI docs for ParseTree version 1.5.0.
  Indexing RI docs for Rubilicious version 0.2.0.
  Indexing RI docs for ZenTest version 3.4.1.
  Indexing RI docs for actionmailer version 1.2.5.
  Indexing RI docs for actionpack version 1.12.5.
  Indexing RI docs for actionwebservice version 1.1.6.
  Indexing RI docs for activerecord version 1.14.4.
  Indexing RI docs for activesupport version 1.3.1.
  Indexing RI docs for builder version 2.0.0.
  Indexing RI docs for call_stack version 0.1.0.0.
  Indexing RI docs for cmdparse version 2.0.2.
  Indexing RI docs for color-tools version 1.3.0.
  Indexing RI docs for dev-utils version 1.0.1.
  Indexing RI docs for extensions version 0.6.0.
  Indexing RI docs for fastercsv version 0.2.1.
  Indexing RI docs for fastri version 0.1.0.1.
  Indexing RI docs for highline version 1.2.1.
  Indexing RI docs for hoe version 1.1.2.
  Indexing RI docs for mailfactory version 1.2.3.
  Indexing RI docs for mime-types version 1.15.
  Indexing RI docs for pdf-writer version 1.1.3.
  Indexing RI docs for rails_analyzer_tools version 1.1.0.
  Indexing RI docs for rake version 0.7.1.
  Indexing RI docs for rcov version 0.7.0.1.
  Indexing RI docs for rspec version 0.6.4.
  Indexing RI docs for ruby-breakpoint version 0.5.1.
  Indexing RI docs for ruby-debug version 0.4.2.
  Indexing RI docs for rubyforge version 0.3.1.
  Indexing RI docs for rubyful_soup version 1.0.4.
  Indexing RI docs for ruport version 0.5.3.
  Indexing RI docs for scruffy version 0.2.2.
  Indexing RI docs for sqlite3-ruby version 1.1.0.
  Indexing RI docs for starfish version 1.2.0.
  Indexing RI docs for sys-proctable version 0.7.3.
  Indexing RI docs for tidy version 1.1.2.
  Indexing RI docs for transaction-simple version 1.3.0.
  Building index.
  Indexed:
  * 11131 methods
  * 2287 classes/modules
  Needed 9.553382 seconds
  Looking for Ring server...
  Located Ring server at druby://127.0.0.1:50275
  fastri-server 0.0.1 (FastRI 0.1.0) listening on druby://127.0.0.1:42913
  ACL:
  deny  all
  allow 127.0.0.1

  $ fastri-server --index-file /tmp/Index2
  Indexing RI docs for ParseTree version 1.5.0.
[...]
  Building index.
  Indexed:
  * 11131 methods
  * 2287 classes/modules
  Needed 1.761658 seconds
  Looking for Ring server...


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