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

[Jonathan Gibbons]

On Wed, 26 Jan 2022 02:46:45 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> 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?

Only forward references, where the target module is not on the module path, will need a `@SuppressWarnings` annotation.  (For example, a reference to `java.desktop` from `java.base`.   If the cross-module reference is to a module that is on the module path, you will get an error if the reference as whole cannot be resolved. (For a reference to `java.base/java.lang.OObject`  in `java.desktop` (or any module) will always cause an error.

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

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