update javadoc for latest code changes