You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by am...@apache.org on 2007/08/24 17:57:45 UTC

svn commit: r569428 [2/2] - in /xerces/c/branches/xerces-2.7/doc: ./ html/ html/apiDocs/ style/dtd/

Modified: xerces/c/branches/xerces-2.7/doc/migration_archive.xml
URL: http://svn.apache.org/viewvc/xerces/c/branches/xerces-2.7/doc/migration_archive.xml?rev=569428&r1=569427&r2=569428&view=diff
==============================================================================
--- xerces/c/branches/xerces-2.7/doc/migration_archive.xml (original)
+++ xerces/c/branches/xerces-2.7/doc/migration_archive.xml Fri Aug 24 08:57:45 2007
@@ -21,9 +21,10 @@
 <s1 title="Migration Archive">
     <s2 title="Migrating to earlier Releases">
       <ul>
+        <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>
         <li><link anchor="Migrateto250">Migrating from &XercesCName; 2.4.0 to 2.5.0</link></li>
-        <li><link anchor="Migrateto240">Migrating from &XercesCName; 2.3.0 to 2.4.0</link></li>      
+        <li><link anchor="Migrateto240">Migrating from &XercesCName; 2.3.0 to 2.4.0</link></li>
         <li><link anchor="Migrateto230">Migrating from &XercesCName; 2.2.0 to 2.3.0</link></li>
         <li><link anchor="Migrateto220">Migrating from &XercesCName; 2.1.0 to 2.2.0</link></li>
         <li><link anchor="Migrateto210">Migrating from &XercesCName; 2.0.0 to 2.1.0</link></li>
@@ -35,6 +36,62 @@
       </ul>
     </s2>
 
+
+    <anchor name="Migrateto270"/>
+    <s2 title="Migrating from &XercesCName; 2.6.0 to &XercesCName; 2.7.0">
+      <p>The following section is a discussion of the technical differences between
+      &XercesCName; 2.6.0 code base and the &XercesCName; 2.7.0.</p>
+
+      <p>Topics discussed are:</p>
+      <ul>
+        <li><link anchor="NewFeatures270">New features in &XercesCName; 2.7.0</link></li>
+        <li><link anchor="API270">Public API Changes</link></li>
+        <ul>
+            <li><link anchor="NewAPI270">New Public API</link></li>
+            <li><link anchor="ModifiedAPI270">Modified Public API</link></li>
+            <li><link anchor="DeprecatedAPI270">Deprecated/Removed Public API</link></li>
+        </ul>
+      </ul>
+
+    <anchor name="NewFeatures270"/>
+    <s3 title="New features in &XercesCName; 2.7.0">
+      <ul>
+        <li>Feature to not generate XML Schema annotations.  That is, not to add them to the grammar.  If you don't need annotations you may want to turn on this feature to avoid memory bloat for XML Schemas that use annotations heavily.</li>
+        <li>Option to skip regenerating the XML Schema annotations when deserializing a grammar.  If you don't need annotations you may want to turn on this option to avoid memory bloat for XML Schemas that use annotations heavily.</li>
+        <li>Feature to not perform default entity resolution.  When the entityResolver returns NULL, the parser doesn't try to resolve the entity externally.</li>
+        <li>Feature to do schema-only validation even if there is a DTD.</li>
+      </ul>
+    </s3>
+
+    <anchor name="API270"/>
+    <s3 title="Public API Changes">
+
+        <p>The following lists the public API changes between the &XercesCName;
+           2.6.0; and the &XercesCName; 2.7.0 releases
+           of the parser. </p>
+
+        <anchor name="NewAPI270"/>
+        <s4 title="New Public API">
+            <ul>
+              <li>XMLString: subString, compareIStringASCII, lowercaseASCII, uppercaseASCII</li>
+              <li>RefHash2KeysTableOf: rehashing support</li>
+              <li>XMemory: placement new and delete</li>
+              <li>SAX2XMLFilter</li>
+            </ul>
+        </s4>
+
+        <anchor name="ModifiedAPI270"/>
+        <s4 title="Modified Public API">
+        </s4>
+
+        <anchor name="DeprecatedAPI270"/>
+        <s4 title="Deprecated/Removed Public API">
+        </s4>
+
+    </s3>
+    </s2>
+
+
 	<anchor name="Migrateto260"/>
 	<s2 title="Migrating from &XercesCName; 2.5.0 to &XercesCName; 2.6.0">
 	<p>The following section is a discussion of the technical differences between
