more javadoc improvement