migration.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">

<s1 title="Migration">
    <s2 title="Migrating from &XercesCName; &XercesCVersion; to &XercesCName; latest code base">
      <p>This document is a discussion of the technical differences between
      &XercesCName; &XercesCVersion; code base and the &XercesCName; latest code base.</p>

      <p>Topics discussed are:</p>
      <ul>
        <li><link anchor="NewFeatures">New features in &XercesCName; latest code base</link></li>
        <li><link anchor="API">Public API Changes in &XercesCName; latest code base</link></li>
        <ul>
            <li><link anchor="NewAPI">New Public API</link></li>
            <li><link anchor="ModifiedAPI">Modified Public API</link></li>
            <li><link anchor="DeprecatedAPI">Deprecated Public API</link></li>
        </ul>
        <li><link anchor="DirChange">Directory change in &XercesCName; latest code base</link></li>
      </ul>
    </s2>

    <anchor name="NewFeatures"/>
    <s2 title="New features in &XercesCName; latest code base">
      <ul>
        <li>SAX2-ext's DeclHandler.</li>
      </ul>
    </s2>

    <anchor name="API"/>
    <s2 title="Public API Changes in &XercesCName; latest code base">

        <p>The following lists the public API changes between the &XercesCName;
           &XercesCVersion; and the &XercesCName; latest code base releases
           of the parser. </p>

        <anchor name="NewAPI"/>
        <s3 title="New Public API">
            <ul>
              <li>SAX2-ext's DeclHandler class.
                  See <jump href="api.html">the API documentation page</jump> for details.</li>
              <li>To support SAX2-ext's DeclHandler, the following new methods are added:</li>
              <ul>
                <li>void DefaultHandler::elementDecl(const XMLCh* const name, const XMLCh* const model)</li>
                <li>void DefaultHandler::attributeDecl(const XMLCh* const eName, const XMLCh* const aName,
                    const XMLCh* const type, const XMLCh* const mode, const XMLCh* const value)</li>
                <li>void DefaultHandler::internalEntityDecl(const XMLCh* const name, const XMLCh* const value)</li>
                <li>void DefaultHandler::externalEntityDecl(const XMLCh* const name, const XMLCh* const publicId,
                    const XMLCh* const systemId)</li>
                <li>DeclHandler* SAX2XMLReader::getDeclarationHandler() const</li>
                <li>void SAX2XMLReader::setDeclarationHandler(DeclHandler* const handler)</li>
                <li>DeclHandler* SAX2XMLReaderImpl::getDeclarationHandler() const</li>
                <li>void SAX2XMLReaderImpl::setDeclarationHandler(DeclHandler* const handler)</li>
              </ul>
            </ul>
        </s3>

        <anchor name="ModifiedAPI"/>
        <s3 title="Modified Public API">
            <ul>
              <li>The namespace-prefixes feature in SAX2 is set to off as default.</li>
            </ul>
        </s3>

        <anchor name="DeprecatedAPI"/>
        <s3 title="Deprecated Public API">
            <ul>
              <li></li>
            </ul>
        </s3>

    </s2>

    <anchor name="DirChange"/>
    <s2 title="Directory change in &XercesCName; latest code base">
      <ul>
        <li>
            A new directory, <em>src/xercesc</em> is created to be the new parent directory to
			all src's direct subdirectories.</li>
        <li>
            Windows application, <br/>
			shall either change the <em>additional include directories </em> setting,
			to "..\..\..\..\..\src\<em>xercesc</em>" (Projects->settings->C/C++->Preprocessor). 
			or <br/>
			change the relevant #include instances, in the source/header files, accordingly, eg <br/>
			#include &lt;util/XMLString.hpp&gt; be changed to <br/>
			#include &lt;<em>xercesc</em>/util/XMLString.hpp&gt; </li>
        <li>
            Unix application, <br/>
			shall either add the line to the Makefile " -I &lt;installroot&gt;/include/<em>xercesc</em>", 
			or <br/>
			change the relevant #include instances in the source/header files as shown above. </li>
      </ul>
    </s2>

    <s2 title="Migration Archive">

       <p>For migration information to &XercesCName; &XercesCVersion; or earlier,
          please refer to <jump href="migrate_archive.html">Migration Archive. </jump></p>

    </s2>

</s1>