@@ -63,20 +120,20 @@
       <ul>
 		<li>Reduce footprint of DLL by building the deprecated DOM as a separate library</li>
         <li>Improve packaging scripts</li>
-        <li>Enable ID's to work on all kinds of schema components</li>       
-        <li>Add messages to DOMExceptions along with the error code</li>        
-        <li>Improve annotation error-reporting capabilities</li>       
-        <li>Make grammar caching work with DTD internal subsets</li>        
-        <li>Bring parser up to the XML 1.0 3rd Edition</li>        
+        <li>Enable ID's to work on all kinds of schema components</li>
+        <li>Add messages to DOMExceptions along with the error code</li>
+        <li>Improve annotation error-reporting capabilities</li>
+        <li>Make grammar caching work with DTD internal subsets</li>
+        <li>Bring parser up to the XML 1.0 3rd Edition</li>
         <li>Update to the XML 1.1 recommendation</li>
-        <li>Add new method to DOMDocument so that DOM level-2 style DOMDocumentTypes (which have a 
-        DOMDocument to own them) can be created</li>        
-        <li>Feature for disabling identity constraints</li>        
-        <li>Update schema errata</li>         
-        <li>Provide means to get actual values out of PSVI/schema component model</li>      
-        <li>Synthesize annotation components for non-schema attributes</li>        
-        <li>Expose partial PSVIElement information at the start element call</li>           
-        <li>Externalize validation, actual/canonical value production for arbitrary strings</li> 
+        <li>Add new method to DOMDocument so that DOM level-2 style DOMDocumentTypes (which have a
+        DOMDocument to own them) can be created</li>
+        <li>Feature for disabling identity constraints</li>
+        <li>Update schema errata</li>
+        <li>Provide means to get actual values out of PSVI/schema component model</li>
+        <li>Synthesize annotation components for non-schema attributes</li>
+        <li>Expose partial PSVIElement information at the start element call</li>
+        <li>Externalize validation, actual/canonical value production for arbitrary strings</li>
         <li>Laxly validate schema annotations</li>
         <li>Upgrade to ICU 3.0</li>
         <li>Handle elements with a large number of attributes more efficiently</li>
@@ -93,8 +150,8 @@
         <anchor name="NewAPI260"/>
         <s4 title="New Public API">
             <ul>
-              <li>XSValue</li>            
-              <li>IdentityConstraintHandler</li> 
+              <li>XSValue</li>
+              <li>IdentityConstraintHandler</li>
               <li>XMLBufferFullHandler</li>
               <li>XMLString: removeChar, isValidNOTATION</li>
               <li>XMLUri: normalizeUri</li>
@@ -102,7 +159,7 @@
               <li>RefHash family of classes: getHashModulus</li>
               <li>XSAnnotation: setline/col and systemid</li>
               <li>XMLReader: handeEOL</li>
-              <li>XMLChar: isValidNmToken</li>              
+              <li>XMLChar: isValidNmToken</li>
               <li>XMLBigDecimal: parseDecimal, getIntVal</li>
               <li>HexBin: getCanonicalRepresentation, decode</li>
               <li>Base64: getCanonicalRepresentation, decode</li>
@@ -126,12 +183,12 @@
         <anchor name="DeprecatedAPI260"/>
         <s4 title="Deprecated/Removed Public API">
             <ul>
