Ri, rdoc, OS 10.4

I recently follow the excellent tutorial at the HiveLogic site on installing Ruby on OS 10.4. 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

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

···

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

I recently follow the excellent tutorial at the HiveLogic site on installing Ruby on OS 10.4. 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

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.

···

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. http://hivelogic.com/articles/2005/12/01/ruby_rails_lighttpd_mysql_tiger

--
_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

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

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

···

On Apr 5, 2006, at 1:38 PM, Logan Capaldo wrote:

On Apr 5, 2006, at 1:38 PM, Logan Capaldo wrote:

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

I recently follow the excellent tutorial at the HiveLogic site on installing Ruby on OS 10.4. Dan Benjamin

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

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

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

James Edward Gray II

···

On Apr 5, 2006, at 1:16 PM, Ryan Davis 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

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