RFR: 8358701: Java API docs for javax.management.remote should not link to JMXMP

[Daniel Fuchs]

On Fri, 6 Jun 2025 07:54:38 GMT, Kevin Walls <kevinw at openjdk.org> wrote:

> Doc-only cleanup, not part of the API/spec.
> 
> Remove link to the very old reference implementation of JMXMP in the Javadoc.  This may misleadingly imply it is a supported part of the JDK.

src/java.management/share/classes/javax/management/remote/package-info.java line 56:

> 54:  *     JMXConnectorFactory} and, optionally, the Generic Connector
> 55:  *     (not part of this bundle, see note below).
> 56:  *     </ul>

I wonder if we should keep the first part of the note - without the link. Something like:


 *
 *       <p><u>Note</u>: The historical JMX Remote API specification
 *         also defined an optional part; optional packages implementing
 *         the optional part of the <em>JMX Remote API</em>
 *         are not part of the <em>Java SE Platform</em>.</p>
 *
 ```
 
 @AlanBateman do you think that would be helpful to keep?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25670#discussion_r2131740357