It's been a long time since the revolution in Ruby documentation that magic/help was. And today there's a big new release.
magic/help uses many interesting heuristics to look for documentation. Often it is able to find the right documentation when plain ri wouldn't. Unfortunately there seem to be a major mismatch between the reality and Ruby documentation. One good example are
SomeClass.new methods. They are all documented, but none of them exists ! In reality there's only
Class.new, that calls
SomeClass.initialize. So magic/help "correctly" returned documentation for
Class.new when asked about
SomeClass.new. That was the worst case, but there are many more.
In new release magic/help is much smarter. It is now able to handle many quirks it previously couldn't. It is tested against full documentation database - and it doesn't make even a single mistake now.
magic/help now comes in tarball, zip, and gem formats.
So just grab it, install the gem, and add the following to your
require 'rubygems' require 'magic_help'