update changelog
polish javadocs