error installing RDoc documentation: incompatible

Question

Over the last week, on a few gem install or gem update operations, I've received an error similar to these:

ERROR:  While generating documentation for sinatra-1.3.1 ... MESSAGE:   error generating C:/RailsInstaller/Ruby1.9.2/lib/ruby/gems/1.9.1/doc/sinatra-1.3.1/rdoc/README_de_rdoc.html: incompatible encoding regexp match (UTF-8 regexp with IBM437 string) (Encoding::CompatibilityError)

similarly:

ERROR:  While generating documentation for rest-client-1.6.7 ... MESSAGE:   error generating C:/RailsInstaller/Ruby1.9.2/lib/ruby/gems/1.9.1/doc/rest-client-1.6.7/rdoc/README_rdoc.html: incompatible encoding regexp match (UTF-8 regexp with IBM437 string) (Encoding::CompatibilityError)

and possibly one other place. I've read up on this but don't find a solution for code I did not write and data I don't control. Any idea how to fix this?

Answer 1

On Windows, this worked for me:

> set RDOCOPT="--encoding=UTF-8"
> gem install heroku

Answer 2

I had a similar problem on Ubuntu and updating rubygems itself solved the problem for me. You can do that by entering the following at the command line:

gem update --system

Also, you can always skip the doc generation by using:

--no-rdoc --no-ri

when installing the gem.

Answer 3

michael.rp almost had it, but no quotes on the environment string for Windows. The same solution for Linux appears in the link supplied by jerry. For Windows:

set RDOCOPT=--encoding=UTF-8

I put this in the RubyInstaller\Ruby1.9.3\setup_environment.bat file so it is always there.