From: Jano Svitok <jan.svitok@...>
Date: 2008-03-02T04:34:51+09:00
Subject: Re: gem mysql install error

On Sat, Mar 1, 2008 at 4:25 AM, Tim <TimWelsh5@gmail.com> wrote:
> I tried installing the mysql gem like so:
>
>  -----------------
>  C:\Documents and Settings\Tim>gem install mysql
>  Select which gem to install for your platform (i386-mswin32)
>   1. mysql 2.7.3 (mswin32)
>   2. mysql 2.7.1 (mswin32)
>   3. mysql 2.7 (ruby)
>   4. mysql 2.6 (ruby)
>   5. Skip this gem
>   6. Cancel installation
>  > 1
>  Successfully installed mysql-2.7.3-mswin32
>  Installing ri documentation for mysql-2.7.3-mswin32...
>  Installing RDoc documentation for mysql-2.7.3-mswin32...
>  While generating documentation for mysql-2.7.3-mswin32
>  ... MESSAGE:   Unhandled special: Special: type=17, text="<!-- $Id:
>  README.html,
>  v 1.20 2006-12-20 05:31:52 tommy Exp $ -->"
>  ... RDOC args: --op c:/ruby/lib/ruby/gems/1.8/doc/mysql-2.7.3-mswin32/
>  rdoc --exc
>  lude ext --main README --quiet ext README docs/README.html
>  (continuing with the rest of the installation)
>
>  C:\Documents and Settings\Tim>
>  -----------------
>
>  Apparently, the rdoc documentation doesn't install correctly.  When I
>  click on mysql's rdoc link from the RubyGems Documentation Index, it
>  just says webpage not found.  Is there some way to install this
>  documentation?  Or failing that, is the documentation somewhere on the
>  web?
>
>  Also, I am a ruby newbie so I don't know where to find the ri
>  documentation which seemingly *was* installed.  And does ri =
>  reference implementation?

1. you can most probably generate the rdocs from the installed gem - run "rdoc"
somewhere in the mysql gem directory (I don't have my kmachine here,
so I can't tell you more now).

2. for ri documentation, there's ri command, e.g. "ri Array" or
"String#length". You may want to try fast-ri
(http://eigenclass.org/hiki/fastri)