# Ri, rdoc, OS 10.4

**URL:** <https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914>\
**Category:** Ruby\
**Created:** [April 5, 2006, 7:19pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914 "2006-04-05T19:19:59Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jean-Charles\_Carell](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/c68b51/32.png) [@Jean-Charles\_Carell](https://www.ruby-forum.com/u/Jean-Charles_Carell)\
**Post date:** [April 5, 2006, 7:19pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914/1 "2006-04-05T19:19:59Z")

</div>

I recently follow the excellent tutorial at the HiveLogic site on  
installing Ruby on OS 10.4. [Dan Benjamin](http://hivelogic.com/articles/2005/12/01/)  
ruby\_rails\_lighttpd\_mysql\_tiger

My Problem: is with ri and rdoc:

When I first tried running ri, I got an error message saying ri /  
rdoc were not installed and to contact the distributor of the binary  
used to install ruby or if ruby had been manually installed, to run  
make again with directives to install rdoc. I did the latter. Now  
when I run ri, I get this error:

Before using ri, you need to generate documentation  
using ‘rdoc’ with the --ri option

I’ve tried running rdoc with any and all options. The result is a  
long wait followed by an error stating rdoc doesn’t know what to do  
with some random file nested deep inside one of the other apps on my  
system ( Flash, TextWrangler, Toast ???).

ri, rdoc, ruby, are all installed in /usr/local/bin

How do I run rdoc so that is doesn’t choke on non ruby files?

Many thanks for any help. I’m sure I’m just missing something simple.

Best,  
Jean-Charles

---

<div class="post-metadata">

**Author:** ![Jean-Charles\_Carell](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/c68b51/32.png) [@Jean-Charles\_Carell](https://www.ruby-forum.com/u/Jean-Charles_Carell)\
**Post date:** [April 5, 2006, 7:41pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914/2 "2006-04-05T19:41:20Z")

</div>

On Apr 5, 2006, at 1:19 PM, Jean-Charles Carelli wrote:

> latter. Now when I run ri, I get this error:  
> ri, rdoc, ruby, are all installed in /usr/local/bin
> 
> How do I run rdoc so that is doesn’t choke on non ruby files?
> 
> Many thanks for any help. I’m sure I’m just missing something simple.
> 
> Best,  
> Jean-Charles

You need to run rdoc in the directory with the ruby files. For the  
core / stdlib etc. this is usually done when installing. I don’t know  
how terrible it would be to go do it now on an installed ruby but you  
can try. Just cd to the directory with the ruby libs.

to do that find out the lib dir:

ruby -e ‘puts Config::CONFIG[“libdir”]’  
You’ll wnat to cd to the result of that command and then cd into the  
directory 1.8  
then you can attempt to run rdoc. Good luck

---

<div class="post-metadata">

**Author:** ![Jean-Charles\_Carell](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/c68b51/32.png) [@Jean-Charles\_Carell](https://www.ruby-forum.com/u/Jean-Charles_Carell)\
**Post date:** [April 5, 2006, 8:08pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914/3 "2006-04-05T20:08:54Z")

</div>

Thanks Logan, it worked perfectly.

Who would have thought being in the right directory would help ? LOL

One thing: when I used the command you suggested below, I got an error:

pwrBook: ~: jnchrls-\> ruby -e ‘puts Config::CONFIG[“libdir”]’  
-e:1: uninitialized constant Config (NameError)

I found the 1.8 dir manually instead. Is the error a typo or  
something I should worry about?

Thanks again for the help.

J-C

On Apr 5, 2006, at 1:38 PM, Logan C. wrote:  
You need to run rdoc in the directory with the ruby files. For the  
core / stdlib etc. this is usually done when installing. I don’t know  
how terrible it would be to go do it now on an installed ruby but you  
can try. Just cd to the directory with the ruby libs.

to do that find out the lib dir:

ruby -e ‘puts Config::CONFIG[“libdir”]’  
You’ll wnat to cd to the result of that command and then cd into the  
directory 1.8  
then you can attempt to run rdoc. Good luck

---

<div class="post-metadata">

**Author:** ![Jean-Charles\_Carell](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/c68b51/32.png) [@Jean-Charles\_Carell](https://www.ruby-forum.com/u/Jean-Charles_Carell)\
**Post date:** [April 5, 2006, 8:39pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914/4 "2006-04-05T20:39:20Z")

</div>

On Apr 5, 2006, at 1:16 PM, Ryan D. wrote:

> On Apr 5, 2006, at 10:19 AM, Jean-Charles Carelli wrote:
> 
> > I recently follow the excellent tutorial at the HiveLogic site  
> > on installing Ruby on OS 10.4. [Dan Benjamin](http://hivelogic.com/articles/)  
> > 2005/12/01/ruby\_rails\_lighttpd\_mysql\_tiger
> 
> It isn’t excellent. It is missing an important step. After “sudo  
> make install” for the ruby phase, do a “sudo make install-doc”.

Or you can do install-all, to handle both at once.

James Edward G. II

---

<div class="post-metadata">

**Author:** ![Jean-Charles\_Carell](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/c68b51/32.png) [@Jean-Charles\_Carell](https://www.ruby-forum.com/u/Jean-Charles_Carell)\
**Post date:** [April 5, 2006, 8:18pm UTC](https://www.ruby-forum.com/t/ri-rdoc-os-10-4/56914/5 "2006-04-05T20:18:03Z")

</div>

On Apr 5, 2006, at 10:19 AM, Jean-Charles Carelli wrote:

> I recently follow the excellent tutorial at the HiveLogic site on  
> installing Ruby on OS 10.4. [Dan Benjamin](http://hivelogic.com/articles/)  
> 2005/12/01/ruby\_rails\_lighttpd\_mysql\_tiger

It isn’t excellent. It is missing an important step. After “sudo make  
install” for the ruby phase, do a “sudo make install-doc”.

I just emailed the author asking for an update.

–  
\_why: zenspider’s most intense moments of solice are immediately  
following the slaughter […]  
\_why: that topknot’s the only thing keeping a lid on the righteous anger  
bricolage: yeah, that and his flagrant obsession with dvorak
