RFR: 8338596: Clarify handling of restricted and caller-sensitive methods [v3]

[David Holmes]

On Mon, 23 Sep 2024 08:42:43 GMT, Alan Bateman <alanb at openjdk.org> wrote:

> Is your ask that the javadoc generated text inline this, or the equivalent by change the method description of each restricted method? 

I admit I had missed the fact there would be some auto-generated text and links in the API docs for `System.loadLibrary`, as I've stated before I was basing this on how CS is handled in specific CS methods. A prominent link to the "restricted method" text may suffice, though at the moment the restricted method text doesn't seem to talk about simple native method calls at all, so the reason for `loadLibrary` being restricted is not at all obvious IMO.

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

PR Comment: https://git.openjdk.org/jdk/pull/21067#issuecomment-2367720802