Integrated: 8329718: Incorrect `@since` tags in elements in jdk.compiler and java.compiler

[Nizar Benalla]

On Fri, 26 Apr 2024 11:05:03 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

> This PR aims to add `@since` tags in elements in both `jdk.compiler` and `java.compiler`.
> A lot of these changes have to do with handling of preview features.
> 
> The existing rules for handling of `@since` for preview elements:
> - 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.
> 
> It is tricky to check these, the way preview elements were annotated before the inroduction of `@Previewfeature` in JDK 17:
> - in jdk 12-13 they were annotated with `@Deprecated(forRemoval=true, since=...)`
> - in jdk 14-15 they were annotated with `@jdk.internal.preview` or with `{@preview Associated with ....` in the `javadoc` comment
> 
> If you're reviewing these changes, Thanks!

This pull request has now been integrated.

Changeset: d59c12fe
Author:    Nizar Benalla <nbenalla at openjdk.org>
Committer: Vicente Romero <vromero at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/d59c12fe1041a1f61f68408241a9aa4d96ac4fd2
Stats:     36 lines in 13 files changed: 25 ins; 0 del; 11 mod

8329718: Incorrect `@since` tags in elements in jdk.compiler and java.compiler

Reviewed-by: darcy, jjg

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

PR: https://git.openjdk.org/jdk/pull/18972