xerces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bor...@apache.org
Subject svn commit: r903188 - in /xerces/c/trunk/doc: build.xml migration.xml migration_archive.xml readme.xml
Date Tue, 26 Jan 2010 11:51:03 GMT
Author: borisk
Date: Tue Jan 26 11:51:03 2010
New Revision: 903188

URL: http://svn.apache.org/viewvc?rev=903188&view=rev
Log:
Update documentation for the 3.1.0 release.

Modified:
    xerces/c/trunk/doc/build.xml
    xerces/c/trunk/doc/migration.xml
    xerces/c/trunk/doc/migration_archive.xml
    xerces/c/trunk/doc/readme.xml

Modified: xerces/c/trunk/doc/build.xml
URL: http://svn.apache.org/viewvc/xerces/c/trunk/doc/build.xml?rev=903188&r1=903187&r2=903188&view=diff
==============================================================================
--- xerces/c/trunk/doc/build.xml (original)
+++ xerces/c/trunk/doc/build.xml Tue Jan 26 11:51:03 2010
@@ -28,7 +28,6 @@
        <li><link anchor="UNIX">UNIX/Linux/Mac OS X/Cygwin/MinGW</link></li>
        <li><link anchor="Windows">Windows using Microsoft Visual C++</link></li>
        <li><link anchor="BorlandCC">Windows using Borland C++</link></li>
-       <li><link anchor="BorlandBuilder">Windows using Borland C++ Builder</link></li>
     </ul>
 
     <anchor name="UNIX"/>
@@ -290,7 +289,6 @@
             directory:</p>
 
 <source>
-(For VC6)   projects\Win32\VC6\xerces-all\xerces-all.dsw
 (For VC7.1) projects\Win32\VC7.1\xerces-all\xerces-all.sln
 (For VC8)   projects\Win32\VC8\xerces-all\xerces-all.sln
 (For VC9)   projects\Win32\VC9\xerces-all\xerces-all.sln
@@ -324,32 +322,12 @@
                only)" to build all the selected projects in one shot.</p>
     </s3>
 
-    <anchor name="BorlandBuilder"/>
-    <s3 title="Building on Windows using Borland C++ Builder">
-        <p>&XercesCName; source distribution comes with the
-           Borland C++ Builder 6 projects. The following describes the steps you
-           need to build with this compiler.</p>
-
-        <p>The library and example projects are all contained in the
-           Xerces-all project group:
-           <code>&XercesC3SrcInstallDir;\projects\Win32\BCB6\Xerces-all\Xerces-all.bpg</code>.
-	   Each project in the group refers a directory below <code>Xerces-all\</code>.
-	   For example, the XercesLib project files are contained in the directory
-           <code>&XercesC3SrcInstallDir;\projects\Win32\BCB6\Xerces-all\XercesLib</code>.</p>
-
-        <p>To build a project, open the project manager, double click on the project
-           name, and select "Project -> Build" from the menu. For example, double click
-           on XercesLib.dll in the manager then select "Project -> Build XercesLib" from
-           the menu.
-        </p>
-    </s3>
-
     <anchor name="BorlandCC"/>
     <s3 title="Building on Windows using Borland C++">
         <p>&XercesCName; source distribution comes with the Borland C++ makefiles.
The
            following describes the steps you need to build &XercesCName; with this compiler.</p>
         <ol>
-	   <li>Change to the <code>&XercesC3SrcInstallDir;\projects\Win32\BCC.551\Xerces-all</code>
directory</li>
+	   <li>Change to the <code>&XercesC3SrcInstallDir;\projects\Win32\BCC5\Xerces-all</code>
directory</li>
            <li>Run <code>MakeBuildDirs.bat</code></li>
 	   <li><code>make -f Xerces-all.mak</code> to build the library, examples,
and tests.</li>
 	</ol>

Modified: xerces/c/trunk/doc/migration.xml
URL: http://svn.apache.org/viewvc/xerces/c/trunk/doc/migration.xml?rev=903188&r1=903187&r2=903188&view=diff
==============================================================================
--- xerces/c/trunk/doc/migration.xml (original)
+++ xerces/c/trunk/doc/migration.xml Tue Jan 26 11:51:03 2010
@@ -21,105 +21,68 @@
 <s1 title="Migration">
     <s2 title="Migration Archive">
 
