7a163ec05c
2002-12-19 Anthony Green <green@redhat.com> * Makefile.am (ordinary_java_source_files): Add org/xml/sax/helpers/NewInstance.java. * Makefile.in: Rebuilt. * org/xml/sax/package.html, org/xml/sax/ext/package.html, org/xml/sax/helpers/package.html: New files. * org/xml/sax/*: Upgrade to SAX 2.0.1 release from http://www.saxproject.org. From-SVN: r60350
50 lines
1.7 KiB
HTML
50 lines
1.7 KiB
HTML
<HTML><HEAD>
|
|
|
|
</HEAD><BODY>
|
|
|
|
<p>
|
|
This package contains interfaces to optional SAX2 handlers.
|
|
|
|
<p>See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
|
|
for more information about SAX.</p>
|
|
|
|
<p>
|
|
The package is independent of the SAX2 core, though the functionality
|
|
exposed generally needs to be implemented within a parser.
|
|
That independence has several consequences:</p>
|
|
|
|
<ul>
|
|
|
|
<li>SAX2 drivers are <em>not</em> required to recognize these handlers,
|
|
and you cannot assume that the class files will be present in every SAX2
|
|
installation.</li>
|
|
|
|
<li>This package may be updated independently of SAX2 (i.e. new
|
|
handlers may be added without updating SAX2 itself).</li>
|
|
|
|
<li>The handlers are not implemented by the SAX2
|
|
<code>org.xml.sax.helpers.DefaultHandler</code> or
|
|
<code>org.xml.sax.helpers.XMLFilterImpl</code> classes.
|
|
You can subclass these if you need such behaviour.</li>
|
|
|
|
<li>The handlers need to be registered differently than regular SAX2
|
|
handlers.</li>
|
|
|
|
</ul>
|
|
|
|
<p>This package, SAX2-ext, is a standardized extension to SAX2. It is
|
|
designed both to allow SAX parsers to pass certain types of information
|
|
to applications, and to serve as a simple model for other SAX2 parser
|
|
extension packages. Not all such extension packages should need to
|
|
be recognized directly by parsers, however.
|
|
As an example, most schema systems can be cleanly layered on top
|
|
of parsers supporting the standardized SAX2 interfaces. </p>
|
|
|
|
<p><strong>NOTE:</strong> this package alone does add any
|
|
functionality; it simply provides optional interfaces for SAX2 drivers
|
|
to use. You must use a SAX2 driver that recognizes these interfaces if
|
|
you actually want to have access to lexical and declaration
|
|
information.</p>
|
|
|
|
</BODY></HTML>
|