(unknown)

ruby-talk
1

Hi,
     Maybe I don't understand how rdoc should work, but I'm seeing some odd behavior. If I do 'rdoc --all --ri /usr/lib/ruby' so that ~/.rdoc and its contents are created, I can no longer do 'ri Array' without seeing the following:

$ ri Array
/usr/lib/ruby/1.8/rdoc/ri/ri_descriptions.rb:99:in `concat': cannot convert nil into Array (TypeError)
         from /usr/lib/ruby/1.8/rdoc/ri/ri_descriptions.rb:99:in `merge_in'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_reader.rb:56:in `get_class'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_reader.rb:52:in `each'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_reader.rb:52:in `get_class'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_reader.rb:31:in `find_class_by_name'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_display.rb:97:in `display_class_info'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_display.rb:96:in `each'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_display.rb:96:in `display_class_info'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_display.rb:77:in `page'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_display.rb:77:in `display_class_info'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_driver.rb:71:in `report_class_stuff'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_driver.rb:106:in `get_info_for'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_driver.rb:135:in `process_args'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_driver.rb:134:in `each'
         from /usr/lib/ruby/1.8/rdoc/ri/ri_driver.rb:134:in `process_args'
         from /usr/bin/ri:48

In an attempt to combine all documentation in ~/.rdoc, I deleted ~/.rdoc, downloaded and extracted ruby-1.8.2.tar.gz, then did 'rdoc --all --ri /usr/lib/ruby ~/ruby-1.8.2'. Now, 'ri Array' works, but I seem to have duplicates:

$ ri IO\#flush
More than one method matched your request. You can refine
your search by asking for information on one of:

      IO#flush, IO#flush

Is this the expected behavior? Am I doing something wrong? How does one get the stuff from */lib/ruby into ri format without losing the ability to do 'ri Array' or 'ri IO\#flush'?

Configuration:

Mac OS X 10.4.1.
$ ruby --version
ruby 1.8.2 (2004-12-25) [powerpc-darwin8.0]
$ ri --version
ri v1.0.1 - 20041108

Thanks,
Ryan

2

Rdoc on Ruby itself is supposed to be run from the source tree after
the source is built, usually with install-doc.

-austin

···

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

3

Sorry for the lack of subject. So I downloaded the ruby-1.8.2 tarball, uncompressed it, cd-ed into it, and did 'rdoc --all --ri'. However, when I do 'ri IO\#expect' I get 'Nothing known about IO#expect'. Of course, ~/.rdoc/IO doesn't contain anything having to do with expect. Is there a way to get this "missing" documentation?

Thanks,
Ryan

···

On Jul 1, 2005, at 11:50 AM, Austin Ziegler wrote:

Rdoc on Ruby itself is supposed to be run from the source tree after
the source is built, usually with install-doc.

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