I believe this looks good for generating the docs. For consumption, we
also need to define a new bundle and configure Jib to upload it.
/Erik
On 2017-10-19 14:30, Magnus Ihse Bursie wrote:
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 needed."
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
WebRev:
http://cr.openjdk.java.net/~ihse/JDK-8189056-reference-javadoc/webrev.01
/Magnus
