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

[David Holmes]

On Mon, 23 Sep 2024 10:35:44 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> 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.

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

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