Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8332286 Fix the `@since` tags in java source code documentation
  3. JDK-8329718

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

XMLWordPrintable

    • Icon: Sub-task Sub-task
    • Resolution: Fixed
    • Icon: P4 P4
    • 23
    • None
    • tools
    • b24

      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

            nbenalla Nizar Benalla
            nbenalla Nizar Benalla
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: