[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openjdk-2d-dev
Subject:    Re: RFR: JDK-8280492: Address remaining doclint issues in JDK build
From:       Joe Darcy <darcy () openjdk ! java ! net>
Date:       2022-01-24 18:25:08
Message-ID: bKU73Xd2TZ0n_rLO9-r27yJipw0eVhMUa6Xlq6-HJ4o=.bae9221e-cbfc-4b25-bb75-0b98b450ed1b () github ! com
[Download RAW message or body]

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


[prev in list] [next in list] [prev in thread] [next in thread]