update some Javadoc