On Mon, 24 Jan 2022 11:33:18 GMT, Pavel Rappo <pra...@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

Reply via email to