Removes obsolete flags from rdoc
Updates code sample in README
Starts to clean up the spec_helper and requires.
Adds ability to read the file data stream.

I was indisciplined and there are other refactorings and test improvements
in here as well as the new functionality.