[DERBY-7038] Upgrade ant version and re-write javadoc build targets to use improved <javadoc>task

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.16.1.1
• Fix Version/s: 10.15.2.0, 10.16.1.1
• Component/s: Build tools
• Urgency: Normal
• Assignee: Richard N. Hillegas
• Reporter: Richard N. Hillegas
• Created: 24/Mar/19 20:14
• Updated: 12/Jan/20 18:40
• Resolved: 12/Jan/20 18:40

Description

Version 1.10.6 of ant will enhance the <javadoc> task in order to understand some of the module-aware switches introduced by Java 9. Currently, our javadoc targets work around the limitations of the <javadoc> task by running javadoc via the <java> task. We should upgrade our version of ant and re-write the javadoc targets to take advantage of the improvements introduced by ant 1.10.16 (see https://dist.apache.org/repos/dist/dev/ant/RELEASE-NOTES-1.10.6.html). I imagine this work will occur in 3 phases:

1) Upgrade the Jenkins scripts to require ant 1.10.6.

2) Upgrade our build scripts to require ant 1.10.6.

3) Re-wire our javadoc targets.

Issue Links

• relates to: DERBY-6945 Re-package Derby as a collection of jigsaw modules