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

[Henry Jen]

I don't have a strong preference in this case, and I hear you that those 
classes are public and can be accessed in 1.5 even though it's not part 
of API specification of JDK.

Considered DOM Level 2 is still listed as secondary information, and as 
the document you pointed out, 1.9 is used because that those APIs will 
become official in JDK 9.

Lets give it a couple days before commit this, hopefuly some 
dicussion(along with other cases brought up in this thread[1]) will 
occur and lead to a concensus. Sometime I feel we need a supreme court 
for Java affairs to come out the final ruling on such stuff. :)

[1] 
http://mail.openjdk.java.net/pipermail/core-libs-dev/2014-July/027503.html

Cheers,
Henry



On 07/02/2014 05:12 PM, huizhe wang wrote:
> 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
>>>
>>
>