RFR: JDK-8316972: Add javadoc support for restricted methods

Tue Oct 17 11:59:08 UTC 2023

On Mon, 16 Oct 2023 13:26:36 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

> Question: we have this section on restricted method in the java/lang/foreign javadoc: https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/package-summary.html#restricted
> 
> Should the text that javadoc generate for restricted method point here? Or should we move this text onto a separate HTML page, and link to that instead? I note that for preview feature we do not link to anywhere else, so maybe what is done in this PR is sufficient.

If also noticed that there is no link for further information about restricted methods. (It's similar for preview APIs, but at least there you have the links to the preview JEPs.) One possible place for such a link would be the new "Restricted Methods" section in the help page. Let me know in case you think there should be a link.

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

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