/[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.20 by wakaba, Wed Dec 5 10:26:35 2007 UTC revision 1.23 by wakaba, Sat Dec 8 10:24:35 2007 UTC
# Line 10  Line 10 
10    
11  <div class="header">  <div class="header">
12  <h1>DOM Document Type Definition Module</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-05>5 December 2007</time></h2>  <h2>Working Draft <time datetime=2007-12-08>8 December 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 50  available at <code class="URI">&lt;<a Line 50  available at <code class="URI">&lt;<a
50  <div id="abstract" class="section">  <div id="abstract" class="section">
51  <h2>Abstract</h2>  <h2>Abstract</h2>
52    
53  <div class="ed issue">...</div>  <p>The <abbr>DOM</abbr> Document Type Definition module is a set of
54    <abbr>DOM</abbr> interfaces, including both new interfaces and modifications
55    to existing <abbr>DOM</abbr> interfaces, over which <abbr>DOM</abbr>
56    applications are able to access to the definitions of the document type.</p>
57  </div>  </div>
58    
59  <div id="status" class="section">  <div id="status" class="section">
# Line 80  normative version.</p> Line 82  normative version.</p>
82    
83  <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>
84    
 <div class="issue ed">  
 <p>This is a work-in-progress specification for DOM Document Type  
 Definition module, as implemented by manakai and  
 <a href="http://suika.fam.cx/gate/2005/sw/DOM%20XML%20Document%20Type%20Definition">partially documented in the SuikaWiki</a>.</p>  
 </div>  
   
85  <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>  <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>
86  module is a set of <abbr>DOM</abbr> interfaces, including both new  module is a set of <abbr>DOM</abbr> interfaces, including both new
87  interfaces and modifications to existing <abbr>DOM</abbr> interfaces,  interfaces and modifications to existing <abbr>DOM</abbr> interfaces,
88  over which <abbr>DOM</abbr> applications are able to access to the  over which <abbr>DOM</abbr> applications are able to access to the
89  definitions of the document type.</p>  definitions of the document type.</p>
90    
91  <p>Interfaces defined in this specification are partially modeled from  <p>Interfaces defined in this document are partially modeled and inspired by
92  early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>,  early drafts of <abbr>DOM</abbr> Level 1
93  <abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and  <cite class="bibref informative">[<a href="#ref-DOM1WD">DOM1WD</a>]</cite>,
94  <abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with  <abbr>DOM</abbr> Level 3 Abstract Schemas <abbr>W3C</abbr> Note
95  any of them as a whole.</p>  <cite class="bibref informative">[<a href="#ref-DOM3AS">DOM3AS</a>]</cite>,
96    and <abbr>XML</abbr> Schema <abbr>API</abbr> specification
97    <cite class="bibref informative">[<a href="#ref-XSAPI">XSAPI</a>]</cite>, but
98    they are not compatible with any of them as a whole.</p>
99  </div>  </div>
100    
101  <div class="section" id="terminology">  <div class="section" id=conformance>
102  <h2>Terminology</h2>  <h2>Conformance Requirements</h2>
103    
104  <p>The key words <q><em class="rfc2119">MUST</em></q>,  <div class=section id=terminology>
105  <q><em class="rfc2119">MUST NOT</em></q>,  <h3>Terminology</h3>
 <q><em class="rfc2119">SHOULD</em></q>,  
 <q><em class="rfc2119">SHOULD NOT</em></q>, and  
 <q><em class=rfc2119>MAY</em></q> in this  
 document are to be interpreted as described in  
 <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>  
 2119</a>  
 <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>  
106    
 <!-- Strictly speaking the paragraph below is not part of terminology. -->  
107  <p>All examples and notes in this specification are non$B!>(Bnormative,  <p>All examples and notes in this specification are non$B!>(Bnormative,
108  as are all sections explicitly marked non$B!>(Bnormative.  Everything  as are all sections explicitly marked non$B!>(Bnormative.  Everything
109  else in this specification is normative.</p>  else in this specification is normative.</p>
110    
111  <p><span class=ed>Algorithm is normative but non-normative</span>.  <p>The key words <q><em class="rfc2119">MUST</em></q>,
112  In addition, the order in which <a href="#errors">errors</a> are  <q><em class="rfc2119">MUST NOT</em></q>, and <q><em class=rfc2119>MAY</em></q>
113  raised is undefined.</p>  in this document are to be interpreted as described in
114    <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
115    2119</a>
116    <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
117    
118  <p class=ed><var>A</var> object is an object implementing <var>A</var>  <p>Conformance requirements phrased as algorithms or specific steps
119  interface.</p>  <em class=rfc2119>MAY</em> be implemented in any manner, so long as the end
120    result is equivalent.  Requirements phrased in the imperative as part of
121    algorithms are to be interpreted with the meaning of the key word used in
122    introducing the algorithm.</p>
123    
124    <p>Sometimes an exception is phrased as being required to be raised.  As
125    specified in the <abbr>DOM</abbr> Core specification
126    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>,
127    when the value of the <code>strictErrorChecking</code> attribute of the
128    <a href="#Document"><code>Document</code></a> node is <code>false</code>,
129    then the exception is not have to be raised.</p>
130    
131    <p>Some conformance requirements are phrased as requirements on interfaces,
132    attributes, methods, or objects.  Such requirements are applied to
133    implementations.</p>
134    
135    <p>The construction <q>a <code><var>Foo</var></code> object</q>, where
136    <code><var>Foo</var></code> is an interface, is used instead of the more
137    accurate <q>an object implementing the interface
138    <code><var>Foo</var></code></q>.</p>
139    
140    <p>The construction <q>raise a <code><var>Bar</var></code></q>, where
141    <code><var>Bar</var></code> is an exception code, is used instead of the more
142    accurate <q>raise an exception implementing the interface
143    <code>DOMException</code>
144    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
145    with its <code>code</code> attribute set to
146    <code><var>Bar</var></code></q>.</p>
147    
148    <p>The terms
149    <em id=live><a href="http://www.whatwg.org/specs/web-apps/current-work/#live">live</a></em>
150    and <em id=setting>setting</em> and <em id=getting>getting</em> of an attribute
151    is defined in the HTML5 specification
152    <cite class="bibref normative">[<a href="#ref-HTML5">HTML5</a>]</cite>.</p>
153    
154    <p>The term
155    <em id=read-only><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-readonly-node">read$B!>(Bonly (node)</a></em>
156    is defined in the <abbr>DOM</abbr> Level 3 Core specification
157    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
158    
159  <p class=ed>@@ ref to DOM Binding Spec</p>  <p class=ed>@@ ref to DOM Binding Spec</p>
160    </div>
161    
162  <p>If the <code>strictErrorChecking</code> attribute of the  <div class=section id=conformance-categories>
163  <code>Document</code> node is <code>false</code>, the methods are  <h3>Conformance Categories</h3>
 not required to raise exceptions <span class=ed>[DOM3]</span>.</p>  
164    
165  <div class=ed>  <p>There are several kinds of products that can be claim to conform to
166  <p>Conformant product classes: implementation, XML parser (XML document ->  this specification:</p>
167  DOM converter), XML serializer (DOM -> XML document covnerter).  <dl>
168  XML Infoset -> DOM converter, and DOM -> XML Infoset converter.</p>  <dt id=category-dom-implementation><abbr>DOM</abbr> Implementation</dt>
169      <dd>A <abbr>DOM</abbr> implementation (or just written as
170      <q>implementation</q> in this document) provides a way to access
171      <abbr>DOM</abbr> trees for applications by implementing interfaces defined
172      by this and other documents.  Unless otherwise noted, requirements in this
173      document are applied to <abbr>DOM</abbr> implementations.  To implement
174      all the features in this document, the implementation have to implement
175      some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core
176      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>)
177      with one or more language binding (e.g. ECMAScript or Java binding <span class=ed>[BINDINGS]</span> or
178      Perl binding <span class=ed>[PERLBINDING]</span>).</dd>
179    <dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document
180    to <abbr>DOM</abbr> tree converter)</dt>
181      <dd>A software component that converts
182      <abbr>XML</abbr> 1.0 or 1.1 document
183      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
184      <a href="#ref-XML11">XML11</a>]</cite> (or fragment thereof) into a
185      <abbr>DOM</abbr> tree (or fragment thereof) in the context of this
186      document.  Note that this document does not define any particular way to
187      parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr>
188      document, but it defines constraints for such processing.</dd>
189    <dt id=category-xml-serializer><abbr>XML</abbr> Serializer (<abbr>DOM</abbr>
190    tree to <abbr>XML</abbr> document converter)</dt>
191      <dd>A software component that converts
192      <abbr>DOM</abbr> tree (or fragment thereof) into an <abbr>XML</abbr> 1.0 or
193      1.1 document (or fragment thereof).  Note that this document does not define
194      any particular way to serialize a <abbr>DOM</abbr> tree, but it defines
195      constraints for such processing.</dd>
196    <dt id=category-infoset-dom><abbr>XML</abbr> Information Set to
197    <abbr>DOM</abbr> Tree Converter</dt>
198      <dd>A software component that converts an <abbr>XML</abbr> information set
199      <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
200      into a <abbr>DOM</abbr> tree.  Note that this documetn does not define
201      any particular way for the convertion, but it defines constraints for
202      such processing.</dd>
203    <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>
204    Information Set Converter</dt>
205      <dd>A software component that converts a <abbr>DOM</abbr> tree into
206      an <abbr>XML</abbr> information set.  Note that this documetn does not define
207      any particular way for the convertion, but it defines constraints for
208      such processing.</dd>
209    </dl>
210  </div>  </div>
211  </div>  </div>
212    
# Line 151  In addition, it modifies existing interf Line 224  In addition, it modifies existing interf
224  <a href="#Document"><code>Document</code></a>,  <a href="#Document"><code>Document</code></a>,
225  <a href="#DocumentType"><code>DocumentType</code></a>,  <a href="#DocumentType"><code>DocumentType</code></a>,
226  <a href="#Entity"><code>Entity</code></a>, and  <a href="#Entity"><code>Entity</code></a>, and
227  <a href="#Notation"><code>Notation</code></a>.</p>  <a href="#Notation"><code>Notation</code></a>
228    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
229    
230  <div class=section id=features>  <div class=section id=features>
231  <h3>Feature Name</h3>  <h3>Feature String</h3>
232    
233  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of
234  the <abbr>DOM</abbr> Document Type Definition module, the  the <abbr>DOM</abbr> Document Type Definition module, the
235  <code>hasFeature</code> method of a <code>DOMImplementation</code> object  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
236    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
237  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
238  set to  set to
239  <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>  <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>
240  and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.</p>  and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.  Any
241    method that takes one or more feature names, with or without version number,
242  <p>In such an implementation, the <code>getFeature</code> method of a  such as <code>hasFeature</code> or <code>getFeature</code>,
243  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least  <em class=rfc2119>MUST</em> behave in a manner consistent with it.</p>
 conceptually) same object implementing the  
 <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when  
 the parameters are set to  
 <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>  
 and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively.    
 Likewise, any method that takes one or more feature names with or without  
 version number, including the methods <code>hasFeature</code> and  
 <code>getFeature</code>, <em class=rfc2119>MUST</em> behave in a manner  
 consistent with the aforementioned cases.</p>  
244  </div>  </div>
245    
246  <div class=section id=section-node>  <div class=section id=section-node>
# Line 216  these kinds of nodes, methods and attrib Line 282  these kinds of nodes, methods and attrib
282      Note that the value might be <code>null</code>.</p>      Note that the value might be <code>null</code>.</p>
283    </dd>    </dd>
284  <dt><code id=cloneNode>cloneNode</code></dt>  <dt><code id=cloneNode>cloneNode</code></dt>
285    <dd class=ed>@@</dd>    <dd class=ed>
286        <p>A future version of the specification is expected to define the
287        behavior of the <a href="#cloneNode"><code>cloneNode</code></a> method
288        for those kinds of nodes.  In addition, it might revise behavior of
289        the method for <a href="#Entity"><code>Entity</code></a>,
290        <a href="#Notation"><code>Notation</code></a>, and/or
291        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
292      </dd>
293      <!--
294    <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>    <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
295      -->
296  <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>  <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
297    <dd class=ed>@@</dd>    <dd class=ed>
298        <p>A future version of the specification is expected to define the
299        behavior of the method
300        for those kinds of nodes.  In addition, it might revise behavior of
301        the method for <a href="#Entity"><code>Entity</code></a>,
302        <a href="#Notation"><code>Notation</code></a>, and/or
303        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
304      </dd>
305  <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>  <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
306    <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return    <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
307    <code>false</code>.</p></dd>    <code>false</code>.</p></dd>
# Line 233  these kinds of nodes, methods and attrib Line 315  these kinds of nodes, methods and attrib
315      and at least one of them has the support for the feature      and at least one of them has the support for the feature
316      <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>      <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
317      <ul>      <ul>
318      <li>they are equal according to <abbr>DOM</abbr> level 3 definition      <li>they are equal according to <abbr>DOM</abbr> Level 3 Core definition
319      <span class=ed>@@ ref</span>, and      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>,
320        and
321      <li>either:      <li>either:
322        <ul><!--        <ul><!--
323        <li>both of them does not support the feature        <li>both of them does not support the feature
# Line 331  following:</p> Line 414  following:</p>
414    <dd>    <dd>
415      <p>If the node is an      <p>If the node is an
416      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
417      On getting, the attributes <em class=rfc2119>MUST</em> return the      On getting, the attributes <em class=rfc2119>MUST</em> return
418      name of the element type.</p>      <code>null</code>.</p>
   
     <div class="note memo">  
       <p>Thus, on setting the attributes does nothing  
       <span class=ed>[DOM3]</span>.</p>  
     </div>  
   
     <p>On setting, the <a href="#textContent"><code>textContent</code></a>  
     attribute <em class=rfc2119>MUST NOT</em> raise a  
     <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>.  
     <span class=ed>@@ I forgot why this requirement is necessary.</span></p>  
419    
420      <p>If the node is an    <div class="note memo">
421      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>    <p>Thus, on setting the attributes does nothing
422      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
423      </div>
424    
425      <pre class=ed>    <p>If the node is an
426  The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
427  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    The attribute <em class=rfc2119>MUST</em> behave as if the node
428  [['''MUST''']] return the normalized default value    were <code>Attr</code>
429  of the attribute.    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p></dd>
   
 @@  
   
 [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]  
 attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object [['''MUST''']] behave as if it were an  
 [CODE(DOMi)@en[[[Attr]]]] object.  
   
 The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute  
 of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object  
 [['''MUST''']] behave as if the following algorithm  
 is performed:  
 = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]  
 object is read-only, then throw an  
 [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].  
 = Remove any child node the node has.  
 = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],  
 then create a [CODE(DOMi)@en[[[Text]]]] node  
 whose [CODE(DOMa)@en[[[data]]]] is the new value  
 and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].  
 </pre>  
   </dd>  
