RFR: JDK-8189056 javadoc target for stable specdiff comparisons

Magnus Ihse Bursie magnus.ihse.bursie at oracle.com
Thu Oct 19 12:30:24 UTC 2017

 From the bug report: "For JSR 383 (Java SE 18.3), we need weekly diffs 
of the Java SE 18.3 API specification. The current "doc-javase" makefile 
target always uses the most recent version of the javadoc tool (i.e. the 
tool that was just built). Unfortunately, this introduces unwanted diffs 
that are due to changes in the javadoc tool's formatting of the 
specification. A means to use a fixed version of the javadoc tool so 
that the only detected changes are those to the specification itself is 

I have introduced a new class of documentation, "docs-reference", that 
will create up-to-date javadoc using the Boot JDK javadoc, and a fixed 
set of options.

Note that this bug is blocked on JDK-8189094 (Change required boot jdk 
to JDK 9). I will await that patch to enter jdk10/master before pushing 
this, but my preliminary testing indicates that there will be no issues. 
(However, with JDK 8 as Boot JDK, this will not work, since the command 
line options is not accepted by JDK 8 javadoc.) If it turns out that 
more fixing is needed, I'll reiterate this review before pushing.

Bug: https://bugs.openjdk.java.net/browse/JDK-8189056


More information about the build-dev mailing list