RFR: 8329644: Discuss expected visitor evolution patterns in javax.lang.model.util

[Pavel Rappo]

On Wed, 17 Apr 2024 14:14:52 GMT, Jan Lahoda <jlahoda at openjdk.org> wrote:

> > I have a few inline comments and a dumb question. The question: what happens if a preview feature exits the preview stage without being promoted to the standard, i.e. the preview feature is dropped?
> 
> When the preview feature is dropped, I would assume the API elements related to it would be removed. The `Preview` help with that, as they stay, only the methods are removed. At least, this is what I would expect.
> 
> Overall, looks reasonable to me. I wonder if the text should say the newly-added API entry points should be marked as preview? I assume it may be difficult to talk explicitly about `@jdk.internal.javac.PreviewFeature` here, but maybe a general note that it should be ensured the entry points are recognized as preview? Or did I miss that? Thanks.

Your latter paragraph is why I asked my question in the first place. If you reflect on an element of a preview feature Y, one could say that you indirectly use that preview feature Y, and so all the terms and conditions for preview features apply. If Y then goes away, you weren't warned/reminded that your code will no longer compile, and that's bad.

Let's wait for Joe to respond.

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

PR Comment: https://git.openjdk.org/jdk/pull/18804#issuecomment-2061502185