A lot of elements that were in preview before the addition of @PreviewFeature have an incorrect `@since` and it should be fixed, alongside different mistakes in the `@since` in some elements.
The current rules for handling `@since` in Preview versions is :
- When an element is still marked as preview, the `@since` should be the first JDK release where the element was added.
- If the element is no longer marked as preview, the `@since` should be the first JDK release where it was no longer preview.
The way preview elements were annotated before:
- in jdk 12-13 they were annotated with @Deprecated(forRemoval=true, since=...)
- in jdk 14-15 they were annotated with @jdk.internal.preview
- in jdk 17 @PreviewFeature was added
The current rules for handling `@since` in Preview versions is :
- When an element is still marked as preview, the `@since` should be the first JDK release where the element was added.
- If the element is no longer marked as preview, the `@since` should be the first JDK release where it was no longer preview.
The way preview elements were annotated before:
- in jdk 12-13 they were annotated with @Deprecated(forRemoval=true, since=...)
- in jdk 14-15 they were annotated with @jdk.internal.preview
- in jdk 17 @PreviewFeature was added
- links to
-
Commit openjdk/jdk/d59c12fe
-
Review(master) openjdk/jdk/18972