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

[Joe Wang]

On 9/14/19 1:08 AM, Alan Bateman wrote:
> On 13/09/2019 21:50, Joe Wang wrote:
>> :
>>
>> It can be said that the SAX project, in terms of the API work, was 
>> dead a long time ago. There hasn't been any updates/changes since SAX 
>> 2.0.2 released in 2004[1]. SAX is in public domain [2]. Sun/Oracle 
>> incorporated SAX2 in Java SE with a GPL license. I assume we're free 
>> to make changes. Please let me know if you think otherwise.
> I'm not objecting to notifying the content handler of declarations. 
> I'm also not discussing licenses. I'm mostly concerned that 
> ContentHandler and all the other classes in this API point the reader 
> to the SAX project as the place to go for documentation and more 
> information. Has there been any effort to find a contact for the SAX 
> project on soucreforge and get them to put an EOL notice on the main 
> page? Alternatively, if the SAX API in Java SE is getting a second 
> wind then maybe the links to the SAX project could be reduced to a 
> historical note.

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.

[1] https://bugs.openjdk.java.net/browse/JDK-8231083

-Joe

>
> -Alan
>
>
>
>