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

Remove support for the "old" doclet API in com.sun.javadoc.*

    Details

    • Type: CSR
    • Status: Closed
    • Priority: P3
    • Resolution: Approved
    • Fix Version/s: 13
    • Component/s: tools
    • Labels:
      None
    • Subcomponent:
    • Compatibility Risk:
      medium
    • Compatibility Risk Description:
      This will affect any remaining clients of the old API, which will no longer be supported.
    • Interface Kind:
      Java API

      Description

      Summary

      Remove support for the now-unsupported "old" doclet API

      Problem

      The version of the javadoc "doclet" API that was in use up to JDK 8 was superseded by a new API in JDK 9, and a corresponding new "Standard Doclet". The old Standard Doclet has already been removed; the old API has been retained somewhat longer in case there are other doclets in use using the API. However, the API is old, unsupported and does not support newer language features, like modules, and newer javadoc tags.

      Solution

      Remove the old API in com.sun.javadoc.*, and the old entry point, com.sun.tools.javadoc.Start

      An off-brand use of the old API was as an early "Language Model" API. But javax.lang.model has been available as a first-class supported Language Model API since JDK 6.

      Specification

      The primary change is about removing the old API. There are some residual references in the remaining API that need to be updated.

      Specification attached, also available at

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                jjg Jonathan Gibbons
                Reporter:
                jjg Jonathan Gibbons
                Reviewed By:
                Priya Lakshmi Muthuswamy (Inactive)
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: