RFR: JDK-8280488: doclint reference checks withstand warning suppression [v2]

Joe Darcy darcy at openjdk.java.net
Fri Jan 28 02:12:11 UTC 2022


On Wed, 26 Jan 2022 16:46:23 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).
>
> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
> 
>   fix typos

FYI, the build completes with the changes in this PR, expanding the target set of of SuppressWarnings (JDK-8280744), and https://github.com/openjdk/jdk/pull/7237.

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

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


More information about the javadoc-dev mailing list