adjusted javadoc