improved class javadoc