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
