From: Austin Ziegler <halostatue@...>
Date: 2004-08-06T21:18:31+09:00
Subject: ri bug -- might be Windows only

I am preparing for a Diff::LCS 1.0.3 release because of a bug report
submitted. It's basically ready, but I want to be able to generate the
RI documentation, too. The problem is -- and this may be specific to
the Windows installer -- is that it looks like ri is not additive when
using ri --ri-site. I have my Ruby installed in c:\Apps\Ruby, and the
ri documentation is in c:\Apps\Ruby\share\ri\1.8\site. In Diff::LCS, I
have diff/lcs/array.rb that simply consists of :

  require 'diff/lcs'

  class Array
    include Diff::LCS
  end 

This completely clears the existing ri documentation for Array when I do:

  rdoc --ri-site --show-hash

I haven't yet added a comment, but I should for the HTML doc output,
so I don't want to add a #:nodoc: marker if I can avoid it

Is this broken in ri? Is this broken in the Windows installer only
(e.g., should the default be in --ri-system instead)?

As a note, when I changed the rdoc line to:

  rdoc --ri-system --show-hash

I get:

> ri Array
More than one class or module matched your request. You can refine
your search by asking for information on one of:

     Array, Array

So it seems that this will break ri in any case. This seems suboptimal.

I don't have Ruby installed on anything *but* Windows right at the
moment (that will change, but not in the next three weeks :), so I
can't verify this behaviour on non-Windows boxen.

-austin
-- 
Austin Ziegler * halostatue@gmail.com
               * Alternate: austin@halostatue.ca