From: James Herdman <james.herdman@...>
Date: 2009-06-12T00:13:44+09:00
Subject: Re: ri for gems working?

--0016362835a67d114b046c14092b
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

Hi Roger.
Depending on how the documentation for EventMachine was written, your RI
command may not have been enough.

Try running the command "gem server". This will start up a web server that
hosts all of your local RDocs. Point your web browser of choice at
http://localhost:8808. You can find your docs here. Take a look at how
EventMachine does their documentation. That may help you use RI with the
EventMachine docs in the future.

I know the above solution isn't perfect, but given that documentation
quality is highly variable between projects, it's often the best solution.

James H.

On Thu, Jun 11, 2009 at 9:27 AM, Roger Pack <rogerpack2005@gmail.com> wrote:

> For some reason I've never had success with ri + gems
>
> ex:
> rdp@li49-39:~$ gem install eventmachine
> Successfully installed eventmachine-0.12.8
> Installing ri documentation for eventmachine-0.12.8...
> rdp@li49-39:~$ ri EventMachine
> 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.
>
>
>
> shouldn't it have picked up the ri from the gem just installed?
> Just wondering if this is a bug.
> Thanks.
> -=r
> --
> Posted via http://www.ruby-forum.com/.
>
>

--0016362835a67d114b046c14092b--