summaryrefslogtreecommitdiff
path: root/build.xml
diff options
context:
space:
mode:
authorJaikiran Pai <jaikiran@apache.org>2019-03-19 13:12:26 +0530
committerJaikiran Pai <jaikiran@apache.org>2019-03-19 13:12:26 +0530
commitc8e0adbd2af78f43dbc8158970c38eeb41bb5c6c (patch)
treea18a24f4d207d7b38e4d6c2d01b2c082a08717ec /build.xml
parent9d98adbb5b0bf567055bb012db893d2cb629a0bc (diff)
downloadant-c8e0adbd2af78f43dbc8158970c38eeb41bb5c6c.tar.gz
Use -html4 for javadoc generation
javadoc in our classes don't yet comply to html5 semantics. When generating javadocs for our project, using JDK 11, we run into build failures since JDK 11 javadoc tool defaults to html5 output and is strict if the classes don't comply to the semantics. The commit here explicitly sets the output to html4 to avoid such failures, till we fix our javadoc to comply with html5
Diffstat (limited to 'build.xml')
-rw-r--r--build.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/build.xml b/build.xml
index 6f7fc08c3..6ea84ef73 100644
--- a/build.xml
+++ b/build.xml
@@ -1503,6 +1503,14 @@
<patternset refid="useful.tests"/>
</srcfiles>
</uptodate>
+ <!-- Javadoc on classes in Ant project, don't (yet) comply to HTML5
+ semantics. javadoc tool in JDK 9+ allows specifying the HTML version
+ to use for the output generation. We intentionally set it to -html4
+ to prevent javadoc tool failures (in JDK 11, which is strict) when
+ running against our code -->
+ <condition property="javadoc.output.htmlversion" value="-html4" else="">
+ <isset property="jdk9+"/>
+ </condition>
</target>
<target name="javadocs" depends="check-javadoc"
@@ -1535,6 +1543,7 @@
<group title="Optional Types" packages="org.apache.tools.ant.types.optional*"/>
<group title="Ant Utilities" packages="org.apache.tools.ant.util*"/>
<classpath refid="tests-classpath"/>
+ <arg line="${javadoc.output.htmlversion}"/>
</javadoc>
</target>