-       <p>For migration information to &XercesCName; 2 series or earlier,
+       <p>For migration information on earlier versions of &XercesCName; 2
           please refer to <link idref="migrate-archive-&XercesC3Series;">Migration
Archive</link>.</p>
 
     </s2>
 
-    <s2 title="Migrating from &XercesCName; 2 series to &XercesCName; &XercesC3Version;">
+    <s2 title="Migrating from &XercesCName; 3.0.0 to &XercesCName; &XercesC3Version;">
       <p>The following section is a discussion of the technical differences between
-      &XercesCName; 2 series and &XercesCName; &XercesC3Version;.</p>
+      &XercesCName; 3.0.0 and &XercesCName; &XercesC3Version;.</p>
 
       <p>Topics discussed are:</p>
       <ul>
         <li><link anchor="NewFeatures300">New features in &XercesCName; &XercesC3Version;</link></li>
         <li><link anchor="API300">Public API Changes</link></li>
-        <ul>
-            <li><link anchor="NewAPI300">New Public API</link></li>
-            <li><link anchor="ModifiedAPI300">Modified Public API</link></li>
-            <li><link anchor="DeprecatedAPI300">Deprecated/Removed Public API</link></li>
-        </ul>
       </ul>
 
     <anchor name="NewFeatures300"/>
     <s3 title="New features in &XercesCName; &XercesC3Version;">
       <ul>
-        <li>Autotools-based build system for the UNIX/Linux/Mac OS X platforms</li>
-        <li>Project files for VC++ 9</li>
-        <li>Support for the ICU transcoder in VC++ 7.1, 8, and 9 project files</li>
-        <li>libcurl-based net accessor</li>
-        <li>Support for XInclude in DOM</li>
-        <li>Support for both XPath 1 and XPath 2 models in the DOM XPath interface</li>
-        <li>Support for the XML Schema subset of XPath 1 in DOM</li>
-        <li>Conformance to the final DOM Level 3 interface specification</li>
-        <li>Ability to provide custom DOM memory manager as well as tune the global
DOM heap parameters</li>
-        <li>All public and widely used interfaces as well as a large
-            portion of the implementation were converted to be 64-bit safe.</li>
-        <li>Various XML Schema fixes including the fix for the large
-            maxOccurs and minOccurs bug as well as for the changed ##other
-            interpretation</li>
-        <li>Reviewed and cleaned up diagnostics messages</li>
-        <li>Optimizations for SAX/SAX2 and DOM parsing as well as XML Schema
-            validation</li>
+    <li>Working multi-import support. The support for handling multiple import
+        declarations with the same target namespaces has been improved and
+        thoroughly tested. Furthermore, the same logic was extended to
+        loadGrammar and the schemaLocation attributes so that you can load
+        several schemas with the same namespace and/or "add" more declarations
+        with the schemaLocation attributes. To enable this feature, set the
+        XMLUni::fgXercesHandleMultipleImports feature/parameter to true.
+        Starting with this release all the tests and examples have multi-import
+        support enabled by default.</li>
+
+    <li>New property, XMLUni::fgXercesLowWaterMark, allows to configure the
+        parser buffer low water mark. In particular, setting this value to 0
+        disables data caching in the parser which can be useful if you want
+        the SAX events to be dispatched as soon as the data is available.</li>
+
+    <li>DOMLSParser::parseWithContext implementation. In particular, this
+        functionality allows one to parse a document fragment with missing
+        namespace declarations as long as the context document provides them.</li>
+
+    <li>Improved performance and reduced memory footprint when validating with
+        large maxOccurs values. If available, the SSE2 instructions are used to
+        further speedup this case.</li>
+
+    <li>Improved scalability of the XML Schema identity checking (key, keyref,
+        and unique).</li>
+
+    <li>Multiple XML Schema conformance fixes.</li>
+
+    <li>More robust external library detection (libcurl and ICU). In particular,
+        the build system no longer tries to inject any additional paths such as
+        /usr or /usr/local.</li>
+
+    <li>Compilation of the ICU message loader resources no longer depends on
+        the ICU implementation details.</li>
       </ul>
     </s3>
 
     <anchor name="API300"/>
     <s3 title="Public API Changes">
 
-        <p>&XercesCName; &XercesC3Version; is a major release and includes
-           a number of application-breaking interface changes compared to
-           &XercesCName; 2 series.
-           The following sub-sections provide an overview of the public API
-           changes between &XercesCName; 2 series and this release.</p>
-
-        <anchor name="NewAPI300"/>
-        <s4 title="New Public APIs">
-            <ul>
-              <li>XMLGrammarPoolImpl implementation has been moved to
-                  framework/ and is now publicly accessible</li>
-
-              <li>DOM XPath interfaces now support XPath 2 model</li>
-
-              <li>A number of DOM interfaces (DOMLSInput, DOMLSOuput,
-                  DOMLSParser, DOMLSSerializer, DOMConfiguration, etc.)
-                  were added as part of the the final DOM Level 3
-                  specification conformance work</li>
-            </ul>
-        </s4>
-
-        <anchor name="ModifiedAPI300"/>
-        <s4 title="Modified Public APIs">
-
-          <p>A large number of public APIs have been modified. Consult
-             individual interface documentation for details. The following
-             list gives an overview of major changes:</p>
-
-          <ul>
-            <li>Several DOM interfaces have been adjusted to conform to the final
-                DOM Level 3 specification</li>
-
-            <li>DOM XPath interfaces have been adjusted to support both XPath 1
-                and XPath 2</li>
-
-            <li>Many public interfaces that used int/long types to represent
-                memory-related sizes, counts, indexes, etc., have been modified
-                to use the 64-bit safe XMLSize_t type instead</li>
-          </ul>
-
-        </s4>
-
-        <anchor name="DeprecatedAPI300"/>
-        <s4 title="Deprecated/Removed Public APIs">
-          <p>All APIs marked as deprecated in &XercesCName; 2 series have
-             been removed in this release. In particular deprecated DOM
-             (depdom) as well as COM support have been removed.</p>
-
-          <p>Furthermore, a number of DOM interfaces (DOMBuilder, DOMWriter,
-             DOMInputSource, etc.) were replaced as part of the the final
-             DOM Level 3 specification conformance work.</p>
-        </s4>
-
+        <p>&XercesCName; &XercesC3Version; is a minor release and does
+           not include any public API changes that would preclude
+           applications using the previous version of &XercesCName; from
+           building successfully with this version.</p>
     </s3>
     </s2>
 

Modified: xerces/c/trunk/doc/migration_archive.xml
URL: http://svn.apache.org/viewvc/xerces/c/trunk/doc/migration_archive.xml?rev=903188&r1=903187&r2=903188&view=diff
==============================================================================
--- xerces/c/trunk/doc/migration_archive.xml (original)
+++ xerces/c/trunk/doc/migration_archive.xml Tue Jan 26 11:51:03 2010
@@ -21,6 +21,7 @@
 <s1 title="Migration Archive">
     <s2 title="Migrating to earlier Releases">
       <ul>
+	<li><link anchor="Migrateto300">Migrating from &XercesCName; 2.8.0 to 3.0.0</link></li>
         <li><link anchor="Migrateto280">Migrating from &XercesCName; 2.7.0
to 2.8.0</link></li>
         <li><link anchor="Migrateto270">Migrating from &XercesCName; 2.6.0
to 2.7.0</link></li>
         <li><link anchor="Migrateto260">Migrating from &XercesCName; 2.5.0
to 2.6.0</link></li>
@@ -37,6 +38,104 @@
       </ul>
     </s2>
 
