Install Issues on FC5

Ruby
1

Hi All,

firstly, I’m a newb to Ruby and programming in general. I currently
attend a
Ruby study group here in Sydney. Matz, and others, thanx for this great
language. Ok, now to my dilemna. I installed Ruby via yum and had issues
with ri on FC5. I took it to a Fedora list, but no answer after a few
days.
See issue below,

]$ ri array
No ri documentation found in:

Was rdoc run to create documentation?

Installing Documentation

‘ri’ uses a database of documentation built by the RDoc utility.

So, how do you install this documentation on your system? It depends on
how you installed Ruby.

If you installed Ruby from source files (that is, if it some point you
typed ‘make’ during the process :), you can install the RDoc
documentation yourself. Just go back to the place where you have your
Ruby source and type

make install-doc

You’ll probably need to do this as a superuser, as the documentation is
installed in the Ruby target tree (normally somewhere under
+/usr/local+.

If you installed Ruby from a binary distribution (perhaps using a
one-click installer, or using some other packaging system), then the
team that produced the package probably forgot to package the
documentation as well. Contact them, and see if they can add it to the
next release.

I have installed everything that is relevant and still get this after
running rdoc. I am now looking at installing from source, which I have
some
limited experience with, for other apps. Does thre source install
install
everything, including ri and irb? Just wanted to confirm before going
ahead.
I looked at README and README.TXT but found nothing specific. Hope this
is a
relevant request on here. Cheers.

Mark S…

2

Howdy Mark,

Mark S. wrote:

running rdoc.
Are you sure that you have all relevent packages installed? I haven’t
personally used Fedora Core since FC1 (and never used Ruby under it),
but I’d guess there’s a ruby-docs or ruby-ri package you’re missing.

Regards,
Nick Evans

3

Nicholas E. wrote:

No ri documentation found in:

Was rdoc run to create documentation?

I have installed everything that is relevant and still get this after
running rdoc.

Have you run rdoc over the main Ruby lib dir to generate the ri
datafile?

run rdoc --help (or whatever gets you a help listing) and see what the
magic incantation is for creating the ri files.

–
James B.

“In physics the truth is rarely perfectly clear, and that is certainly
universally the case in human affairs. Hence, what is not surrounded
by
uncertainty cannot be the truth.”

  • R. Feynman
4

On 6/17/06, James B. [email protected] wrote:

Have you run rdoc over the main Ruby lib dir to generate the ri datafile?

Oh, I didn’t realize I had to be in a specific dir when running it,
thanx.

run rdoc --help (or whatever gets you a help listing) and see what the

magic incantation is for creating the ri files.

I will do as suggested. Thanx. Cheers.

Mark S…

5

On 6/17/06, Nicholas E. [email protected] wrote:

Howdy Mark,

Are you sure that you have all relevent packages installed? I haven’t
personally used Fedora Core since FC1 (and never used Ruby under it),
but I’d guess there’s a ruby-docs or ruby-ri package you’re missing.

I would not be exactly sure of that, Nick. Please see below,

$ sudo rpm -qa | grep ruby | uniq
ruby-libs-1.8.4-5.fc5
ruby-rdoc-1.8.4-5.fc5
ruby-docs-1.8.4-5.fc5
ruby-irb-1.8.4-5.fc5
ruby-1.8.4-5.fc5
ruby-ri-1.8.4-5.fc5

Cheers.

Mark S…

6

On 6/17/06, James B. [email protected] wrote:

Nicholas E. wrote:

Howdy Mark,
Have you run rdoc over the main Ruby lib dir to generate the ri datafile?

run rdoc --help (or whatever gets you a help listing) and see what the
magic incantation is for creating the ri files.

Hi All,

James, which dir of these two should rdoc be run in? Cheers.

/usr/lib/ruby /usr/local/lib/ruby

Mark S…

7

On 6/20/06, Mark S. [email protected] wrote:

James, which dir of these two should rdoc be run in? Cheers.

/usr/lib/ruby /usr/local/lib/ruby

Hi All,

ok, I’ve run rdoc in both, and still not able to run ri “something”. Any
other suggestions? Cheers.

Below is the last section of the rdoc process,

Generating HTML…

Files: 521
Classes: 1385
Modules: 791
Methods: 6922
Elapsed: 471.739s

Mark S…

8

On 6/16/06, Mark S. [email protected] wrote:

Hi All,

[snip]
See issue below,

]$ ri array
No ri documentation found in:

Was rdoc run to create documentation?

try

$ ri Array

—John

9

On 6/21/06, John G. [email protected] wrote:

try

$ ri Array

Hi All,

thanx, I also tried that after somoene pointed it out to me somewhere
else.
I eventually ditched the rpm install and went source. All is well now.
Thanx. Cheers.

Mark S…

10

Mark S. wrote:

On 6/20/06, Mark S. [email protected] wrote:

James, which dir of these two should rdoc be run in? Cheers.

/usr/lib/ruby /usr/local/lib/ruby

Um, whichever has the Ruby C source code.

Hi All,

ok, I’ve run rdoc in both, and still not able to run ri “something”. Any
other suggestions? Cheers.

rdoc with the arg to tell it to generate ri files? Because otherwise it
only generates the rdoc HTML files.

run this:

rdoc --help

And look for these:

–ri-site, -R
–ri-system, -Y

I think you want -Y

(“This option is intended to be used during Ruby installations”)

–
James B.

http://www.ruby-doc.org - Ruby Help & Documentation
Ruby Code & Style - The Journal By & For Rubyists
http://www.rubystuff.com - The Ruby Store for Ruby Stuff
http://www.30secondrule.com - Building Better Tools