Updated for RDoc 2.5 and various best practices

This pull request includes a ton of work by Erik Hollensbe to cleanup the code base and implement it for RDoc 2.5. It also includes a bunch of work, including documentation, to use various best practices for the manner of gem integration. It's used by the rdbi projects among others, and should be release ready.