On Sat, 21 Mar 2026 13:01:59 GMT, Marcono1234 <[email protected]> wrote:
>> We should fix the return type of `DynamicCallSiteDesc.bootstrapMethod`;
>> luckily we can do this without breaking binary compatibility.
>
> src/java.base/share/classes/java/lang/constant/DynamicCallSiteDesc.java line
> 221:
>
>> 219: * An implementation of {@code DynamicCallSiteDesc} in Java may
>> declare a
>> 220: * non-exported supertype declaring the method above to support
>> reference
>> 221: * to that method (JLS {@jls 13.4.12}).
>
> Are these `@implSpec` and `@implNote` tags really needed? For users they will
> be quite confusing.
>
> And `DynamicCallSiteDesc` is `final`, so this would mostly be relevant for
> re-implementations of the JDK (?) or rewrites of this class?
Yes, implSpec and implNote are for implementations of the Java SE Platform.
Rules concerning subclasses in public are part of the regular API
specifications.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/30351#discussion_r2969580293