+    <anchor name="Migrateto300"/>
+    <s2 title="Migrating from &XercesCName; 2.8.0 to &XercesCName; 3.0.0">
+      <p>The following section is a discussion of the technical differences between
+      &XercesCName; 2.8.0 and &XercesCName; 3.0.0.</p>
+
+      <p>Topics discussed are:</p>
+      <ul>
+        <li><link anchor="NewFeatures300">New features in &XercesCName; 3.0.0</link></li>
+        <li><link anchor="API300">Public API Changes</link></li>
+        <ul>
+            <li><link anchor="NewAPI300">New Public API</link></li>
+            <li><link anchor="ModifiedAPI300">Modified Public API</link></li>
+            <li><link anchor="DeprecatedAPI300">Deprecated/Removed Public API</link></li>
+        </ul>
+      </ul>
+
+    <anchor name="NewFeatures300"/>
+    <s3 title="New features in &XercesCName; 3.0.0">
+      <ul>
+        <li>Autotools-based build system for the UNIX/Linux/Mac OS X platforms</li>
+        <li>Project files for VC++ 9</li>
+        <li>Support for the ICU transcoder in VC++ 7.1, 8, and 9 project files</li>
+        <li>libcurl-based net accessor</li>
+        <li>Support for XInclude in DOM</li>
+        <li>Support for both XPath 1 and XPath 2 models in the DOM XPath interface</li>
+        <li>Support for the XML Schema subset of XPath 1 in DOM</li>
+        <li>Conformance to the final DOM Level 3 interface specification</li>
+        <li>Ability to provide custom DOM memory manager as well as tune the global
DOM heap parameters</li>
+        <li>All public and widely used interfaces as well as a large
+            portion of the implementation were converted to be 64-bit safe.</li>
+        <li>Various XML Schema fixes including the fix for the large
+            maxOccurs and minOccurs bug as well as for the changed ##other
+            interpretation</li>
+        <li>Reviewed and cleaned up diagnostics messages</li>
+        <li>Optimizations for SAX/SAX2 and DOM parsing as well as XML Schema
+            validation</li>
+      </ul>
+    </s3>
+
+    <anchor name="API300"/>
+    <s3 title="Public API Changes">
+
+        <p>&XercesCName; 3.0.0 is a major release and includes
+           a number of application-breaking interface changes compared to
+           &XercesCName; 2 series.
+           The following sub-sections provide an overview of the public API
+           changes between &XercesCName; 2 series and this release.</p>
+
+        <anchor name="NewAPI300"/>
+        <s4 title="New Public APIs">
+            <ul>
+              <li>XMLGrammarPoolImpl implementation has been moved to
+                  framework/ and is now publicly accessible</li>
+
+              <li>DOM XPath interfaces now support XPath 2 model</li>
+
+              <li>A number of DOM interfaces (DOMLSInput, DOMLSOuput,
+                  DOMLSParser, DOMLSSerializer, DOMConfiguration, etc.)
+                  were added as part of the the final DOM Level 3
+                  specification conformance work</li>
+            </ul>
+        </s4>
+
+        <anchor name="ModifiedAPI300"/>
+        <s4 title="Modified Public APIs">
+
+          <p>A large number of public APIs have been modified. Consult
+             individual interface documentation for details. The following
+             list gives an overview of major changes:</p>
+
+          <ul>
+            <li>Several DOM interfaces have been adjusted to conform to the final
+                DOM Level 3 specification</li>
+
+            <li>DOM XPath interfaces have been adjusted to support both XPath 1
+                and XPath 2</li>
+
+            <li>Many public interfaces that used int/long types to represent
+                memory-related sizes, counts, indexes, etc., have been modified
+                to use the 64-bit safe XMLSize_t type instead</li>
+          </ul>
+
+        </s4>
+
+        <anchor name="DeprecatedAPI300"/>
+        <s4 title="Deprecated/Removed Public APIs">
+          <p>All APIs marked as deprecated in &XercesCName; 2 series have
+             been removed in this release. In particular deprecated DOM
+             (depdom) as well as COM support have been removed.</p>
+
+          <p>Furthermore, a number of DOM interfaces (DOMBuilder, DOMWriter,
+             DOMInputSource, etc.) were replaced as part of the the final
+             DOM Level 3 specification conformance work.</p>
+        </s4>
+
+    </s3>
+    </s2>
+
     <anchor name="Migrateto280"/>
     <s2 title="Migrating from &XercesCName; 2.7.0 to &XercesCName; 2.8.0">
     <p>The following section is a discussion of the technical differences between

Modified: xerces/c/trunk/doc/readme.xml
URL: http://svn.apache.org/viewvc/xerces/c/trunk/doc/readme.xml?rev=903188&r1=903187&r2=903188&view=diff
==============================================================================
--- xerces/c/trunk/doc/readme.xml (original)
+++ xerces/c/trunk/doc/readme.xml Tue Jan 26 11:51:03 2010
@@ -91,7 +91,7 @@
                <li><jump href="http://www.w3.org/TR/2008/REC-ElementTraversal-20081222/">
             	   Element Traversal Specification</jump>, W3C Recommendation 22 December
2008</li>
             </ul>
-            <li>Source code, samples, and documentation is provided</li>
+            <li>Source code, samples, and documentation are provided</li>
             <li>Programmatic generation and validation of XML</li>
             <li>Pluggable catalogs, validators and encodings</li>
             <li>High performance</li>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xerces.apache.org
For additional commands, e-mail: commits-help@xerces.apache.org


Mime
View raw message