RFR [14/java.xml] 8230814: Enable SAX ContentHandler to handle XML Declaration

Joe Wang huizhe.wang at oracle.com
Tue Sep 17 16:26:30 UTC 2019


On 9/17/19 3:00 AM, Alan Bateman wrote:
> On 16/09/2019 19:25, Joe Wang wrote:
>> :
>>
>> I deliberately left the javadoc in the SAX package as they are. But I 
>> agree it may be worth it to address this aspect of the document. I 
>> suggest we do so with a separate doc-only request[1] to clarify the 
>> relationship with the SAX project, likely adding a short note in the 
>> package description and removing all other references. If you are 
>> okay, I'll keep this changeset the way it is, limiting it to the new 
>> method.
> A separate issue is fine but I think important to do it in the same 
> release where the APIs diverge to avoid confusing the reader (by 
> redirecting them to stale API docs).

Agree, will do it next while we all are here on the issue.

-Joe
>
> -Alan



More information about the core-libs-dev mailing list