RFR: 8263102: Expand documention of Method.isBridge [v5]
Stuart Marks
smarks at openjdk.java.net
Wed Mar 10 00:18:07 UTC 2021
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
More information about the core-libs-dev
mailing list