430  <dt><code id=normalize>normalize</code></dt>  <dt><code id=normalize>normalize</code></dt>
431    <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is    <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is
432    normalized, any nodes in the <code>NamedNodeMap</code> object in the    normalized, any nodes in the <code>NamedNodeMap</code> object in the
# Line 385  and append it to the [CODE(DOMi)@en[[[At Line 438  and append it to the [CODE(DOMi)@en[[[At
438    is normalized, any nodes in the <code>NamedNodeMap</code> object in the    is normalized, any nodes in the <code>NamedNodeMap</code> object in the
439    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
440    attribute <em class=rfc2119>MUST</em> be normalized as well.</p></dd>    attribute <em class=rfc2119>MUST</em> be normalized as well.</p></dd>
 <dt class=ed>@@ ...</dt>  
441  </dl>  </dl>
442    
443  </div>  </div>
# Line 393  and append it to the [CODE(DOMi)@en[[[At Line 445  and append it to the [CODE(DOMi)@en[[[At
445  <div class=section id=section-document>  <div class=section id=section-document>
446  <h3>Modifications to the <code id=Document>Document</code> Interface</h3>  <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
447    
448    <!--
449  <p>If an attempt is made to adopt an  <p>If an attempt is made to adopt an
450  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
451  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
452  the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>  the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>
453  raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@  raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@
454  ref</span>.</p>  ref</span>.</p>
455    -->
456    
457    <div class=ed>
458    <p>Future version of the specification is expected to define what should
459    be done if <code>adoptNode</code> or <code>importNode</code> method have to
460    adopt or import an
461    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
462    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node.
463    In addition it might revise behavior of those methods for
464    <a href="#Entity"><code>Entity</code></a>,
465    <a href="#Notation"><code>Notation</code></a>, and/or
466    <a href="#DocumentType"><code>DocumentType</code></a> nodes.
467    Behavior of <code>normalizeDocument</code> method for these kinds of
468    nodes might also be defined in some day.</p>
469    </div>
470    
471  </div>  </div>
472    
473  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
474  <h3>The <code>DocumentXDoctype</code> Interface</h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
475    
476    <p>The <a href="#Document"><code>Document</code></a> nodes
477    <em class=rfc2119>MUST</em> also implement the
478    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface.</p>
479    
480    <p>An instance of the
481    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>
482    interface <em class=rfc2119>MUST</em> be able to be obtained by using
483    binding$B!>(Bspecific casting methods on an instance of the
484    <a href="#Document"><code>Document</code></a> interface (if such
485    casting methods are available) or by using the method <code>getFeature</code>
486    with parameter values
487    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
488    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
489    <a href="#Document"><code>Document</code></a> node supports the
490    feature <code>Core</code> version <code>3.0</code>
491    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
492    
493  <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface  <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
494  <em class=rfc2119>MUST</em> be implemented as following:</p>  <em class=rfc2119>MUST</em> be implemented as following:</p>
495  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
# Line 424  ref</span>.</p> Line 510  ref</span>.</p>
510      raises (DOMException);      raises (DOMException);
511  }</code></pre>  }</code></pre>
512    
 <div class=ed>@@ cast definition</div>  
   
