[JAVA-1410] Documenting org.bson.BSON; refactoring BSONOldTest so that encoding and decoding hooks are more clearly tested/documented; made StringRangeSet package protected, moved it into the package that needs it, and massively simplified it; added a test for ClassMap to clearly document its functionality.