getting ri working on FreeBSD

[Chad Perrin]

I seem to have run into a small problem on FreeBSD. Hopefully, someone
here has an answer. (Note: cross-posted to freebsd-questions list)

No matter what I try to look up with ri (the Ruby information utility
that is used to look up stuff about classes, methods, et cetera, from the
command line), it returns the same result:

ri Time.strftime

Nothing known about Time.strftime

I don't see anything in /usr/ports/lang that seems to relate to the
matter of ensuring ri has a database of information to share. What
am I missing? How can I get ri working properly on FreeBSD?

 

[Chad Perrin]

I seem to have run into a small problem on FreeBSD. Hopefully, someone
here has an answer. (Note: cross-posted to freebsd-questions list)

No matter what I try to look up with ri (the Ruby information utility
that is used to look up stuff about classes, methods, et cetera, from the
command line), it returns the same result:

Nothing known about Time.strftime

I don't see anything in /usr/ports/lang that seems to relate to the
matter of ensuring ri has a database of information to share. What
am I missing? How can I get ri working properly on FreeBSD?

I managed to get it working. Apparently, I had to run:
# tar jxvf /usr/ports/distfiles/ruby/ruby-1.8.6.tar.bz2
# rdoc --ri -R -U ruby-1.8.6/

. . but there didn't appear to be any documentation for that in any
easily discoverable location.

 

[barjunk]

I seem to have run into a small problem on FreeBSD. Hopefully, someone
here has an answer. (Note: cross-posted to freebsd-questions list)

No matter what I try to look up with ri (the Ruby information utility
that is used to look up stuff about classes, methods, et cetera, from the
command line), it returns the same result:
Nothing known about Time.strftime

I don't see anything in /usr/ports/lang that seems to relate to the
matter of ensuring ri has a database of information to share. What
am I missing? How can I get ri working properly on FreeBSD?

I managed to get it working. Apparently, I had to run:
# tar jxvf /usr/ports/distfiles/ruby/ruby-1.8.6.tar.bz2
# rdoc --ri -R -U ruby-1.8.6/

. . but there didn't appear to be any documentation for that in any
easily discoverable location.

--
CCD CopyWrite Chad Perrin [http://ccd.apotheon.org]
Leon Festinger: "A man with a conviction is a hard man to change. Tell him
you disagree and he turns away. Show him facts and figures and he questions
your sources. Appeal to logic and he fails to see your point."

Chad,

Where did you end up finding information about that...especially the -
U switch.

Mike B.

 

[Chad Perrin]

Where did you end up finding information about that...especially the -
U switch.

Enter "rdoc --help" or "rdoc -h" at the command line to get information
about the CLI arguments available for rdoc.

It was actually someone else on the freebsd-questions mailing list that
pointed me in the right direction, through a series of hunches.
Attempting to run "ri -c" (something I had not yet tried) gave a faint
hint, which led to another faint hint, and from there we found our way to
the rdoc help to sort out what to do to build the ri database. It was
kind of like a very brief, and interesting, scavenger hunt -- which can
be fun, but isn't really the best way to document a fundamentally
necessary feature.

At this point, I'm not sure whether the problem is a FreeBSD issue or a
Ruby packaging issue, so I haven't decided to make any bug reports or
anything like that (since I don't know yet where to send them, not
knowing who's responsible for this bug).

 

[Ryan Zezeski]

--
CCD CopyWrite Chad Perrin [http://ccd.apotheon.org]
Leon Festinger: "A man with a conviction is a hard man to change. Tell him
you disagree and he turns away. Show him facts and figures and he questions
your sources. Appeal to logic and he fails to see your point."

Chad,

Where did you end up finding information about that...especially the -
U switch.

Mike B.

You can run rdoc -h for a list of the commands.

I think you may want to use -Y instead of -R because you are building
the documentation for the standard classes.

# rdoc --ri -Y -U ruby-1.8.6

I've just started using FreeBSD (6.2) as of a week ago, but I would
think the port should do this automatically? I looked at the
/usr/ports/lang/ruby18 and it seems to have an option to build/install
the documentation. There is also /usr/ports/lang/ruby-doc-stdlib, but I
didn't try building it.

 

[Chad Perrin]

--
CCD CopyWrite Chad Perrin [http://ccd.apotheon.org]
Leon Festinger: "A man with a conviction is a hard man to change. Tell him
you disagree and he turns away. Show him facts and figures and he questions
your sources. Appeal to logic and he fails to see your point."

Chad,

Where did you end up finding information about that...especially the -
U switch.

Mike B.

You can run rdoc -h for a list of the commands.

I think you may want to use -Y instead of -R because you are building
the documentation for the standard classes.

I wish I'd known that before I ran the command with -R.

# rdoc --ri -Y -U ruby-1.8.6

I've just started using FreeBSD (6.2) as of a week ago, but I would
think the port should do this automatically? I looked at the
/usr/ports/lang/ruby18 and it seems to have an option to build/install
the documentation. There is also /usr/ports/lang/ruby-doc-stdlib, but I
didn't try building it.

I don't recall that being an option at the time I installed Ruby. C'est
la vie.

 

[Eric Hodel]

I seem to have run into a small problem on FreeBSD. Hopefully,
someone
here has an answer. (Note: cross-posted to freebsd-questions list)

No matter what I try to look up with ri (the Ruby information utility
that is used to look up stuff about classes, methods, et cetera,
from the
command line), it returns the same result:

Nothing known about Time.strftime

I don't see anything in /usr/ports/lang that seems to relate to the
matter of ensuring ri has a database of information to share. What
am I missing? How can I get ri working properly on FreeBSD?

cd /usr/ports/lang/ruby
WITH_RDOC=yes make install

 

[barjunk]

barjunkwrote:

--
CCD CopyWrite Chad Perrin [http://ccd.apotheon.org]
Leon Festinger: "A man with a conviction is a hard man to change. Tell him
you disagree and he turns away. Show him facts and figures and he questions
your sources. Appeal to logic and he fails to see your point."
Chad,
Where did you end up finding information about that...especially the -
U switch.
Mike B.

You can run rdoc -h for a list of the commands.

I think you may want to use -Y instead of -R because you are building
the documentation for the standard classes.

I wish I'd known that before I ran the command with -R.

# rdoc --ri -Y -U ruby-1.8.6

I've just started using FreeBSD (6.2) as of a week ago, but I would
think the port should do this automatically? I looked at the
/usr/ports/lang/ruby18 and it seems to have an option to build/install
the documentation. There is also /usr/ports/lang/ruby-doc-stdlib, but I
didn't try building it.

I don't recall that being an option at the time I installed Ruby. C'est
la vie.

Interestingly:

rdoc --ri -Y -U ruby-1.8.6

gives me:

invalid option -- U

For help on options, try 'rdoc --help'


I'm using RDoc V1.0.1 - 20041108, which i think comes with ruby 1.8.4.

Mike B.