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

[Maurizio Cimadamore]

On Fri, 4 Oct 2024 16:32:50 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> It will only be `@docRoot` in the JDK, but not in any other code base, and certainly not in that test.

Note: only JDK is allowed to have restricted methods. `@Restricted` is a non-exported JDK annotation. So 3rd party libraries cannot define restricted methods. So, how to render the javadoc for restricted methods is "our own" issue.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21067#discussion_r1787971401