JEP draft: Prepare to Restrict The Use of JNI

[Maurizio Cimadamore]

On 24/08/2023 15:04, Volker Simonis wrote:
> My question is why not making a "real" public like e.g
> "java.lang.preview.PreviewFeature" but export it only to "java.*" such
> that it can be documented properly in the API docs and also appears on
> all the relevant classes/methods in the API doc?

We're going a bit in circles, in the sense that you keep bringing up the 
"public annotation", but I keep asking is really: how would that 
decision affect javadoc? Is there anything in the documentation of 
_preview_ API methods you find suboptimal? We have added quite a lot of 
bells and whistles to javadoc to have special sections on preview API 
methods and there's no reason we cannot do the same for restricted 
methods. The discussion on whether the annotation should itself be 
visible or not in the javadoc is, IMHO, missing the mark.

Maurizio