-              <li>XSerializeEngine constructor</li>                
+              <li>XSerializeEngine constructor</li>
               <li>DTDAttDef: getDOMTypeInfoName,  getDOMTypeInfoUri</li>
 			  <li>DTDElementDecl: getDOMTypeInfoName, getDOMTypeInfoUri</li>
      	      <li>SchemaAttDef: setAnyDatatypeValidator</li>
  			  <li>UnionDatatypeValidator: getMemberTypeName, getMemberTypeUri, getMemberTypeAnonymous, getMemberTypeValidator</li>
- 			  <li>XMLAttr: getValidatingTypeURI, getValidatingTypeName, setDatatypeValidator, setSchemaValidated</li>                          
+ 			  <li>XMLAttr: getValidatingTypeURI, getValidatingTypeName, setDatatypeValidator, setSchemaValidated</li>
  			  <li>ComplexTypeInfo: setContentModel</li>
  			  <li>XMLGrammarPool: getXSModel</li>
  			  <li>SAXParser, mark this class deprecated</li>
@@ -140,7 +197,7 @@
 
     </s3>
     </s2>
-    
+
 	<anchor name="Migrateto250"/>
 	<s2 title="Migrating from &XercesCName; 2.4.0 to &XercesCName; 2.5.0">
       <p>The following section is a discussion of the technical differences between
@@ -167,7 +224,7 @@
               <li>Re-pluggable Panic Handler</li>
               <li>Enhenced mutex creation to impove thread safety</li>
               <li>Intrinsic transcoding support for 390.</li>
-              <li>Canonical Representation Support </li>              
+              <li>Canonical Representation Support </li>
               <li>New sample SCMPrint</li>
               <li>New sample PSVIWriter</li>
               <li>New test XSerializerTest</li>
@@ -184,7 +241,7 @@
         <anchor name="NewAPI250"/>
         <s4 title="New Public API">
             <ul>
-              <li></li>            
+              <li></li>
             </ul>
         </s4>
 
@@ -198,13 +255,13 @@
         <anchor name="DeprecatedAPI250"/>
         <s4 title="Deprecated/Removed Public API">
             <ul>
-              <li></li>              
+              <li></li>
             </ul>
         </s4>
 
     </s3>
     </s2>
-    
+
     <anchor name="Migrateto240"/>
     <s2 title="Migrating from &XercesCName; 2.3.0 to &XercesCName; 2.4.0">
       <p>The following section is a discussion of the technical differences between
@@ -225,7 +282,7 @@
     <s3 title="New features in &XercesCName; 2.4.0">
       <ul>
         <li>PSVI</li>
-        <li>Performance enhancement</li>        
+        <li>Performance enhancement</li>
         <li>Stateless Grammar </li>
         <li>Grammar Serialization/Deserialiation</li>
       </ul>
@@ -242,7 +299,7 @@
         <s4 title="New Public API">
             <ul>
               <li>PSVI related</li>
-              <li>Grammar serialization/deserialization related</li>              
+              <li>Grammar serialization/deserialization related</li>
             </ul>
         </s4>
 
@@ -259,7 +316,7 @@
               <li>XMLAttDef: getProvided, getDOMTypeInfoUri, getDOMTypeInfoName, setProvided</li>
               <li>XMLAttDefList: hasMoreElements, nextElement, Reset</li>
               <li>DTDAttDefList: hasMoreElements, nextElement, Reset</li>
-              <li>SchemaAttDefList: hasMoreElements, nextElement, Reset</li>       
+              <li>SchemaAttDefList: hasMoreElements, nextElement, Reset</li>
               <li>XMLElementDecl: LookupOpts</li>
               <li>XMLNumber family: toString</li>
               <li>ENTITYDatatypeValidator: setEntityDeclPool</li>
@@ -269,13 +326,13 @@
               <li>SchemaGrammar: getIDRefList</li>
               <li>SchemaElementDecl: all non thread safe methods </li>
               <li>SchemaAttDef: getters </li>
-              <li>DTDGrammar: getRootElemId</li>                           
+              <li>DTDGrammar: getRootElemId</li>
             </ul>
         </s4>
 
     </s3>
     </s2>
