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

Henry Jen henry.jen at oracle.com
Mon Jun 30 19:35:46 UTC 2014

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.


More information about the core-libs-dev mailing list