From: "Jonas Pfenniger (zimbatm)" <jonas@...>
Date: 2011-01-07T18:14:36+09:00
Subject: Re: gem install

2011/1/7 Brian Smither <bhsmitherINVALID@invalidgmail.com>:
> It's nice where you are given the command line text to use to install a gem
> (see: http://rubygems.org/gems/mysql2), and even more info on the gem's
> homepage (see: https://github.com/brianmario/mysql2 "Installing"). But when
> is this syntax ever going to change?
>
> I would REALLY like it if there were more to "You may have to specify...".
> When? Why? What happens if I don't?

If gem install works, then you don't have to worry about it. It's for
people who install mysql in a non-standard place.

> And I would REALLY like it if explanations of errors were discussed. For
> example:
> Successfully installed mysql2-0.2.6-x86-mingw32
> 1 gem installed
> Installing ri documentation for mysql2-0.2.6-x86-mingw32...
> Enclosing class/module 'mMysql2' for class Client not known
> Installing RDoc documentation for mysql2-0.2.6-x86-mingw32...
> Enclosing class/module 'mMysql2' for class Client not known
>
> Is 'class Client not known' reporting an error, or it supposed to say this
> when things are good?

I agree that this is confusing. The error is generated by the ri and
RDoc generator, which is not able to understand some statement in the
source code. It means that the documentation may not be perfect, but
this doesn't affect the library execution at all.

Cheers,
  zimbatm