update comments for javadoc