adding updated javadocs