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.
More information about the build-dev