Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8358759

Remove misleading javax.management.remote API doc wording about JMX spec, and historic link to JMXMP

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Unresolved
    • Icon: P3 P3
    • 25, 26
    • core-svc
    • None
    • behavioral
    • minimal
    • Documentation clarification, not an API spec change.
    • Other
    • SE

      Summary

      Wording in javax.management.remote package description is updated to more accurately reflect our commitments.

      Problem

      The phrase "specification of this functionality is completed by Part III of the JMX Specification, version 1.4" is misleading, and should be removed, to avoid implying that our implementation is extended by the historical spec.

      Mentioning the historic JMXMP Connector and Generic Connector, and having links to the very old JMX Remote reference implementation in the Javadoc, may misleadingly imply these are a supported part of the JDK. These should be removed.

      Solution

      Documentation update.

      Specification

      Attached image: management_remote_doc_3.png

      Current published docs reference: https://docs.oracle.com/en/java/javase/24/docs/api/java.management/javax/management/remote/package-summary.html

      Attached diff: 8358759.diff

      Github for reference: https://github.com/openjdk/jdk/pull/25670

            kevinw Kevin Walls
            kevinw Kevin Walls
            Alan Bateman, Daniel Fuchs
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: