Bug ID: JDK-8157606 deprecate com.sun.javadoc API

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

Versions (Unresolved/Resolved/Fixed)

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 9
9 b121Fixed

Related Reports

Duplicate :	JDK-8137067 - Deprecate the old doclet
Relates :	JDK-8157608 - deprecate old entry points for javadoc tool
Relates :	JDK-8194651 - javadoc: mark the com.sun.javadoc API for removal
Relates :	JDK-8157055 - consider unified release notes for deprecated APIs

Description

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.

Comments

Review: http://mail.openjdk.java.net/pipermail/javadoc-dev/2016-May/000250.html

27-05-2016

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.

23-05-2016