From d36c4cd3c5790cbd1439ba5e7bb679c18fc77b79 Mon Sep 17 00:00:00 2001
From: David Abram Cargill <cargilld@apache.org>
Date: Wed, 13 Apr 2005 17:25:11 +0000
Subject: [PATCH] Update documentation for recently added features.

git-svn-id: https://svn.apache.org/repos/asf/xerces/c/trunk@176380 13f79535-47bb-0310-9956-ffa450edef68
---
 doc/program-dom.xml  | 61 ++++++++++++++++++++++++++++++++++++++++++++
 doc/program-sax.xml  | 29 +++++++++++++++++++++
 doc/program-sax2.xml | 34 +++++++++++++++++++++++-
 3 files changed, 123 insertions(+), 1 deletion(-)

diff --git a/doc/program-dom.xml b/doc/program-dom.xml
index 0856c625c..2fc456a8c 100644
--- a/doc/program-dom.xml
+++ b/doc/program-dom.xml
@@ -612,7 +612,36 @@
                 <tr><th><em>note:</em></th><td> Each annotation is validated independently. </td></tr>
             </table>
             <p/>         
+
+            <anchor name="IgnoreAnnotations"/>
+            <table>
+                <tr><th colspan="2"><em>setIgnoreAnnotations</em></th></tr>
+                <tr><th><em>true:</em></th><td> Do not generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>false:</em></th><td> Generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+            </table>
+            <p/>    
             
+            <anchor name="DisableDefaultEntityResolution"/>
+            <table>
+                <tr><th colspan="2"><em>setDisableDefaultEntityResolution</em></th></tr>
+                <tr><th><em>true:</em></th><td> The parser will not attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+            </table>
+            <p/>
+            
+            <anchor name="SkipDTDValidation"/>
+            <table>
+                <tr><th colspan="2"><em>setSkipDTDValidation</em></th></tr>
+                <tr><th><em>true:</em></th><td> When schema validation is on the parser will ignore the DTD, except for entities.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will not ignore DTDs when validating.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+                <tr><th><em>see:</em></th><td>
+                <link anchor="schema">DoSchema</link></td></tr>                
+            </table>
+            <p/>                                               
+                        
             <anchor name="XercesIgnoreCachedDTD"/>
             <table>            
                 <tr><th colspan="2"><em>setIgnoreCachedDTD</em></th></tr>
@@ -1337,6 +1366,38 @@
             </table>
             <p/>
             
+            <anchor name="builder-IgnoreAnnotations"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/schema/ignore-annotations</em></th></tr>
+                <tr><th><em>true:</em></th><td> Do not generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>false:</em></th><td> Generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>     
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesIgnoreAnnotations </td></tr>           
+            </table>
+            <p/>    
+            
+            <anchor name="builder-DisableDefaultEntityResolution"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/disable-default-entity-resolution</em></th></tr>
+                <tr><th><em>true:</em></th><td> The parser will not attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>       
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesDisableDefaultEntityResolution </td></tr>         
+            </table>
+            <p/>
+            
+            <anchor name="builder-SkipDTDValidation"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/validation/schema/skip-dtd-validation</em></th></tr>
+                <tr><th><em>true:</em></th><td> When schema validation is on the parser will ignore the DTD, except for entities.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will not ignore DTDs when validating.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesSkipDTDValidation </td></tr>
+                <tr><th><em>see:</em></th><td>
+                <link anchor="builder-schema">Schema Validation</link></td></tr>                
+            </table>
+            <p/>                                               
+                        
             <anchor name="builder-IgnoreCachedDTD"/>
             <table>            
                 <tr><th colspan="2"><em>http://apache.org/xml/features/validation/ignoreCachedDTD</em></th></tr>
diff --git a/doc/program-sax.xml b/doc/program-sax.xml
index 883792dd1..05a8b5ddc 100644
--- a/doc/program-sax.xml
+++ b/doc/program-sax.xml
@@ -389,6 +389,35 @@ void MySAXHandler::fatalError(const SAXParseException&amp; exception)
                 <tr><th><em>note:</em></th><td> Each annotation is validated independently. </td></tr>
             </table>
             <p/>               
+            
+            <anchor name="IgnoreAnnotations"/>
+            <table>
+                <tr><th colspan="2"><em>setIgnoreAnnotations</em></th></tr>
+                <tr><th><em>true:</em></th><td> Do not generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>false:</em></th><td> Generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+            </table>
+            <p/>    
+            
+            <anchor name="DisableDefaultEntityResolution"/>
+            <table>
+                <tr><th colspan="2"><em>setDisableDefaultEntityResolution</em></th></tr>
+                <tr><th><em>true:</em></th><td> The parser will not attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+            </table>
+            <p/>
+            
+            <anchor name="SkipDTDValidation"/>
+            <table>
+                <tr><th colspan="2"><em>setSkipDTDValidation</em></th></tr>
+                <tr><th><em>true:</em></th><td> When schema validation is on the parser will ignore the DTD, except for entities.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will not ignore DTDs when validating.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+                <tr><th><em>see:</em></th><td>
+                <link anchor="schema">DoSchema</link></td></tr>                
+            </table>
+            <p/>                                                
 
 			<anchor name="XercesIgnoreCachedDTD"/>
             <table>            
diff --git a/doc/program-sax2.xml b/doc/program-sax2.xml
index c36e5b2bc..a79563158 100644
--- a/doc/program-sax2.xml
+++ b/doc/program-sax2.xml
@@ -420,7 +420,39 @@ void MySAX2Handler::fatalError(const SAXParseException&amp; exception)
                 <tr><th><em>note:</em></th><td> Each annotation is validated independently. </td></tr>
             </table>
             <p/>                                    
-
+            
+            <anchor name="IgnoreAnnotations"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/schema/ignore-annotations</em></th></tr>
+                <tr><th><em>true:</em></th><td> Do not generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>false:</em></th><td> Generate XSAnnotations when traversing a schema.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>     
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesIgnoreAnnotations </td></tr>           
+            </table>
+            <p/>    
+            
+            <anchor name="DisableDefaultEntityResolution"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/disable-default-entity-resolution</em></th></tr>
+                <tr><th><em>true:</em></th><td> The parser will not attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will attempt to resolve the entity when the resolveEntity method returns NULL.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>       
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesDisableDefaultEntityResolution </td></tr>         
+            </table>
+            <p/>
+            
+            <anchor name="SkipDTDValidation"/>
+            <table>
+                <tr><th colspan="2"><em>http://apache.org/xml/features/validation/schema/skip-dtd-validation</em></th></tr>
+                <tr><th><em>true:</em></th><td> When schema validation is on the parser will ignore the DTD, except for entities.</td></tr>
+                <tr><th><em>false:</em></th><td> The parser will not ignore DTDs when validating.</td></tr>
+                <tr><th><em>default:</em></th><td> false </td></tr>                
+                <tr><th><em>XMLUni Predefined Constant:</em></th><td> fgXercesSkipDTDValidation </td></tr>
+                <tr><th><em>see:</em></th><td>
+                <link anchor="schema">Schema Validation</link></td></tr>                
+            </table>
+            <p/>                                               
+                      
            <anchor name="IgnoreCachedDTD"/>
             <table>            
                 <tr><th colspan="2"><em>http://apache.org/xml/features/validation/ignoreCachedDTD</em></th></tr>
-- 
GitLab