[jdk16] RFR: JDK-8258657: Doc build is broken by use of new language features

[Iris Clark]

On Tue, 5 Jan 2021 22:51:29 GMT, Erik Joelsson <erikj at openjdk.org> wrote:

> This patch changes how the docs-reference make target behaves to better support the requirements for it. This target is used to generate javadocs in a more stable way between releases, so that they those docs are better suited for generating diffs between releases. Currently we use the boot JDK to run javadoc for these, but this has shown to be problematic. This patch introduced a specific configure parameter for the JDK to use just for generating these docs. If not set, it will revert to the default interim javadoc, just like the main docs are built (but still with a separate set of parameters).
> 
> This fix needs to go into JDK 16 so that the docs-reference target there can be used to generate diffs for JDK 17.

Do you need to update the copyright year?  Other than that, your changes appear to implement the described behaviour.

Thanks!
Iris

-------------

Marked as reviewed by iris (Reviewer).

PR: https://git.openjdk.java.net/jdk16/pull/88