On Tue, 24 Sep 2024 06:19:12 GMT, David Holmes wrote:
> > It is outside the scope of the javadoc text to state exactly why each
> > restricted method is marked as such.
>
> I don't agree. I think restricted methods should document why they are
> restricted if it is not patently obvious.
I thi
On Mon, 23 Sep 2024 10:35:44 GMT, Maurizio Cimadamore
wrote:
> It is outside the scope of the javadoc text to state exactly why each
> restricted method is marked as such.
I don't agree. I think restricted methods should document why they are
restricted if it is not patently obvious.
--
> This PR moves the section on restricted methods from the the javadoc of
> `java.lang.foreign` package into a standalone static [javadoc
> page](https://cr.openjdk.org/~mcimadamore/jdk/restricted_javadoc_section/docs/api/java.base/java/lang/foreign/doc-files/RestrictedMethods.html).
>
> This is
On Mon, 23 Sep 2024 10:30:18 GMT, Maurizio Cimadamore
wrote:
>> This PR moves the section on restricted methods from the the javadoc of
>> `java.lang.foreign` package into a standalone static [javadoc
>> page](https://cr.openjdk.org/~mcimadamore/jdk/restricted_javadoc_section/docs/api/java.bas
