RFR: JDK-8280492: Address remaining doclint issues in JDK build

[Joe Darcy]

On Mon, 24 Jan 2022 11:33:18 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> > Use presumed syntax that will be introduced by JDK-8280488.
> 
> Is that a wrong bug? If you are talking about module-prefix syntax for links, then it was introduced in JDK 15; JDK-8164408: Add module support for @see, @link and @linkplain javadoc tags.

Ah; thanks Pavel for the additional context. Bug JDK-8280488 will allow (i.e. ignore) cross-module @see/@link references during javac compilation. So while the syntax in this PR is already valid per JDK-8164408, I cannot (yet) enable the "reference" doctlint check in the javac build due to the cross-module situation.

I'll double-check the syntax in this PR generates the expected links in the result of the docs builds, give the bug a more descriptive title, and get these changes pushed. Enabling the reference warning can be done under another bug.

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

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