-    
+
     <anchor name="Migrateto230"/>
     <s2 title="Migrating from &XercesCName; 2.2.0 to &XercesCName; 2.3.0">
       <p>The following section is a discussion of the technical differences between
@@ -298,15 +355,15 @@
         <li>Experimental Implementation of Namespaces in XML 1.1 </li>
         <li>Experimental Implementation of XML 1.1: in DOMWriter</li>
         <li>More Schema 1.0 Errata Implementation</li>
-        <li>More DOM L3 Core Support</li>        
+        <li>More DOM L3 Core Support</li>
         <ul>
             <li>DOMConfiguration</li>
             <li>Document Normalization</li>
         </ul>
-        <li>Plugable Memory Manager</li>      
-        <li>Plugable Security Manager</li>      
+        <li>Plugable Memory Manager</li>
+        <li>Plugable Security Manager</li>
         <li>Plugable Panic Handler</li>
-        <li>Logical Path Resolution</li>        
+        <li>Logical Path Resolution</li>
       </ul>
     </s3>
 
@@ -342,7 +399,7 @@
 
     </s3>
     </s2>
-        
+
     <anchor name="Migrateto220"/>
     <s2 title="Migrating from &XercesCName; 2.1.0 to &XercesCName; 2.2.0">
       <p>The following section is a discussion of the technical differences between
@@ -384,9 +441,9 @@
         <li>Support for Linux/390</li>
         <li>Performance: Break Scanner for different functionalities and many other performance improvement</li>
         <li>New feature, "http://apache.org/xml/features/dom/byte-order-mark", allows user to enable
-            DOMWriter to write Byte-Order-Mark in the output XML stream, 
+            DOMWriter to write Byte-Order-Mark in the output XML stream,
             See <jump href="program-dom.html#Byte-Order-Mark">
-            Xercesc Feature: Byte Order Mark</jump> for details</li>        
+            Xercesc Feature: Byte Order Mark</jump> for details</li>
       </ul>
     </s3>
 
@@ -487,7 +544,7 @@
 
     </s3>
     </s2>
-        
+
     <anchor name="Migrateto210"/>
     <s2 title="Migrating from &XercesCName; 2.0.0 to &XercesCName; 2.1.0">
       <p>The following section is a discussion of the technical differences between

Modified: xerces/c/branches/xerces-2.7/doc/readme.xml
URL: http://svn.apache.org/viewvc/xerces/c/branches/xerces-2.7/doc/readme.xml?rev=569428&r1=569427&r2=569428&view=diff
==============================================================================
--- xerces/c/branches/xerces-2.7/doc/readme.xml (original)
+++ xerces/c/branches/xerces-2.7/doc/readme.xml Fri Aug 24 08:57:45 2007
@@ -25,8 +25,11 @@
         <p>&XercesCName; is a validating XML parser written in a portable subset of
         C++.   &XercesCName; makes it easy to give your application the ability to read and write
         <jump href="http://www.w3.org/XML/">XML</jump> data.    A shared
-        library is provided for parsing, generating, manipulating, and validating XML documents.
-        </p>
+        library is provided for parsing, generating, manipulating, and validating XML documents
+        using the DOM, SAX, and SAX2 APIs. For an introduction to programming
+        with &XercesCName; refer to the <jump href="program.html">Programming
+        Guide</jump>.</p>
+
         <p>&XercesCName; is faithful to the
         <jump href="http://www.w3.org/TR/REC-xml">XML 1.0</jump> recommendation
         and many associated standards (see <link anchor="Features">Features</link> below).
@@ -60,8 +63,8 @@
                <li><jump href="http://www.w3.org/TR/2004/REC-xml-20040204/">
                    XML 1.0 (Third Edition)</jump>, W3C Recommendation</li>
 			   <li><jump href="http://www.w3.org/TR/2004/REC-xml11-20040204/">
