JDK-8194692 : javadoc: mark the com.sun.javadoc API for removal
  • Type: CSR
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P2
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 11
  • Submitted: 2018-01-06
  • Updated: 2018-01-11
  • Resolved: 2018-01-10
Related Reports
CSR :  
JDK-8194651 - javadoc: mark the com.sun.javadoc API for removal
Description
Summary
-------

Mark the APIs in com.sun.javadoc API for removal.

Problem
-------

The com.sun.javadoc API has been superceded by the jdk.javadoc API, and is no longer being updated for new language features. 

Solution
--------
The API has already been deprecated in JDK 9. In JDK 11, the API should be marked for removal.


Specification
-------------

The specification with the removal changes are attached for reference it is available here:
http://cr.openjdk.java.net/~ksrini/8194651/specdiff.out/overview-summary.html
Comments
Voting to approve. (Noting that since we intent to keep supporting the jdk.javadoc.doclet package in the same jdk.javadoc module, the jdk.javadoc module itself should *not* be deprecated.)
10-01-2018
Ooops, sorry about that, have attached it now.
08-01-2018
Please attach a webrev or specdiff of the changes; for archival purposes a link to the specdiff is convenient, but not sufficient. I expect to approve the CSR after the attachment is added.
08-01-2018