Thanks Jim. I recorded this policy in JEP 12, under "Relationship to
Java SE APIs":
"The API developer must also add an @since tag that indicates the
release when @preview was first added. (If the essential API element is
eventually made final and permanent in Java SE $Z, then the @since tag
must be changed to indicate the $Z release.)"
Alex
On 4/6/2020 10:03 AM, Jim Laskey wrote:
FTR: A question was raised about which Java version should be used with
the @since tag of method associated with a preview feature. The evident
answer is that while previewing, that the value should be the version of
Java where the preview feature was introduced. When the feature becomes
standard, then the value should be the Java version where the feature
became standard.
Ex. Text Blocks became a preview feature in JDK 13, thus
String::stripIndent had a @since 13tag. Since, Text Blocks continued as
preview feature in JDK 14 and the tag remained the same. When Text
Blocks become standard in JDK 15, the tag in String::stripIndent will
become @since 15.
Cheers,
-- Jim
