RFR: 8049109: Add @since 1.9 to new packages added in jaxp

huizhe wang huizhe.wang at oracle.com
Thu Jul 3 00:12:53 UTC 2014


These packages were defined in JDK 1.5 / JAXP 1.3 (JSR 206). In that 
sense, they were in JDK since 1.5.

For reasons I don't know, they were excluded from the Java API 
Documentation. From the tag conventions 
<http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@since> 
[1], you may be right since it "Specify the product version when the 
Java name was added to the API specification". But it can be confusing 
to users since they've been using them since JDK 1.5

[1] 
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@since

-Joe

On 7/2/2014 3:43 PM, Joe Darcy wrote:
> Looks good Henry; cheers,
>
> -Joe
>
> On 07/02/2014 02:45 PM, Henry Jen wrote:
>> Hi,
>>
>> Related to JDK-8023276[1] where we added two packages to JDK 9, we 
>> should update @since to have 1.9 value as well.
>>
>> http://cr.openjdk.java.net/~henryjen/jdk9/8049109/0/webrev/
>>
>> [1] https://bugs.openjdk.java.net/browse/JDK-8023276
>>
>> Cheers,
>> Henry
>>
>




More information about the core-libs-dev mailing list