From: John Joyce <dangerwillrobinsondanger@...>
Date: 2007-05-11T12:57:57+09:00
Subject: Re: ri


On May 11, 2007, at 12:16 PM, Pe�a, Botp wrote:

> From: seebs@seebs.net [mailto:seebs@seebs.net]
> # I have 'ri', but it doesn't know about any of the standard library
> # classes or built-ins.  So, "ri Array" says it's never heard of it,
> # same with "ri CGI".
>
> it should.
>
> root@pc4all:~# qri Array
> ----------------------------------------------------------- Class:  
> Array
>      Arrays are ordered, integer-indexed collections of any object.
>      Array indexing starts at 0, as in C or Java. A negative index is
>      assumed to be relative to the end of the array---that is, an  
> index
>      of -1 indicates the last element of the array, -2 is the next to
>      last element in the array, and so on.
>
> ---------------------------------------------------------------------- 
> --
>
> Includes:
>      Enumerable(all?, any?, collect, detect, each_cons, each_slice,
>      each_with_index, entries, enum_cons, enum_slice, enum_with_index,
>      find, find_all, grep, include?, inject, map, max, member?, min,
>      partition, reject, select, sort, sort_by, to_a, to_set, zip)
> [snip]
>
>
> works here on my linux and windows boxes.
> kind regards -botp
>
Does ri know the path to your docs ?

ri looks in a few places by default: the system's docs, the site docs  
(in an ri directory) and user docs (in a hidden dot dir in user's  
home dir).

Mine look like this on OS X :
/usr/local/share/ri/1.8/site
/usr/local/share/ri/1.8/system

I could have (local only to my home dir) but don't have :
~/.rdoc/

To find your data directory:
ruby -r rbconfig -e 'p Config::CONFIG["datadir"]'

Mine is :
/usr/local/share/

This is the same location as my system's man pages.

You may have to add docs to ri yourself. (it seems...)
you need to run rdoc

One file at a time:

rdoc --ri filename.rb filename2.rb

Ruby's standard library and built in classes and modules:

rdoc --ri-system

(need to be in the Ruby source code directory, probably:    /lib
   maybe /lib/ruby  )