SAX feature documentation in docs/features.html

Michael Glavassevich <[email protected]> Wed, 17 Mar 2004 17:18:00 -0500
Newsgroups gmane.text.xml.sax.devel
Message-ID <OFAF9DAAA4.92B215CD-ON85256E5A.00775489-85256E5A.007A7069@ca.ibm.com>
Hi everyone,

Regarding the note on docs/features.html being the canonical location for 
feature documentation, this document doesn't contain any of the features 
and properties for the extensions, for instance lexical-handler isn't 
there nor is declaration-handler.  On the web page, resolve-dtd-uris [1] 
is listed as one of the features for SAX2 extensions 1.1.  If that's true 
shouldn't it be documented somewhere. It was in package.html for 
org.xml.sax along with the description of every other feature and 
property.  I understand rolling out the SAX 2.1 stuff, but the file in CVS 
is basically empty now.  SAX 2.0.1 [2] provided the description of all of 
the features and properties in the package description.  It would be good 
to keep this information in the javadoc. I wasn't aware of 
docs/features.html until I looked in CVS.  These docs aren't posted on the 
website (in fact the page on features which is currently there refers to 
the org.xml.sax package description).  They also seem to get separated 
from the API when its distributed, for instance I don't see them in the 
zip for SAX 2.0.1.

[1] http://www.saxproject.org/?selected=ext
[2] 
http://xml.apache.org/xerces2-j/javadocs/api/org/xml/sax/package-summary.html

Michael Glavassevich
XML Parser Development
IBM Toronto Lab
E-mail: [email protected]
E-mail: [email protected]