@since specification for preview features

[Jim Laskey]

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 13 tag. 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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/amber-spec-experts/attachments/20200406/4d954c4a/attachment.htm>