From: Joel VanderWerf <vjoel@...>
Date: 2006-09-25T04:16:42+09:00
Subject: Re: [ANN] hoe 1.0.4 released

Ryan Davis wrote:
> 
> On Sep 24, 2006, at 9:20 AM, Bil Kleb wrote:
> 
>> Ryan Davis wrote:
>>> See class rdoc for help. Hint: ri Hoe
>>
>> Can someone please expand the "Hint"? -- I'm an
>> impatient bonehead;
>>
>>  $ sudo gem update
>>  Upgrading installed gems...
>>  Attempting remote upgrade of hoe
>>  Attempting remote installation of 'hoe'
>>  Successfully installed hoe-1.0.4
>>  Installing RDoc documentation for hoe-1.0.4...
>>  Gems: [hoe] updated
>>
>>  $ ri Hoe
>>  Nothing known about Hoe
>>
>>  $ ri hoe
>>  Nothing known about hoe
> 
> It could be one of two things. Either you don't have the right version 
> of ri/rdoc (1.8.5 has built in rubygem ri support) or rdoc/ri wasn't 
> generated for some unknown reason.
> 
> % gem -v
> 0.9.0
> % ruby -v
> ruby 1.8.4 (2006-03-04) [i686-darwin8.6.2]
> % gem list hoe
> 
> *** LOCAL GEMS ***
> 
> hoe (1.0.4)
>     Hoe is a way to write Rakefiles much easier and cleaner.
> % ri Hoe | head -2
> ------------------------------------------------------------- Class: Hoe
>      hoe - a tool to help rake
> 
> For the latter: sudo gem rdoc Hoe
> 
> If you aren't in a position to upgrade ruby/gems at this point in time, 
> you're stuck with gem_server or going to 
> http://seattlerb.rubyforge.org/hoe/
> 

Same (or similar) problem here, but with all gems, not just Hoe:

$ gem install Hoe
Need to update 2 gems from http://gems.rubyforge.org
..
complete
Successfully installed hoe-1.0.4
Installing ri documentation for hoe-1.0.4...
Installing RDoc documentation for hoe-1.0.4...
$ ri Hoe
Nothing known about Hoe
$ gem -v
0.9.0
$ ruby -v
ruby 1.8.4 (2005-12-24) [i686-linux]
$ gem list Hoe

*** LOCAL GEMS ***

hoe (1.0.4)
     Hoe is a way to write Rakefiles much easier and cleaner.


BUT: in my case _none_ of my installed gems are found by ri, even though 
their docs are all in the usual place, /usr/local/lib/ruby/gems/1.8/doc.

Passing the path explicitly doesn't seem to help either:

$ ri -d /usr/local/lib/ruby/gems/1.8/doc Hoe
Nothing known about Hoe
$ ri -d /usr/local/lib/ruby/gems/1.8 Hoe
Nothing known about Hoe
$ ri -d /usr/local/lib/ruby/gems Hoe
Nothing known about Hoe

-- 
       vjoel : Joel VanderWerf : path berkeley edu : 510 665 3407