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).
-Alan