-                   XML 1.1 (First Edition)</jump>, W3C Recommendation 
-                   (Note: section 2.13 Normalization Checking has not been implemented)</li>                   
+                   XML 1.1 (First Edition)</jump>, W3C Recommendation
+                   (Note: section 2.13 Normalization Checking has not been implemented)</li>
                <li><jump href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/">
                    DOM Level 1 Specification</jump>, W3C Recommendation of October 1, 1998</li>
                <li><jump href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/">
@@ -71,17 +74,17 @@
                    W3C Recommendation of November 13, 2000</li>
                <li><jump href="http://sax.sourceforge.net/">SAX 1.0 and SAX 2.0</jump></li>
                <li><jump href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">
-                   Namespaces in XML</jump>, W3C Recommendation of January 14, 1999</li>    
+                   Namespaces in XML</jump>, W3C Recommendation of January 14, 1999</li>
 	           <li><jump href="http://www.w3.org/TR/xml-names11/">
-                   Namespaces in XML 1.1</jump>, W3C Recommendation</li>                                             
+                   Namespaces in XML 1.1</jump>, W3C Recommendation</li>
                <li><jump href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">
                    XML Schema Part 1: Structure</jump>, W3C Recommendation 2 May 2001</li>
                <li><jump href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">
-                   XML Schema Part 2: Datatypes</jump>, W3C Recommendation 2 May 2001</li>               
+                   XML Schema Part 2: Datatypes</jump>, W3C Recommendation 2 May 2001</li>
             </ul>
             <li>Contains a partial implementation of the
             <jump href="http://www.w3.org/TR/DOM-Level-3-Core/">
-            DOM Level 3.0 Core Specification</jump>, Version 1.0 W3C Working Draft 26 February 2003 
+            DOM Level 3.0 Core Specification</jump>, Version 1.0 W3C Working Draft 26 February 2003
             and
             <jump href="http://www.w3.org/TR/DOM-Level-3-LS/">
             Document Object Model (DOM) Level 3 Load and Save Specification</jump>,

Modified: xerces/c/branches/xerces-2.7/doc/releases_plan.xml
URL: http://svn.apache.org/viewvc/xerces/c/branches/xerces-2.7/doc/releases_plan.xml?rev=569428&r1=569427&r2=569428&view=diff
==============================================================================
--- xerces/c/branches/xerces-2.7/doc/releases_plan.xml (original)
+++ xerces/c/branches/xerces-2.7/doc/releases_plan.xml Fri Aug 24 08:57:45 2007
@@ -34,7 +34,7 @@
 	source compatibility will not be needed, and that "3.0" features will be
 	released in the 2.x line.</p>
 	<p>Further releases in the 2.x line are anticipated concurrent with 3.0 development
-	in order to fix issues or bugs in 2.8.0. Once 3.0 is released, we may also issue
+	in order to fix issues or bugs in 2.x. Once 3.0 is released, we may also issue
 	further 2.x releases as needed by the community.</p>
 	<p>&XercesCName; 2.y.z - as needed to address bugs or other issues.</p>
 	<p>&XercesCName; 3.0 - Targetted roughly for the end of 2007.</p>
@@ -46,7 +46,7 @@
 	It does not include fixing bugs that are opened in Jira; unless such Jira bug
 	involves a major development effort and requires an architectural redesign,
 	or is an enhancement suggestion.</p>
-	
+
 	<p>This list tracks current ideas and developer sign-up for 3.0 features. Some items
 	on this list have no volunteer. Items that have no volunteer will receive no
 	development attention and therefore will not become part of 3.0. If you would
@@ -59,13 +59,13 @@
 			<th>Feature Description</th>
 			<th>Volunteer</th>
 		</tr>
-	
+
 		<tr>
 			<td>1</td>
 			<td>Reorganization of public/private includes</td>
 			<td></td>
 		</tr>
-	   
+
 		<tr>
 			<td>2</td>
 			<td>Revisiting/sanity checking of install locations</td>
@@ -80,7 +80,7 @@
 					Mac re-port/test - James (done)<br/>
 					Windows re-port/test - Alberto<br/>
 					Linux re-port/test: Gareth, Alberto [VMWare (Red Hat 9, Red Hat 7.3) and I can add more],
