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

Details

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

    Description

      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

      Attachments

        Issue Links

          Activity

            People

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

              Dates

                Created:
                Updated:
                Resolved: