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