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?

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?