docs/dom3.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">
<s1 title="Document Object Model Level 3 Implementation">
	<s2 title="Disclaimer">
		<p>

			The &ParserNameLong; &ParserVersion; contains a partial
			implementation of the W3C Document Object Model Level 3.
		</p>
		<p>
			The
			<jump href="http://www.w3.org/DOM/DOMTR#DOML3">DOM Level 3</jump>
			specification is at the stage of
			<strong>Candidate Recommendation</strong>, which represents work in progress 
			and has been widely reviewed and satisfies certain technical requirements
			but may still change based on implementation experience.

			This implementation is experimental: it should not be
			considered as complete or correct.
		</p>
	</s2>
	<s2 title="Introduction">
		<p>
			The &ParserNameLong; &ParserVersion; contains an implementation of 
			the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-Core-20031107/">Core</jump> 
			and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/">Load and Save</jump> Candidate Recommendations.
			To learn how to program with the DOM Level 3 see <jump href="samples-dom.html#DOM3">dom.DOM3</jump> sample.
		</p>


		<note>
			To find out how to access
			<em>DOM Level 3 functionality</em>, please refer to the
			<link idref='faq-dom'>FAQ</link>
			.
		</note>
	</s2>

	<s2 title='Implementation of DOM Level 3 Core'>
            <p>Missing functionality:</p>
             <ul>
               <li><strong>DOMConfiguration "infoset"</strong> parameter - value "true" is not supported. </li>
             </ul>
              
		<p>
			The <code>parameters</code> supported are:
		</p>
		<ul>
			<li>
				<strong>error-handler</strong>
				[
				<em>DOMErrorHandler</em>
				]
			</li>
			<li>
				<strong>resource-resolver</strong>
				[
				<em>DOMResourceResolver</em>
				]
			</li>
			<li>
				<strong>schema-type</strong>
				[
				<em>String</em>
				]
			</li>
			<li>
				<strong>schema-location</strong>
				[
				<em>String</em>
				]
			</li>
			<li>
				<strong>canonical-form</strong>
				[
				<em>false</em>
				]
			</li>
			<li>
				<strong>cdata-sections</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>comments</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>namespaces</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>entities</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>infoset</strong>
				[
				<em>false</em>
				]
			</li>
			<li>
				<strong>namespace-declarations</strong>
				[
				<em>true</em>
				]
			</li>
			<li>
				<strong>normalize-characters</strong>
				[
				<em>false</em>
				]
			</li>
			<li>
				<strong>split-cdata-sections</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>validate-if-schema</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>whitespace-in-element-content</strong>
				[
				<em>true</em>
				]
			</li>
			<li>
				<strong>datatype-normalization</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>validate</strong>
				[
				<em>true/false</em>
				] -- revalidation is supported only against XML Schemas. For more information, please refer to
				<link idref='faq-dom'>How to revalidate DOM in memory?</link>
				.
			</li>
			<li>
				<strong>validate-if-schema</strong>
				[
				<em>true/false</em>
				]
			</li>
			<li>
				<strong>check-character-normalization</strong>
				[
				<em>false</em>
				]
			</li>			
			<li>
				<strong>well-formed</strong>
				[
				<em>true/false</em>
				]
			</li>	
			<li>
				<strong>psvi</strong>
				[
				<em>true/false</em>
				] -- (NON-DOM) setting the value of this parameter to true will include 
				PSVI information in the DOM tree. 
				To access the information, cast dom.Element to org.apache.xerces.xs.ElementPSVI and dom.Attr to org.apache.xerces.xs.AttributePSVI.
			</li>

		</ul>
	</s2>

	<s2 title='Implementation of DOM Level 3 Load and Save'>
		<p>Most of the functionality is implemented. Here is the list of limitations:</p>
		<ul>

    		<li>
    			<strong>LSParser</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-LSParser-parseWithContext">
    			parserWithContext</jump>
    			 -- not supported.
	    	</li>
	      <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-DOMIMplementationLS-MODE_ASYNCH">
			MODE_ASYNCHRONOUS</jump> 
				-- not supported.
			</li>
            <li><strong>LSSerializer</strong> - the following parameters are not supported:</li>
<ul>
<li><strong>ignore-unknown-character-denormalizations</strong>
[
<em>true</em>
]</li>
<li><strong>normalize-characters</strong>
[
<em>true</em>
]</li>
<li><strong>well-formed</strong>
[
<em>true</em>
]</li>
</ul>
</ul>

	</s2>

</s1>