ri doesn't seem to work

[illoai at gmail.com]

On 13/06/07, Chad Perrin <perrin at apotheon.com> wrote:
> On Wed, Jun 13, 2007 at 03:06:08AM -0400, illoai at gmail.com wrote:
> > On 13/06/07, illoai at gmail.com <illoai at gmail.com> wrote:
> > >On 12/06/07, Chad Perrin <perrin at apotheon.com> wrote:
> > >> No matter what I try to look up with ri (the Ruby information utility
> > >> that is used to look up stuff about classes, methods, et cetera, from the
> > >> command line), it returns the same result:
> > >>
> > >>   > ri Time.strftime
> > >>   Nothing known about Time.strftime
> > >>
> > >> I don't see anything in /usr/ports/lang that seems to relate to the
> > >> matter of ensuring ri has a database of information to share.  What am I
> > >> missing?  How can I get ri working properly on FreeBSD?
> > >
> > >On a hunch I typed "ri -h" . . .
> > >and another hunch made me type "ri -c" . . .
> > >
> > >. . .
> > >Well, crap. rdoc wants something I can't think
> > >to give it.
> > >Hopefully this will start making sense.
> > >
> >
> > Hello, self.  Also, hello, Chad!
> >
> > % tar jxvf /ports/distfiles/ruby/ruby-1.8.6.tar.bz2
> > % sudo rdoc --ri -R -U ruby-1.8.6/
> >
> > seems to be producing output.
>
> Interesting.  Any idea why this isn't more obvious?
>
> I guess my mistake was in not trying "ri -c".  I'm also not terribly
> clear on how I'd have guessed at:
>   /usr/ports/distfiles/ruby/ruby-1.8.6.tar.bz2
>
> . . . without any easily discoverable guidance.

Something on the ruby site hinted at the
rdoc parser needing the source files,
though I suppose that hardly qualifies
as "Easily discoverable guidance".

>
> Thanks much!  It's working now.

No, thank _you_.  I had given up on making
ri work myself.

-- 
--