RFR: JDK-8316972: Add javadoc support for restricted methods [v4]

[Hannes Wallnöfer]

On Mon, 5 Feb 2024 02:11:56 GMT, Luca Kellermann <duke at openjdk.org> wrote:

>> This change seems to result in a wrong `sealed` modifier being added to all restricted methods ([example](https://cr.openjdk.org/~hannesw/8316972/api.00/java.base/java/lang/foreign/AddressLayout.html#withTargetLayout(java.lang.foreign.MemoryLayout)), wasn't there in [Java 21](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/AddressLayout.html#withTargetLayout(java.lang.foreign.MemoryLayout))). My guess to why this is happening is that `com.sun.tools.javac.code.Flags` has the same value for both `SEALED` and `RESTRICTED`.
>
>> My guess to why this is happening is that `com.sun.tools.javac.code.Flags` has the same value for both `SEALED` and `RESTRICTED`.
> 
> If this is the reason, then https://github.com/openjdk/jdk/pull/15964 is probably the real cause. `Flags.RESTRICTED` was added in that PR.

Thanks for the report, @lukellmann. I've filed a bug: https://bugs.openjdk.org/browse/JDK-8325209

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

PR Comment: https://git.openjdk.org/jdk/pull/16188#issuecomment-1926422876