Re: RDoc problems

Peter McMaster wrote:
> I think that possibly one of the things which makes it more complex is 
> that I have ruby installed via the darwinports ( 
> darwinports.opendarwin.org/ ) system.
> Basically 'port install ruby' installs v1.8.1 of ruby, puts it in a 
> sensible place for an OS X system, and sets paths etc. so it all works. 
> Great way of installing things (partly because 'port uninstall whatever' 
> works like one would hope!), but not so helpful when it comes to working 
> out problems like this.
>   port fetch ruby
>   port expand ruby
>
> ...puts the 1.8.1 source files in a work directory (these are sub-stages 
> which usually are completed by 'port install ...'). After reading 
> through 
> http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/89061 I ran 
> the following in the freshly fetched ruby source dir:
>   rdoc --ri *.c lib/*.rb
>
> ...which apparently worked fine. (This didn't work in 
> /opt/local/lib/ruby/) Interestingly, it seemed to fail to pick up 
> anything from any of the .c files, so for example you get:
>   ~> ri 'Array.flatten!'
>   Nothing known about Array.flatten!
>
> ...possibly missing something obvious there?
>
>   rdoc --op ~/rdocs  *.c lib/*.rb
>
> ...however, failed, with the same ".as_href method missing from 
> nil:NilClass" error as before.
> I'll work on it later today (i.e., after sleep!) and see if I can make 
> any progress.
>  - Peter
There's a related thread on this in ruby-talk right now.  Basically, ri 
is not installed by default when installing from source, so instructions 
are being provided, at least for the general case.
James