-						Scott Cantor [test], cargilld [w/ xlC]<br/>					
+						Scott Cantor [test], cargilld [w/ xlC]<br/>
 					Solaris - Scott Cantor [test]<br/>
 					Cygwin - Neil/Alberto (mostly done?)<br/>
 					MingGW - Alberto (mostly done?)<br/>
@@ -89,7 +89,7 @@
 					OS390 - cargilld
 			</td>
 		</tr>
-		
+
 		<tr>
 			<td>4</td>
 			<td>A true autoconf based build infrastructure</td>
@@ -141,13 +141,13 @@
 			<td>Add RelaxNG support</td>
 			<td>(Michael Fuller -- would provide some help)</td>
 		</tr>
-		
+
 		<tr>
 			<td>11</td>
 			<td>Audit/Update of XML Schema support.</td>
 			<td>cargilld</td>
 		</tr>
-		
+
 		<tr>
 			<td>12</td>
 			<td>Const signature changes. [783, 1153, 1223]</td>
@@ -157,14 +157,14 @@
 		<tr>
 			<td>13</td>
 			<td>XML Catalog Support</td>
-			<td></td>       
-		</tr>    
+			<td></td>
+		</tr>
 
 		<tr>
 			<td>14</td>
 			<td>Roll .c code into template headers?</td>
-			<td></td>       
-		</tr>    
+			<td></td>
+		</tr>
 
 		<tr>
 			<th></th><th colspan='2'>Features/APIs to be removed</th>
@@ -183,31 +183,31 @@
 			<td>Remove and/or update deprecated enums</td>
 			<td>Gareth</td>
 		</tr>
-		
+
 		<tr>
 			<td>22</td>
 			<td>Remove non-thread-safe psvi methods</td>
 			<td>Gareth</td>
 		</tr>
-		
+
 		<tr>
 			<td>23</td>
 			<td>Remove Mac OS Classic Support</td>
 			<td>James</td>
 		</tr>
-		
+
 		<tr>
 			<td>24</td>
 			<td>Remove OS/2 (or update it)</td>
 			<td>Alberto</td>
 		</tr>
-		
+
 		<tr>
 			<td>25</td>
 			<td>Remove Borland C++ 4, CodeWarrior, VACPP40 and Unsupported from Windows platform</td>
 			<td>Alberto</td>
 		</tr>
-		
+
 		<tr>
 			<td>26</td>
 			<td>Audit/Potential removal of all deprecated methods</td>
@@ -218,10 +218,10 @@
 			<td>27</td>
 			<td>Remove tests/samples not invoked by sanityTest.pl</td>
 			<td>cargilld / James</td>
-		</tr>		
-																																	 
+		</tr>
+
 	</table>
-	
+
 </s3>
 </s2>
 

Modified: xerces/c/branches/xerces-2.7/doc/style/dtd/entities.ent
URL: http://svn.apache.org/viewvc/xerces/c/branches/xerces-2.7/doc/style/dtd/entities.ent?rev=569428&r1=569427&r2=569428&view=diff
==============================================================================
--- xerces/c/branches/xerces-2.7/doc/style/dtd/entities.ent (original)
+++ xerces/c/branches/xerces-2.7/doc/style/dtd/entities.ent Fri Aug 24 08:57:45 2007
@@ -107,12 +107,12 @@
 <li>Whether you built the &XercesCName; library yourself or used the
 binary distribution</li>
 <li>What happened</li>
-</ul>			
+</ul>
 <p>
 are all necessary information to allow developer to reproduce,
 identify, evaluate and eventually, fix the bug, which is the very
 purpose of your reporting of the bug.
-</p>  
+</p>
 <p>If you are providing a patch please review the information in
 <jump href="faq-contributing.html#Submitting Patches">Submitting Patches</jump>.
 </p>
@@ -152,9 +152,10 @@
 
 <!-- note in build-winunix.xml about building on untested platforms -->
 <!ENTITY build-winunix-note '
