xml-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Glenn Marcy" <gma...@us.ibm.com>
Subject Re: New SAX2 release out
Date Thu, 18 Oct 2001 05:18:39 GMT

Well, it doesn't seem too terrible at first glance.  They have the
fix for XML-Commons defect #4129, but not for defect #4130.

Do you have a proposal w.r.t. the XMLReaderFactory comment:

 * <p><strong>Note to Distributions bundled with parsers:</strong>
 * You should modify the implementation of the no-arguments
 * <em>createXMLReader</em> to handle cases where the external
 * configuration mechanisms aren't set up.  That method should do its
 * best to return a parser when one is in the class path, even when
 * nothing bound its class name to <code>org.xml.sax.driver</code> so
 * those configuration mechanisms would see it.</p>

Sounds like some decision needs to be made for Xerces in this regard.

I am somewhat concerned with the light-hearted reference to "doc
bugs".  People have generally considered the SAX2 JavaDoc to be
the "gospel" when it comes to what the implementation is supposed
to do.  Changing some of those comments to add, remove or change
the behavior of SAX is not something I am happy about without some
more background on who reported these supposed bugs...

Some examples are:

In DTDHandler.notationDecl:

     * If a system identifier is present, and it is a URL, the SAX
     * parser must resolve it fully before passing it to the
     * application through this event.</p>
     * When a system identifier is present, applications are responsible
     * for knowing if it is used as a URL, and absolutizing it against
     * the appropriate URI when appropriate.

In InputSource:

 * <p>An InputSource object belongs to the application: the SAX parser
 * shall never modify it in any way (it may modify a copy if
 * necessary).</p>
 * <p>An InputSource object belongs to the application: the SAX parser
 * shall never modify it in any way (it may modify a copy if
 * necessary).  However, standard processing of both byte and
 * character streams is to close them on as part of end-of-parse cleanup,
 * so applications should not attempt to re-use such streams after they
 * have been handed to a parser.  </p>

I am not trying to argue for or against these changes, but to raise some
awareness to the fact that changes to SAX need to be taken seriously.


                    Edwin Goei                                                           
                    <edwingo@sun.c       To:     general@xml.apache.org               
                    om>                  cc:     xml-commons-dev@xml.apache.org,      
                                          "xerces-j-dev@xml.apache.org" <xerces-j-dev@xml.apache.org>
                    10/17/2001           Subject:     New SAX2 release out               
                    08:19 PM                                                             
                    Please respond                                                       

Hi all,

There is a new SAX2 release out.  Checking this into xml-commons and
other projects that use SAX could fix reported bugs.  I'd like to
propose that this gets integrated into xml-commons and other projects
such as xerces 1, xerces 2, and xalan 2.  Comments?

----- Message from David Brownell <david-b@pacbell.net> on Wed, 17 Oct 2001
16:29:46 -0700 -----
      To: sax-announce@lists.sourceforge.net,          
      cc: xml-dev@lists.xml.org                        
 Subject: [Sax-announce] SAX2 r2 pre2 release          

There's a new SAX2 release available for download, see


Or jump directly to the downloads page


See the release notes.  Think of it as "SAX 2.0.1 beta2";
it's got no API changes, but includes fixes for all the bugs that
have been reported.  A fair number of those were doc bugs,
but not all.

The release is in the form of a JAR file that includes source,
javadoc, and a pre-built "sax.jar" file.

What I'm looking for with this release is reports of problems
that would prevent this code from becoming "SAX 2.0.1";
as well as any other bugs that haven't yet been reported.

- Dave

Sax-announce mailing list

In case of troubles, e-mail:     webmaster@xml.apache.org
To unsubscribe, e-mail:          general-unsubscribe@xml.apache.org
For additional commands, e-mail: general-help@xml.apache.org

View raw message