/[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.26 by wakaba, Sat Dec 8 13:49:56 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  <p class=ed><var>A</var> object is an object implementing <var>A</var>  2119</a>
116  interface.</p>  <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
117    
118  <p class=ed>@@ ref to DOM Binding Spec</p>  <p>Conformance requirements phrased as algorithms or specific steps
119    <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>The <em id=idl-fragment><abbr>IDL</abbr> fragments</em> in this document are
160    to be interpreted as described in the <cite>Language Bindings for
161    <abbr>DOM</abbr> Specifications</cite> specification
162    <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</p>
163    
164    <p>Some <abbr>IDL</abbr> fragments are presented as <i>patch</i> to an
165    <abbr>IDL</abbr> fragment defined in another document.  They are to be
166    interpreted as an instance of
167    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMembers"><code>InterfaceMembers</code></a>
168    <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.
169    If the <abbr>IDL</abbr> fragment to which the <i>patch</i> is applied has any
170    instance of
171    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
172    with same
173    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a>
174    part as that of any instance of
175    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
176    in the <i>patch</i>, then the former instance of
177    <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
178    <em class=rfc2119>MUST</em> be ignored.</p>
179    </div>
180    
181  <p>If the <code>strictErrorChecking</code> attribute of the  <div class=section id=conformance-categories>
182  <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>  
183    
184  <div class=ed>  <p>There are several kinds of products that can be claim to conform to
185  <p>Conformant product classes: implementation, XML parser (XML document ->  this specification:</p>
186  DOM converter), XML serializer (DOM -> XML document covnerter).  <dl>
187  XML Infoset -> DOM converter, and DOM -> XML Infoset converter.</p>  <dt id=category-dom-implementation><abbr>DOM</abbr> Implementation</dt>
188      <dd>A <abbr>DOM</abbr> implementation (or just written as
189      <q>implementation</q> in this document) provides a way to access
190      <abbr>DOM</abbr> trees for applications by implementing interfaces defined
191      by this and other documents.  Unless otherwise noted, requirements in this
192      document are applied to <abbr>DOM</abbr> implementations.  To implement
193      all the features in this document, the implementation have to implement
194      some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> Level 3 Core
195      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>)
196      with one or more language binding (e.g. ECMAScript and Java bindings
197      <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>
198      or Perl binding
199      <cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>).
200      A conforming implementation <em class=rfc2119>MUST</em> also be a
201      <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#dfn-conforming-implementation">conforming
202      implementation</a> of the <abbr>IDL</abbr> fragments in this document, as
203      described in the <cite>Language Bindings for <abbr>DOM</abbr>
204      Specifications</cite> specification
205      <cite class="bibref normative">[<a href="#ref-DOMBIND">DOMBIND</a>]</cite>.</dd>
206    <dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document
207    to <abbr>DOM</abbr> tree converter)</dt>
208      <dd>A software component that converts
209      <abbr>XML</abbr> 1.0 or 1.1 document
210      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
211      <a href="#ref-XML11">XML11</a>]</cite> (or fragment thereof) into a
212      <abbr>DOM</abbr> tree (or fragment thereof) in the context of this
213      document.  Note that this document does not define any particular way to
214      parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr>
215      document, but it defines constraints for such processing.</dd>
216    <dt id=category-xml-serializer><abbr>XML</abbr> Serializer (<abbr>DOM</abbr>
217    tree to <abbr>XML</abbr> document converter)</dt>
218      <dd>A software component that converts
219      <abbr>DOM</abbr> tree (or fragment thereof) into an <abbr>XML</abbr> 1.0 or
220      1.1 document (or fragment thereof).  Note that this document does not define
221      any particular way to serialize a <abbr>DOM</abbr> tree, but it defines
222      constraints for such processing.</dd>
223    <dt id=category-infoset-dom><abbr>XML</abbr> Information Set to
224    <abbr>DOM</abbr> Tree Converter</dt>
225      <dd>A software component that converts an <abbr>XML</abbr> information set
226      <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
227      into a <abbr>DOM</abbr> tree.  Note that this documetn does not define
228      any particular way for the convertion, but it defines constraints for
229      such processing.</dd>
230    <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>
231    Information Set Converter</dt>
232      <dd>A software component that converts a <abbr>DOM</abbr> tree into
233      an <abbr>XML</abbr> information set.  Note that this documetn does not define
234      any particular way for the convertion, but it defines constraints for
235      such processing.</dd>
236    </dl>
237  </div>  </div>
238  </div>  </div>
239    
# Line 151  In addition, it modifies existing interf Line 251  In addition, it modifies existing interf
251  <a href="#Document"><code>Document</code></a>,  <a href="#Document"><code>Document</code></a>,
252  <a href="#DocumentType"><code>DocumentType</code></a>,  <a href="#DocumentType"><code>DocumentType</code></a>,
253  <a href="#Entity"><code>Entity</code></a>, and  <a href="#Entity"><code>Entity</code></a>, and
254  <a href="#Notation"><code>Notation</code></a>.</p>  <a href="#Notation"><code>Notation</code></a>
255    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
256    
257  <div class=section id=features>  <div class=section id=features>
258  <h3>Feature Name</h3>  <h3>Feature String</h3>
259    
260  <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
261  the <abbr>DOM</abbr> Document Type Definition module, the  the <abbr>DOM</abbr> Document Type Definition module, the
262  <code>hasFeature</code> method of a <code>DOMImplementation</code> object  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
263    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
264  <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
265  set to  set to
266  <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>
267  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
268    method that takes one or more feature names, with or without version number,
269  <p>In such an implementation, the <code>getFeature</code> method of a  such as <code>hasFeature</code> or <code>getFeature</code>,
270  <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>  
271  </div>  </div>
272    
273  <div class=section id=section-node>  <div class=section id=section-node>
# Line 182  consistent with the aforementioned cases Line 275  consistent with the aforementioned cases
275    
276  <p>The implementation of the  <p>The implementation of the
277  <a href="#Node"><code>Node</code></a> interface  <a href="#Node"><code>Node</code></a> interface
278  <em class=rfc2119>MUST</em> be modified as following:</p>  <em class=rfc2119>MUST</em> be modified as the following
279    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
280  <pre class=idl><code>// Additions to the Node interface  <pre class=idl><code>// Additions to the Node interface
281    
282  // Additions to the NodeType definition group  // Additions to the NodeType definition group
# Line 203  these kinds of nodes, methods and attrib Line 297  these kinds of nodes, methods and attrib
297  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
298    
299  <dl>  <dl>
300  <dt><code id=attributes>attributes</code></dt>  <dt><code id=attributes>attributes</code>,
301    <code id=localName>localName</code>,
302    <code id=manakaiLocalName>manakaiLocalName</code>
303    <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite>,
304    <code id=namespaceURI>namespaceURI</code>, and
305    <code id=prefix>prefix</code></dt>
306    <dd>    <dd>
307      <p>On getting, the attribute <em class=rfc2119>MUST</em> return      <p>On getting, the attributes <em class=rfc2119>MUST</em> return
308      <code>null</code>.</p>      <code>null</code>.</p>
309    </dd>    </dd>
310  <dt><code id=baseURI>baseURI</code></dt>  <dt><code id=baseURI>baseURI</code></dt>
# Line 216  these kinds of nodes, methods and attrib Line 315  these kinds of nodes, methods and attrib
315      Note that the value might be <code>null</code>.</p>      Note that the value might be <code>null</code>.</p>
316    </dd>    </dd>
317  <dt><code id=cloneNode>cloneNode</code></dt>  <dt><code id=cloneNode>cloneNode</code></dt>
318    <dd class=ed>@@</dd>    <dd class=ed>
319        <p>A future version of the specification is expected to define the
320        behavior of the <a href="#cloneNode"><code>cloneNode</code></a> method
321        for those kinds of nodes.  In addition, it might revise behavior of
322        the method for <a href="#Entity"><code>Entity</code></a>,
323        <a href="#Notation"><code>Notation</code></a>, and/or
324        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
325      </dd>
326      <!--
327    <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>    <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
328      -->
329  <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>  <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
330    <dd class=ed>@@</dd>    <dd class=ed>
331        <p>A future version of the specification is expected to define the
332        behavior of the method
333        for those kinds of nodes.  In addition, it might revise behavior of
334        the method for <a href="#Entity"><code>Entity</code></a>,
335        <a href="#Notation"><code>Notation</code></a>, and/or
336        <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
337      </dd>
338  <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>  <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
339    <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return    <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
340    <code>false</code>.</p></dd>    <code>false</code>.</p></dd>
# Line 233  these kinds of nodes, methods and attrib Line 348  these kinds of nodes, methods and attrib
348      and at least one of them has the support for the feature      and at least one of them has the support for the feature
349      <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>
350      <ul>      <ul>
351      <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
352      <span class=ed>@@ ref</span>, and      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>,
353        and
354      <li>either:      <li>either:
355        <ul><!--        <ul><!--
356        <li>both of them does not support the feature        <li>both of them does not support the feature
# Line 298  these kinds of nodes, methods and attrib Line 414  these kinds of nodes, methods and attrib
414    </dd>    </dd>
415  <dt><code id=nodeType>nodeType</code></dt>  <dt><code id=nodeType>nodeType</code></dt>
416    <dd>    <dd>
417      <p>On getting, the attribute <em class=rfc2119>MUST</em> return      <p>On getting, the attribute <!--<em class=rfc2119>MUST</em>--> returns
418        <!-- NOTE: No MUST, to avoid circular reference (nodeType==8100[12]
419        is defined that they MUST implement ElementType|AttributeDefinition). -->
420      <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>
421      (if the node is an      (if the node is an
422      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
# Line 331  following:</p> Line 449  following:</p>
449    <dd>    <dd>
450      <p>If the node is an      <p>If the node is an
451      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
452      On getting, the attributes <em class=rfc2119>MUST</em> return the      On getting, the attributes <em class=rfc2119>MUST</em> return
453      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>  
454    
455      <p>If the node is an    <div class="note memo">
456      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:</p>    <p>Thus, on setting the attributes does nothing
457      <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
458      </div>
459    
460      <pre class=ed>    <p>If the node is an
461  The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
462  of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object    The attribute <em class=rfc2119>MUST</em> behave as if the node
463  [['''MUST''']] return the normalized default value    were <code>Attr</code>
464  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>  
465  <dt><code id=normalize>normalize</code></dt>  <dt><code id=normalize>normalize</code></dt>
466    <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is    <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is
467    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 473  and append it to the [CODE(DOMi)@en[[[At
473    is normalized, any nodes in the <code>NamedNodeMap</code> object in the    is normalized, any nodes in the <code>NamedNodeMap</code> object in the
474    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
475    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>  
476  </dl>  </dl>
477    
478  </div>  </div>
# Line 393  and append it to the [CODE(DOMi)@en[[[At Line 480  and append it to the [CODE(DOMi)@en[[[At
480  <div class=section id=section-document>  <div class=section id=section-document>
481  <h3>Modifications to the <code id=Document>Document</code> Interface</h3>  <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
482    
483    <!--
484  <p>If an attempt is made to adopt an  <p>If an attempt is made to adopt an
485  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
486  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
487  the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>  the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>
488  raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@  raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@
489  ref</span>.</p>  ref</span>.</p>
490    -->
491    
492    <div class=ed>
493    <p>Future version of the specification is expected to define what should
494    be done if <code>adoptNode</code> or <code>importNode</code> method have to
495    adopt or import an
496    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
497    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node.
498    In addition it might revise behavior of those methods for
499    <a href="#Entity"><code>Entity</code></a>,
500    <a href="#Notation"><code>Notation</code></a>, and/or
501    <a href="#DocumentType"><code>DocumentType</code></a> nodes.
502    Behavior of <code>normalizeDocument</code> method for these kinds of
503    nodes might also be defined in some day.</p>
504    </div>
505    
506  </div>  </div>
507    
508  <div class=section id=section-documentxdoctype>  <div class=section id=section-documentxdoctype>
509  <h3>The <code>DocumentXDoctype</code> Interface</h3>  <h3>The <code>DocumentXDoctype</code> Interface</h3>
510    
511    <p>The <a href="#Document"><code>Document</code></a> nodes
512    <em class=rfc2119>MUST</em> also implement the
513    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface.</p>
514    
515    <p>An instance of the
516    <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>
517    interface <em class=rfc2119>MUST</em> be able to be obtained by using
518    binding$B!>(Bspecific casting methods on an instance of the
519    <a href="#Document"><code>Document</code></a> interface (if such
520    casting methods are available) or by using the method <code>getFeature</code>
521    with parameter values
522    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
523    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
524    <a href="#Document"><code>Document</code></a> node supports the
525    feature <code>Core</code> version <code>3.0</code>
526    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
527    
528  <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface  <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
529  <em class=rfc2119>MUST</em> be implemented as following:</p>  <em class=rfc2119>MUST</em> be implemented as the following
530    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
531  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
532    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
533      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
# Line 424  ref</span>.</p> Line 546  ref</span>.</p>
546      raises (DOMException);      raises (DOMException);
547  }</code></pre>  }</code></pre>
548    
 <div class=ed>@@ cast definition</div>  
   
549  <dl>  <dl>
550  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
551  method</dt>  method</dt>
552    <dd>    <dd>
553      <p>This method creates a <code>DocumentType</code> node with the specified      <p>This method creates a <code>DocumentType</code> node with the specified
554      name, belonging to the document.</p>      name, belonging to the document.</p>
555      <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>      <p>The
556        <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
557      parameter is the name of the document type.</p>      parameter is the name of the document type.</p>
558    
559      <p>When invoked, the method <em class=rfc2119>MUST</em> create and      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
560      return a <code>DocumentType</code> node with the following attributes:</p>      return a <a href="#DocumentType"><code>DocumentType</code></a> node with
561        the following attributes:</p>
562      <dl>      <dl>
563      <dt><code>attributes</code>, <code>parentNode</code></dt>      <dt><code>attributes</code>, <code>parentNode</code></dt>
564        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
565      <dt><code>elementTypes</code>, <code>generalEntities</code>, and      <dt><a href="#elementTypes"><code>elementTypes</code></a>,
566      <code>notations</code></dt>      <a href="#entities"><code>entities</code></a>, and
567        <dd>Empty <code>NamedNodeMap</code> objects.</dd>      <a href="#notations"><code>notations</code></a></dt>
568      <dt><code>entities</code></dt>        <dd>Empty <code>NamedNodeMap</code> objects respectively.</dd>
       <dd>The same value as the <code>generalEntities</code> attribute.</dd>  
569      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
570        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
571      <dt><code>internalSubset</code>, <code>publicId</code>, and      <dt><a href="#internalSubset"><code>internalSubset</code></a>,
572      <code>systemId</code></dt>      <a href="#publicId"><code>publicId</code></a>, and
573        <a href="#systemId"><code>systemId</code></a></dt>
574        <dd>Empty strings.</dd>        <dd>Empty strings.</dd>
     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
       <dd><code>false</code>.</dd>  
575      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
576        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
577      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
578        <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
579          method is invoked.</dd>
580      </dl>      </dl>
581        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
582        <a href="#read-only">read$B!>(Bonly</a>.</p>
583      <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
584      containing five general entity declarations: <code>amp</code>,      containing five general entity declarations: <code>amp</code>,
585      <code>lt</code>, <code>gt</code>, <code>quot</code>, and      <code>lt</code>, <code>gt</code>, <code>quot</code>, and
# Line 478  method</dt> Line 601  method</dt>
601      <dl>      <dl>
602      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
603        <dd>An empty <code>NamedNodeMap</code> object.</dd>        <dd>An empty <code>NamedNodeMap</code> object.</dd>
     <dt><code>attributes</code>, <code>parentNode</code></dt>  
       <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>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
       <dd><code>false</code>.</dd>  
     <dt><code>nodeName</code></dt>  
607        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
608      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
609        <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>
610      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
611        and <code>parentNode</code></dt>
612        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dt>  
613      </dl>      </dl>
614        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
615        <a href="#read-only">read$B!>(Bonly</a>.</p>
616    </dd>    </dd>
617  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
618  method</dt>  method</dt>
# Line 507  method</dt> Line 628  method</dt>
628      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
629      node with the following attributes:</p>      node with the following attributes:</p>
630      <dl>      <dl>
631      <dt><code>allowedTokens</code></dt>      <dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt>
632        <dd>An empty <code>DOMStringList</code> object.</dd>        <dd>An empty <code>DOMStringList</code> object.</dd>
     <dt><code>attributes</code>,  
     <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
633      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
634        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
635      <dt><code>declaredType</code></dt>      <dt><a href="#declaredType"><code>declaredType</code></a></dt>
636        <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>
637      <dt><code>defaultType</code></dt>      <dt><a href="#defaultType"><code>defaultType</code></a></dt>
638        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
639      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
       <dd><code>false</code>.</dd>  
     <dt><code>nodeName</code></dt>  
640        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
641      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
642        <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>
643      <dt class=ed>@@ Ensure all attributes are defined</dt>      <dt><a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>
644        and <code>parentNode</code></dt>
645          <dd><code>null</code>.</dd>
646      </dl>      </dl>
647        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
648        <a href="#read-only">read$B!>(Bonly</a>.</p>
649    
650        <!-- This requirement, if not droped, should be part of xml-id spec.
651      <div class=ed>      <div class=ed>
652      <p>@@ Should we keep these statements?:      <p>@@ Should we keep these statements?:
653  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 655  parameter is set to <code>true</code> an
655  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]  is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
656  attribute is set to <code>ID_ATTR</code>.  attribute is set to <code>ID_ATTR</code>.
657  [CODE(DOMa)@en[[[defaultType]]]]?</p>  [CODE(DOMa)@en[[[defaultType]]]]?</p>
658      </div>      </div>-->
659    </dd>    </dd>
660  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
661  method</dt>  method</dt>
# Line 550  method</dt> Line 670  method</dt>
670      an <a href="#Entity"><code>Entity</code></a> node with the following      an <a href="#Entity"><code>Entity</code></a> node with the following
671      attributes:</p>      attributes:</p>
672      <dl>      <dl>
     <dt><code>attributes</code>, <code>notationName</code>,  
     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
673      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
674        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
675      <dt><code>manakaiDeclarationBaseURI</code>,      <dt><code>manakaiDeclarationBaseURI</code>,
676      <code>manakaiEntityBaseURI</code>, and      <code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code>
677      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
678        <dd>No explicit value is set.</dd>        <dd>No explicit value is set.</dd>
679      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a></dt>
     <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
680        <dd><code>false</code>.</dd>        <dd><code>false</code>.</dd>
681      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
682        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
# Line 577  method</dt> Line 692  method</dt>
692            with its <code>nodeName</code> attribute set to <code>amp</code>.</p>            with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
693          </div>          </div>
694        </dd>        </dd>
695        <dt><a href="#notationName"><code>notationName</code></a>,
696        <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
697        and <code>parentNode</code></dt>
698          <dd><code>null</code>.</dd>
699      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
700        <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>
701      <dt><code>publicId</code>, and <code>systemId</code></dt>      <dt><a href="#publicId"><code>publicId</code></a> and
702        <a href="#systemId"><code>systemId</code></a></dt>
703        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
704        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dd>  
705      </dl>      </dl>
706    </dd>    <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
707      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
708  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
709  method</dt>  method</dt>
710    <dd>    <dd>
# Line 596  method</dt> Line 716  method</dt>
716      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
717      a <code>Notation</code> node with the following attributes:</p>      a <code>Notation</code> node with the following attributes:</p>
718      <dl>      <dl>
     <dt><code>attributes</code>,  
     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
719      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
720        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
721      <dt><code>manakaiDeclarationBaseURI</code></dt>      <dt><code>manakaiDeclarationBaseURI</code>
722        <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
723        <dd>No explicit value is set.</dd>        <dd>No explicit value is set.</dd>
     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
       <dd><code>false</code>.</dd>  
724      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
725        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
726      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
727        <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>
728      <dt><code>publicId</code> and <code>systemId</code></dt>      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
729        and <code>parentNode</code></dt>
730          <dd><code>null</code>.</dd>
731        <dt><a href="#publicId"><code>publicId</code></a> and
732        <a href="#systemId"><code>systemId</code></a></dt>
733        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
734        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dt>  
735      </dl>      </dl>
736    </dd>    <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
737      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
738  </dl>  </dl>
739    
740  <p>These methods <em class=rfc2119>MUST</em> raise an  <p>These methods <em class=rfc2119>MUST</em> raise an
741  <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
742  if <var>name</var> is <em>not</em> a legal <code>Name</code> according to  <code>Name</code>
743  the <abbr>XML</abbr> version in use, as specified in the  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
744  <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>  <a href="#ref-XML11">XML11</a>]</cite> according to the <abbr>XML</abbr>
745    version specified in the <code>xmlVersion</code> attribute of the
746    <a href="#Document"><code>Document</code></a> node.</p>
747    
748  <div class="note memo">  <div class="note memo">
749  <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,
750  since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not  since <abbr>DOM</abbr> Level 3 Core specification
751  define it for <code>Document</code> methods.</p>  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>
752    does not define it for <a href="#Document"><code>Document</code></a>
753    methods.</p>
754    
755  <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>
756  </div>  </div>
# Line 641  Interface</h3> Line 764  Interface</h3>
764    
765  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
766  <em class=rfc2119>MAY</em> contain zero or more  <em class=rfc2119>MAY</em> contain zero or more
767  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes in the <code>NodeList</code> object
768  nodes in the <code>NodeList</code> object contained in the  contained in the <code>childNodes</code> attribute of the
 <code>childNodes</code> attribute of the  
769  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
770    
771  <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created  <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
772  during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>  during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
773  document, the <code>NodeList</code> object in the <code>childNodes</code>  document, the <code>NodeList</code> object in the <code>childNodes</code>
774  object <em class=rfc2119>MUST</em> contains the  object <em class=rfc2119>MUST</em> contains the
775  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes representing the processing
776  nodes representing the processing instructions in the document type  instructions in the document type definition of the document processed
777  definition of the document processed <span class=ed>@@ ref</span> by  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
778  the <abbr>XML</abbr> processor.  If the  <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor.  If
779  <a href="#DocumentType"><code>DocumentType</code></a> node is marked  the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as
780  as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>  <a href="#read-only">read$B!>(Bonly</a>, then all the child nodes
781  also be marked as read$B!>(Bonly.</p>  <em class=rfc2119>MUST</em> also be marked as
782    <a href="#read-only">read$B!>(Bonly</a>.</p>
783    
784  <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
785  from a document type declaration information item <span class=ed>@@ ref</span>,  from a
786    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
787    type declaration information item</a>
788    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
789  the <code>NodeList</code> object in the <code>childNodes</code> attribute  the <code>NodeList</code> object in the <code>childNodes</code> attribute
790  of the node <em class=rfc2119>MUST</em> contain the  of the node <em class=rfc2119>MUST</em> contain the
791  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  <code>ProcessingInstruction</code> nodes created from any
792  created from the processing instruction information items in the list in the  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing
793  [children] property of the document type declaration item in the same  instruction information items</a> in the list in the [children] property of the
794  order.</p>  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
795    type declaration item</a> in the same order.</p>
796    
797  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
798  a document type declaration information item, the list in the [children]  a document type declaration information item, the list in the [children]
799  property <em class=rfc2119>MUST</em> contain the processng instruction  property <em class=rfc2119>MUST</em> contain the processng instruction
800  information items created from the  information items created from the <code>ProcessingInstruction</code> nodes
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
801  in the <code>NodeList</code> object in the <code>childNodes</code> attribute  in the <code>NodeList</code> object in the <code>childNodes</code> attribute
802  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
803    
804  <p>The implementation of the  <p>The implementation of the
805  <a href="#DocumentType"><code>DocumentType</code></a> interface  <a href="#DocumentType"><code>DocumentType</code></a> interface
806  <em class=rfc2119>MUST</em> be modified as following:</p>  <em class=rfc2119>MUST</em> be modified as the following
807    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
808  <pre class=idl><code>// Modifications to the DocumentType interface  <pre class=idl><code>// Modifications to the DocumentType interface
809    attribute DOMString <a href="#publicId">publicId</a>;    attribute DOMString <a href="#publicId">publicId</a>;
810    attribute DOMString <a href="#systemId">systemId</a>;    attribute DOMString <a href="#systemId">systemId</a>;
# Line 693  of the <a href="#DocumentType"><code>Doc Line 820  of the <a href="#DocumentType"><code>Doc
820  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
821    
822  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
823  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
824  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>
825  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
826  associated to the attribute.  No normalization, relative reference resolution,  normalization, relative reference resolution, or lexical validation is
827  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
828  value is <code>null</code>, ...</span></p>  mpty string be set?</span></p>
829    
830  <div class="note memo">  <div class="note memo">
831  <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 843  or <a href="#Entity"><code>Entity</code>
843  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
844    
845  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
846  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
847  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>
848  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
849  associated to the attribute.  No normalization, or lexical validation is  normalization, or lexical validation is performed.  <span class=ed>@@ If the
850  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>  
851    
852  </div>  </div>
853    
854  <div class=section id=section-documenttypedefinition>  <div class=section id=section-documenttypedefinition>
855  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>  <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
856    
857    <p>The <a href="#DocumentType"><code>DocumentType</code></a> nodes
858    <em class=rfc2119>MUST</em> also implement the
859    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
860    interface.</p>
861    
862    <p>An instance of the
863    <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
864    interface <em class=rfc2119>MUST</em> be able to be obtained by using
865    binding$B!>(Bspecific casting methods on an instance of the
866    <a href="#DocumentType"><code>DocumentType</code></a> interface (if such
867    casting methods are available) or by using the method <code>getFeature</code>
868    with parameter values
869    <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
870    and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively (if the
871    <a href="#DocumentType"><code>DocumentType</code></a> node supports the
872    feature <code>Core</code> version <code>3.0</code>
873    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
874    
875  <div class="note memo">  <div class="note memo">
876  <p>This interface is a separated interface from the  <p>This interface is a separated interface from the
877  <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions  <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
878  to the <a href="#DocumentType"><code>DocumentType</code></a>,  to the <a href="#DocumentType"><code>DocumentType</code></a>,
879  for the historical reason.</p>  for the historical reason.</p>
880    
881    <p class=ed>Should the interface be merged with
882    <a href="#DocumentType"><code>DocumentType</code></a>?</p>
883  </div>  </div>
884    
885  <p>The  <p>The
886  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
887  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as the following
888    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
889  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {  <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
890    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;    readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
891    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;    readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
# Line 761  interface <em class=rfc2119>MUST</em> be Line 909  interface <em class=rfc2119>MUST</em> be
909      raises (DOMException);      raises (DOMException);
910  }</code></pre>  }</code></pre>
911    
 <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>  
   
912  <dl>  <dl>
913  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of  <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
914  type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>  type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
915    <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
916    type definitions belonging to the <code>DocumentType</code> node.</p>    contains all the element type definitions belonging to the
917      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
918    
919    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
920    <code>NamedNodeMap</code> object that contains all the    <code>NamedNodeMap</code> object that contains all the
921    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
922    nodes belonging to the <code>DocumentType</code> node.  The    nodes belonging to the <code>DocumentType</code> node.  The
923    <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
924    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
925    object <em class=rfc2119>MUST</em> be live and the same object    <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
926    <em class=rfc2119>MUST</em> be returned for any invocation.</p>    <a href="#live">live</a>.</p>
927    
928    <p>If the <code>DocumentType</code> node is created during the process    <p>If the <code>DocumentType</code> node is created during the process
929    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 932  type <code>NamedNodeMap</code>, read$B!
932    <em class=rfc2119>MUST</em> be so transformed that the object contains    <em class=rfc2119>MUST</em> be so transformed that the object contains
933    the <code>ElementTypeDefinition</code> nodes for the element types    the <code>ElementTypeDefinition</code> nodes for the element types
934    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
935    attribute definition list declarations processed by the <abbr>XML</abbr>    attribute definition list declarations processed
936    processor.  If there is more than one element type declarations for an    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
937      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr>
938      processor.  If there are more than one element type declarations for an
939    element type, then the declarations other than the first one    element type, then the declarations other than the first one
940    <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
941    <code>NamedNodeMap</code> object.</p></dd>    <code>NamedNodeMap</code> object.</p></dd>
942  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>  <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
943  of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>  of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
944    <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
945    entities belonging to the <code>DocumentType</code> node.</p>    contains all the general entities belonging to the
946      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
947        
948    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
949    same value as the <code>entities</code> attribute (defined in the    same value as the <code id=entities>entities</code> attribute (defined in the
950    <code>DocumentType</code> interface) of the same node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
951      node.</p>
952    
953    <div class="note memo">    <div class="note memo">
954      <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 976  reflected by that of the object.
976  -->  -->
977  <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
978  <code>notations</code>, read$B!>(Bonly</code>  <code>notations</code>, read$B!>(Bonly</code>
979    <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
980    notations belonging to the <code>DocumentType</code> node.</p>    contains all the notations belonging to the
981      <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
982        
983    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
984    same value as the <code>notations</code> attribute (defined in the    same value as the <code>notations</code> attribute (defined in the
985    <code>DocumentType</code> interface) of the same node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
986      node.</p>
987    
988    <div class="note memo">    <div class="note memo">
989      <p>This attribute is part of the interface for historical reason.</p>      <p>This attribute is part of the interface for historical reason.</p>
990      <p>Implementations are not required to implement the      <p>Implementations are not required to implement the
991      <code>notations</code> attribute twice (for <code>DocumentType</code>      <code>notations</code> attribute twice (for
992      and <code>DocumentTypeDefinition</code> interfaces); they share exactly      <a href="#DocumentType"><code>DocumentType</code></a> and
993      same definition.</p>      <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
994        interfaces); they share exactly same definition.</p>
995    </div></dd>    </div></dd>
996  <!--  <!--
997  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
# Line 889  method</dt> Line 1036  method</dt>
1036    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
1037    node.  If there is no such node, it <em class=rfc2119>MUST</em> return    node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1038    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
 <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,  
 method</dt>  
   <dd><p>Returns the  
   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node  
   with the specified name.</p>  
   
   <p>The  
   <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>  
   parameter is the name of the element type.</p>  
   
   <p>When invoked, the method <em class=rfc2119>MUST</em> return the  
   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,  
   whose <a href="#nodeName"><code>nodeName</code></a> is equal to  
   <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the  
   <code>NamedNodeMap</code> object in the  
   <a href="#elementTypes"><code>elementTypes</code></a> attribute of the  
   node.  If there is no such node, it <em class=rfc2119>MUST</em> return  
   <code>null</code>.</p></dd>  
1039  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
1040  method</dt>  method</dt>
1041    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
1042    with the specified name.</p>    with the specified name.</p>
1043    
1044    <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>    <p>The
1045      <dfn id=getGeneralEntityNode-name class=dom-param><var>name</var></dfn>
1046    parameter is the name of the general entity.</p>    parameter is the name of the general entity.</p>
1047    
1048    <p>When invoked, the method <em class=rfc2119>MUST</em> return the    <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1049    <a href="#Entity"><code>Entity</code></a> node,    <a href="#Entity"><code>Entity</code></a> node,
1050    whose <a href="#nodeName"><code>nodeName</code></a> is equal to    whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1051    <a href="#getEntityNode-name"><var>name</var></a>, in the    <a href="#getGeneralEntityNode-name"><var>name</var></a>, in the
1052    <code>NamedNodeMap</code> object in the    <code>NamedNodeMap</code> object in the
1053    <a href="#entities"><code>entities</code></a> attribute of the    <a href="#entities"><code>entities</code></a> attribute of the
1054    node.  If there is no such node, it <em class=rfc2119>MUST</em> return    node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1055    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
1056  <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,  <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,
1057  method</dt>  method</dt>
1058    <dd><p>Returns the <a href="#Notation"><code>Notation>/code></a> node    <dd><p>Returns the <a href="#Notation"><code>Notation</code></a> node
1059    with the specified name.</p>    with the specified name.</p>
1060    
1061    <p>The    <p>The
# Line 963  method</dt> Line 1093  method</dt>
1093    
1094  <p>The nodes of type  <p>The nodes of type
1095  <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>
1096  represents an element type definition.  Such a node implements the  represents an element type definition.  Such a node
1097    <em class=rfc2119>MUST</em> implement the
1098  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1099  interface, which extends the <a href="#Node"><code>Node</code></a>  interface, which extends the <a href="#Node"><code>Node</code></a>
1100  interface.</p>  interface.</p>
# Line 982  declaration for that element type, the < Line 1113  declaration for that element type, the <
1113  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1114  node for that element type.</p>  node for that element type.</p>
1115    
1116    <p>An <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1117    node cannot be a child of any node.  An
1118    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1119    cannot have any child node.</p>
1120    
1121  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>  <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1122  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as the following
1123    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1124  <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> {
1125    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;    readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
1126    
1127    <span class=ed>@@ more</span>    readonly attribute NamedNodeMap <a href="#attributeDefinitions">attributeDefinitions</a>;
1128      <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
1129        (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
1130      void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
1131        (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-node"><var>node</var></a>)
1132        raises (DOMException);
1133  }</code></pre>  }</code></pre>
1134    
1135  <dl>  <dl>
# Line 998  of type <a href="#DocumentType"><code>Do Line 1140  of type <a href="#DocumentType"><code>Do
1140    attribute of    attribute of
1141    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
1142    <a href="#Entity"><code>Entity</code></a>, and    <a href="#Entity"><code>Entity</code></a>, and
1143    <a href="#Notation"><code>Notation</code></a> interface contains the    <a href="#Notation"><code>Notation</code></a> interfaces contain the
1144    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node    <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
1145    is attached.</p>    is attached.</p>
1146    
# Line 1014  of type <a href="#DocumentType"><code>Do Line 1156  of type <a href="#DocumentType"><code>Do
1156    <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
1157    a <a href="#DocumentType"><code>DocumentType</code></a> node,    a <a href="#DocumentType"><code>DocumentType</code></a> node,
1158    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>
1159    <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>
1160    of type NamedNodeMap, read$B!>(Bonly</dt>
1161      <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
1162      contains all the attribute definitions belonging to the
1163      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1164      node.</p>
1165    
1166      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1167      <code>NamedNodeMap</code> object that contains all the
1168      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1169      belonging to the
1170      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1171      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1172      read$B!>(Bonly if and only if the node is <a href="#read-only">read$B!>(Bonly</a>.  
1173      The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
1174      <a href="#live">live</a>.</p>
1175      
1176      <p>If the
1177      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
1178      is created during the process to create a <abbr>DOM</abbr> from an
1179      <abbr>XML</abbr> document, the following requirements are applied:  The
1180      <code>NamedNodeMap</code> object in the
1181      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1182      attribute <em class=rfc2119>MUST</em> be so transformed that the object
1183      contains the
1184      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1185      corresponding to the attribute definitions in the attribute definition
1186      list declarations processed
1187      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1188      <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor and
1189      associated to the element type represented by the node.  If there are more
1190      than one attribute definitions for an attribute, then the definitions other
1191      than the first one <em class=rfc2119>MUST</em> be ignored for the purpose
1192      of constructing the <code>NamedNodeMap</code> object.</p></dd>
1193    <dt><dfn id=getAttributeDefinitionNode class=dom-method><code>getAttributeDefinitionNode</code></dfn>,
1194    method</dt>
1195      <dd><p>Return the
1196      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1197      with the specified name.</p>
1198    
1199      <p>The
1200      <dfn id=getAttributeDefinitionNode-name class=dom-param><var>name</var></dfn>
1201      parameter is the name of the attribute.</p>
1202    
1203      <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1204      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
1205      whose <a href="#nodeName"><code>nodeName</code></a> attribute value is
1206      equal to <a href="#getAttributeDefinitionNode-name"><var>name</var></a>,
1207      in the <code>NamedNodeMap</code> in the
1208      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1209      attribute of the node.  If there is no such node, it
1210      <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
1211    <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
1212    method</dt>
1213      <dd class=ed>@@</dd>
1214  </dl>  </dl>
1215    
1216  <div class=ed>  <div class=ed>
# Line 1028  element type.</p> Line 1225  element type.</p>
1225    
1226  <p>The nodes of type  <p>The nodes of type
1227  <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>  <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
1228  represents an attribute definition.  Such a node implements the  represents an attribute definition.  Such a node
1229    <em class=rfc2119>MUST</em> implement the
1230  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
1231  which extends the <a href="#Node"><code>Node</code></a> interface.</p>  which extends the <a href="#Node"><code>Node</code></a> interface.</p>
1232    
# Line 1042  type in <abbr>DTD</abbr>, the result <ab Line 1240  type in <abbr>DTD</abbr>, the result <ab
1240  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for  <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
1241  that attribute.</p>  that attribute.</p>
1242    
1243    <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1244    node cannot be a child of any node.  An
1245    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1246    can have zero or more child nodes of same kinds as those allowed for
1247    <code>Attr</code> nodes
1248    <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>.</p>
1249    
1250  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>  <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1251  interface <em class=rfc2119>MUST</em> be implemented as following:</p>  interface <em class=rfc2119>MUST</em> be implemented as the following
1252    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1253  <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> {
1254    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>    <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
1255    const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;    const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
# Line 1069  interface <em class=rfc2119>MUST</em> be Line 1275  interface <em class=rfc2119>MUST</em> be
1275    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;    readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
1276    
1277    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;    readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
1278      readonly attribute DOMStringList <a href="#allowedTokens">allowedTokens</a>;
1279    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;    readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
   
   <span class=ed>...</span>  
1280  }</code></pre>  }</code></pre>
1281    
1282  <dl>  <dl>
# Line 1087  read$B!>(Bonly</dt> Line 1292  read$B!>(Bonly</dt>
1292    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
1293    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1294    It <em class=rfc2119>MUST</em> be such a node that whose    It <em class=rfc2119>MUST</em> be such a node that whose
1295    <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1296    attribute contains the <code>NamedNodeMap</code> object that contains    attribute contains the <code>NamedNodeMap</code> object that contains
1297    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1298    node.  If there is no such an    node.  If there is no such an
# Line 1095  read$B!>(Bonly</dt> Line 1300  read$B!>(Bonly</dt>
1300    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
1301  <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
1302  <code>unsigned short</code></dt>  <code>unsigned short</code></dt>
1303    <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.    <dd><p>The declared type
1304    It is expected that this attribute contains a value from the definition group    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1305      <a href="#ref-XML11">XML11</a>]</cite> of the attribute.  It is expected that
1306      this attribute contains a value from the definition group
1307    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>    <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
1308    
1309    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1310    value associated to this attribute.</p>    value associated to this attribute.</p>
1311    
1312    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1313    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
   exception if the  
1314    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1315    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it    is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1316    <em class=rfc2119>MUST</em> set the specified value as the value    <em class=rfc2119>MUST</em> set the specified value as the value
1317    associated to this attribute.</p>    associated to this attribute.</p>
1318    
# Line 1129  group contains the following constants:< Line 1335  group contains the following constants:<
1335  <tbody>  <tbody>
1336  <tr>  <tr>
1337  <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>
1338  <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
1339    value</a>
1340    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>.</tr>
1341  <tr>  <tr>
1342  <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>
1343  <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>  <td><code>1</code><td><code>CDATA</code>
1344    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1345    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1346  <tr>  <tr>
1347  <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>
1348  <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>  <td><code>2</code><td><code>ID</code>
1349    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1350    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1351  <tr>  <tr>
1352  <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>
1353  <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>  <td><code>3</code><td><code>IDREF</code>
1354    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1355    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1356  <tr>  <tr>
1357  <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>
1358  <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>  <td><code>4</code><td><code>IDREFS</code>
1359    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1360    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1361  <tr>  <tr>
1362  <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>
1363  <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>  <td><code>5</code><td><code>ENTITY</code>
1364    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1365    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1366  <tr>  <tr>
1367  <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>
1368  <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>  <td><code>6</code><td><code>ENTITIES</code>
1369    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1370    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1371  <tr>  <tr>
1372  <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>
1373  <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>  <td><code>7</code><td><code>NMTOKEN</code>
1374    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1375    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1376  <tr>  <tr>
1377  <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>
1378  <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>  <td><code>8</code><td><code>NMTOKENS</code>
1379    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1380    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1381  <tr>  <tr>
1382  <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>
1383  <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>  <td><code>9</code><td><code>NOTATION</code>
1384    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1385    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1386  <tr>  <tr>
1387  <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>
1388  <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>  <td><code>10</code><td>Enumeration
1389    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1390    <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1391  <tr>  <tr>
1392  <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>
1393  <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>,
1394  has been read but the [all declaration processed] property  because no declaration for the attribute has been read but the
1395  <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>
1396    property
1397    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
1398    would be false.</tr>
1399  </tbody>  </tbody>
1400  </table>  </table>
1401    
1402  <p>If no attribute type information is available, or if the source  <p>If no attribute type information is available, or if the source
1403  of the information does not distinguish <q>no value</q> and <q>unknown</q>  of the information does not distinguish
1404  <span class=ed>[INFOSET]</span>, then the value  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">no
1405    value</a> and
1406    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1407    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
1408    then the value
1409  <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>  <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
1410  <em class=rfc2119>MUST</em> be used.</p>  <em class=rfc2119>MUST</em> be used.</p>
1411    
# Line 1182  method has its <a href="#declaredType">< Line 1417  method has its <a href="#declaredType"><
1417  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>
1418  </div>  </div>
1419    
1420  <p>If the source of the information does not distinguish <q>no value</q>  <p>If the source of the information does not distinguish
1421  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
1422  <code>CDATA</code> <span class=ed>[XML]</span>, then the value  value</a> and/or
1423    <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#intro.null">unknown</a>
1424    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite> and
1425    <code>CDATA</code>
1426    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1427    <a href="#ref-XML11">XML11</a>]</cite>, then the value
1428  <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>
1429  be used.</p>  be used.</p>
1430    
1431  <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the  <p>In Perl binding
1432    <cite class="bibref normative">[<a href="#ref-DOMPERL">DOMPERL</a>]</cite>, the
1433  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the  <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
1434  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>  <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
1435  definition group.</p>  definition group.</p>
1436    
1437    </dd>    </dd>
1438    <dt><dfn id=allowedTokens class=dom-attr><code>allowedTokens</code></dfn> of
1439    type <code>DOMStringList</code>, read$B!>(Bonly</dt>
1440      <dd><p>The list of allowed attribute values.</p>
1441    
1442      <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
1443      <code>DOMStringList</code> object associated to this attribute.  The object
1444      <em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of
1445      zero or more characters respectively, possibly with duplications.  The
1446      object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node
1447      is <a href="#read-only">read$B!>(Bonly</a>.</p>
1448    
1449      <p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1450      node is created during the process to create a <abbr>DOM</abbr> from an
1451      <abbr>XML</abbr> document, the object <em class=rfc2119>MUST</em> contain
1452      the names or name tokens allowed for the attribute defined by the node.
1453      If the document is well$B!>(Bformed, the object will be empty unless
1454      the <a href="#declaredType"><code>declaredType</code></a> is
1455      <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1456      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>.</p>
1457    
1458      <p>If the <a href="#declaredType"><code>declaredType</code></a> is different
1459      from <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
1460      <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>, this attribute
1461      <em class=rfc2119>MUST</em> be ignored for the purpose of serializing
1462      into (part of) <abbr>XML</abbr> document.</p>
1463    
1464      <div class="note memo">
1465        <p>When serializing the node it should be noted that the object might
1466        be empty, might contain duplications, and might contain strings that are
1467        not names or name tokens.</p>
1468      </div></dd>
1469  <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of  <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
1470  type <code>unsigned short</code></dt>  type <code>unsigned short</code></dt>
1471    <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 1476  type <code>unsigned short</code></dt>
1476    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1477    
1478    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1479    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the
   exception if the  
1480    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
1481    is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it    is <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1482    <em class=rfc2119>MUST</em> set the specified value as the value    <em class=rfc2119>MUST</em> set the specified value as the value
1483    associated to this attribute.</p>    associated to this attribute.</p>
1484    
# Line 1234  type <code>unsigned short</code></dt> Line 1505  type <code>unsigned short</code></dt>
1505    <td><code>0</code><td>Unknown.</tr>    <td><code>0</code><td>Unknown.</tr>
1506    <tr>    <tr>
1507    <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>
1508    <td><code>1</code><td>Provided explicitly and fixed    <td><code>1</code><td>Provided explicitly and only the value is allowed.
1509    <span class=ed>@@ ref</span> to that value.</tr>    <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1510      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1511    <tr>    <tr>
1512    <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>
1513    <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
1514    explicitly specified.</tr>    explicitly specified.</tr>
1515    <tr>    <tr>
1516    <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>
1517    <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>    <td><code>3</code><td>Implied
1518      <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
1519      <a href="#ref-XML11">XML11</a>]</cite>.</tr>
1520    <tr>    <tr>
1521    <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>
1522    <td><code>4</code><td>Provided explicitly.</tr>    <td><code>4</code><td>Provided explicitly.</tr>
# Line 1270  type <code>unsigned short</code></dt> Line 1544  type <code>unsigned short</code></dt>
1544  <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>  <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
1545    
1546  <p>The implementation of the <a href="#Entity"><code>Entity</code></a>  <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
1547  interface <em class=rfc2119>MUST</em> be modified as following:</p>  interface <em class=rfc2119>MUST</em> be modified as the following
1548    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1549  <pre class=idl><code>// Modifications to the Entity interface  <pre class=idl><code>// Modifications to the Entity interface
1550    attribute DOMString <a href="#publicId">publicId</a>;    attribute DOMString <a href="#publicId">publicId</a>;
1551    attribute DOMString <a href="#systemId">systemId</a>;    attribute DOMString <a href="#systemId">systemId</a>;
# Line 1288  interface <em class=rfc2119>MUST</em> be Line 1563  interface <em class=rfc2119>MUST</em> be
1563  read$B!>(Bonly.</p>  read$B!>(Bonly.</p>
1564    
1565  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a  <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1566  <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>  <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1567  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>
1568  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
1569  associated to the attribute.  No lexical validation is performed.  The new  validation is performed.  The new value <em class=rfc2119>MAY</em> be
1570  value <em class=rfc2119>MAY</em> be <code>null</code>.</p>  <code>null</code>.</p>
1571    
1572  <dl>  <dl>
1573  <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 1580  of type boolean</dt>
1580    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1581    
1582    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1583    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1584    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1585    Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the    <em class=rfc2119>MUST</em> set the specified value as the
1586    value associated to this attribute.</p>    value associated to this attribute.</p>
1587    
1588    <div class="note memo">    <div class="note memo">
# Line 1351  of type boolean</dt> Line 1626  of type boolean</dt>
1626    the value associated to this attribute.</p>    the value associated to this attribute.</p>
1627    
1628    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a    <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
1629    <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>    <code>NO_MODIFICATION_ALLOWED_ERR</code> if the node is
1630    exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.      <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it
1631    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
1632    value associated to this attribute.</p>    to this attribute.</p>
1633    
1634    <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
1635    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 1370  of type boolean</dt> Line 1645  of type boolean</dt>
1645  <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>  <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>
1646    
1647  <p>The implementation of the <a href="#Notation"><code>Notation</code></a>  <p>The implementation of the <a href="#Notation"><code>Notation</code></a>
1648  interface <em class=rfc2119>MUST</em> be modified as following:</p>  interface <em class=rfc2119>MUST</em> be modified as the following
1649    <a href="#idl-fragment"><abbr>IDL</abbr> fragment</a>:</p>
1650  <pre class=idl><code>// Modifications to the Notation interface  <pre class=idl><code>// Modifications to the Notation interface
1651    attribute DOMString <a href="#publicId">publicId</a>;    attribute DOMString <a href="#publicId">publicId</a>;
1652    attribute DOMString <a href="#systemId">systemId</a>;    attribute DOMString <a href="#systemId">systemId</a>;
# Line 1390  interface <em class=rfc2119>MUST</em> be Line 1666  interface <em class=rfc2119>MUST</em> be
1666    
1667  <dl>  <dl>
1668  <dt id=ref-DOM3CORE>DOM3CORE</dt>  <dt id=ref-DOM3CORE>DOM3CORE</dt>
1669    <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
1670  <dt id=ref-DOMDTDEF>DOMDTDEF</dt>    Object Model (<abbr>DOM</abbr>) Level 3 Core Specification, Version
1671    <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
1672      April 2004</time>.  <em>This</em> version of the specification is referenced.
1673      The latest version of the specification is available at
1674      <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>
1675    <dt id=ref-DOMBIND>DOMBIND</dt>
1676      <dd><cite><a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/">Language
1677      Bindings for <abbr>DOM</abbr> Specifications</a></cite>, <abbr>W3C</abbr>
1678      Working Draft, <time datetime=2007-10-17>17 October 2007</time>.  
1679      <em>This</em> version of the specification is referenced.  The latest version
1680      of the specification is available at
1681      <code class=uri>&lt;<a href="http://www.w3.org/TR/DOM-Bindings/">http://www.w3.org/TR/DOM-Bindings/</a>></code>.</dd>
1682    <dt id=ref-DOMPERL>DOMPERL</dt>
1683      <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Perl%20Binding">manakai's
1684      <abbr>DOM</abbr> Perl Binding</a></cite>, editor's draft.  Work in
1685      progress.</dd>
1686    <dt id=ref-HTML5>HTML5</dt>
1687      <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
1688      <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
1689      Working Draft.  Work in progress.</dd>
1690    <dt id=ref-INFOSET>INFOSET</dt>
1691      <dd><cite><a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204"><abbr>XML</abbr>
1692      Information Set (Second Edition)</a></cite>, <abbr>W3C</abbr> Recommendation,
1693      <time datetime=2004-02-04>4 February 2004</time>.  <em>This</em> version of
1694      the specification is referenced.  The latest version of the specification is
1695      available at
1696      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml-infoset">http://www.w3.org/TR/xml-infoset</a>></code>.</dd>
1697  <dt id="ref-KEYWORDS">KEYWORDS</dt>  <dt id="ref-KEYWORDS">KEYWORDS</dt>
1698    <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
1699    <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 1702  interface <em class=rfc2119>MUST</em> be
1702    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
1703    <time datetime=1997-03>March 1997</time>.    <time datetime=1997-03>March 1997</time>.
1704    <em>This</em> version of the specification is referenced.</dd>    <em>This</em> version of the specification is referenced.</dd>
1705  <dt id=ref-INFOSET>INFOSET</dt>  <dt id=ref-MANAKAI>MANAKAI</dt>
1706    <dd class=ed>@@</dd>    <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions">
1707  <dt id=ref-XML10">XML10</dt>    manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft.  Work in
1708      progress.</dd>
1709    <dt id=ref-XML10>XML10</dt>
1710    <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
1711    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
1712    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1713    2006</time>, edited in place <time datetime=2006-09-29>29 September    2006</time>, edited in place <time datetime=2006-09-29>29 September
1714    2006</time>.  Tje latest version of the specification is available at    2006</time>.  <em>This</em> version of the specification is referenced.  The
1715    <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
1716    <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>
1717  <dt id=ref-XML11>XML11</dt>  <dt id=ref-XML11>XML11</dt>
1718    <dd class=ed>@@</dd>    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml11-20060816/">Extensible
1719      Markup Language (<abbr>XML</abbr>) 1.1 (Second Edition)</a></cite>,
1720      <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
1721      2006</time>, edited in place <time datetime=2006-09-29>29 September
1722      2006</time>.  <em>This</em> version of the specification is referenced.  The
1723      latest version of the specification is available at
1724      <code class=uri>&lt;<a href="http://www.w3.org/TR/xml11">http://www.w3.org/TR/xml11</a>></code>.</dd>
1725  </dl>  </dl>
1726  </div>  </div>
1727    
1728  <div id="informative-references" class="section informative reference">  <div id="informative-references" class="section informative reference">
1729  <h3>Non$B!>(Bnormative References</h3>  <h3>Non$B!>(Bnormative References</h3>
1730    
1731  <dl class=ed>  <dl>
1732  <dt id=ref-CSS>CSS</dt>  <dt id=ref-DOM1WD>DOM1WD</dt>
1733    <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
1734    Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1735    Specification</a></cite>,    <time datetime=1997-12-09>9 December 1998</time>.</dd>
1736    <abbr title="World Wide Web Consortium">W3C</abbr> Candidate    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object
1737    Recommendation, <time datetime=2007-07-19>19 July 2007</time>.    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1738    Work in progress.  The latest version of the specification is    <time datetime=1998-03-18>18 March 1998</time>.</dd>
1739    available at    <dd><cite><a href="http://www.w3.org/TR/1998/WD-DOM-19980416/">Document
1740    <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
1741  <dt id=ref-CSSOM>CSSOM</dt>    Draft, <time datetime=1998-04-16>16 April 1998</time>.</dd>
1742    <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>
1743    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
1744    <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,    Object Model (<abbr>DOM</abbr>) Level 3 Abstract Schemas Specification,
1745    <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
1746    The latest Editor's Draft of the specification is available at    July 2002</time>.  The latest version of the specification is available at
1747    <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>
1748  <dt id=ref-HTML5>HTML5</dt>  <dt id=ref-XSAPI>XSAPI</dt>
1749    <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>
1750    <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>    Schema <abbr>API</abbr></a></cite>, <abbr>W3C</abbr> Member Submission,
1751    Working Draft.  Work in progress.</dd>    <time datetime=2004-03-09>9 March 2004</time>.  The latest version of the
1752  <dt id=ref-SAPI>SAPI</dt>    specification is available at
1753    <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>  
1754  </dl>  </dl>
1755  </div>  </div>
1756    

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

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24