updating the javadocs