JDK-8215584 : Remove support for the "old" doclet API in com/sun/javadoc
  • Type: Sub-task
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 13
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2018-12-19
  • Updated: 2021-05-25
  • Resolved: 2019-02-22
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 13
13 b10Fixed
Related Reports
Blocks :  
JDK-8215608 - Remove old javadoc features
CSR :  
JDK-8215587 - Remove support for the "old" doclet API in com.sun.javadoc.*
Duplicate :  
JDK-8194715 - Remove com.sun.javadoc API and support infrastructure
Relates :  
JDK-8220382 - Cleanup doclet instantiation
Relates :  
JDK-8267708 - Remove references to com.sun.tools.javadoc.**
Relates :  
JDK-8219575 - jdk/javadoc/tool/removeOldDoclet/RemoveOldDoclet test fails in mach5
Description
The old doclet API in com.sun.javadoc.* was superseded by the new doclet API in jdk.javadoc.doclet in conjunction with the existing javax.lang.model API added in JDK 6.

The old API is crufty, and is not up to date with recent language features, like modules. It has been retained for a while to give folk a chance to migrate to other solutions; but that grace period is now over, and the API should be removed.
Comments
The work primarily consists of removing all of the following directories and their contents. src/jdk.javadoc/share/classes/com src/jdk.javadoc/share/classes/com/sun src/jdk.javadoc/share/classes/com/sun/tools src/jdk.javadoc/share/classes/com/sun/tools/javadoc src/jdk.javadoc/share/classes/com/sun/tools/javadoc/main src/jdk.javadoc/share/classes/com/sun/tools/javadoc/resources src/jdk.javadoc/share/classes/com/sun/tools/doclets src/jdk.javadoc/share/classes/com/sun/tools/doclets/standard src/jdk.javadoc/share/classes/com/sun/javadoc There will be residual references in the main program and and related files: $ grep -rl com.sun.javadoc src/jdk.javadoc/share/classes/{module-info.java,jdk} src/jdk.javadoc/share/classes/module-info.java src/jdk.javadoc/share/classes/jdk/javadoc/doclet/package-info.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/package-info.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc_zh_CN.properties src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc.properties src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc_ja.properties src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/HtmlDocletWriter.java $ grep -rl com.sun.tools.doclets src/jdk.javadoc/share/classes/{module-info.java,jdk} src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc_zh_CN.properties src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc.properties src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources/javadoc_ja.properties
19-12-2018