[DRILL-8378] Support doing Maven releases using modern JDKs

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 1.20.2
• Fix Version/s: 1.21.0
• Component/s: Tools, Build & Test
• Assignee: James Turton
• Reporter: James Turton
• Created: 28/Dec/22 12:05
• Updated: 08/Feb/23 08:31
• Resolved: 08/Feb/23 08:31

Description

While DRILL-8113 enabled the building of Drill using a modern JDK, more work is required to enable a Maven release of Drill using a modern JDK. Presently, the Maven Release Plugin will fail on Javadoc generation when run with a newer JDK while it succeeds with JDK 8. The failures are due to dependencies missing from the Maven Javadoc Plugin's config which I assume get treated with a more lenient "warn and skip" policy in the javadoc tool shipped with JDK 8 but cause errors in newer JDKs (in my case OpenJDK 17).{}

In particular, the presence of the sourcepath property in the javadoc plugin's config in the root pom causes the default javadoc:javadoc goal to try to generate docs for our src/test packages. Unlike the javadoc:test-javadoc, the javadoc:javadoc goal does not inherit dependencies declared with test scope.

 

Issue Links

• requires: DRILL-8113 Support building with a JDK 8 target using newer JDKs
• supercedes: DRILL-6637 Root pom: Release build needs to remove dep to tests in maven-javadoc-plugin