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

[Alan Bateman]

On Tue, 24 Sep 2024 06:19:12 GMT, David Holmes <dholmes 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.

I think you are arguing for an API note in each of these methods to document the rationale for why they are restricted. I don't think it needs to be done here, that is, API notes can be added separately, as needed.

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

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