updated javadoc comments