JDK-8157606 : deprecate com.sun.javadoc API
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2016-05-23
  • Updated: 2018-01-05
  • Resolved: 2016-05-27
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.
9 b121Fixed
Related Reports
Duplicate :  
Relates :  
Relates :  
Relates :  
This should be done as part of JEP 221, Simplified Doclet API.

We should deprecate the old API types.  This should include the following:

There should be a package-info.java file with an @Deprecated annotation (for completeness) and an @deprecated comment giving details.

In addition, there should be an @Deprecated annotation on each top level type in the com.sun.javadoc package, with a short @deprecated comment referencing the package-info file.
Review: http://mail.openjdk.java.net/pipermail/javadoc-dev/2016-May/000250.html

Suggested text: This package has been superseded by the package jdk.javadoc.doclet, and users are recommended to migrate doclets to the new API. The new API provides support for language features like modules, and improved support for language features like arrays and type annotations. This package will be removed in a future release.