/[suikacvs]/markup/xml/domdtdef/domdtdef-work.en.html
Suika

Diff of /markup/xml/domdtdef/domdtdef-work.en.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1 by wakaba, Sun Dec 2 04:19:12 2007 UTC revision 1.14 by wakaba, Tue Dec 4 10:27:26 2007 UTC
# Line 1  Line 1 
1  <!DOCTYPE html>  <!DOCTYPE html>
2  <html lang="en" class="formal-specification status-work-in-progress">  <html lang="en" class="formal-specification status-work-in-progress">
3  <head>  <head>
4  <title>manakai's XML Conformance Checking</title>  <title>DOM Document Type Definition Module</title>
5  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">
6    <link rel="stylesheet" href="http://suika.fam.cx/www/style/def/dom">
7  <link rel="license" href="http://suika.fam.cx/c/gnu/fdl">  <link rel="license" href="http://suika.fam.cx/c/gnu/fdl">
 <style>  
   a[id]::before {  
     content: "[" attr(id) "]";  
     color: gray;  
     font-size: 70%;  
     font-family: Courier New, monospace;  
     vertical-align: 60%;  
   }  
 </style>  
8  </head>  </head>
9  <body class="has-abstract">  <body class="has-abstract">
10    
11  <div class="header">  <div class="header">
12  <h1>manakai's <abbr>XML</abbr> Conformance Checking</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-01>1 December 2007</time></h2>  <h2>Working Draft <time datetime=2007-12-03>3 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
17    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work"    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
18        >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work</a>&gt;</code></dd>        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
19  <dt>Latest Version</dt>  <dt>Latest Version</dt>
20    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc"    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef"
21        >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc</a>&gt;</code></dd>        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef</a>&gt;</code></dd>
22  <dt>Latest Working Draft</dt>  <dt>Latest Working Draft</dt>
23    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work"    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
24        >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work</a>&gt;</code></dd>        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
25  <!-- <dt>Previous Version</dt> -->  <!-- <dt>Previous Version</dt> -->
26  <dt>Version History</dt>  <dt>Version History</dt>
27    <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/xml/xmlcc/xmlcc-work.en.html">http://suika.fam.cx/gate/cvs/markup/xml/xmlcc/xmlcc-work.en.html</a>&gt;</code></dd>    <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/xml/domdtdef/domdtdef-work.en.html">http://suika.fam.cx/gate/cvs/markup/xml/domdtdef/domdtdef-work.en.html</a>&gt;</code></dd>
28  </dl>  <dt id=author>Author</dt>
 <dl class="authors" id="author">  
 <dt>Author</dt>  
29    <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"    <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"
30        lang=ja>Wakaba</a>        lang=ja>Wakaba</a>
31    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"
# Line 72  at the time of its publication.  Other d Line 62  at the time of its publication.  Other d
62  might supersede this document.</em></p>  might supersede this document.</em></p>
63    
64  <p>This document is a working draft, produced as part of the  <p>This document is a working draft, produced as part of the
 <a href="http://suika.fam.cx/www/markup/html/whatpm/readme">Whatpm</a>  
 subproject of the  