513  <dl>  <dl>
514  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
515  method</dt>  method</dt>
516    <dd>    <dd>
517      <p>This method creates a <code>DocumentType</code> node with the specified      <p>This method creates a <code>DocumentType</code> node with the specified
518      name, belonging to the document.</p>      name, belonging to the document.</p>
519      <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>      <p>The
520        <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
521      parameter is the name of the document type.</p>      parameter is the name of the document type.</p>
522    
523      <p>When invoked, the method <em class=rfc2119>MUST</em> create and      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
524      return a <code>DocumentType</code> node with the following attributes:</p>      return a <a href="#DocumentType"><code>DocumentType</code></a> node with
525        the following attributes:</p>
526      <dl>      <dl>
527      <dt><code>attributes</code>, <code>parentNode</code></dt>      <dt><code>attributes</code>, <code>parentNode</code></dt>
528        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
529      <dt><code>elementTypes</code>, <code>generalEntities</code>, and      <dt><a href="#elementTypes"><code>elementTypes</code></a>,
530      <code>notations</code></dt>      <a href="#entities"><code>entities</code></a>, and
531        <dd>Empty <code>NamedNodeMap</code> objects.</dd>      <a href="#notations"><code>notations</code></a></dt>
532      <dt><code>entities</code></dt>        <dd>Empty <code>NamedNodeMap</code> objects respectively.</dd>
       <dd>The same value as the <code>generalEntities</code> attribute.</dd>  
