RFR: 8246774: Record Classes (final) implementation

Alex Buckley alex.buckley at oracle.com
Thu Sep 24 00:40:11 UTC 2020


On 9/23/2020 5:26 PM, Mandy Chung wrote:
> What is the policy of `@since` release value when a preview API
> becomes final.    I would expect `@since` should be updated from 14
> to 16 because 16 is the Java SE release these APIs are added??

Yes. Per 
http://openjdk.java.net/jeps/12#Specifications-of-Preview-Features :

In particular, all elements of a preview API must have the following 
tags: ... An @since tag that indicates the release when [the API 
element] was first added. *If the API element is eventually made final 
and permanent in Java SE $N, then the @since tag must be changed to 
indicate the $N release (the element's history prior to $N is not of 
long-term interest).*

Alex


More information about the core-libs-dev mailing list