RFR: 8349373: Support JavaFX preview features [v3]

[Kevin Rushforth]

On Wed, 12 Mar 2025 14:24:08 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

> > Should we specify that the `@Deprecated` annotation on preview features be marked as `forRemoval=true`
> 
> wouldn't this send a wrong message?

Yes, that's the main counter-argument. Unlike incubator modules, which necessarily need to move elsewhere when finalized, there is a very good chance that a preview feature API will not change. So let's shelf the notion of `forRemoval=true`.

> could we invent a new annotation `@Preview` ?

That's an interesting idea, but probably not, at least not without a lot more effort. We would need to ship the annotation as part of `javafx.base`, since it would need runtime retention (so that javac and IDEs would be able to display it). We would also need to add a similar javadoc tag.

@mstr2 I presume you initially considered something like this?

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

PR Comment: https://git.openjdk.org/jfx/pull/1359#issuecomment-2718126813