Bump jacoco to 0.8.4
[odlparent.git] / NEWS.rst
index a0b397bf4ef09bf5fac2c71610fb0c3367ddd160..bfecfd776b8f98f174d2175ae722604033ee0f16 100644 (file)
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -2,6 +2,373 @@
 ODL Parent release notes
 ========================
 
+Version 5.0.1
+-------------
+
+This is a bug-fix upgrade from version 5.0.0.
+
+Third-party dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following dependencies have been upgraded:
+
+* Akka 2.5.21 → 2.5.23, release notes:
+  * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
+  * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
+
+* asciidoctorj-diagram 1.5.12 → 1.5.16
+
+* Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
+
+* commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
+
+* Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
+
+* Jolokia `1.6.0 → 1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
+
+* Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
+
+* Netty 4.1.34 → 4.1.36, release notes:
+  * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
+  * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
+
+* Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
+
+* scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
+
+* Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
+
+* Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
+
+* XBean finder 4.12 → 4.14, release notes:
+  * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
+  * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
+
+* Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
+
+Plugin upgrades
+~~~~~~~~~~~~~~~
+
+* maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
+  * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
+  * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
+
+* maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
+
+* maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
+
+* maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
+
+* maven-help-plugin `3.1.1 → 3.2.0 <https://blog.soebes.de/blog/2019/04/22/apache-maven-help-plugin-version-3-dot-2-0-released/>`__
+
+* maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
+
+* maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
+
+* maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
+
+* maven-surefire-plugin 2.22.1 → 2.22.2
+
+New features
+~~~~~~~~~~~~
+
+* ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
+  along with the Guava compabitility layer.
+
+Version 5.0.0
+-------------
+
+This is a major upgrade from version 4, with breaking changes; projects will
+need to make changes to upgrade to this version.
+
+The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
+which removes JSR305 from default dependencies and does not present it at class path by default.
+
+Deleted artifacts
+~~~~~~~~~~~~~~~~~
+
+``findbugs`` has been removed, as its only purpose was to provide FindBugs
+rule definitions. Equivalent definitions are available in ``spotbugs``.
+
+Bug fixes
+~~~~~~~~~
+
+* ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
+  across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
+  to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
+
+* ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
+  which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
+
+* Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
+  and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
+
+* Karaf log file rollover was not explictly set up, leading to inability to easily override
+  the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
+
+* Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
+  See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
+
+* ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
+  to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
+  in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
+  not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
+
+Upstream version removals
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following upstream dependencies have been removed from dependency management:
+
+* cassandra-driver-core
+
+* org.codehaus.enunciate/enunciate-core-annotations
+
+* org.jboss.resteasy/jaxrs-api
+
+* org.json/json
+
+* org.osgi/org.osgi.compendium
+
+Removed features
+~~~~~~~~~~~~~~~~
+
+* odl-jersey-1
+
+* ``features-akka`` feature repository has been integrated into ``features-odlparent``
+
+Third-party dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following dependencies have been upgraded:
+
+* apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
+
+* Aeron 1.12.0 → 1.15.3, release notes:
+  * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
+  * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
+  * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
+  * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
+  * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
+  * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
+
+* Agrona 0.9.27 → 0.9.33, release notes:
+  * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
+  * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
+  * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
+  * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
+  * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
+  * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
+
+* Akka 2.5.19 → 2.5.21, release notes:
+  * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
+  * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
+
+* antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
+
+* asciidoctorj-diagram 1.5.11 → 1.5.12
+
+* Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
+
+* checkstyle 8.16 → 8.18, release notes:
+  * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
+  * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
+
+* commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
+
+* Google Error Prone 2.3.2 → 2.3.3
+
+* Google Guava 25.1 → 27.1, release notes:
+  * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
+  * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
+  * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
+  * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
+
+* Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
+
+* h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
+
+* Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
+
+* Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
+
+* log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
+
+* Mockito 2.23.4 → 2.25.0, release notes:
+  * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
+  * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
+
+* Netty 4.1.32 → 4.1.34, release notes:
+  * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
+  * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
+  * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
+
+* OSGi 5.0.0 → 6.0.0
+
+* Powermockito 1.7.4 → 2.0.0, release notes:
+  * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
+  * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
+  * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
+
+* SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
+
+* ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
+
+* Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
+
+Plugin removals
+~~~~~~~~~~~~~~~
+
+* gmaven-plugin
+
+* maven-findbugs-plugin
+
+Plugin upgrades
+~~~~~~~~~~~~~~~
+
+* jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
+
+* maven-invoker-plugin `3.1.0 → 3.2.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201901.mbox/%3Cop.zvzdg9tbkdkhrr@desktop-2khsk44%3E>`__
+
+* maven-javadoc-plugin `3.0.1 → 3.1.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201903.mbox/%3C6064d830-474c-4b43-afef-99502c3a305a%40getmailbird.com%3E>`__
+
+* spotbugs-maven-plugin 3.1.8 → 3.1.11
+
+Version 4.0.9
+-------------
+
+This is a bug-fix upgrade from version 4.0.8.
+
+Bug fixes
+~~~~~~~~~
+
+* ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
+  patched features to be overwritten with their stock versions, referencing
+  bundles which were not populated in the local repository. (See
+  `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
+
+* ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
+  plugin management so downstreams can override it without needing
+  to repeat its configuration.
+
+* ``karaf-plugin`` no longer reads features twice when running discovery,
+  speeding up the process a bit.
+
+* Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
+  can’t use the 1.7.25 implementation we provide; we therefore provide an
+  implementation of 1.8 beta 2 when SpotBugs is used. (See
+  `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
+
+New features
+~~~~~~~~~~~~
+
+* ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
+  us by Karaf.
+
+Version 4.0.8
+-------------
+
+This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
+
+Bug fixes
+~~~~~~~~~
+
+* ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
+  need to ship both; we now only ship the former. In addition, we install the
+  Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
+  the boot classpath (JDK 9 removes the extension mechanism which was used
+  previously), and provide the corresponding bundles from the boot classpath
+  instead of using separate JARs in the system repository. (See
+  `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
+  `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
+
+* A dependency check has been added to ensure that we don’t run into the
+  TrieMap dependency bug in 4.0.6 again.
+
+* Dependencies pulled in by features are now checked for convergence, and
+  ``karaf-plugin`` warns when it finds diverging dependencies (the same
+  artifact with two different versions). Upstream-provided features are
+  patched to avoid the following divergences (and upgrade some dependencies in
+  the process):
+
+  * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
+  * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
+  * Commons Codec 1.8/1.10 (upgraded to 1.11).
+  * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
+
+  (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
+
+New features
+~~~~~~~~~~~~
+
+* ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
+  available in dependency management).
+
+* ``enunciate-maven-plugin`` is added as the replacement for
+  ``maven-enunciate-plugin``.
+
+Third-party dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following dependencies are no longer provided by the JVM, starting with
+version 11, but we make them available via dependency management for projects
+which need them:
+
+* ``javax.annotation-api``.
+
+* JAXB (``jaxb-core``, ``jaxb-impl``).
+
+The following dependencies have been upgraded:
+
+* Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
+
+* Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
+
+* ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
+
+* Immutables 2.7.1 → 2.7.3:
+
+  * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
+  * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
+
+  (2.7.4 breaks our Javadocs.)
+
+* Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
+
+Version 4.0.7
+-------------
+
+This is a bug-fix release, correcting the ``triemap`` import declaration.
+
+Version 4.0.6
+-------------
+
+This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
+
+Bug fixes
+~~~~~~~~~
+
+Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
+release adds the additional JVM configuration needed.
+
+Third-party dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This release adds the ``triemap`` BOM to dependency management.
+
+Version 4.0.5
+-------------
+
+This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
+`broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
+need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
+
+Version 4.0.4
+-------------
+
+This is a bug-fix release, reverting the change made in 4.0.3 to handle
+building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
+builds in our infrastructure, without the empty Karaf archive).
+
 Version 4.0.3
 -------------