533      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
534        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
535      <dt><code>internalSubset</code>, <code>publicId</code>, and      <dt><a href="#internalSubset"><code>internalSubset</code></a>,
536      <code>systemId</code></dt>      <a href="#publicId"><code>publicId</code></a>, and
537        <a href="#systemId"><code>systemId</code></a></dt>
538        <dd>Empty strings.</dd>        <dd>Empty strings.</dd>
539      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
540        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
541      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
542        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
543      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
544        <dd>The <code>Document</code> over which the method is invoked.</dd>        <dd>The <a href="#Document"><code>Document</code></a> node over which the
545          method is invoked.</dd>
546      </dl>      </dl>
547      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
548      containing five general entity declarations: <code>amp</code>,      containing five general entity declarations: <code>amp</code>,
# Line 478  method</dt> Line 565  method</dt>
565      <dl>      <dl>
566      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
567        <dd>An empty <code>NamedNodeMap</code> object.</dd>        <dd>An empty <code>NamedNodeMap</code> object.</dd>
568      <dt><code>attributes</code>, <code>parentNode</code></dt>      <dt><a href="#attributes"><code>attributes</code></a>,
569        <code>parentNode</code></dt>
570        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
571      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
572        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
573      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
574        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
575      <dt><code>nodeName</code></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
576        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
577      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
578        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
# Line 507  method</dt> Line 595  method</dt>
595      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
596      node with the following attributes:</p>      node with the following attributes:</p>
597      <dl>      <dl>
598      <dt><code>allowedTokens</code></dt>      <dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt>
599        <dd>An empty <code>DOMStringList</code> object.</dd>        <dd>An empty <code>DOMStringList</code> object.</dd>
600      <dt><code>attributes</code>,      <dt><a href="#attributes"><code>attributes</code></a>,
601      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,
602      and <code>parentNode</code></dt>      and <code>parentNode</code></dt>
603        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
604      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
605        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
606      <dt><code>declaredType</code></dt>      <dt><a href="#declaredType"><code>declaredType</code></a></dt>
607        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
608      <dt><code>defaultType</code></dt>      <dt><a href="#defaultType"><code>defaultType</code></a></dt>
609        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
610      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
611        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
612      <dt><code>nodeName</code></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
613        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
614      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
615        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
616      <dt class=ed>@@ Ensure all attributes are defined</dt>      <dt class=ed>@@ Ensure all attributes are defined</dt>
617      </dl>      </dl>
618    
619        <!-- This requirement, if not droped, should be part of xml-id spec.
620      <div class=ed>      <div class=ed>
621      <p>@@ Should we keep these statements?:      <p>@@ Should we keep these statements?:
622  However, if the &lt;cfg::cfg|xml-id> configuration  However, if the &lt;cfg::cfg|xml-id> configuration
# Line 535  parameter is set to <code>true</code> an Line 624  parameter is set to <code>true</code> an
624  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
625  attribute is set to <code>ID_ATTR</code>.  attribute is set to <code>ID_ATTR</code>.
626  [CODE(DOMa)@en[[[defaultType]]]]?</p>  [CODE(DOMa)@en[[[defaultType]]]]?</p>
627      </div>      </div>-->
628    </dd>    </dd>
629  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
630  method</dt>  method</dt>
# Line 550  method</dt> Line 639  method</dt>
639      an <a href="#Entity"><code>Entity</code></a> node with the following      an <a href="#Entity"><code>Entity</code></a> node with the following
640      attributes:</p>      attributes:</p>
641      <dl>      <dl>
642      <dt><code>attributes</code>, <code>notationName</code>,      <dt><code>attributes</code>,
643        <a href="#notationName"><code>notationName</code></a>,
644      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
645      and <code>parentNode</code></dt>      and <code>parentNode</code></dt>
646        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
# Line 579  method</dt> Line 669  method</dt>
669        </dd>        </dd>
670      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
671        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
672      <dt><code>publicId</code>, and <code>systemId</code></dt>      <dt><a href="#publicId"><code>publicId</code></a> and
673        <a href="#systemId"><code>systemId</code></a></dt>
674        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
675        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
676      <dt class=ed>@@ Ensure all attributes are defined</dd>      <dt class=ed>@@ Ensure all attributes are defined</dd>
# Line 610  method</dt> Line 701  method</dt>
701        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
702      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
703        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
704      <dt><code>publicId</code> and <code>systemId</code></dt>      <dt><a href="#publicId"><code>publicId</code></a> and
705        <a href="#systemId"><code>systemId</code></a></dt>
706        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
707        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
708      <dt class=ed>@@ Ensure all attributes are defined</dt>      <dt class=ed>@@ Ensure all attributes are defined</dt>
# Line 619  method</dt> Line 711  method</dt>
711  </dl>  </dl>
712    
713  <p>These methods <em class=rfc2119>MUST</em> raise an  <p>These methods <em class=rfc2119>MUST</em> raise an
714  <code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>  <code>INVALID_CHARACTER_ERR</code> if <var>name</var> is <em>not</em> a legal
715  if <var>name</var> is <em>not</em> a legal <code>Name</code> according to  <code>Name</code>
716  the <abbr>XML</abbr> version in use, as specified in the  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
717  <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>  <a href="#ref-XML11">XML11</a>]</cite> according to the <abbr>XML</abbr>
718    version specified in the <code>xmlVersion</code> attribute of the
719    <a href="#Document"><code>Document</code></a> node.</p>
720    
721  <div class="note memo">  <div class="note memo">
722  <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,  <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
723  since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not  since <abbr>DOM</abbr> Level 3 Core specification
724  define it for <code>Document</code> methods.</p>  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
725    does not define it for <a href="#Document"><code>Document</code></a>
726    methods.</p>
727    
728  <p><var>name</var> does not have to be a namespace qualified name.</p>  <p><var>name</var> does not have to be a namespace qualified name.</p>
729  </div>  </div>
# Line 652  document, the <code>NodeList</code> obje Line 748  document, the <code>NodeList</code> obje
748  object <em class=rfc2119>MUST</em> contains the  object <em class=rfc2119>MUST</em> contains the
749  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
750  nodes representing the processing instructions in the document type  nodes representing the processing instructions in the document type
751  definition of the document processed <span class=ed>@@ ref</span> by  definition of the document processed
752  the <abbr>XML</abbr> processor.  If the  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
753  <a href="#DocumentType"><code>DocumentType</code></a> node is marked  <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor.  If
754  as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>  the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as
755  also be marked as read$B!>(Bonly.</p>  <a href="#read-only">read$B!>(Bonly</a>, then all the child nodes
756    <em class=rfc2119>MUST</em> also be marked as
757    <a href="#read-only">read$B!>(Bonly</a>.</p>
758    
759  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
760  from a document type declaration information item <span class=ed>@@ ref</span>,  from a
761    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
762    type declaration information item</a>
763    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
764  the <code>NodeList</code> object in the <code>childNodes</code> attribute  the <code>NodeList</code> object in the <code>childNodes</code> attribute
765  of the node <em class=rfc2119>MUST</em> contain the  of the node <em class=rfc2119>MUST</em> contain the
766  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
# Line 693  of the <a href="#DocumentType"><code>Doc Line 794  of the <a href="#DocumentType"><code>Doc
794  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
795    
796  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
797  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
798  exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.    <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
799  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  set the specified value as the value associated to the attribute.  No
800  associated to the attribute.  No normalization, relative reference resolution,  normalization, relative reference resolution, or lexical validation is
801  or lexical validation is performed. <span class=ed>@@ If the new  performed. <span class=ed>@@ If the new value is <code>null</code>, should an e
802  value is <code>null</code>, ...</span></p>  mpty string be set?</span></p>
803    
804  <div class="note memo">  <div class="note memo">
805  <p>Setting an invalid identifier might make the node unserializable.  <p>Setting an invalid identifier might make the node unserializable.
# Line 716  or <a href="#Entity"><code>Entity</code> Line 817  or <a href="#Entity"><code>Entity</code>
817  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
818    
819  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
820  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
821  exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.    <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
822  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  set the specified value as the value associated to the attribute.  No
823  associated to the attribute.  No normalization, or lexical validation is  normalization, or lexical validation is performed.  <span class=ed>@@ If the
824  performed. <span class=ed>@@ If the new value is <code>null</code>,  new value is <code>null</code>, should an empty string be set?</span></p>
 ...</span></p>  
825    
826  </div>  </div>
827    
828  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
829  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
830    
831    <p>The <a href="#DocumentType"><code>DocumentType</code></a> nodes
832    <em class=rfc2119>MUST</em> also implement the
833    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
834    interface.</p>
835    
836    <p>An instance of the
837    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
838    interface <em class=rfc2119>MUST</em> be able to be obtained by using
839    binding$B!>(Bspecific casting methods on an instance of the
840    <a href="#DocumentType"><code>DocumentType</code></a> interface (if such
841    casting methods are available) or by using the method <code>getFeature</code>
842    with parameter values
843    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
844    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
845    <a href="#DocumentType"><code>DocumentType</code></a> node supports the
846    feature <code>Core</code> version <code>3.0</code>
847    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
848    
849  <div class="note memo">  <div class="note memo">
850  <p>This interface is a separated interface from the  <p>This interface is a separated interface from the
851  <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions  <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
852  to the <a href="#DocumentType"><code>DocumentType</code></a>,  to the <a href="#DocumentType"><code>DocumentType</code></a>,
853  for the historical reason.</p>  for the historical reason.</p>
854    
855    <p class=ed>Should the interface be merged with
856    <a href="#DocumentType"><code>DocumentType</code></a>?</p>
857  </div>  </div>
858    
859  <p>The  <p>The
# Line 761  interface <em class=rfc2119>MUST</em> be Line 882  interface <em class=rfc2119>MUST</em> be
882      raises (DOMException);      raises (DOMException);
883  }</code></pre>  }</code></pre>
884    
 <pre class=ed>  
 [1] In an implementation that supports the  
 [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]  
 feature, a [CODE(DOMi)@en[[[DocumentType]]]] node  
 must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]  
 interface.  See [[DOM XML Document Type Definition]>>3] for  
 details.  
 </pre>  
   
885  <dl>  <dl>
886  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
887  type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>  type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
888    <dd><p>A live <code>NamedNodeMap</code> object that contains all the element    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
889    type definitions belonging to the <code>DocumentType</code> node.</p>    contains all the element type definitions belonging to the
890      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
891    
892    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
893    <code>NamedNodeMap</code> object that contains all the    <code>NamedNodeMap</code> object that contains all the
894    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
895    nodes belonging to the <code>DocumentType</code> node.  The    nodes belonging to the <code>DocumentType</code> node.  The
896    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
897    if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>    if and only if the node is <a href="#read-only">read$B!>(Bonly</a>.  The
898    object <em class=rfc2119>MUST</em> be live and the same object    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
899    <em class=rfc2119>MUST</em> be returned for any invocation.</p>    <a href="#live">live</a>.</p>
900    
901    <p>If the <code>DocumentType</code> node is created during the process    <p>If the <code>DocumentType</code> node is created during the process
902    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following    to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
# Line 792  type <code>NamedNodeMap</code>, read$B! Line 905  type <code>NamedNodeMap</code>, read$B!
905    <em class=rfc2119>MUST</em> be so transformed that the object contains    <em class=rfc2119>MUST</em> be so transformed that the object contains
906    the <code>ElementTypeDefinition</code> nodes for the element types    the <code>ElementTypeDefinition</code> nodes for the element types
907    whose name is presented as the <code>Name</code> of the element type or    whose name is presented as the <code>Name</code> of the element type or
908    attribute definition list declarations processed by the <abbr>XML</abbr>    attribute definition list declarations processed
909    processor.  If there is more than one element type declarations for an    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
910      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr>
911      processor.  If there are more than one element type declarations for an
912    element type, then the declarations other than the first one    element type, then the declarations other than the first one
913    <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the    <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
914    <code>NamedNodeMap</code> object.</p></dd>    <code>NamedNodeMap</code> object.</p></dd>
915  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
916  of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>  of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
917    <dd><p>A live <code>NamedNodeMap</code> object that contains all the general    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
918    entities belonging to the <code>DocumentType</code> node.</p>    contains all the general entities belonging to the
919      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
920        
921    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
922    same value as the <code>entities</code> attribute (defined in the    same value as the <code>entities</code> attribute (defined in the
923    <code>DocumentType</code> interface) of the same node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
924      node.</p>
925    
926    <div class="note memo">    <div class="note memo">
927      <p>This attribute is part of the interface for historical reason.</p>      <p>This attribute is part of the interface for historical reason.</p>
# Line 832  reflected by that of the object. Line 949  reflected by that of the object.
949  -->  -->
950  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
951  <code>notations</code>, read$B!>(Bonly</code>  <code>notations</code>, read$B!>(Bonly</code>
952    <dd><p>A live <code>NamedNodeMap</code> object that contains all the    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
953    notations belonging to the <code>DocumentType</code> node.</p>    contains all the notations belonging to the
954      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
955        
956    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
957    same value as the <code>notations</code> attribute (defined in the    same value as the <code>notations</code> attribute (defined in the
958    <code>DocumentType</code> interface) of the same node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
959      node.</p>
960    
961    <div class="note memo">    <div class="note memo">
962      <p>This attribute is part of the interface for historical reason.</p>      <p>This attribute is part of the interface for historical reason.</p>
963      <p>Implementations are not required to implement the      <p>Implementations are not required to implement the
964      <code>notations</code> attribute twice (for <code>DocumentType</code>      <code>notations</code> attribute twice (for
965      and <code>DocumentTypeDefinition</code> interfaces); they share exactly      <a href="#DocumentType"><code>DocumentType</code></a> and
966      same definition.</p>      <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
967        interfaces); they share exactly same definition.</p>
968    </div></dd>    </div></dd>
969  <!--  <!--
970  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
# Line 925  method</dt> Line 1045  method</dt>
1045    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
1046  <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,  <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,
1047  method</dt>  method</dt>
1048    <dd><p>Returns the <a href="#Notation"><code>Notation>/code></a> node    <dd><p>Returns the <a href="#Notation"><code>Notation</code></a> node
1049    with the specified name.</p>    with the specified name.</p>
1050    
1051    <p>The    <p>The
# Line 963  method</dt> Line 1083  method</dt>
1083    
1084  <p>The nodes of type  <p>The nodes of type
1085  <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>  <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
1086  represents an element type definition.  Such a node implements the  represents an element type definition.  Such a node
1087    <em class=rfc2119>MUST</em> implement the
1088  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1089  interface, which extends the <a href="#Node"><code>Node</code></a>  interface, which extends the <a href="#Node"><code>Node</code></a>
1090  interface.</p>  interface.</p>
# Line 982  declaration for that element type, the < Line 1103  declaration for that element type, the <
1103  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1104  node for that element type.</p>  node for that element type.</p>
1105    
1106    <p>An <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1107    node cannot be a child of any node.  An
1108    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1109    cannot have any child node.</p>
1110    
1111  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1112  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as following:</p>
1113  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {  <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
1114    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1115    
1116    <span class=ed>@@ more</span>    readonly attribute NamedNodeMap <a href="#attributeDefinitions">attributeDefinitions</a>;
1117      <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
1118        (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
1119      void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
1120        (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-name"><var>node</var></a>)
1121        raises (DOMException);
1122  }</code></pre>  }</code></pre>
1123    
1124  <dl>  <dl>
# Line 998  of type <a href="#DocumentType"><code>Do Line 1129  of type <a href="#DocumentType"><code>Do
1129    attribute of    attribute of
1130    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1131    <a href="#Entity"><code>Entity</code></a>, and    <a href="#Entity"><code>Entity</code></a>, and
1132    <a href="#Notation"><code>Notation</code></a> interface contains the    <a href="#Notation"><code>Notation</code></a> interfaces contain the
1133    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
1134    is attached.</p>    is attached.</p>
1135    
# Line 1014  of type <a href="#DocumentType"><code>Do Line 1145  of type <a href="#DocumentType"><code>Do
1145    <code>NamedNodeMap</code> object that contains the node.  If there is no such    <code>NamedNodeMap</code> object that contains the node.  If there is no such
1146    a <a href="#DocumentType"><code>DocumentType</code></a> node,    a <a href="#DocumentType"><code>DocumentType</code></a> node,
1147    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
1148    <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>
1149    of type NamedNodeMap, read$B!>(Bonly</dt>
1150      <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
1151      contains all the attribute definitions belonging to the
1152      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1153      node.</p>
1154    
1155      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1156      <code>NamedNodeMap</code> object that contains all the
1157      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1158      belonging to the
1159      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1160      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1161      read$B!>(Bonly if and only if the node is <a href="#read-only">read$B!>(Bonly</a>.  
1162      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1163      <a href="#live">live</a>.</p>
1164      
1165      <p>If the
1166      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1167      is created during the process to create a <abbr>DOM</abbr> from an
1168      <abbr>XML</abbr> document, the following requirements are applied:  The
1169      <code>NamedNodeMap</code> object in the
1170      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1171      attribute <em class=rfc2119>MUST</em> be so transformed that the object
1172      contains the
1173      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1174      corresponding to the attribute definitions in the attribute definition
1175      list declarations processed
1176      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1177      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor and
1178      associated to the element type represented by the node.  If there are more
1179      than one attribute definitions for an attribute, then the definitions other
1180      than the first one <em class=rfc2119>MUST</em> be ignored for the purpose
1181      of constructing the <code>NamedNodeMap</code> object.</p></dd>
1182    <dt><dfn id=getAttributeDefinitionNode class=dom-method><code>getAttributeDefinitionNode</code></dfn>,
1183    method</dt>
1184      <dd><p>Return the
1185      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1186      with the specified name.</p>
1187    
1188      <p>The
1189      <dfn id=getAttributeDefinitionNode-name class=dom-param><var>name</var></dfn>
1190      parameter is the name of the attribute.</p>
1191    
1192      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1193      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
1194      whose <a href="#nodeName"><code>nodeName</code></a> attribute value is
1195      equal to <a href="#getAttributeDefinitionNode-name"><var>name</var></a>,
1196      in the <code>NamedNodeMap</code> in the
1197      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1198      attribute of the node.  If there is no such node, it
1199      <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
1200    <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
1201    method</dt>
1202      <dd class=ed>@@</dd>
1203  </dl>  </dl>
1204    
1205  <div class=ed>  <div class=ed>
# Line 1028  element type.</p> Line 1214  element type.</p>
1214    
1215  <p>The nodes of type  <p>The nodes of type
1216  <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>  <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
1217  represents an attribute definition.  Such a node implements the  represents an attribute definition.  Such a node
1218    <em class=rfc2119>MUST</em> implement the
1219  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
1220  which extends the <a href="#Node"><code>Node</code></a> interface.</p>  which extends the <a href="#Node"><code>Node</code></a> interface.</p>
1221    
# Line 1042  type in <abbr>DTD</abbr>, the result <ab Line 1229  type in <abbr>DTD</abbr>, the result <ab
1229  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
1230  that attribute.</p>  that attribute.</p>
1231    
1232    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1233    node cannot be a child of any node.  An
1234    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1235    can have zero or more child nodes of same kinds as those allowed for
1236    <code>Attr</code> nodes
1237    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
1238    
1239  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1240  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as following:</p>
1241  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {  <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
# Line 1069  interface <em class=rfc2119>MUST</em> be Line 1263  interface <em class=rfc2119>MUST</em> be
1263    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
1264    
1265    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
1266      readonly attribute DOMStringList <a href="#allowedTokens">allowedTokens</a>;
1267    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
   
   <span class=ed>...</span>  
1268  }</code></pre>  }</code></pre>
1269    
1270  <dl>  <dl>
# Line 1095  read$B!>(Bonly</dt> Line 1288  read$B!>(Bonly</dt>
1288    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
1289  <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type  <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
1290  <code>unsigned short</code></dt>  <code>unsigned short</code></dt>
1291    <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.    <dd><p>The declared type
1292    It is expected that this attribute contains a value from the definition group    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1293      <a href="#ref-XML11">XML11</a>]</cite> of the attribute.  It is expected that
1294      this attribute contains a value from the definition group
1295    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
1296    
1297    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1298    value associated to this attribute.</p>    value associated to this attribute.</p>
1299    
1300    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1301    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
   exception if the  
1302    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1303    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it    is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1304    <em class=rfc2119>MUST</em> set the specified value as the value    <em class=rfc2119>MUST</em> set the specified value as the value
1305    associated to this attribute.</p>    associated to this attribute.</p>
1306    
# Line 1129  group contains the following constants:< Line 1323  group contains the following constants:<
1323  <tbody>  <tbody>
1324  <tr>  <tr>
1325  <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>  <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
1326  <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>  <td><code>0</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">No
1327    value</a>
1328    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>.</tr>
1329  <tr>  <tr>
1330  <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>  <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
1331  <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>  <td><code>1</code><td><code>CDATA</code>
1332    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1333    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1334  <tr>  <tr>
1335  <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>  <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
1336  <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>  <td><code>2</code><td><code>ID</code>
1337    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1338    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1339  <tr>  <tr>
1340  <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>  <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
1341  <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>  <td><code>3</code><td><code>IDREF</code>
1342    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1343    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1344  <tr>  <tr>
1345  <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>  <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
1346  <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>  <td><code>4</code><td><code>IDREFS</code>
1347    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1348    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1349  <tr>  <tr>
1350  <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>  <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
1351  <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>  <td><code>5</code><td><code>ENTITY</code>
1352    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1353    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1354  <tr>  <tr>
1355  <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>  <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
1356  <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>  <td><code>6</code><td><code>ENTITIES</code>
1357    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1358    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1359  <tr>  <tr>
1360  <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>  <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
1361  <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>  <td><code>7</code><td><code>NMTOKEN</code>
1362    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1363    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1364  <tr>  <tr>
1365  <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>  <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
1366  <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>  <td><code>8</code><td><code>NMTOKENS</code>
1367    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1368    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1369  <tr>  <tr>
1370  <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>  <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
1371  <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>  <td><code>9</code><td><code>NOTATION</code>
1372    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1373    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1374  <tr>  <tr>
1375  <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>  <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
1376  <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>  <td><code>10</code><td>Enumeration
1377    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1378    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1379  <tr>  <tr>
1380  <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>  <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
1381  <td><code>11</code><td>Unknown, because no declaration for the attribute  <td><code>11</code><td><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">Unknown</a>,
1382  has been read but the [all declaration processed] property  because no declaration for the attribute has been read but the
1383  <span class=ed>[INFOSET]</span> would be false.</tr>  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.document">[all declaration processed]</a>
1384    property
1385    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
1386    would be false.</tr>
1387  </tbody>  </tbody>
1388  </table>  </table>
1389    
1390  <p>If no attribute type information is available, or if the source  <p>If no attribute type information is available, or if the source
1391  of the information does not distinguish <q>no value</q> and <q>unknown</q>  of the information does not distinguish
1392  <span class=ed>[INFOSET]</span>, then the value  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no
1393    value</a> and
1394    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1395    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
1396    then the value
1397  <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>  <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
1398  <em class=rfc2119>MUST</em> be used.</p>  <em class=rfc2119>MUST</em> be used.</p>
1399    
# Line 1182  method has its <a href="#declaredType">< Line 1405  method has its <a href="#declaredType"><
1405  set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>  set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
1406  </div>  </div>
1407    
1408  <p>If the source of the information does not distinguish <q>no value</q>  <p>If the source of the information does not distinguish
1409  and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no
1410  <code>CDATA</code> <span class=ed>[XML]</span>, then the value  value</a> and/or
1411    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1412    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> and
1413    <code>CDATA</code>
1414    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1415    <a href="#ref-XML11">XML11</a>]</cite>, then the value
1416  <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>  <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
1417  be used.</p>  be used.</p>
1418    
# Line 1194  be used.</p> Line 1422  be used.</p>
1422  definition group.</p>  definition group.</p>
1423    
1424    </dd>    </dd>
1425    <dt><dfn id=allowedTokens class=dom-attr><code>allowedTokens</code></dfn> of
1426    type <code>DOMStringList</code>, read$B!>(Bonly</dt>
1427      <dd><p>The list of allowed attribute values.</p>
1428    
1429      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1430      <code>DOMStringList</code> object associated to this attribute.  The object
1431      <em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of
1432      zero or more characters respectively, possibly with duplications.  The
1433      object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node
1434      is <a href="#read-only">read$B!>(Bonly</a>.</p>
1435    
1436      <p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1437      node is created during the process to create a <abbr>DOM</abbr> from an
1438      <abbr>XML</abbr> document, the object <em class=rfc2119>MUST</em> contain
1439      the names or name tokens allowed for the attribute defined by the node.
1440      If the document is well$B!>(Bformed, the object will be empty unless
1441      the <a href="#declaredType"><code>declaredType</code></a> is
1442      <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1443      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>.</p>
1444    
1445      <p>If the <a href="#declaredType"><code>declaredType</code></a> is different
1446      from <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1447      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>, this attribute
1448      <em class=rfc2119>MUST</em> be ignored for the purpose of serializing
1449      into (part of) <abbr>XML</abbr> document.</p>
1450    
1451      <div class="note memo">
1452        <p>When serializing the node it should be noted that the object might
1453        be empty, might contain duplications, and might contain strings that are
1454        not names or name tokens.</p>
1455      </div></dd>
1456  <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of  <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
1457  type <code>unsigned short</code></dt>  type <code>unsigned short</code></dt>
1458    <dd><p>The type of the default for the attribute.  It is expected that this    <dd><p>The type of the default for the attribute.  It is expected that this
# Line 1204  type <code>unsigned short</code></dt> Line 1463  type <code>unsigned short</code></dt>
1463    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1464    
1465    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1466    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
   exception if the  
1467    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1468    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it    is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1469    <em class=rfc2119>MUST</em> set the specified value as the value    <em class=rfc2119>MUST</em> set the specified value as the value
1470    associated to this attribute.</p>    associated to this attribute.</p>
1471    
# Line 1234  type <code>unsigned short</code></dt> Line 1492  type <code>unsigned short</code></dt>
1492    <td><code>0</code><td>Unknown.</tr>    <td><code>0</code><td>Unknown.</tr>
1493    <tr>    <tr>
1494    <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>    <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
1495    <td><code>1</code><td>Provided explicitly and fixed    <td><code>1</code><td>Provided explicitly and only the value is allowed.
1496    <span class=ed>@@ ref</span> to that value.</tr>    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1497      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1498    <tr>    <tr>
1499    <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>    <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
1500    <td><code>2</code><td>No default value and the attribute have to be    <td><code>2</code><td>No default value and the attribute have to be
1501    explicitly specified.</tr>    explicitly specified.</tr>
1502    <tr>    <tr>
1503    <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>    <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
1504    <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>    <td><code>3</code><td>Implied
1505      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1506      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1507    <tr>    <tr>
1508    <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>    <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
1509    <td><code>4</code><td>Provided explicitly.</tr>    <td><code>4</code><td>Provided explicitly.</tr>
# Line 1288  interface <em class=rfc2119>MUST</em> be Line 1549  interface <em class=rfc2119>MUST</em> be
1549  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
1550    
1551  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1552  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1553  exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.  <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
1554  Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value  set the specified value as the value associated to the attribute.  No lexical
1555  associated to the attribute.  No lexical validation is performed.  The new  validation is performed.  The new value <em class=rfc2119>MAY</em> be
1556  value <em class=rfc2119>MAY</em> be <code>null</code>.</p>  <code>null</code>.</p>
1557    
1558  <dl>  <dl>
1559  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
# Line 1305  of type boolean</dt> Line 1566  of type boolean</dt>
1566    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1567    
1568    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1569    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1570    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1571    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the    <em class=rfc2119>MUST</em> set the specified value as the
1572    value associated to this attribute.</p>    value associated to this attribute.</p>
1573    
1574    <div class="note memo">    <div class="note memo">
# Line 1351  of type boolean</dt> Line 1612  of type boolean</dt>
1612    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1613    
1614    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1615    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1616    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1617    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the    <em class=rfc2119>MUST</em> set the specified value as the value associated
1618    value associated to this attribute.</p>    to this attribute.</p>
1619    
1620    <p>If the <a href="#Entity"><code>Entity</code></a> node is created during    <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
1621    the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,    the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
# Line 1390  interface <em class=rfc2119>MUST</em> be Line 1651  interface <em class=rfc2119>MUST</em> be
1651    
1652  <dl>  <dl>
1653  <dt id=ref-DOM3CORE>DOM3CORE</dt>  <dt id=ref-DOM3CORE>DOM3CORE</dt>
1654    <dd class=ed>@@ W3C DOM Level 3 Core</dd>    <dd><cite><a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document
1655  <dt id=ref-DOMDTDEF>DOMDTDEF</dt>    Object Model (<abbr>DOM</abbr>) Level 3 Core Specification, Version
1656    <dd class=ed>@@ manakai's extension to DOM for document type definitions</dd>    1.0</a></cite>, <abbr>W3C</abbr> Recommendation, <time datetime=2004-04-07>7
1657      April 2004</time>.  <em>This</em> version of the specification is referenced.
1658      The latest version of the specification is available at
1659      <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Level-3-Core">http://www.w3.org/TR/DOM-Level-3-Core</a>></code>.</dd>
1660    <dt id=ref-HTML5>HTML5</dt>
1661      <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
1662      <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
1663      Working Draft.  Work in progress.</dd>
1664    <dt id=ref-INFOSET>INFOSET</dt>
1665      <dd><cite><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204"><abbr>XML</abbr>
1666      Information Set (Second Edition)</a></cite>, <abbr>W3C</abbr> Recommendation,
1667      <time datetime=2004-02-04>4 February 2004</time>.  <em>This</em> version of
1668      the specification is referenced.  The latest version of the specification is
1669      available at
1670      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml-infoset">http://www.w3.org/TR/xml-infoset</a>></code>.</dd>
1671  <dt id="ref-KEYWORDS">KEYWORDS</dt>  <dt id="ref-KEYWORDS">KEYWORDS</dt>
1672    <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in    <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in
1673    <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,    <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,
# Line 1401  interface <em class=rfc2119>MUST</em> be Line 1676  interface <em class=rfc2119>MUST</em> be
1676    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
1677    <time datetime=1997-03>March 1997</time>.    <time datetime=1997-03>March 1997</time>.
1678    <em>This</em> version of the specification is referenced.</dd>    <em>This</em> version of the specification is referenced.</dd>
 <dt id=ref-INFOSET>INFOSET</dt>  
   <dd class=ed>@@</dd>  
1679  <dt id=ref-XML10">XML10</dt>  <dt id=ref-XML10">XML10</dt>
1680    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible
1681    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
1682    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1683    2006</time>, edited in place <time datetime=2006-09-29>29 September    2006</time>, edited in place <time datetime=2006-09-29>29 September
1684    2006</time>.  Tje latest version of the specification is available at    2006</time>.  <em>This</em> version of the specification is referenced.  The
1685    <code class=uri>&lt;<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>&gt;</code>.    latest version of the specification is available at
1686    <em>This</em> version of the specification is referenced.</dd>    <code class=uri>&lt;<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>&gt;</code>.</dd>
1687  <dt id=ref-XML11>XML11</dt>  <dt id=ref-XML11>XML11</dt>
1688    <dd class=ed>@@</dd>    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml11-20060816/">Extensible
1689      Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>,
1690      <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1691      2006</time>, edited in place <time datetime=2006-09-29>29 September
1692      2006</time>.  <em>This version of the specification is referenced.  The
1693      latest version of the specification is available at
1694      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd>
1695  </dl>  </dl>
1696  </div>  </div>
1697    
1698  <div id="informative-references" class="section informative reference">  <div id="informative-references" class="section informative reference">
1699  <h3>Non$B!>(Bnormative References</h3>  <h3>Non$B!>(Bnormative References</h3>
1700    
1701  <dl class=ed>  <dl>
1702  <dt id=ref-CSS>CSS</dt>  <dt id=ref-DOM1WD>DOM1WD</dt>
1703    <dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-971209/">Document Object
1704    Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1705    Specification</a></cite>,    <time datetime=1997-12-09>9 December 1998</time>.</dd>
1706    <abbr title="World Wide Web Consortium">W3C</abbr> Candidate    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object
1707    Recommendation, <time datetime=2007-07-19>19 July 2007</time>.    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1708    Work in progress.  The latest version of the specification is    <time datetime=1998-03-18>18 March 1998</time>.</dd>
1709    available at    <dd><cite><a href="http://www.w3.org/TR/1998/WD-DOM-19980416/">Document
1710    <code class=URI>&lt;<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd>    Object Model Specification, Version 1.0</a></cite>, <abbr>W3C</abbr> Working
1711  <dt id=ref-CSSOM>CSSOM</dt>    Draft, <time datetime=1998-04-16>16 April 1998</time>.</dd>
1712    <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&amp;content-type=text/html;%20charset=utf-8">Cascading  <dt id=ref-DOM3AS>DOM3AS</dt>
1713    Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>,    <dd><cite><a href="http://www.w3.org/TR/2002/NOTE-DOM-Level-3-AS-20020725/">Document
1714    <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,    Object Model (<abbr>DOM</abbr>) Level 3 Abstract Schemas Specification,
1715    <time datetime=2007-06-18>18 June 2007</time>.  Work in progress.    Version 1.0</a></cite>, <abbr>W3C</abbr> Note, <time datetime=2002-07-25>25
1716    The latest Editor's Draft of the specification is available at    July 2002</time>.  The latest version of the specification is available at
1717    <code class=URI>&lt;<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd>    <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Level-3-AS">http://www.w3.org/TR/DOM-Level-3-AS</a>></code>.</dd>
1718  <dt id=ref-HTML5>HTML5</dt>  <dt id=ref-XSAPI>XSAPI</dt>
1719    <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,    <dd><cite><a href="http://www.w3.org/Submission/2004/SUBM-xmlschema-api-20040309/"><abbr>XML</abbr>
1720    <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>    Schema <abbr>API</abbr></a></cite>, <abbr>W3C</abbr> Member Submission,
1721    Working Draft.  Work in progress.</dd>    <time datetime=2004-03-09>9 March 2004</time>.  The latest version of the
1722  <dt id=ref-SAPI>SAPI</dt>    specification is available at
1723    <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&amp;content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>,    <code class=uri>&lt;<a href="http://www.w3.org/Submission/xmlschema-api/">http://www.w3.org/Submission/xmlschema-api/</a>></code>.</dd>
   <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,  
   <time datetime=2007-08-29>29 August 2007</time>.  Work in progress.  
   The latest Editor's Draft of the specification is available at  
   <code class=URI>&lt;<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.  
   The latest published version of the specification is available at  
   <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>  
 <dt id=XBL2>XBL2</dt>  
   <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>  
   2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.  
   Work in progress.  The latest  
   <abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished  
   version of the specification is available at  
   <code class=URI>&lt;<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd>  
 <dt id=ref-XML5>XML5</dt>  
   <dd class=ed>@@</dd>  
1724  </dl>  </dl>
1725  </div>  </div>
1726    

Legend:
Removed from v.1.20  
changed lines
  Added in v.1.23

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24