@since specification for preview features
alex.buckley at oracle.com
Mon Apr 6 17:10:45 UTC 2020
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.)"
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.
> -- Jim
More information about the amber-spec-experts