Cleanup and corrections to the Javadocs to match the code.

Fixed references to old Boolean store flag with proper storeMode
in the Constructors for RecordDescriptor

Updates to README