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.
Related Reports
Duplicate :  
Relates :  
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.