JDK-8145470 : enhance javadoc treatment of deprecated APIs
  • Type: Sub-task
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • Submitted: 2015-12-15
  • Updated: 2017-05-11
  • Resolved: 2016-09-07
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.
Other
tbd_majorResolved
Related Reports
Duplicate :  
JDK-8162674 - change javadoc output text and style emitted by for-removal deprecations
Relates :  
JDK-8141099 - [javadoc] Remove support for @deprecated tags on packages.
Description
javadoc will need to be enhanced in a variety of ways to handle the enhanced deprecation annotations. Of particular note is the new forRemoval element of the @Deprecated annotation. There are a couple ideas:

1) Change the wording of the text that's inserted into the specification of an API that is deprecated for removal. The wording should make clear that the API is to be removed, and it should be made stronger. The formatting could also be changed in order to attract more attention.

2) The list of deprecated APIs should note the forRemoval status of the API as well as displaying the text of the "since" element of the @Deprecated annotation.