JDK-8192849 : Add @since and default methods of Compiler Tree API methods.
  • Type: CSR
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P3
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 10
  • Submitted: 2017-11-30
  • Updated: 2017-12-04
  • Resolved: 2017-12-01
Related Reports
CSR :  
JDK-8184683 - Add @since tags and default methods for some elements in Compiler Tree API
Description
Summary
-------

Add default methods for new-in-9 DocTreeVisitor methods.

Problem
-------
 
@since and default methods were missed for several APIs introduced in JDK 9

Solution
--------

Add the necessary  @since tags @implSpec tags and default methods for
those APIs that were missed in JDK 9.

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

For convenience the specification is provided here: 
http://cr.openjdk.java.net/~ksrini/8184683/specdiff.out/overview-summary.html
Comments
Given the expected usage of the API, keeping the current behavior in the concrete visitor and adding default interface methods which throw an exception is reasonable. Moving to Approved.
01-12-2017
Attached specdiff.zip
01-12-2017
The CSR needs to include some persistent representation of the change, such as an inline diff or attached specdiff. A URL to cr.openjdk.java.net is a good convenience, but not sufficient. Pending the request until a persistent version of the diff is added.
30-11-2017