JDK 13 RFR of JDK-708660: (reflect) Clarifications to javadoc for getGeneric*Type methods in j.l.r

[Joe Darcy]

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]