@since specification for preview features

[Alex Buckley]

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
>