RFR: JDK-8300357: Use generalized see and link tags in java.management

Daniel Fuchs dfuchs at openjdk.org
Wed Jan 18 12:34:28 UTC 2023


On Wed, 18 Jan 2023 00:37:05 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Use new javadoc capabilities courtesy JDK-8200337 to have more-readable-in-javadoc-source links to anchors in several management types. Analogous change is out for review in core libs, JDK-8300133.

src/java.management/share/classes/javax/management/remote/JMXConnectorFactory.java line 140:

> 138:  * implementation may choose to find providers by other means.  For
> 139:  * example, it may support {@linkplain
> 140:  * java.base/java.util.ServiceLoader##developing-service-providers service providers},

is `java.base/` needed here? I am a bit surprised - it's first time I see a module name used in a regular link target.

src/java.management/share/classes/javax/management/remote/JMXConnectorServerFactory.java line 129:

> 127:  * <code>MalformedURLException</code> if there is none.  An
> 128:  * implementation may choose to find providers by other means.  For
> 129:  * example, it may support {@linkplain

Same remark regarding `java.base/` prefix.

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

PR: https://git.openjdk.org/jdk/pull/12058


More information about the serviceability-dev mailing list