updated the javadocs