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

[Stuart Marks]

On Tue, 9 Mar 2021 03:27:29 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> The existing documentation of Method.isBridge isn't terribly helpful to the reader. This RFE proposes to given a common example of how bridge methods are used. The JLS does *not* have a section discussing bridge methods in detail; bridge methods are a compilation technique for lowering the Java language to the JVM, they are not a language feature per se. The example given is not exhaustive; there can be and are other uses of bridge methods.
>> 
>> Once the text is agreed to; I'll update the copyright year as well.
>
> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Respond to review feedback.

src/java.base/share/classes/java/lang/reflect/Method.java line 579:

> 577:      * Bridge methods are used by Java compilers in various
> 578:      * circumstances to span across differences in Java programming
> 579:      * language semantics and JVM semantics.

Quibble: "span across" => "span"

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

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