RFR: JDK-8280488: doclint reference checks withstand warning suppression

[Joe Darcy]

On Wed, 26 Jan 2022 02:20:24 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> Please review a small modification to the way that bad references are reported by DocLint.
> 
> A new "mode" is introduced, `strictReferenceChecks`.   
> 
> If the mode is _not_ set, references that explicitly include a module name when that module name is not resolved in the module graph will be reported with a (suppressible) warning instead of an error.  All other issues with references will be reported as errors. This is the mode used by javac.
> 
> If the mode is set, all issues with references will be reported as errors. This is the mode used by javadoc.
> 
> This will need to be documented in the tool guide (man page).

Question: for the JDK use case in particular, to turn all the doclint warning on during compilation, the cross-module references need to be SuppressWarning'ed?

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

PR: https://git.openjdk.java.net/jdk/pull/7222