RFR: 8263102: Expand documention of Method.isBridge [v2]

[liach]

On Tue, 9 Mar 2021 01:58:38 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Improve linkage for isSynethetic.
>
> src/java.base/share/classes/java/lang/reflect/Method.java line 597:
> 
>> 595:      * <p>Bridge methods may also be used by Java compiler in other
>> 596:      * circumstances to span across difference in Java Language
>> 597:      * semantics and JVM semantics.
> 
> If you decide to put less detail here, you could start with this statement. I think the main point is that there are some semantic gaps between methods in the Java language and in the JVM; bridge methods are necessary to "span" this gap. You might simply list some examples without explaining them fully.
> 
> Would this be "used by **a** Java compiler" or "used by **the** Java compiler?

Imo "created" should be better. Is there any case where a java compiler accepts bridge methods generated?

-------------

PR: https://git.openjdk.java.net/jdk/pull/2852