65  <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>  <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>
66  project.  It might be updated, replaced, or obsoleted by  project.  It might be updated, replaced, or obsoleted by
67  other documents at any time.  It is inappropriate to  other documents at any time.  It is inappropriate to
# Line 92  normative version.</p> Line 80  normative version.</p>
80    
81  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
82    
83  <div class="issue ed">...</div>  <div class="issue ed">
84    <p>This is a work-in-progress specification for DOM Document Type
85    Definition module, as implemented by manakai and
86    <a href="http://suika.fam.cx/gate/2005/sw/DOM%20XML%20Document%20Type%20Definition">partially documented in the SuikaWiki</a>.</p>
87    </div>
88    
89    <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>
90    module is a set of <abbr>DOM</abbr> interfaces, including both new
91    interfaces and modifications to existing <abbr>DOM</abbr> interfaces,
92    over which <abbr>DOM</abbr> applications are able to access to the
93    definitions of the document type.</p>
94    
95    <p>Interfaces defined in this specification are partially modeled from
96    early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>,
97    <abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and
98    <abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with
99    any of them as a whole.</p>
100  </div>  </div>
101    
102  <div class="section" id="terminology">  <div class="section" id="terminology">
# Line 118  else in this specification is normative. Line 120  else in this specification is normative.
120  <p><span class=ed>Algorithm is normative but non-normative</span>.  <p><span class=ed>Algorithm is normative but non-normative</span>.
121  In addition, the order in which <a href="#errors">errors</a> are  In addition, the order in which <a href="#errors">errors</a> are
122  raised is undefined.</p>  raised is undefined.</p>
 </div>  
   
   
 <div class=section id=error-categories>  
 <h2>Error Classification</h2>  
   
 <p class=ed>If a <code>Document</code> node has no  
 xml-well-formedness-error, entity-error, and unknown-error,  
 then it is well-formed.  If a well-formed <code>Document</code>  
 node has no xml-validity-error, it is valid.</p>  
   
 <div class="note memo">  
 <p>A well$B!>(Bformed <code>Document</code> can be safely serialized  
 into a well$B!>(Bformed XML document.  A valid <code>Document</code>  
 can be easily serialized into a valid XML document.</p>  
 </div>  
   
 <p class=ed>To be a conforming <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-validating">validating XML processor</a>,  
 ...</p>  
   
 <p>Errors are classified into these  
 <dfn id=error-category title="error category">error categories</dfn>:</p>  
123    
124  <dl id=errors>  <p class=ed><var>A</var> object is an object implementing <var>A</var>
125  <dt><dfn id=entity-error><code>entity-error</code></dfn></dt>  interface.</p>
   <dd>  
     <p class=ed>@@</p>  
     <div class="note memo">  
       <p>This <span class=ed>algorithm</span> does not support  
       <abbr>DOM</abbr> tree with one or more <code>EntityReference</code>  
       nodes.  It is expected that any entity references are expanded  
       at the parse time and any unexpandable entity references  
       make parse time errors raised so that never result in  
       <abbr>DOM</abbr> tree with <code>EntityReference</code> nodes.</p>  
     </div>  
   </dd>  
 <dt><dfn id=round-trip-error><code>round-trip-error</code></dfn></dt>  
   <dd class=ed>@@</dd>  
 <dt><dfn id=round-trip-warning><code>round-trip-warning</code></dfn></dt>  
   <dd>  
     <p>A <a href="#round-trip-warning"><code>round-trip-warning</code></a>  
     will be raised when a construct, which might not be restored to the same  
     construct when it is serialized and then re-parsed by a conforming  
     processor, is encountered.</p>  
     <div class="example memo">  
       <p>For a <code>Comment</code> node a  
       <a href="#round-trip-warning"><code>round-trip-warning</code></a> will  
       be raised, since <abbr>XML</abbr> processors are not required to  
       report texts of comments for applications.</p>  
     </div>  
   </dd>  
 <dt class=ed><dfn id=unknown-error><code>unknown-error</code></dfn>?</dt>  
   <dd class=ed>@@</dd>  
 <dt><dfn id=xml-misc-error><code>xml-misc-error</code></dt>  
   <dd>An <abbr>XML</abbr> <i>error</i> (<abbr>XML</abbr> 1.0  
   <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>  
   <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-error">error</a> /  
   <abbr>XML</abbr> 1.1  
   <cite class="bibref normative">[<a href="#ref-XML11">XML11</a>]</cite>  
   <a href="@@/#dt-error">error</a>)  
   that is not classified to any other <a href="#error-category">error  
   category</a>.</dd>  
 <dt><dfn id=xml-misc-fatal-error><code>xml-misc-fatal-error</code></dt>  
   <dd>An <abbr>XML</abbr> <i>fatal error</i> (<abbr>XML</abbr> 1.0  
   <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>  
   <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-fatal">fatal  
   error</a> / <abbr>XML</abbr> 1.1  
   <cite class="bibref normative">[<a href="#ref-XML11">XML11</a>]</cite>  
   <a href="@@/#dt-fatal">fatal error</a>)  
   that is not classified to any other <a href="#error-category">error  
   category</a>. <span class=ed>@@ What errors fall into this category?</span></dd>  
 <dt><dfn id=xml-misc-recommendation><code>xml-misc-recommendation</code></dfn></dt>  
   <dd>  
     <p>An  
     <a href="#xml-misc-recommendation"><code>xml-misc-recommendation</code></a>  
     will be raised if a <em class=rfc2119>SHOULD</em>$B!>(Blevel requirement  
     in <abbr>XML</abbr> specification is not met.</p>  
   </dd>  
 <dt><dfn id=xml-validity-error><code>xml-validity-error</code></dfn></dt>  
   <dd>A violation of validity constraint in XML document.</dd>  
 <dt><dfn id=xml-well-formedness-error><code>xml-well-formedness-error</code></dfn></dt>  
   <dd><p>If an <code>xml-well-formedness-error</code> is raised,  
   it would not be possible to generate an XML serialization that  
   would match to the appropriate production rule and that would not  
   violate to any well$B!>(Bformedness constraint in XML  
   specification <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,  
   <a href="#ref-XML11">XML11</a>]</cite>.</p></dd>  
 </dl>  
126    
127  <div class=ed><p>@@ TODO: #dt-atuseroption at user option  <p class=ed>@@ ref to DOM Binding Spec</p>
 (MAY or MUST), #dt-compat for compatibility,  
 #dt-interop for interoperability</p></div>  
128    
129    <p>If the <code>strictErrorChecking</code> attribute of the
130    <code>Document</code> node is <code>false</code>, the methods are
131    not required to raise exceptions <span class=ed>[DOM3]</span>.</p>
132  </div>  </div>
133    
134  <div class=section id=parsing-xml>  <div class=section id=dom-dtdef>
135  <h2>Parsing <abbr>XML</abbr> Document</h2>  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
136    
137    <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
138    consists of three interfaces:</p>
139  <ul>  <ul>
140  <li>If the <abbr>XML</abbr> document does not begin with an  <li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>
141  <abbr>XML</abbr> declaration, then raise an  <li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>
142  <a href="#xml-misc-recommentation" id=xmr-xml-decl><code>xml-misc-recommendation</code></a>.</li>  <li><a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a></li>
143  <li>If the replacement text of an entity declaration is  <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>
 <code>&lt;</code>, then raise an  
 <a href="#xml-misc-warning" id=xmw-entity-value-lt><code>xml-misc-warning</code></a>.<!--  
 "strongly advised to avoid" in a Note in Section 2.3 of [XML10], [XML11].  
 --></li>  
 <li>If there is an element type declaration whose <code>Name</code>  
 value is already declared, then raise an  
 <a href="#xml-validity-error" id=vc-edunique><code>xml-validity-error</code></a>.</li>  
 <li>If attribute definition whose <code>Name</code> is  
 <code>xml:space</code> has <span class=ed>declared type different from  
 (default|preserve), (default), or (preserve)</span>, then raise an  
 <a href="#xml-misc-error" id=xme-ad-xml-space><code>xml-misc-error</code></a>.  
 <span class=ed>@@ duplication with  
 <a href="#xml-at-xml-space">#xml-at-xml-space</a>.<!--  
 <!ATTLIST e xml:space CDATA #IMPLIED xml:space CDATA #IMPLIED> --></span></li>  
 <li>If an empty-element tag is used for an element which is <em>not</em>  
 declared <code>EMPTY</code>, then raise an  
 <a href="#xml-misc-recommentation" id=xmr-emptyelemtag-not-empty><code>xml-misc-recommendation</code></a>.</li>  
 <li>If an empty-element tag is <em>not</em> used for an element which is  
 declared <code>EMPTY</code>, then raise an  
 <a href="#xml-misc-recommentation" id=xmr-empty-not-emptyelemtag><code>xml-misc-recommendation</code></a>.</li>  
 <!--  
   
 #vc-PEinMarkupDecl Validity constraint: Proper Declaration/PE Nesting  
 #wfc-PEinInternalSubset Well-formedness constraint: PEs in Internal Subset  
 #ExtSubset Well-formedness constraint: External Subset  
 #PE-between-Decls Well-formedness constraint: PE Between Declarations  
 #GIMatch Well-formedness constraint: Element Type Match  
 #uniqattspec Well-formedness constraint: Unique Att Spec  
 #NoExternalRefs Well-formedness constraint: No External Entity References  
 #CleanAttrVals Well-formedness constraint: No < in Attribute Values  
 #vc-PEinGroup Validity constraint: Proper Group/PE Nesting  
 "For interoperability, if a parameter-entity reference appears in a choice, seq, or Mixed construct, its replacement text SHOULD contain at least one non-blank character, and neither the first nor last non-blank character of the replacement text SHOULD be a connector (| or ,)."  
 "For interoperability, an XML processor MAY at user option issue a warning when more than one attribute-list declaration is provided for a given element type, or more than one attribute definition is provided for a given attribute, but this is not an error."  
 #condsec-nesting Validity constraint: Proper Conditional Section/PE Nesting  
 #wf-Legalchar Well-formedness constraint: Legal Character  
 #textent Well-formedness constraint: Parsed Entity  
 #norecursion Well-formedness constraint: No Recursion  
 #indtd Well-formedness constraint: In DTD  
 "External parsed entities SHOULD each begin with a text declaration."  
 "It is an error for a reference to an unparsed entity to appear in the EntityValue in an entity declaration."  
 #UniqueNotationName Validity constraint: Unique Notation Name  
   
 @@ Need detailed review, but maybe should be in parsing phase  
   
 #vc-check-rmd Validity constraint: Standalone Document Declaration  
   
 @@ Need dtailed review  
   
 #wf-entdeclared Well-formedness constraint: Entity Declared  
 #vc-entdeclared Validity constraint: Entity Declared  
 "For interoperability, valid documents SHOULD declare the entities amp, lt, gt, apos, quot, in the form specified in 4.6 Predefined Entities."  
 "If the entities lt or amp are declared, they MUST be declared as internal entities whose replacement text is a character reference to the respective character (less-than sign or ampersand) being escaped; the double escaping is REQUIRED for these entities so that references to them produce a well-formed result. If the entities gt, apos, or quot are declared, they MUST be declared as internal entities whose replacement text is the single character being escaped (or a character reference to that character; the double escaping here is OPTIONAL but harmless)."  
   
 @@ flaged and then reported in DOM check phase  
   
 "Entities encoded in UTF-16 MUST and entities encoded in UTF-8 MAY begin with the Byte Order Mark"  
 "In the absence of external character encoding information (such as MIME headers), parsed entities which are stored in an encoding other than UTF-8 or UTF-16 MUST begin with a text declaration"  
 "In an encoding declaration, the values "UTF-8", "UTF-16", "ISO-10646-UCS-2", and "ISO-10646-UCS-4" SHOULD be used for the various encodings and transformations of Unicode / ISO/IEC 10646, the values "ISO-8859-1", "ISO-8859-2", ... "ISO-8859-n" (where n is the part number) SHOULD be used for the parts of ISO 8859, and the values "ISO-2022-JP", "Shift_JIS", and "EUC-JP" SHOULD be used for the various encoded forms of JIS X-0208-1997. It is RECOMMENDED that character encodings registered (as charsets) with the Internet Assigned Numbers Authority [IANA-CHARSETS], other than those just listed, be referred to using their registered names; other encodings SHOULD use names starting with an "x-" prefix."  
   
 @@ in parsing phase  
   
 "It is a fatal error when an XML processor encounters an entity with an encoding that it is unable to process. It is a fatal error if an XML entity is determined (via default, encoding declaration, or higher-level protocol) to be in a certain encoding but contains byte sequences that are not legal in that encoding."  
   
 -->  
144  </ul>  </ul>
 </div>  
   
 <div class="section" id=checking-dom>  
 <h2>Checking <abbr>DOM</abbr></h2>  
   
 <p>The following algorithms and definitions are applied to  
 <abbr>XML</abbr> documents; especially, they are not applied  
 to <abbr>HTML</abbr> documents.<!-- TODO: ref to HTML5 --></p>  
   
 <div class=section id=definitions>  
 <h3>Definitions</h3>  
   
 <p>The <dfn id=xml-version><abbr>XML</abbr> version</dfn> of a node is  
 the <abbr>XML</abbr> version of the document to which the node belongs.  
 For a <code>Documemt</code> node, the <abbr>XML</abbr> version  
 of the document is the value of the <code>xmlVersion</code>  
 attribute of the node.  For a <code>DocumentType</code> node whose  
 <code>ownerDocument</code> attribute is set to <code>null</code>,  
 the <abbr>XML</abbr> version of the document is <code>1.0</code><!--  
 since createDocumentType [DOM3CORE] assumes XML 1.0 [XML10TE] -->.  
 For any other node, the <abbr>XML</abbr> version of the document  
 is that of the <code>Document</code> node contained in the  
 <code>ownerDocument</code> attribute of the node.</p>  
145    
146  </div>  <p>In addition, it modifies interfaces
147    <a href="#Node"><code>Node</code></a>,
148    <a href="#DocumentType"><code>DocumentType</code></a>,
149  <div class=section id=checking-components>  <a href="#Entity"><code>Entity</code></a>,
150  <h3>Conformance Checking Algorithms for Components</h3>  <a href="#EntityReference"><code>EntityReference</code></a>,
151    <a href="#Notation"><code>Notation</code></a>, and
152  <p>To  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>.</p>
153  <dfn id=algorithm-to-validate-an-xml-character-data title="validate an XML string">to  
154  validate an <abbr>XML</abbr> string (<dfn id=var-s><var>s</var></dfn>)</dfn>,  <div class=section id=features>
155  the following algorithm <em class=rfc2119>MUST</em> be used:</p>  <h3>Feature Name</h3>
156  <ol>  
157  <li>If <var>s</var> contains a character that is <em>not</em> in  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of
158  the character class <a href="#class-Char10"><code>Char10</code></a>,  the <abbr>DOM</abbr> Document Type Definition module, the
159  then raise an  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
160  <a href="#xml-well-formedness-error" id=wfe-illegal-char><code>xml-well-formedness-error</code></a>.</li>  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
161  <li>If <var>s</var> contains a character that is in the character  set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
162  class <a href="#class-CompatChar10"><code>CompatChar10</code></a>,  <code>3.0</code> respectively.</p>
163  then raise an  
164  <a href="#xml-misc-warning" id=xmw-compat-char><code>xml-misc-warning</code></a>.</li>  <p>In such an implementation, the <code>getFeature</code> method of a
165  <li>If <var>s</var> contains a character that is in the character  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
166  class <a href="#class-ControlChar10"><code>ControlChar10</code></a>,  conceptually) same object implementing the
167  then raise an  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
168  <a href="#xml-misc-warning" id=xmw-control-char><code>xml-misc-warning</code></a>.</li>  the parameters are set to
169  <li class=ed>@@ XML 1.1 support</li>  <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
170  <li>If <var>s</var> contains a <code class=char>U+000D</code>  <code>3.0</code> respectively.  Likewise, any method that takes one or more
171  <code class=charname>CARRIAGE RETURN</code> character, then  feature names with or without version number, including the methods
172  raise a  <code>hasFeature</code> and <code>getFeature</code>,
173  <a href="#round-trip-error" id=rte-cr><code>round-trip-error</code></a>.  <em class=rfc2119>MUST</em> behave in a manner consistent with the
174  <span class=ed>@@ We should not raise duplicate errors for U+000D  aforementioned cases.</p>
175  in attribute values.  In addition, we should support a mode where  </div>
176  U+000D will be serialized as &#x000D; (so that no round-trip-error  
177  will be raised).</span></li>  <div class=section id=section-node>
178  </ol>  <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
179    
180  <p>To  <pre class=idl><code>// Additions to the Node interface
181  <dfn id=algorithm-to-validate-a-name title="validate a Name">validate a  
182  <code>Name</code> (<dfn id=var-name-s><var>s</var></dfn>)</dfn>, the following  // Additions to the NodeType definition group
183  algorithm <em class=rfc2119>MUST</em> be used:</p>  const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
184  <ol>  const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
185  <li>If <var>s</var> is an empty string, then raise an  </pre>
186  <a href="#xml-well-formedness-error" id=wfe-name-empty><code>xml-well-formedness-error</code></a>.  
187  Abort these steps.</li>  <p>This specification adds two new types (subinterfaces) of
188  <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate  <a href="#Node"><code>Node</code></a>: element type definition (node type
189  <var>s</var> as an <abbr>XML</abbr> string</a>.</li>  <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
190  <li>If the first character in <var>s</var> is a character that is  interface
191  <em>not</em> in the character class  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
192  <a href="#class-NameStartChar10"><code>NameStartChar10</code></a>, then raise  attribute definition (node type
193  an  <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
194  <a href="#xml-well-formedness-error" id=wfe-name-startchar><code>xml-well-formedness-error</code></a>.</li>  interface
195  <li>If a character other than the first character in <var>s</var> is a  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
196  character that is <em>not</em> in the character class  these kinds of nodes, methods and attributes in the
197  <a href="#class-NameChar10"><code>NameChar10</code></a>, then raise an  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
198  <a href="#xml-well-formedness-error" id=wfe-name-char><code>xml-well-formedness-error</code></a>.</li>  
199  <li>If <var>s</var> begins with the string <code>xml</code> (in any  <dl>
200  case combination), then raise an  <dt><code id=nodeType>nodeType</code></dt>
201  <a href="#xml-misc-warning" id=xmw-reserved-name><code>xml-misc-warning</code></a>.    <dd>
202  <span class=ed>@@ except for attribute names <code>xml:lang</code>,      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
203  <code>xml:space</code>, <code>xml:base</code>, <code>xml:id</code>,      <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
204  <code>xmlns</code>, <code>xmlns:<var>*</var></code>,      (if the node is an
205  pi name <code>xml-stylesheet</code>.</span><!--      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
206  "names beginning with a match to (('X'|'x')('M'|'m')('L'|'l')) are reserved for standardization in this or future versions of this specification.":      <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
207  xmlns, xml-stylesheet, xml:base and xml:id specifications violate to this sentense!      (if the node is an
208  --></li>      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
209  <!-- COLON in Name is a lowercase "should not" in a Note of [XML10],  
210  [XML11]. -->      <!-- NodeType -->
211  <li class=ed>@@ XML 1.1 support</li>  <p>Two constants are added to the <code id=NodeType>NodeType</code>
212  </ol>  definition group of the <a href="#Node"><code>Node</code></a> interface as
213    following:</p>
214  <p>To  <table>
215  <dfn id=algorithm-to-validate-an-ncname title="validate an NCName">validate  <thead>
216  an <code>NCName</code> (<dfn id=var-ncname-s><var>s</var></dfn>)</dfn>, the  <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
217  following algorithm <em class=rfc2119>MUST</em> be used:</p>  </thead>
218  <ol>  <tbody>
219  <li><a href="#algorithm-to-validate-a-name" title="validate a Name">Validate  <tr>
220  <var>s</var> as a <code>Name</code></a>.</li>  <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
221  <li class=ed>@@</li>  <td><code>81001</code><td>The node is an
222  </ol>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
223    <tr>
224  <p>To  <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
225  <dfn id=algorithm-to-validate-a-public-identifier title="validate a public identifier">validate  <td><code>81002</code><td>The node is an
226  a public identifier (<dfn id=var-pid><var>pid</var></dfn>)</dfn>, the  <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
227  following algorithm <em class=rfc2119>MUST</em> be used:</p>  </tbody>
228  <ol>  </table>
229  <li>If <var>pid</var> is <code>null</code>, abort these steps.</li>    </dd>
230  <li>If <var>pid</var> contains a character that is <em>not</em> in the  <dt class=ed>@@ ...</dt>
231  character class <a href="#class-PubidChar"><code>PubidChar</code></a>, then  </dl>
 raise an  
 <a href="#xml-well-formedness-error" id=wfe-pubid-char><code>xml-well-formedness-error</code></a>.</li>  
   <li>If <var>pid</var> contains one of <code class=char>U+0009</code>  
   <code class=charname>CHARACTER TABULATION</code>,  
   <code class=char>U+000A</code> <code class=charname>CARRIAGE RETURN</code>,  
   and <code class=char>U+000D</code> <code class=charname>LINE FEED</code>  
   characters, if the first character of <var>pid</var> is  
   <code class=char>U+0020</code> <code class=charname>SPACE</code> character,  
   if the last character of <var>pid</var> is <code class=char>U+0020</code>  
   <code class=charname>SPACE</code> character, or if there is a  
   <code class=char>U+0020</code> <code class=charname>SPACE</code> character  
   immediately followed by another <code class=char>U+0020</code>  
   <code class=charname>SPACE</code> character in <var>pid</var>, then it is a  
   <a href="#round-trip-error" id=rte-pubid-space><code>round-trip-error</code></a>.  
   <span class=ed>Is this really a roundtripness problem?  XML spec  
   does only define the way to match public identifiers in fact, no  
   canonical form.</span></li>  
 </ol>  
   
 <p>To  
 <dfn id=algorithm-to-validate-a-system-identifier title="validate a system identifier">validate  
 a system identifier (<dfn id=var-sid><var>sid</var></dfn>)</dfn>, the  
 following algorithm <em class=rfc2119>MUST</em> be used:</p>  
 <ol>  
   <li>If <var>sid</var> is <code>null</code>, abort these steps.</li>  
 <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate  
 <var>sid</var> as an <abbr>XML</abbr> string</a>.</li>  
   <li>If <var>sid</var> contains both <code class=char>U+0022</code>  
   <code class=charname>QUOTATION MARK</code> (<code class=char>"</code>) and  
   <code class=char>U+0027</code> <code class=charname>APOSTROPHE</code>  
   (<code class=char>'</code>) characters, raise an  
   <a href="#xml-well-formedness-error" id=wfe-sid-lit><code>xml-well-formedness-error</code></a>.</li>  
   <li>If <var>sid</var> contains at least one <code class=char>U+0023</code>  
   <code class=charname>NUMBER SIGN</code> (<code class=char>#</code>)  
   character, then raise an  
   <a href="#xml-misc-error" id=xme-sid-fragment><code>xml-misc-error</code></a>.</li>  
   <li class=ed>@@ If <var>sid</var> cannot be converted to a URI  
   reference, then raise a fact-level error (xml-misc-warning?).<!--  
   XML 1.0 has no conformance language for system identifier being  
   a URI reference. --></li>  
 </ol>  
232    
233  </div>  </div>
234    
235  <div class=section id=checking-node>  <div class=section id=section-documentxdoctype>
236  <h3>Checking <code>Node</code></h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
237    
238  <p>The algorithm <dfn title="to check a node" id=algorithm-to-check-a-node>to  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
239  check a node (<dfn id=var-n><var>n</var></dfn>)</dfn> is defined as    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
240  following:</p>      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
241  <dl class=switch>      raises (DOMException);
242  <dt>If <var>n</var> is an <code>Attr</code> node</dt>    <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
243    <dd>      (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
244      <ol>      raises (DOMException);
245      <li><a href="#algorithm-to-validate-an-ncname">Validate the    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
246      <code>localName</code> attribute value as an <code>NCName</code></a>.</li>      (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
247      <li>If the <code>prefix</code> attribute value is different from      raises (DOMException);
248      <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate    <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
249      the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>      (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
250      <li>For each node <dfn id=var-attr-nc><var>n<sub><var>c</var></sub></var></dfn> in the      raises (DOMException);
251      <code>childNodes</code> list of <var>n</var>,    <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
252        <ol>      (in DOMString <a href="#createNotation-name"><var>name</var></a>)
253        <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a      raises (DOMException);
254        <code>Text</code> or <code>EntityReference</code> node, then it is an  }</code></pre>
255        <a href="#xml-well-formedness-error" id=wfe-attr-child><code>xml-well-formedness-error</code></a>.</li>  
256        <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  <div class=ed>@@ cast definition</div>
257        <code>EntityReference</code> node, then it is an  
258        <a href="#entity-error" id=ee-attr-er><code>entity-error</code></a>.</li>  <dl>
259        <li>Otherwise,  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
260        <a href="#algorithm-to-check-a-node" title="check a node">check  method</dt>
261        <var>n<sub><var>c</var></sub></var></a> recusrively.</li>    <dd>
262        </ol></li>      <p>This method creates a <code>DocumentType</code> node with the specified
263      <li>If <code>nodeName</code> attribute of <var>n</var> is      name, belonging to the document.</p>
264      <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>      <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
265      and <code>value</code> attribute of <var>n</var> is neither      parameter is the name of the document type.</p>
266      <code>default</code> nor <code>preserve</code>, then it is an  
267      <a href="#xml-misc-error" id=xme-attr-xml-space><code>xml-misc-error</code></a>.<!--      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
268      Note that <!ATTLIST e xml:space (default|preserve) "a">...      return a <code>DocumentType</code> node with the following attributes:</p>
269      <e xml:space="default"/> is conforming and valid. --></li>      <dl>
270      <li class=ed>@@ xml:lang value is not a language tag [RFC 3066 or its      <dt><code>attributes</code>, <code>parentNode</code></dt>
271      successor] or an empty string, then xml-misc-warning        <dd><code>null</code>.</dd>
272      (a "fact"-level error; not an XML error).</li>      <dt><code>elementTypes</code>, <code>generalEntities</code>, and
273      <li class=ed>@@ <code>specified</code>,      <code>notations</code></dt>
274      <code>manakaiAttributeType</code> (#ValueType Validity constraint: Attribute Value Type)</li>        <dd>Empty <code>NamedNodeMap</code> objects.</dd>
275      <!-- xml:space MUST be declared to be valid. -->      <dt><code>entities</code></dt>
276      <li>Let <dfn id=var-v><var>v</var></dfn> be the value of the        <dd>The same value as the <code>generalEntities</code> attribute.</dd>
277      attribute <code>value</code> of <var>n</var>.</li>      <dt><code>childNodes</code></dt>
278      <li>Validate the <var>n</var> against the <span class=ed>declared        <dd>An empty <code>NodeList</code> object.</dd>
279      type</span> as following:      <dt><code>internalSubset</code>, <code>publicId</code>, and
280        <dl class=switch>      <code>systemId</code></dt>
281        <dt class=ed><code>ID_ATTR</code></dt>        <dd>Empty strings.</dd>
282          <dd>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
283            <ol>        <dd><code>false</code>.</dd>
284            <li><span class=ed>Validate <var>v</var> as an      <dt><code>nodeName</code></dt>
285            <code>Name</code>.</span>  If it fails, then raise an        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
286            <a href="#xml-validity-error" id=vc-id-name><code>xml-validity-error</code></a>.</li>      <dt><code>ownerDocument</code></dt>
287            <li><span class=ed>If <code>ID</code> <var>v</var> is defined,</span>        <dd>The <code>Document</code> over which the method is invoked.</dd>
288            then raise an        </dl>
289            <a href="#xml-validity-error" id=vc-id-duplication><code>xml-validity-error</code></a>.</li>      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
290            </ol>      containing five general entity declarations: <code>amp</code>,
291          </dd>      <code>lt</code>, <code>gt</code>, <code>quot</code>, and
292        <dt class=ed>IDREF_ATTR</dt>      <code>apos</code>.</p>
293          <dd>    </dd>
294            <ol>  <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
295            <li><span class=ed>Validate <var>v</var> as an  method</dt>
296            <code>Name</code>.</span>  If it fails, then raise an    <dd>
297            <a href="#xml-validity-error" id=vc-idref-name><code>xml-validity-error</code></a>.</li>      <p>This method creates a <code>ElementTypeDefinition</code> node with the
298            <li><span class=ed>If <code>ID</code> <var>v</var> is NOT      specified name, belonging to the document.</p>
299            defined,</span> then raise an        <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
300            <a href="#xml-validity-error" id=vc-idref-match><code>xml-validity-error</code></a>.</li>      parameter is the name of the element type defined by the element
301            </ol>      type definition.</p>
302          </dd>  
303        <dt class=ed>IDREFS_ATTR</dt>      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
304          <dd class=ed>@@</dd>      return an
305        <dt class=ed>ENTITY_ATTR</dt>      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
306          <dd>      node with the following attributes:</p>
307            <ol>      <dl>
308            <li><span class=ed>Validate <var>v</var> as an      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
309            <code>Name</code>.</span>  If it fails, then raise an        <dd>An empty <code>NamedNodeMap</code> object.</dd>
310            <a href="#xml-validity-error" id=vc-entname-name><code>xml-validity-error</code></a>.</li>      <dt><code>attributes</code>, <code>parentNode</code></dt>
311            <li><span class=ed>If <code>Entity</code> <var>v</var> is NOT        <dd><code>null</code>.</dd>
312            defined,</span> then raise an        <dt><code>childNodes</code></dt>
313            <a href="#xml-validity-error" id=vc-entname-match><code>xml-validity-error</code></a>.</li>        <dd>An empty <code>NodeList</code> object.</dd>
314            </ol>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
315          </dd>        <dd><code>false</code>.</dd>
316        <dt class=ed>ENTITIES_ATTR</dt>      <dt><code>nodeName</code></dt>
317          <dd class=ed>@@</dd>        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
318        <dt class=ed>NMTOKEN_ATTR</dt>      <dt><code>ownerDocument</code></dt>
319          <dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
320            <ol>      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>
321            <li><span class=ed>Validate <var>v</var> as an        <dd><code>null</code>.</dd>
322            <code>Nmtoken</code>.</span>  If it fails, then raise an      <dt class=ed>@@ Ensure all attributes are defined</dt>
323            <a href="#xml-validity-error" id=vc-nmtok-name><code>xml-validity-error</code></a>.</li>      </dl>
324            </ol>    </dd>
325          </dd>  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
326        <dt class=ed>NMTOKENS_ATTR</dt>  method</dt>
327          <dd class=ed>@@</dd>    <dd>
328        <dt class=ed>NOTATION_ATTR</dt>      <p>This method creates a <code>AttributeDefinition</code> node with the
329          <dd class=ed><var>v</var> must be one of enumerated values.      specified name, belonging to the document.</p>
330          If not, then raise an      <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
331          <a href="#xml-validity-error" id=vc-notatn-match><code>xml-validity-error</code></a>.</dd>      parameter is the name of the attribute defined by the attribute
332        <dt class=ed>ENUMERATED_ATTR</dt>      definition.</p>
333          <dd class=ed><var>v</var> must be one of enumerated values.  
334          If not, then raise an      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
335          <a href="#xml-validity-error" id=vc-enum><code>xml-validity-error</code></a>.</dd>      return an
336        <dt class=ed>@@</dt>      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
337        </dl>      node with the following attributes:</p>
338      </li>      <dl>
339      <li>If <span class=ed>type ID and default is NOT #IMPLIED or #REQUIRED</span>, then      <dt><code>allowedTokens</code></dt>
340      raise an        <dd>An empty <code>DOMStringList</code> object.</dd>
341      <a href="#xml-validity-error" id=vc-id-default><code>xml-validity-error</code></a>.</li>      <dt><code>attributes</code>,
342      <li class=ed>@@ #FixedAttr Validity constraint: Fixed Attribute Default</li>      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,
343      <li class=ed>@@ strict serialization error for U+000D, U+000A, and      and <code>parentNode</code></dt>
344      U+0009 characters, leading/trailing U+0020, and U+0020{2,} string?</li>        <dd><code>null</code>.</dd>
345      </ol>      <dt><code>childNodes</code></dt>
346    </dd>        <dd>An empty <code>NodeList</code> object.</dd>
347  <dt>If <var>n</var> is an <code>AttributeDefinition</code> node</dt>      <dt><code>declaredType</code></dt>
348    <dd>        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
349      <ol>      <dt><code>defaultType</code></dt>
350      <li class=ed></li>        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
351      <li>If <code>nodeName</code> attribute of <var>n</var> is      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
352      <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>        <dd><code>false</code>.</dd>
353      and <span class=ed>its declared type is different from (default|preserve),      <dt><code>nodeName</code></dt>
354      (default), or (preserve)</span>, then raise an        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
355      <a href="#xml-misc-error" id=xme-at-xml-space><code>xml-misc-error</code></a>.</li>      <dt><code>ownerDocument</code></dt>
356      <li>For each node <dfn id=var-ad-nc><var>n<sub><var>c</var></sub></var></dfn> in the        <dd>The <code>Document</code> node over which the method is invoked.</dd>
357      <code>childNodes</code> list of <var>n</var>,      <dt class=ed>@@ Ensure all attributes are defined</dt>
358        <ol>      </dl>
359        <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a  
360        <code>Text</code> or <code>EntityReference</code> node, then it is an      <div class=ed>
361        <a href="#xml-well-formedness-error" id=wfe-at-child><code>xml-well-formedness-error</code></a>.</li>      <p>@@ Should we keep these statements?:
362        <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  However, if the &lt;cfg::cfg|xml-id> configuration
363        <code>EntityReference</code> node, then it is an  parameter is set to <code>true</code> and the <var>name</var>
364        <a href="#entity-error" id=ee-at-er><code>entity-error</code></a>.</li>  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
365        <li>Otherwise,  attribute is set to <code>ID_ATTR</code>.
366        <a href="#algorithm-to-check-a-node" title="check a node">check  [CODE(DOMa)@en[[[defaultType]]]]?</p>
367        <var>n<sub><var>c</var></sub></var></a> recusrively.</li>      </div>
       </ol></li>  
     <li class=ed>If <code>NOTATION_ATTR</code>, enumerated values MUST  
     be declared.  If not, then raise an  
     <a href="#xml-validity-error" id=vc-notatn-declared><code>xml-validity-error</code></a>.</li>  
     <li class=ed>If <code>NOTATION_ATTR</code> or <code>ENUMERATED_ATTR</code>,  
     values MUST all be distinct.  If not, then raise an  
     <a href="#xml-validity-error" id=vc-no-duplicate-tokens><code>xml-validity-error</code></a>.</li>  
     <li class=ed>If <code>NOTATION_ATTR</code> on an <code>EMPTY</code>  
     element, then raise an  
     <a href="#xml-validity-error" id=vc-no-notation-empty><code>xml-validity-error</code></a>.</li>  
     <li class=ed>@@ #defattrvalid Validity constraint: Attribute Default Value Syntactically Correct</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>CDATASection</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the  
     <code>data</code> attribute value as an <abbr>XML</abbr> character  
     data</a>.</li>  
     <li>If the <code>data</code> attribute value contains  
     a string <code>]]></code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-cs-mse><code>xml-well-formedness-error</code></a>.<!-- "for compatibility" --></li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-cs-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Comment</code> node</dt>  
   <dd>  
     <ol>  
     <li>Raise an  
     <a href="#round-trip-warning" id=rtw-comment><code>round-trip-warning</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the  
     <code>data</code> attribute value as an <abbr>XML</abbr> character  
     data</a>.</li>  
     <li>If the <code>data</code> attribute value contains  
     a string <code>--</code>, or if it ends with a character  
     <code>-</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-comment-com><code>xml-well-formedness-error</code></a>.<!--  
     "for compatibility" --></li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-comment-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Document</code> node</dt>  
   <dd>  
     <ol>  
     <li>If <a href="#xml-version"><abbr>XML</abbr> version</a> of <var>n</var>  
     is different from <code>1.0</code> or <code>1.1</code>,  
     then it is an <code class=ed>unknown-error?</code>.</li>  
     <li>If the <code>xmlEncoding</code> attribute value does <em>not</em>  
     match to <code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code>  
     <span class=ed>@@ formal def</span>, then it is an  
     <a href="#xml-well-formedness-error" id=wfe-encoding><code>xml-well-formedness-error</code></a>.</li>  
     <li>The <code>childNodes</code> list of <var>n</var> have to  
     consist of zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes, followed by  
     an optional <code>DocumentType</code> node, followed  
     by zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes, followed by  
     an <code>Element</code> node, followed  
     by zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes.  Any violation to this is an  
     <a href="#xml-well-formedness-error" id=wfe-document-child><code>xml-well-formedness-error</code></a>.</li>  
     <li>For each node <dfn id=var-document-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>EntityReference</code> node, then  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     <li class=ed>@@ <code>allDeclarationsProcessed</code></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>DocumentFragment</code> node</dt>  
   <dd>  
     <ol>  
     <li>For each node <dfn id=var-df-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>, <code>Text</code>, <code>CDATASection</code>,  
       <code>Comment</code>, <code>ProcessingInstruction</code>, or  
       <code>EntityReference</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-df-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-df-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>DocumentType</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>Follow the following substeps:  
       <ol>  
       <li>If <code>ownerDocument</code> attribute of <var>n</var> is  
       <code>null</code>, then abort these substeps.</li>  
       <li>If <code>documentElement</code> attribute of the node  
       set to <code>ownerDocument</code> attribute of <var>n</var> is  
       <code>null</code>, then abort these substeps.</li>  
       <li>If <code>nodeName</code> attribute of the node set to  
       <code>documentElement</code> attribute of the node set to  
       <code>ownerDocument</code> attribute of <var>n</var> is  
       different from <code>nodeName</code> of <var>n</var>,  
       then raise an  
       <a href="#xml-validity-error" id=vc-roottype><code>xml-validity-error</code></a>.</li></li>  
       </ol>  
     </li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>publicId</code> attribute value of <var>n</var> is  
     <em>not</em> <code>null</code> and the <code>systemId</code> attribute  
     value of <var>n</var> is <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-dt-sid><code>xml-well-formedness-error</code></a>.  
     <span class=ed>@@ publicId == null?  Or, publicId == ""</span></li>  
     <li>For each node <dfn id=var-dt-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a  
       <code>ProcessingInstruction</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-dt-child><code>xml-well-formedness-error</code></a>.  
       <span class=ed>@@ ref to manakai's extensions</span></li>  
       <li>Otherwise, <!-- if n_c is not an EntityReference node, -->  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>  
       </ol></li>  
     <li>For each node in the <code>entities</code>, <code>notations</code>,  
     and <code>elementTypes</code> lists of <var>n</var>,  
     <a href="#algorithm-to-check-a-node" title="check a node">check the  
     node</a> recursively.</li>  
     <li class=ed>@@ externally declared?</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Element</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>localName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>If the <code>prefix</code> attribute value is different from  
     <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate  
     the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>For each node <dfn id=var-element-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or  
       <code>EntityReference</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-element-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-element-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     <li class=ed>@@ #elementvalid Validity constraint: Element Valid</li>  
     <li>Let <var>attrs</var> be the value of the <code>attribute</code>  
     attribute of <var>n</var>.  Check conformance of <var>attrs</var>  
     as following:  
       <ol>  
       <li>If <var>attrs</var> contains an <code>Attr</code> node whose  
       <code>nodeName</code> attribute value is equal to that of another  
       <code>Attr</code> node in <var>attrs</var>, then raise an  
       <a href="#xml-well-formedness-error" id=wfe-uniqattspec><code>xml-well-formedness-error</code></a>.<!--  
       #uniqattspec Well-formedness constraint: Unique Att Spec --></li>  
       <li class=ed>@@ #RequiredAttr Validity constraint: Required Attribute</li>  
       </ol>  
     </li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>ElementTypeDefinition</code> node</dt>  
   <dd>  
     <ol>  
     <li class=ed></li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-et-child><code>xml-well-formedness-error</code></a>.</li>  
     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#elemdecls">At user option, an XML processor MAY issue a warning when a declaration mentions an element type for which no declaration is provided, but this is not an error.</q></li>  
     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#sec-element-content">For compatibility, it is an error if the content model allows an element to match more than one occurrence of an element type in the content model. </q></li>  
     <li class=ed>@@ #vc-MixedChildrenUnique  
     Validity constraint: No Duplicate Types</li>  
     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#attdecls">At user option, an XML processor MAY issue a warning if attributes are declared for an element type not itself declared, but this is not an error.</q></li>  
     <li>If there is more than one <code>AttributeDefinition</code> node  
     with <span class=ed>attribute type <code>ID</code></span> in the  
     <code>NamedNodeMap</code> list contained in the  
     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an  
     <a href="#xml-validity-error" id=vc-one-id-per-el><code>xml-validity-error</code></a>.</li>  
     <li>If there is more than one <code>AttributeDefinition</code> node  
     with <span class=ed>attribute type <code>NOTATION</code></span> in the  
     <code>NamedNodeMap</code> list contained in the  
     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an  
     <a href="#xml-validity-error" id=vc-one-notation-per><code>xml-validity-error</code></a>.</li>  
     <li class=ed>"For interoperability, the same Nmtoken  SHOULD NOT occur more than once in the enumerated attribute types of a single element type."</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Entity</code> node whose  
 <code>notationName</code> attribute value is <code>null</code> (i.e. a  
 parsed entity)</dt>  
   <dd>  
     <ol>  
     <li>Raise an  
     <a href="#entity-error" id=ee-entity-node><code>entity-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>publicId</code> attribute value of <var>n</var> is  
     <em>not</em> <code>null</code> and the <code>systemId</code> attribute  
     value of <var>n</var> is <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-entity-sid><code>xml-well-formedness-error</code></a>.</li>  
     <li>For each node <dfn id=var-entity-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or <code>EntityReference</code>  
       node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-entity-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-er-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Entity</code> node whose  
 <code>notationName</code> attribute value is <em>not</em> <code>null</code>  
 (i.e. an unparsed entity)</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>systemId</code> attribute value of <var>n</var> is  
     <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-uentity-sid><code>xml-well-formedness-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>notationName</code> attribute value of <var>n</var> as an  
     <code>NCName</code></a>.</li>  
     <li class=ed>@@ #not-declared Validity constraint: Notation Declared</li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-uentity-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>EntityReference</code> node</dt>  
   <dd>  
     <ol>  
     <li>An <a href="#entity-error" id=ee-er-node><code>entity-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>For each node <dfn id=var-er-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or <code>EntityReference</code>  
       node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-er-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-entity-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Notation</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-notation-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>ProcessingInstruction</code> node</dt>  
   <dd>  
     <ol>  
     <li>If the <code>target</code> attribute value matches to the string  
     <code>xml</code> in any case combination, then raise a  
     <a href="#xml-well-formedness-error" id=wfe-pi-xml><code>xml-well-formedness-error</code></a>.</li>  
     <li>Otherwise, <a href="#algorithm-to-validate-an-ncname">validate the  
     <code>target</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>Then,  
     <a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">validate  
     the <code>data</code> attribute value as an <abbr>XML</abbr> character  
     data</a>.</li>  
     <li>If the <code>data</code> attribute value contains a string  
     <code>?></code>, then raise a  
     <a href="#xml-well-formedness-error" id=wfe-pi-pic><code>xml-well-formedness-error</code></a>.</li>  
     <li>If the <code>data</code> attribute value starts with either  
     <code class=char>U+0009</code> <code class=charname>CHARACTER  
     TABULATION</code>, <code class=char>U+000A</code> <code class=charname>LINE  
     FEED</code>, <code class=char>U+000D</code> <code class=charname>CARRIAGE  
     RETURN</code>, or <code class=char>U+0020</code>  
     <code class=charname>SPACE</code> character, then raise a  
     <a href="#round-trip-error" id=rte-pi-s><code>round-trip-error</code></a>.</li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-pi-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
368    </dd>    </dd>
369  <dt>If <var>n</var> is a <code>Text</code> node</dt>  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
370    method</dt>
371    <dd>    <dd>
372      <ol>      <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
373      <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the      with the specified name, which represents a general entity, belonging to
374      <code>data</code> attribute value as an <abbr>XML</abbr> character      the document.</p>
375      data</a>.</li>      <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
376      <li>If the <code>childNodes</code> list of <var>n</var> contains      parameter is the name of the general entity.</p>
377      any nodes, they are in  
378      <a href="#xml-well-formedness-error" id=wfe-text-child><code>xml-well-formedness-error</code></a>.</li>      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
379      </ol>      an <a href="#Entity"><code>Entity</code></a> node with the following
380        attributes:</p>
381        <dl>
382        <dt><code>attributes</code>, <code>notationName</code>,
383        <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
384        and <code>parentNode</code></dt>
385          <dd><code>null</code>.</dd>
386        <dt><code>childNodes</code></dt>
387          <dd>An empty <code>NodeList</code> object.</dd>
388        <dt><code>manakaiDeclarationBaseURI</code>,
389        <code>manakaiEntityBaseURI</code>, and
390        <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
391          <dd>No explicit value is set.</dd>
392        <dt><code>manakaiHasReplacementTree</code> and
393        <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
394          <dd><code>false</code>.</dd>
395        <dt><code>nodeName</code></dt>
396          <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
397          <dd>
398            <div class="note memo">
399              <p>It is not an error for
400              <a href="#createGeneralEntity-name"><var>name</var></a> matching
401              to the name of one of predefined general parsed entities in
402              <abbr>XML</abbr> or <abbr>HTML</abbr>.  For example,
403              <a href="#createGeneralEntity-name"><var>name</var></a> might be
404              <code>amp</code>, resulting in an
405              <a href="#Entity"><code>Entity</code></a> node
406              with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
407            </div>
408          </dd>
409        <dt><code>ownerDocument</code></dt>
410          <dd>The <code>Document</code> node over which the method is invoked.</dd>
411        <dt><code>publicId</code>, and <code>systemId</code></dt>
412          <dd><code>null</code>.</dd>
413          <dd class=ed>@@ publicId and systemId should be empty string?</dd>
414        <dt class=ed>@@ Ensure all attributes are defined</dd>
415        </dl>
416      </dd>
417    <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
418    method</dt>
419      <dd>
420        <p>This method creates a <code>Notation</code> node with the
421        specified name, belonging to the document.</p>
422        <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
423        parameter is the name of the notation.</p>
424    
425        <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
426        a <code>Notation</code> node with the following attributes:</p>
427        <dl>
428        <dt><code>attributes</code>,
429        <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
430        and <code>parentNode</code></dt>
431          <dd><code>null</code>.</dd>
432        <dt><code>childNodes</code></dt>
433          <dd>An empty <code>NodeList</code> object.</dd>
434        <dt><code>manakaiDeclarationBaseURI</code></dt>
435          <dd>No explicit value is set.</dd>
436        <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
437          <dd><code>false</code>.</dd>
438        <dt><code>nodeName</code></dt>
439          <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
440        <dt><code>ownerDocument</code></dt>
441          <dd>The <code>Document</code> node over which the method is invoked.</dd>
442        <dt><code>publicId</code> and <code>systemId</code></dt>
443          <dd><code>null</code>.</dd>
444          <dd class=ed>@@ publicId and systemId should be empty string?</dd>
445        <dt class=ed>@@ Ensure all attributes are defined</dt>
446        </dl>
447    </dd>    </dd>
 <dt>Otherwise</dt>  
   <dd><span class=ed>xml-well-formedness-error?  unknown-error?</span></dd>  
448  </dl>  </dl>
449    
450  </div>  <p>These methods <em class=rfc2119>MUST</em> raise an
451    <code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>
452    if <var>name</var> is <em>not</em> a legal <code>Name</code> according to
453    the <abbr>XML</abbr> version in use, as specified in the
454    <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>
455    
456  </div>  <div class="note memo">
457    <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
458    since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not
459    define it for <code>Document</code> methods.</p>
460    
461    <p><var>name</var> does not have to be a namespace qualified name.</p>
462    </div>
463    
464    </div>
465    
466    <div class=section id=section-documenttypedefinition>
467    <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
468    
469    <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
470      readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
471      readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
472      readonly attribute NamedNodeMap <a href="#notations">notations</a>;
473    
474      <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
475        (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
476      <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
477        (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
478      <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
479        (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
480    
481      void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
482        (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
483        raises (DOMException);
484      void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
485        (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
486        raises (DOMException);
487      void <a href="#setNotationNode">setNotationNode</a>
488        (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
489        raises (DOMException);
490    }</code></pre>
491    
492    <pre class=ed>
493    [1] In an implementation that supports the
494    [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]
495    feature, a [CODE(DOMi)@en[[[DocumentType]]]] node
496    must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
497    interface.  See [[DOM XML Document Type Definition]>>3] for
498    details.
499    </pre>
500    
501    <dl>
502    <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
503    type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
504      <dd><p>A live <code>NamedNodeMap</code> object that contains all the element
505      type definitions belonging to the <code>DocumentType</code> node.</p>
506    
507      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
508      <code>NamedNodeMap</code> object that contains all the
509      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
510      nodes belonging to the <code>DocumentType</code> node.  The
511      <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
512      if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
513      object <em class=rfc2119>MUST</em> be live and the same object
514      <em class=rfc2119>MUST</em> be returned for any invocation.</p>
515    
516      <p>If the <code>DocumentType</code> node is created during the process
517      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
518      requirements are applied:  The <code>NamedNodeMap</code> object in the
519      <a href="#elementTypes"><code>elementType</code></a> attribute
520      <em class=rfc2119>MUST</em> be so transformed that the object contains
521      the <code>ElementTypeDefinition</code> nodes for the element types
522      whose name is presented as the <code>Name</code> of the element type or
523      attribute definition list declarations processed by the <abbr>XML</abbr>
524      processor.  If there is more than one element type declarations for an
525      element type, then the declarations other than the first one
526      <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
527      <code>NamedNodeMap</code> object.</p></dd>
528    <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
529    of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
530      <dd><p>A live <code>NamedNodeMap</code> object that contains all the general
531      entities belonging to the <code>DocumentType</code> node.</p>
532      
533      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
534      same value as the <code>entities</code> attribute (defined in the
535      <code>DocumentType</code> interface) of the same node.</p>
536    
537      <div class="note memo">
538        <p>This attribute is part of the interface for historical reason.</p>
539      </div></dd>
540    <!--
541    All entities declared in the document type definition
542    contained in or referenced from the document entity
543    might not be exposed through this collection, depending
544    on the information provided by the XML processor for
545    the DOM implementation.  In particular, it might not
546    contain any entity if entity references are expanded
547    at the parse time.  An implementation [['''MUST NOT''']]
548    expose an [CODE(DOMi)@en[[[Entity]]]] node whose [CODE(DOMa)@en[[[nodeName]]]]
549    is equal to the name of one of five predefined general entities in
550    XML through the collection as the result of parsing of an XML
551    document that has no error.  Duplicate entity declarations are also discarded.
552    
553    The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
554    object that contains all the [CODE(DOMi)@en[[[Entity]]]] nodes
555    representing general entities belong to the node.  The returned
556    [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if
557    the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
558    and therefore any change of read-only flag on the node is immediately
559    reflected by that of the object.
560    -->
561    <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
562    <code>notations</code>, read$B!>(Bonly</code>
563      <dd><p>A live <code>NamedNodeMap</code> object that contains all the
564      notations belonging to the <code>DocumentType</code> node.</p>
565      
566      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
567      same value as the <code>notations</code> attribute (defined in the
568      <code>DocumentType</code> interface) of the same node.</p>
569    
570      <div class="note memo">
571        <p>This attribute is part of the interface for historical reason.</p>
572        <p>Implementations are not required to implement the
573        <code>notations</code> attribute twice (for <code>DocumentType</code>
574        and <code>DocumentTypeDefinition</code> interfaces); they share exactly
575        same definition.</p>
576      </div></dd>
577    <!--
578    If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
579    created from an XML document, duplicate notation declarations, if any, in DTD
580    [['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]
581    object and only the first declaration [['''MUST''']] be
582    made available as a [CODE(DOMi)@en[[[Notation]]]] node.
583    
584    ;; This definition is based on one for the
585    [CODE(DOMa)@en[[[notations]]]] attribute of the
586    [CODE(DOMi)@en[[[DocumentType]]]] interface in DOM XML module.
587    Since duplication is violation to the Validity Constraint,
588    XML parsers might vary on how notations are notified to
589    the application.  In particular, [CODE(InfoProp)@en[[[notations]]]]
590    property of the document information item in XML Information Set
591    is so defined that in case ''any'' notation is declared for
592    multiple times then the property has no value.
593    
594    The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
595    object that contains all the [CODE(DOMi)@en[[[Notation]]]] nodes
596    representing notations belong to the node.  The returned
597    [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if
598    the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
599    and therefore any change of read-only flag on the node is immediately
600    reflected by that of the object.
601    -->
602    
603  <div id=classes class=section>  <dt class=ed>@@ other members...
604  <h2>Character Classes</h2>  </dl>
605    
606  <p>This section defines a couple of character classes.  <div class=ed>
607  These classes are referred to by algorithms specified above.</p>  <p>A future version of this interface might define the
608    <code>parameterEntities</code> and getter/setter for parameter entities.
609    </div>
610    
611    </div>
612    
613    <div class=section id=section-elementtypedefinition>
614    <h3>The <code>ElementTypeDefinition</code> Interface</h3>
615    
616    <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
617      readonly attribute <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
618    
619      <span class=ed>@@ more</span>
620    }</code></pre>
621    
622    <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
623    
624    [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
625    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
626    [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
627    
628    [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
629    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
630    [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
631    of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
632    [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.
633    Note that it might be [CODE(IDL)@en[[[null]]]].
634    
635    [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
636    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
637    [['''MUST''']] return the name of the element type.
638    
639    [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]
640    and [CODE(DOMa)@en[[[textContent]]]] attributes
641    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
642    object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
643    
644    ;; Thus, the setter of these attributes do nothing.
645    
646    The setter of the [CODE(DOMa)@en[[[textContent]]]]
647    attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
648    object [['''MUST NOT''']] throw a
649    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
650    
651    ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface
652    
653    [5] The
654    [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
655    of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
656    interface is defined in [[manakai//DOM Extensions]>>50].</pre>
657    </div>
658    
659    <div class=section id=section-attributedefinition>
660    <h3>The <code>AttributeDefinition</code> Interface</h3>
661    
662    <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
663      <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
664      const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
665      const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
666      const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
667      const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
668      const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
669      const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
670      const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
671      const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
672      const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
673      const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
674      const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
675      const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
676      
677      readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
678    
679      readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
680      readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
681    
682      <span class=ed>...</span>
683    }</code></pre>
684    
685    <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
686    
687    [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
688    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
689    [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
690    
691    [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
692    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
693    [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
694    of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
695    [CODE(DOMi)@en[[[AttributeDefinition]]]] object.
696    Note that it might be [CODE(IDL)@en[[[null]]]].
697    
698    [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
699    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
700    [['''MUST''']] return the name of the attribute.
701    
702    [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
703    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
704    [['''MUST''']] return the normalized default value
705    of the attribute.
706    
707    @@
708    
709    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
710    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
711    object [['''MUST''']] behave as if it were an
712    [CODE(DOMi)@en[[[Attr]]]] object.
713    
714    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
715    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
716    [['''MUST''']] behave as if the following algorithm
717    is performed:
718    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
719    object is read-only, then throw an
720    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
721    = Remove any child node the node has.
722    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
723    then create a [CODE(DOMi)@en[[[Text]]]] node
724    whose [CODE(DOMa)@en[[[data]]]] is the new value
725    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
726    </pre>
727    
728    <dl>
729    <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
730    of type
731    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
732    read$B!>(Bonly</dt>
733      <dd><p>The
734      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
735      which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
736      node belongs.</p>
737    
738      <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
739      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
740      It <em class=rfc2119>MUST</em> be such a node that whose
741      <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
742      attribute contains the <code>NamedNodeMap</code> object that contains
743      the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
744      node.  If there is no such an
745      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
746      then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
747    <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
748    <code>unsigned short</code></dt>
749      <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
750      It is expected that this attribute contains a value from the definition group
751      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
752    
753      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
754      value associated to this attribute.</p>
755    
756      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
757      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
758      exception if the
759      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
760      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
761      <em class=rfc2119>MUST</em> set the specified value as the value
762      associated to this attribute.</p>
763    
764      <p>If the <code>AttributeDefinition</code> node is created during the process
765      to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
766      appropriate value from the
767      <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
768      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
769    
770      <!-- DeclaredValueType -->
771    <p>The definition group
772    <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
773    integers indicating the declared type of attributes.  The definition
774    group contains the following constants:</p>
775    
776    <table>
777    <thead>
778    <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
779    </thead>
780    <tbody>
781    <tr>
782    <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
783    <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
784    <tr>
785    <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
786    <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>
787    <tr>
788    <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
789    <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>
790    <tr>
791    <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
792    <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
793    <tr>
794    <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
795    <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
796    <tr>
797    <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
798    <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
799    <tr>
800    <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
801    <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>
802    <tr>
803    <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
804    <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
805    <tr>
806    <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
807    <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>
808    <tr>
809    <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
810    <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
811    <tr>
812    <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
813    <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>
814    <tr>
815    <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
816    <td><code>11</code><td>Unknown, because no declaration for the attribute
817    has been read but the [all declaration processed] property
818    <span class=ed>[INFOSET]</span> would be false.</tr>
819    </tbody>
820    </table>
821    
822    <p>If no attribute type information is available, or if the source
823    of the information does not distinguish <q>no value</q> and <q>unknown</q>
824    <span class=ed>[INFOSET]</span>, then the value
825    <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
826    <em class=rfc2119>MUST</em> be used.</p>
827    
 <p>Character class <dfn id=class-Char10><code>Char10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li><code class=char>U+0009</code> <code class=charname>CHARACTER  
 TABULATION</code></li>  
 <li><code class=char>U+000A</code> <code class=charname>LINE FEED</code></li>  
 <li><code class=char>U+000D</code> <code class=charname>CARRIAGE  
 RETURN</code></li>  
 <li><code class=char>U+0020</code> <code class=charname>SPACE</code>  
 .. <code class=char>U+D7FF</code></li>  
 <li><code class=char>U+E000</code> .. <code class=char>U+FFFD</code>  
 <code class=charname>REPLACEMENT CHARACTER</code></li>  
 <li><code class=char>U+10000</code> .. <code class=char>U+10FFFF</code></li>  
 </ul>  
828  <div class="note memo">  <div class="note memo">
829  <p>This character class contains all characters allowed in the production rule  <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
830  <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Char"><code>Char</code></a>  created by the
831  of <abbr>XML</abbr> 1.0  <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
832  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  method has its <a href="#declaredType"><code>declaredType</code></a> attribute
833    set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
834    </div>
835    
836    <p>If the source of the information does not distinguish <q>no value</q>
837    and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
838    <code>CDATA</code> <span class=ed>[XML]</span>, then the value
839    <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
840    be used.</p>
841    
842    <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
843    <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
844    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
845    definition group.</p>
846    
847      </dd>
848    <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
849    type <code>unsigned short</code></dt>
850      <dd><p>The type of the default for the attribute.  It is expected that this
851      attribute contains a value from the definition group
852      <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
853    
854      <p>On getting, the attribute <em class=rfc2119>MUST</em> return
855      the value associated to this attribute.</p>
856    
857      <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
858      <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
859      exception if the
860      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
861      is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
862      <em class=rfc2119>MUST</em> set the specified value as the value
863      associated to this attribute.</p>
864    
865      <p>If the
866      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
867      created during the process to create a <abbr>DOM</abbr> from an
868      <abbr>XML</abbr> document, an appropriate value from the
869      <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
870      group <em class=rfc2119>MUST</em> be set to the attribute.</p>
871    
872      <!-- DefaultValueType -->
873      <p>The definition group
874      <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
875      contains integers indicating the type of the default for the attribute.
876      The definition group contains the following constans:</p>
877    
878      <table>
879      <thead>
880      <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
881      </thead>
882      <tbody>
883      <tr>
884      <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
885      <td><code>0</code><td>Unknown.</tr>
886      <tr>
887      <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
888      <td><code>1</code><td>Provided explicitly and fixed
889      <span class=ed>@@ ref</span> to that value.</tr>
890      <tr>
891      <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
892      <td><code>2</code><td>No default value and the attribute have to be
893      explicitly specified.</tr>
894      <tr>
895      <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
896      <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
897      <tr>
898      <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
899      <td><code>4</code><td>Provided explicitly.</tr>
900      </tbody>
901      </table>
902    
903      <p>If the source of the default type does not distinguish
904      implied and unknown default types, then the value
905      <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
906      <em class=rfc2119>MUST</em> be used.</p>
907    
908      <div class="note memo">
909      <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
910      node created by the
911      <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
912      method has its <a href="#defaultType"><code>defaultType</code></a>
913      attribute set to
914      <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
915      </div></dd>
916    </dl>
917    
918  </div>  </div>
919    
920  <p>Character class <dfn id=class-CompatChar10><code>CompatChar10</code></dfn>  <div class=section id=section-documenttype>
921  contains the following characters:</p>  <h3>Modifications to the <code id=DocumentType>DocumentType</code>
922  <ul>  Interface</h3>
923  <li class=ed>@@ <q>Document authors are encouraged to avoid "compatibility characters", as defined in section 6.8 of [Unicode @@ Unicode 2.0 @@] (see also D21 in section 3.6 of [Unicode3]).</q></li>  
924  </ul>  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
925    <em class=rfc2119>MAY</em> contain zero or more
926    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
927    nodes in the <code>NodeList</code> object contained in the
928    <code>childNodes</code> attribute of the
929    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
930    
931    <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
932    during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
933    document, the <code>NodeList</code> object in the <code>childNodes</code>
934    object <em class=rfc2119>MUST</em> contains the
935    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
936    nodes representing the processing instructions in the document type
937    definition of the document processed <span class=ed>@@ ref</span> by
938    the <abbr>XML</abbr> processor.  If the
939    <a href="#DocumentType"><code>DocumentType</code></a> node is marked
940    as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
941    also be marked as read$B!>(Bonly.</p>
942    
943    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
944    from a document type declaration information item <span class=ed>@@ ref</span>,
945    the <code>NodeList</code> object in the <code>childNodes</code> attribute
946    of the node <em class=rfc2119>MUST</em> contain the
947    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
948    created from the processing instruction information items in the list in the
949    [children] property of the document type declaration item in the same
950    order.</p>
951    
952    <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
953    a document type declaration information item, the list in the [children]
954    property <em class=rfc2119>MUST</em> contain the processng instruction
955    information items created from the
956    <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
957    in the <code>NodeList</code> object in the <code>childNodes</code> attribute
958    of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
959    
960    <pre class=idl><code>// Modifications to the DocumentType interface
961      attribute DOMString <a href="#publicId">publicId</a>;
962      attribute DOMString <a href="#systemId">systemId</a>;
963    
964      attribute DOMString <a href="#internalSubset">internalSubset</a>;
965    </code></pre>
966    
967    <p>The <code id=publicId>publicId</code> attribute and the
968    <code id=systemId>systemId</code> attribute of
969    <a href="#DocumentType"><code>DocumentType</code></a>,
970    <a href="#Entity"><code>Entity</code></a>, and
971    <a href="#Notation"><code>Notation</code></a> interfaces are no longer
972    read$B!>(Bonly.</p>
973    
974    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
975    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
976    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
977    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
978    associated to the attribute.  No normalization, relative reference resolution,
979    or lexical validation is performed. <span class=ed>@@ If the new
980    value is <code>null</code>, ...</span></p>
981    
 <p>Character class <dfn id=class-ControlChar10><code>ControlChar10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li><code class=char>U+007F</code> <code class=charname>DELETE</code> ..  
 <code class=char>U+0084</code> <code class=charname>INDEX</code></li>  
 <li><code class=char>U+0086</code> <code class=charname>START OF SELECTED  
 AREA</code> .. <code class=char>U+009F</code> <code class=charname>APPLICATION  
 PROGRAM COMMAND</code></li>  
 <li><code class=char>U+FDD0</code> .. <code class=char>U+FDEF</code></li>  
 <li><code class=char>U+1FFFE</code> .. <code class=char>U+1FFFF</code></li>  
 <li><code class=char>U+2FFFE</code> .. <code class=char>U+2FFFF</code></li>  
 <li><code class=char>U+3FFFE</code> .. <code class=char>U+3FFFF</code></li>  
 <li><code class=char>U+4FFFE</code> .. <code class=char>U+4FFFF</code></li>  
 <li><code class=char>U+5FFFE</code> .. <code class=char>U+5FFFF</code></li>  
 <li><code class=char>U+6FFFE</code> .. <code class=char>U+6FFFF</code></li>  
 <li><code class=char>U+7FFFE</code> .. <code class=char>U+7FFFF</code></li>  
 <li><code class=char>U+8FFFE</code> .. <code class=char>U+8FFFF</code></li>  
 <li><code class=char>U+9FFFE</code> .. <code class=char>U+9FFFF</code></li>  
 <li><code class=char>U+AFFFE</code> .. <code class=char>U+AFFFF</code></li>  
 <li><code class=char>U+BFFFE</code> .. <code class=char>U+BFFFF</code></li>  
 <li><code class=char>U+CFFFE</code> .. <code class=char>U+CFFFF</code></li>  
 <li><code class=char>U+DFFFE</code> .. <code class=char>U+DFFFF</code></li>  
 <li><code class=char>U+EFFFE</code> .. <code class=char>U+EFFFF</code></li>  
 <li><code class=char>U+FFFFE</code> .. <code class=char>U+FFFFF</code></li>  
 <li><code class=char>U+10FFFE</code> .. <code class=char>U+10FFFF</code></li>  
 </ul>  
982  <div class="note memo">  <div class="note memo">
983  <p>This character class contains the characters listed in the Note in  <p>Setting an invalid identifier might make the node unserializable.
984  <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#charsets">Section 2.2</a>  Setting a public identifier while leaveing system identifier unspecified
985  of <abbr>XML</abbr> 1.0  would also make the <a href="#DocumentType"><code>DocumentType</code></a>
986  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>,  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
987  as amended by  </div>
988  <a href="http://www.w3.org/XML/xml-V10-4e-errata#E02">errata</a>.</p>  
989  </div>  <div class=ed>
990    <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
991    </div>
992    
993    <p>The <code id=internalSubset>internalSubset</code> attribute of the
994    <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
995    read$B!>(Bonly.</p>
996    
997    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
998    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
999    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  
1000    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
1001    associated to the attribute.  No normalization, or lexical validation is
1002    performed. <span class=ed>@@ If the new value is <code>null</code>,
1003    ...</span></p>
1004    
 <p>The character class <dfn id=class-NameStartChar10><code>NameStartChar10</code></dfn>  
 contains the following characters:</p>  
 <ul class=ed>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed as the first character  
 of a string matching to the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
1005  </div>  </div>
1006    
 <p>The character class <dfn id=class-NameChar10><code>NameChar10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li>The characters in the character class  
 <a href="#class-NameStartChar10">NameStartChar10</a>.</li>  
 <li class=ed></li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed as the second  
 character of a string matching to the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
1007  </div>  </div>
1008    
 <p>The character class <dfn id=class-PubidChar><code>PubidChar</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li><code class=char>U+0009</code> <code class=charname>CHARACTER  
 TABULATION</code></li>  
 <li><code class=char>U+000A</code> <code class=charname>LINE FEED</code></li>  
 <li><code class=char>U+000D</code> <code class=charname>CARRIAGE  
 RETURN</code></li>  
 <li><code class=char>U+0020</code> <code class=charname>SPACE</code></li>  
 <li><code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code>  
 (<code class=char>!</code>)</li>  
 <li><code class=char>U+0023</code> <code class=charname>DOLLAR SIGN</code>  
 (<code class=char>$</code>)</li>  
 <li><code class=char>U+0024</code> <code class=charname>NUMBER SIGN</code>  
 (<code class=char>#</code>)</li>  
 <li><code class=char>U+0025</code> <code class=charname>PERCENT SIGN</code>  
 (<code class=char>%</code>)</li>  
 <li><code class=char>U+0027</code> <code class=charname>APOSTROPHE</code>  
 (<code class=char>'</code>)</li>  
 <li><code class=char>U+0028</code> <code class=charname>LEFT PARENTHESIS</code>  
 (<code class=char>(</code>)</li>  
 <li><code class=char>U+0029</code> <code class=charname>RIGHT  
 PARENTHESIS</code> (<code class=char>)</code>)</li>  
 <li><code class=char>U+002A</code> <code class=charname>ASTERISK</code>  
 (<code class=char>*</code>)</li>  
 <li><code class=char>U+002B</code> <code class=charname>PLUS SIGN</code>  
 (<code class=char>+</code>)</li>  
 <li><code class=char>U+002C</code> <code class=charname>COMMA</code>  
 (<code class=char>,</code>)</li>  
 <li><code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>  
 (<code class=char>-</code>)</li>  
 <li><code class=char>U+002E</code> <code class=charname>FULL STOP</code>  
 (<code class=char>.</code>)</li>  
 <li><code class=char>U+002F</code> <code class=charname>SOLIDUS</code>  
 (<code class=char>/</code>)</li>  
 <li><code class=char>U+0030</code> <code class=charname>DIGIT ZERO</code>  
 (<code class=char>0</code>) .. <code class=char>U+0039</code>  
 <code class=charname>DIGIT NINE</code> (<code class=char>9</code>)</li>  
 <li><code class=char>U+003A</code> <code class=charname>COLON</code>  
 (<code class=char>:</code>)</li>  
 <li><code class=char>U+003B</code> <code class=charname>SEMICOLON</code>  
 (<code class=char>;</code>)</li>  
 <li><code class=char>U+003D</code> <code class=charname>EQUAL SIGN</code>  
 (<code class=char>=</code>)</li>  
 <li><code class=char>U+003F</code> <code class=charname>QUESTION MARK</code>  
 (<code class=char>?</code>)</li>  
 <li><code class=char>U+0040</code> <code class=charname>COMMERCIAL AT</code>  
 (<code class=char>@</code>)</li>  
 <li><code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER  
 A</code> (<code class=char>A</code>) .. <code class=char>U+005A</code>  
 <code class=charname>LATIN CAPITAL LETTER Z</code>  
 (<code class=char>Z</code>)</li>  
 <li><code class=char>U+005F</code> <code class=charname>LOW LINE</code>  
 (<code class=char>_</code>)</li>  
 <li><code class=char>U+0061</code> <code class=charname>LATIN CAPITAL LETTER  
 A</code> (<code class=char>A</code>) .. <code class=char>U+007A</code>  
 <code class=charname>LATIN CAPITAL LETTER Z</code>  
 (<code class=char>Z</code>)</li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed in the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-PubidChar"><code>PubidChar</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
 </div>  
1009    
1010  </div>  
1011    
1012    
1013  <div id="references" class="section reference">  <div id="references" class="section reference">
1014  <h2>References</h2>  <h2>References</h2>
Legend:
Removed from v.1.1  
changed lines
  Added in v.1.14
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24