docs/readme.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE s1 SYSTEM 'dtd/document.dtd'>
<s1 title='&ParserNameLong; Readme'>
 <s2 title='&ParserNameLong; &ParserVersion; Release'>
  <p>
   Welcome to the future! Xerces2 is the next generation of
   high performance, fully compliant XML parsers in the Apache
   Xerces family. This new version of Xerces introduces the
   Xerces Native Interface (XNI), a complete framework for
   building parser components and configurations that is
   extremely modular and easy to program. 
  </p>
  <p>
   The Apache Xerces2 parser is the reference implementation 
   of XNI but other parser components, configurations, and parsers
   can be written using the Xerces Native Interface. For complete
   design and implementation documents, refer to the 
   <link idref='xni'>XNI Manual</link>.
  </p>
  <p>
   <strong>Note:</strong> Since this is a beta release, bugs are
   to be expected. Please use 
   <jump href='http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Xerces2-J'>BugZilla</jump>
   to report any bugs that you find.
  </p>
 </s2>
 <s2 title='Features of This Release'>
  <p>
   The &ParserNameLong; &ParserVersion; supports the
   following standards and APIs:
  </p>
  <ul>
   <li>
    <jump href='http://www.w3.org/XML/'>eXtensible Markup Language</jump>
    (XML) 1.0 
    <jump href='http://www.w3.org/TR/2000/REC-xml-20001006'>Second 
    Edition</jump> Recommendation
   </li>
   <li>
    <jump href='http://www.w3.org/TR/REC-xml-names/'>Namespaces
    in XML</jump> Recommendation
   </li>
   <li>
    <jump href='http://www.w3.org/DOM/'>Document Object Model</jump>
    (DOM) Level 2
    <jump href='http://www.w3.org/TR/DOM-Level-2-Core/'>Core</jump>,
    <jump href='http://www.w3.org/TR/DOM-Level-2-Events'>Events</jump>,
    and
    <jump href='http://www.w3.org/TR/DOM-Level-2-Traversal-Range'>Traversal
    and Range</jump> Recommendations
   </li>
   <li>
    <jump href='http://sax.sourceforge.net/'>Simple API for XML</jump>
    (SAX) 2.0
    <jump href='http://prdownloads.sourceforge.net/sax/sax2-r2pre2.jar'>Core</jump>,
    and
    <jump href='http://prdownloads.sourceforge.net/sax/sax2-ext-1.0.zip'>Extension</jump>
   </li>
   <li>
    <jump href='http://java.sun.com/xml/xml_jaxp.html'>Java APIs for 
    XML Processing</jump> (JAXP) 1.1
   </li>
   <li>
    <jump href='http://www.w3.org/XML/Schema'>XML Schema</jump> 1.0
    <jump href='http://www.w3.org/TR/xmlschema-1/'>Structures</jump>
    and
    <jump href='http://www.w3.org/TR/xmlschema-2/'>Datatypes</jump>
    Recommendations
   </li>
   
  </ul>
 </s2>
 <s2 title='Changes from Previous Release'>
  <p>
   Xerces2 release includes full XML Schema support with completely redesigned and rewritten XML Schema validation engine. For more information, refer to the 
   <link idref='limitations-schema'>XML Schema Implementation</link> page. 
  </p>
  <p>
   This release also provides a partial implementation of Document Object Model Level 3  
    <jump href='http://www.w3.org/TR/2001/WD-DOM-Level-3-Core-20010913/'>Core</jump>, 
    <jump href='http://www.w3.org/TR/2001/WD-DOM-Level-3-ASLS-20011025/abstract-schemas.html'>Abstract Schemas</jump> and 
    <jump href='http://www.w3.org/TR/2001/WD-DOM-Level-3-ASLS-20011025/load-save.html'>Load and Save</jump> Working Drafts. For more information, refer to the 
   <link idref='dom3'>DOM Level 3 Implementation</link> page. 
  </p>
  <p>
   The &ParserNameLong; &ParserVersion; introduced some changes to the Xerces Native
   Interface. The following list enumerates the important changes:
  </p>
  <ul>
   <li>The <code>Augmentations</code> interface was added to the core XNI interfaces.
   </li>
   <li>
    The <code>XMLDocumentHandler</code> interface was modified to include <code>Augmentations</code> as an extra parameter for parser events. Getter methods were added to the <code>XMLAttributes</code> to query the <code>Augmentations</code>. 
   </li>

   <li>
    The PSVI interfaces were added as an extention to the core XNI (still under development).
   </li>
  </ul>
  <p>
   For a more complete list of changes, refer to the 
   <link idref='releases'>Release Information</link> page.
  </p>	      
 </s2>
 <s2 title='Changes from Xerces 1.x'>
  <p>
   Xerces2 is a nearly complete rewrite of the Xerces 1.x codebase
   in order to make the code cleaner, more modular, and easier to
   maintain. Applications using only the standard interfaces such as
   JAXP, DOM, and SAX should not see any differences.
  </p>
 </s2>
 <s2 title='License Information'>
  <p>
   The &ParserName; &ParserVersion; release is available
   in source code and precompiled binary (JAR files) form. 
   Both &ParserName; packages are made available under the 
   <jump href='http://xml.apache.org/LICENSE'>Apache Software
   License</jump>.
  </p>
 </s2>
</s1>