Forum: Ruby ri, rdoc, OS 10.4

Announcement (2017-05-07): www.ruby-forum.com is now read-only since I unfortunately do not have the time to support and maintain the forum any more. Please see rubyonrails.org/community and ruby-lang.org/en/community for other Rails- und Ruby-related community platforms.
Jean-Charles Carelli (Guest)
on 2006-04-05 21:19
(Received via mailing list)
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
Logan C. (Guest)
on 2006-04-05 21:41
(Received via mailing list)
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
Jean-Charles Carelli (Guest)
on 2006-04-05 22:08
(Received via mailing list)
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
Ryan D. (Guest)
on 2006-04-05 22:18
(Received via mailing list)
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

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
James G. (Guest)
on 2006-04-05 22:39
(Received via mailing list)
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.  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
This topic is locked and can not be replied to.