update the javadoc