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

[Stuart Marks]

On Tue, 9 Mar 2021 23:38:26 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:
> 
>   Fix typo noted by bpb.

OK just a couple markup comments, otherwise good.

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

> 595:      * and {@code EnumSet<E>} declares its language-level {@linkplain java.util.EnumSet#clone() covariant override}<br>
> 596:      * {@code public EnumSet<E> clone() {...}}<br>
> 597:      * If this technique was being used, the resulting class

Not sure what the preferred code block markup style is here; maybe `<pre>{@code ...}</pre>` instead of `<br>`.

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

Marked as reviewed by smarks (Reviewer).

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