RFR: 8037948: Improve documentation for org.w3c.dom package

[Henry Jen]

On 06/30/2014 12:26 PM, Lance Andersen wrote:
>
> On Jun 30, 2014, at 3:22 PM, huizhe wang <huizhe.wang at oracle.com>
> wrote:
>
>>
>> On 6/30/2014 12:20 PM, Lance Andersen wrote:
>>> Looks OK Joe,  noticed the @since changed as well?
>>
>> Thanks for review.
>>
>> Yes. The support for DOM L3 was since JDK 1.5. Previously this
>> package file mentioned only DOM L2.
>
> OK, thank you.  Just seemed strange that the overall version was
> changed as I suspect L3 is compatible with L2.  I might have just
> indicated that L3 was added in 1.5 as the support was initially in
> 1.4 I believe.  I have no strong preference though

I agree with Lance here, the package itself is included in JDK since 1.4.

In case classes under this package is not properly labeled with @since 
tag, they will be considered has the same @since as package.html, then 
that would be really misleading.

Cheers,
Henry