From: Leo <see_signature@...>
Date: 2004-07-08T08:22:34+09:00
Subject: ruby-1.8.1: problem running rdoc --ri on Linux

Dear Ruby experts,
I just compiled and installed ruby-1.8.1 on my SuSE-9.1 box. 
(I did carefully uninstalled SuSE's version of Ruby prior to my own 
installation). 

Yet, when I run 

sh$ rdoc --ri 

either from the source tree or from installation tree
the end result is the same: after many minutes of hard labor 
ruby throws an exception:

Generating RI...
/pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/markup/simple_markup/to_flow.rb:92:in `accept_rule': undefined local variable or method `size' for #<SM::ToFlow:0x4252d920> (NameError)
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:170:in `accept'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:165:in `each'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:165:in `accept'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/markup/simple_markup.rb:259:in `convert'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:224:in `markup'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:153:in `generate_method_info'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:133:in `generate_class_info'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:132:in `each'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:132:in `generate_class_info'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:90:in `process_class'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:85:in `generate'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:84:in `each'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/generators/ri_generator.rb:84:in `generate'
        from /pkg/ruby-1.8.1/lib/ruby/1.8/rdoc/rdoc.rb:210:in `document'
        from /pkg/bin/rdoc:63


Indeed, inspecting 'to_flow.rb' and 'fragments.rb' reveals that there is no method 
called 'size' and also I do not see any variable that goes by the name 'size'. 
Is it a bug?? How could I finally build my ri database??

Also Dave mentioned in ruby-talk:97877 that one should run rdoc --ri  
the source tree because it contains files ".document" that control which *.rb
files get included. Well, canonical ruby-1.8.1.tar.gz tar-ball has none of
such files.


Thanks, 
--Leo--

my actual email follows:
[ LEOR _at_ WINLAB _dot_ RUTGERS _dot_ EDU ]