update javadoc comments