-<p>If you are not using any of these compilers, you are taking a calculated risk
-by exploring new grounds. Your effort in making &XercesCName; work on this
-new compiler is greatly appreciated and any problems you face can be addressed
+<p>While older platforms/compilers will most likely work, if you are not using any of
+   these compilers, you are taking a calculated risk
+by exploring untested grounds. Your effort in making &XercesCName; work on
+new platforms/compilers is greatly appreciated and any problems you face can be addressed
 on the <jump href="mailto&colon;&XercesCUserEmailAddress;">&XercesCName; user mailing list</jump>.
 </p>
 '>

Modified: xerces/c/branches/xerces-2.7/doc/xerces-c_book.xml
URL: http://svn.apache.org/viewvc/xerces/c/branches/xerces-2.7/doc/xerces-c_book.xml?rev=569428&r1=569427&r2=569428&view=diff
==============================================================================
--- xerces/c/branches/xerces-2.7/doc/xerces-c_book.xml (original)
+++ xerces/c/branches/xerces-2.7/doc/xerces-c_book.xml Fri Aug 24 08:57:45 2007
@@ -43,13 +43,14 @@
 
   <separator/>
 
-     <group    id="faqs"        label="FAQs">
-        &faq-distrib;
-        <entry id="faq-build"   source="faq-build.xml"/>
-        <entry id="faq-parse"   source="faq-parse.xml"/>
-        <entry id="faq-other"   source="faq-other.xml"/>
-        &faq-contributing;
-     </group>
+     <document id="program"     label="Programming"  source="program.xml"/>
+     <hidden   id="program-sax"           source="program-sax.xml"/>
+     <hidden   id="program-sax2"          source="program-sax2.xml"/>
+     <hidden   id="program-dom"           source="program-dom.xml"/>
+     <hidden   id="dom3"                  source="dom3.xml"/>
+     <hidden   id="program-deprecateddom" source="program-deprecateddom.xml"/>
+     <hidden   id="schema"                source="schema.xml"/>
+     <hidden   id="program-others"        source="program-others.xml"/>
 
      <document id="samples"     label="Samples"      source="samples.xml"/>
      <hidden   id="saxcount"    source="saxcount.xml"/>
@@ -68,24 +69,23 @@
      <hidden   id="psviwriter"  source="psviwriter.xml"/>
      <hidden   id="scmprint"    source="scmprint.xml"/>
 
-     <document id="api"         label="API Docs"     source="apidocs.xml"/>
+     <group    id="faqs"        label="FAQs">
+        &faq-distrib;
+        <entry id="faq-build"   source="faq-build.xml"/>
+        <entry id="faq-parse"   source="faq-parse.xml"/>
+        <entry id="faq-other"   source="faq-other.xml"/>
+        &faq-contributing;
+     </group>
 
   <separator/>
 
-     <external href="ApacheDOMC++Binding.html"     label="DOM C++ Binding"/>
+     <document id="api"         label="API Reference"     source="apidocs.xml"/>
 
-     <document id="program"     label="Programming"  source="program.xml"/>
-     <hidden   id="program-sax"           source="program-sax.xml"/>
-     <hidden   id="program-sax2"          source="program-sax2.xml"/>
-     <hidden   id="program-dom"           source="program-dom.xml"/>
-     <hidden   id="dom3"                  source="dom3.xml"/>
-     <hidden   id="program-deprecateddom" source="program-deprecateddom.xml"/>
-     <hidden   id="schema"                source="schema.xml"/>
-     <hidden   id="program-others"        source="program-others.xml"/>
+     <external href="ApacheDOMC++Binding.html"     label="DOM C++ Binding"/>
 
      <document id="migrate"     label="Migration Guide"    source="migration.xml"/>
      <hidden   id="migrate_archive" source="migration_archive.xml"/>
-     
+
   <separator/>
 
   <document id="feedback"    label="Feedback"     source="feedback.xml"/>



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