Hello,
Given upcoming deadlines and the scope of the feedback suggested, I
propose pushing the "type parameters" => "type arguments" fix under
JDK-708660 in JDK 13 and then reworking the type annotation vs
declaration annotation structure for both core reflection and
javax.lang.model in JDK 14 (under separate bugs).
It is fair for the top-level interfaces to more fully discuss type vs
declaration annotations. Such top-level discussion is a complement to
introducing a statement of the type vs declaration distinction in the
method-as-implemented/overridden-in-this-paricular-type since the latter
provides better discoverability for developers.
Thanks,
-Joe
On 6/10/2019 12:16 PM, Alex Buckley wrote:
On 6/8/2019 4:04 PM, Joe Darcy wrote:
Please review the doc clarifications to address
JDK-708660: (reflect) Clarifications to javadoc for getGeneric*Type
methods in j.l.r
webrev: http://cr.openjdk.java.net/~darcy/7086604.0/
specdiff:
http://cr.openjdk.java.net/~darcy/7086604.0.specdiff/overview-summary.html
A few comments on the changes:
* The phrasing "type arguments" rather than "type parameters" is used as
appropriate.
Great!
[snip]
