more comments in the class javadoc