doc/migration.xml

<?xml version="1.0" standalone="no"?>
<!--
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
-->

<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">

<s1 title="Migration">
    <s2 title="Migration Archive">

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

    </s2>

    <s2 title="Migrating from &XercesCName; 2.7.0 to &XercesCName; &XercesCVersion;">
      <p>The following section is a discussion of the technical differences between
      &XercesCName; 2.7.0 code base and the &XercesCName; &XercesCVersion;.</p>

      <p>Topics discussed are:</p>
      <ul>
        <li><link anchor="NewFeatures280">New features in &XercesCName; &XercesCVersion;</link></li>
        <li><link anchor="API280">Public API Changes</link></li>
        <ul>
            <li><link anchor="NewAPI280">New Public API</link></li>
            <li><link anchor="ModifiedAPI280">Modified Public API</link></li>
            <li><link anchor="DeprecatedAPI280">Deprecated/Removed Public API</link></li>
        </ul>
      </ul>

    <anchor name="NewFeatures280"/>
    <s3 title="New features in &XercesCName; &XercesCVersion;">
      <ul>
        <li>Exponential growth of memory block (from 16KB to 128KB) that are allocated by the DOM heap.</li>
        <li>The NODE_CLONED notification is now sent to each node's user data handler when cloning the entire DOMDocument.</li>
        <li>On Windows extract the registry code page from MIME\Database\Charset\&lt;encoding>\@InternetEncoding instead of MIME\Database\Charset\&lt;encoding>\@Codepage.</li>
        <li>Allow whitespace-only nodes to be added as children of a DOMDocument.</li>
        <li>When a node is cloned or imported the type information (PSVI) is also copied.</li>
        <li>When using SAX2, including XMLReaderFactory to use createXMLReader doesn't include xercesc/parsers/SAX2XMLReaderImpl.hpp anymore. If you need to cast the SAX2XMLReader to SAX2XMLReaderImpl,
            you need to include this header yourself.</li>
      </ul>
    </s3>

    <anchor name="API280"/>
    <s3 title="Public API Changes">

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

        <anchor name="NewAPI280"/>
        <s4 title="New Public API">
            <ul>
              <li>XMLBufferMgr: getBufferCount and getAvailableBufferCount</li>
            </ul>
        </s4>

        <anchor name="ModifiedAPI280"/>
        <s4 title="Modified Public API">
        </s4>

        <anchor name="DeprecatedAPI280"/>
        <s4 title="Deprecated/Removed Public API">
        </s4>

    </s3>
    </s2>

</s1>