updated some javadoc