improving javadoc