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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1.4 by wakaba,
Sun Dec  2 05:00:26 2007 UTC
+revision 1.22 by wakaba,
Sat Dec  8 08:16:53 2007 UTC
 Line 10
  <div class="header">
  <h1>DOM Document Type Definition Module</h1>
- <h2>Working Draft <time datetime=2007-12-01>1 December 2007</time></h2>
+ <h2>Working Draft <time datetime=2007-12-08>8 December 2007</time></h2>
  <dl class="versions-uri">
  <dt>This Version</dt>
 Line 50 
 available at <code class="URI">&lt;<a
  <div id="abstract" class="section">
  <h2>Abstract</h2>
- <div class="ed issue">...</div>
+ <p>The <abbr>DOM</abbr> Document Type Definition module is a set of
+ <abbr>DOM</abbr> interfaces, including both new interfaces and modifications
+ to existing <abbr>DOM</abbr> interfaces, over which <abbr>DOM</abbr>
+ applications are able to access to the definitions of the document type.</p>
  </div>
  <div id="status" class="section">
-Line 80 
 normative version.</p>
+Line 82 
 normative version.</p>
  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
- <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>
  <p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>
  module is a set of <abbr>DOM</abbr> interfaces, including both new
  interfaces and modifications to existing <abbr>DOM</abbr> interfaces,
-Line 99 
 early drafts of <abbr>DOM</abbr> level 1
+Line 95 
 early drafts of <abbr>DOM</abbr> level 1
  any of them as a whole.</p>
  </div>
- <div class="section" id="terminology">
+ <div class="section" id=conformance>
- <h2>Terminology</h2>
+ <h2>Conformance Requirements</h2>
- <p>The key words <q><em class="rfc2119">MUST</em></q>,
+ <div class=section id=terminology>
- <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>
-</a>
- <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
- <!-- Strictly speaking the paragraph below is not part of terminology. -->
  <p>All examples and notes in this specification are non$B!>(Bnormative,
  as are all sections explicitly marked non$B!>(Bnormative.  Everything
  else in this specification is normative.</p>
- <p><span class=ed>Algorithm is normative but non-normative</span>.
+ <p>The key words <q><em class="rfc2119">MUST</em></q>,
- 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>
- raised is undefined.</p>
+ in this document are to be interpreted as described in
+ <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
+</a>
+ <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
- <p class=ed><var>A</var> object is an object implementing <var>A</var>
+ <p>Conformance requirements phrased as algorithms or specific steps
- interface.</p>
+ <em class=rfc2119>MAY</em> be implemented in any manner, so long as the end
+ result is equivalent.  Requirements phrased in the imperative as part of
+ algorithms are to be interpreted with the meaning of the key word used in
+ introducing the algorithm.</p>
+ <p>Sometimes an exception is phrased as being required to be raised.  As
+ specified in the <abbr>DOM</abbr> Core specification
+ <span class=ed>[DOM3]</span>,
+ when the value of the <code>strictErrorChecking</code> attribute of the
+ <a href="#Document"><code>Document</code></a> node is <code>false</code>,
+ then the exception is not have to be raised.</p>
+ <p>Some conformance requirements are phrased as requirements on interfaces,
+ attributes, methods, or objects.  Such requirements are applied to
+ implementations.</p>
+ <p>The construction <q>a <code><var>Foo</var></code> object</q>, where
+ <code><var>Foo</var></code> is an interface, is used instead of the more
+ accurate <q>an object implementing the interface
+ <code><var>Foo</var></code></q>.</p>
+ <p>The construction <q>raise a <code><var>Bar</var></code></q>, where
+ <code><var>Bar</var></code> is an exception code, is used instead of the more
+ accurate <q>raise an exception implementing the interface
+ <code>DOMException</code> <span class=ed>[DOM3]</span> with its
+ <code>code</code> attribute set to <code><var>Bar</var></code></q>.</p>
+ <p>The term
+ <q id=live><a href="http://www.whatwg.org/specs/web-apps/current-work/#live">live</a></q>
+ is defined in the HTML5 specification <span class=ed>[HTML5]</span>.</p>
  <p class=ed>@@ ref to DOM Binding Spec</p>
  </div>
+ <div class=section id=conformance-categories>
+ <h3>Conformance Categories</h3>
+ <p>There are several kinds of products that can be claim to conform to
+ this specification:</p>
+ <dl>
+ <dt id=category-dom-implementation><abbr>DOM</abbr> Implementation</dt>
+   <dd>A <abbr>DOM</abbr> implementation (or just written as
+   <q>implementation</q> in this document) provides a way to access
+   <abbr>DOM</abbr> trees for applications by implementing interfaces defined
+   by this and other documents.  Unless otherwise noted, requirements in this
+   document are applied to <abbr>DOM</abbr> implementations.  To implement
+   all the features in this document, the implementation have to implement
+   some version of <abbr>DOM</abbr> Core (e.g. <abbr>DOM</abbr> level 3
+   <span class=ed>[DOM3]</span>) with one or more language binding (e.g.
+   ECMAScript or Java binding <span class=ed>[BINDINGS]</span> or
+   Perl binding <span class=ed>[PERLBINDING]</span>).</dd>
+ <dt id=category-xml-parser><abbr>XML</abbr> Parser (<abbr>XML</abbr> document
+ to <abbr>DOM</abbr> tree converter)</dt>
+   <dd>A software component that converts
+   <abbr>XML</abbr> 1.0 or 1.1 document (or fragment thereof) into a
+   <abbr>DOM</abbr> tree (or fragment thereof) in the context of this
+   document.  Note that this document does not define any particular way to
+   parse an <abbr>XML</abbr> document or to construct an <abbr>DOM</abbr>
+   document, but it defines constraints for such processing.</dd>
+ <dt id=category-xml-serializer><abbr>XML</abbr> Serializer (<abbr>DOM</abbr>
+ tree to <abbr>XML</abbr> document converter)</dt>
+   <dd>A software component that converts
+   <abbr>DOM</abbr> tree (or fragment thereof) into an <abbr>XML</abbr> 1.0 or
+.1 document (or fragment thereof).  Note that this document does not define
+   any particular way to serialize a <abbr>DOM</abbr> tree, but it defines
+   constraints for such processing.</dd>
+ <dt id=category-infoset-dom><abbr>XML</abbr> Information Set to
+ <abbr>DOM</abbr> Tree Converter</dt>
+   <dd>A software component that converts an <abbr>XML</abbr> information set
+   into a <abbr>DOM</abbr> tree.  Note that this documetn does not define
+   any particular way for the convertion, but it defines constraints for
+   such processing.</dd>
+ <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>
+ Information Set Converter</dt>
+   <dd>A software component that converts a <abbr>DOM</abbr> tree into
+   an <abbr>XML</abbr> information set.  Note that this documetn does not define
+   any particular way for the convertion, but it defines constraints for
+   such processing.</dd>
+ </dl>
+ </div>
+ </div>
  <div class=section id=dom-dtdef>
  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
  <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
- consists of three interfaces:</p>
+ introduces four interfaces:
- <ul>
+ <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>,
- <li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>,
- <li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
- <li><a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a></li>
+ and <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>.
- <li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>
+ In addition, it modifies existing interfaces
- </ul>
- <p>In addition, it adds methods, attributes, and/or constants to interfaces
  <a href="#Node"><code>Node</code></a>,
- <a href="#Entity"><code>Entity</code></a>,
+ <a href="#Document"><code>Document</code></a>,
- <a href="#EntityReference"><code>EntityReference</code></a>, and
+ <a href="#DocumentType"><code>DocumentType</code></a>,
- <a href="#Notation"><code>Notation</code></a>.
+ <a href="#Entity"><code>Entity</code></a>, and
- It modifies semantics of some of methods and attributes in
+ <a href="#Notation"><code>Notation</code></a>.</p>
- <a href="#Node"><code>Node</code></a> and
- <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
- interfaces, for the support of new interfaces.</p>
  <div class=section id=features>
- <h3>Feature Name</h3>
+ <h3>Feature String</h3>
  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of
  the <abbr>DOM</abbr> Document Type Definition module, the
  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
- set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
+ set to
- <code>3.0</code> respectively.</p>
+ <dfn id=feature-XDoctype><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></dfn>
+ and <dfn id=feature-XDoctype-3.0><code>3.0</code></dfn> respectively.  Any
+ method that takes one or more feature names, with or without version number,
+ such as <code>hasFeature</code> or <code>getFeature</code>,
+ <em class=rfc2119>MUST</em> behave in a manner consistent with it.</p>
+ </div>
+ <div class=section id=section-node>
+ <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
+ <p>The implementation of the
+ <a href="#Node"><code>Node</code></a> interface
+ <em class=rfc2119>MUST</em> be modified as following:</p>
+ <pre class=idl><code>// Additions to the Node interface
+ // Additions to the NodeType definition group
+ const unsigned short <a href="#ELEMENT_TYPE_DEFINITION_NODE">ELEMENT_TYPE_DEFINITION_NODE</a> = 81001;
+ const unsigned short <a href="#ATTRIBUTE_DEFINITION_NODE">ATTRIBUTE_DEFINITION_NODE</a> = 81002;
+ </pre>
+ <p>This specification adds two new types (subinterfaces) of
+ <a href="#Node"><code>Node</code></a>: element type definition (node type
+ <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>,
+ interface
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) and
+ attribute definition (node type
+ <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>,
+ interface
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).  For
+ these kinds of nodes, methods and attributes in the
+ <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
+ <dl>
+ <dt><code id=attributes>attributes</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+     <code>null</code>.</p>
+   </dd>
+ <dt><code id=baseURI>baseURI</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+     value of the <a href="#baseURI"><code>baseURI</code></a> attribute
+     of the node in the <code>ownerDocument</code> attribute of the node.
+     Note that the value might be <code>null</code>.</p>
+   </dd>
+ <dt><code id=cloneNode>cloneNode</code></dt>
+   <dd class=ed>
+     <p>A future version of the specification is expected to define the
+     behavior of the <a href="#cloneNode"><code>cloneNode</code></a> method
+     for those kinds of nodes.  In addition, it might revise behavior of
+     the method for <a href="#Entity"><code>Entity</code></a>,
+     <a href="#Notation"><code>Notation</code></a>, and/or
+     <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
+   </dd>
+   <!--
+   <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
+   -->
+ <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
+   <dd class=ed>
+     <p>A future version of the specification is expected to define the
+     behavior of the method
+     for those kinds of nodes.  In addition, it might revise behavior of
+     the method for <a href="#Entity"><code>Entity</code></a>,
+     <a href="#Notation"><code>Notation</code></a>, and/or
+     <a href="#DocumentType"><code>DocumentType</code></a> nodes.</p>
+   </dd>
+ <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
+   <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
+   <code>false</code>.</p></dd>
+ <dt><code id=isEqualNode>isEqualNode</code></dt>
+   <dd><p>For the <a href="#isEqualNode"><code>isEqualNode</code></a> method,
+   following items are added to the list of conditions for equality:</p>
+   <ul>
+   <li>
+     <p>If the nodes are <a href="#DocumentType"><code>DocumentType</code></a>
+     and at least one of them has the support for the feature
+     <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
+     <ul>
+     <li>they are equal according to <abbr>DOM</abbr> level 3 definition
+     <span class=ed>@@ ref</span>, and
+     <li>either:
+       <ul><!--
+       <li>both of them does not support the feature
+       <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>,</li>-->
+       <li>exactly one of them support the feature
+       <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
+       and the <code>length</code> attribute of the <code>NamedNodeMap</code>
+       object in the <a href="#elementTypes"><code>elementTypes</code></a>
+       attribute of it is equal to <code>0</code>, or</li>
+       <li>both of them support the feature
+       <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
+       and the values of the
+       <a href="#elementTypes"><code>elementTypes</code></a> attributes are
+       equal (equality of the
+       <a href="#elementTypes"><code>elementTypes</code></a> attribute is same
+       as that for the <code>attributes</code> attribute).</li>
+       </ul>
+     </li>
+     </ul>
+   </li>
+   <li><p>If the nodes are
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
+   the values of the
+   <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
+   attributes are equal (equality of the
+   <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
+   attribute is same as that for the <code>attributes</code> attribute).</p></li>
+   <li><p>If the nodes are
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
+   the values of the <a href="#declaredType"><code>declaredType</code></a> and
+   the <a href="#defaultType"><code>defaultType</code></a> attributes are
+   equal respectively.</p></li>
+   <li><p>If the nodes are
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>,
+   the values of the <code>DOMStringList</code> objects in the
+   <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
+   are equal, i.e. their <code>length</code> attribute values are equal and
+   each string exists in a list is contained in another list (their indeces
+   may be different), with an additional constraint that the number of the
+   items that are equal to a string in a list is equal to the number
+   of the items equal to the string in another list.</p></li>
+   </ul></dd>
+ <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and
+ <code id=lookupPrefix>lookupPrefix</code></dt>
+   <dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return
+   <code>null</code>.</p></dd>
+ <dt><code id=nodeName>nodeName</code></dt>
+   <dd>
+     <p>If the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
+     On getting, the attribute <em class=rfc2119>MUST</em> return the
+     name of the element type definition represented by the node.</p>
+     <p>If the node is an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
+     On getting, the attribute <em class=rfc2119>MUST</em> return the
+     name of the attribute definition represented by the node.</p>
+   </dd>
+ <dt><code id=nodeType>nodeType</code></dt>
+   <dd>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+     <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
+     (if the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
+     <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
+     (if the node is an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
+     <!-- NodeType -->
+ <p>Two constants are added to the <code id=NodeType>NodeType</code>
+ definition group of the <a href="#Node"><code>Node</code></a> interface as
+ following:</p>
+ <table>
+ <thead>
+ <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
+ <td><code>81001</code><td>The node is an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
+ <tr>
+ <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
+ <td><code>81002</code><td>The node is an
+ <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
+ </tbody>
+ </table>
+   </dd>
+ <dt><code id=nodeValue>nodeValue</code> and
+ <code id=textContent>textContent</code></dt>
+   <dd>
+     <p>If the node is an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
+     On getting, the attributes <em class=rfc2119>MUST</em> return
+     <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>
+   <p>If the node is an
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>:
+   The attribute <em class=rfc2119>MUST</em> behave as if the node
+   were <code>Attr</code> <span class=ed>[DOM3]</span>.</p></dd>
+ <dt><code id=normalize>normalize</code></dt>
+   <dd><p>When a <a href="#DocumentType"><code>DocumentType</code></a> is
+   normalized, any nodes in the <code>NamedNodeMap</code> object in the
+   <a href="#elementTypes"><code>elementTypes</code></a> attribute
+   <em class=rfc2119>MUST</em> be normalized as well.</p>
+   <p>When an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
+   is normalized, any nodes in the <code>NamedNodeMap</code> object in the
+   <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
+   attribute <em class=rfc2119>MUST</em> be normalized as well.</p></dd>
+ </dl>
+ </div>
+ <div class=section id=section-document>
+ <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
+ <!--
+ <p>If an attempt is made to adopt an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
+ the <code id=adoptNode>adoptNode</code> method <em class=rfc2119>MUST</em>
+ raise a <code>NOT_SUPPORTED_ERR</code> exception <span class=ed>@@
+ ref</span>.</p>
+ -->
+ <div class=ed>
+ <p>Future version of the specification is expected to define what should
+ be done if <code>adoptNode</code> or <code>importNode</code> method have to
+ adopt or import an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> or
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node.
+ In addition it might revise behavior of those methods for
+ <a href="#Entity"><code>Entity</code></a>,
+ <a href="#Notation"><code>Notation</code></a>, and/or
+ <a href="#DocumentType"><code>DocumentType</code></a> nodes.
+ Behavior of <code>normalizeDocument</code> method for these kinds of
+ nodes might also be defined in some day.</p>
+ </div>
- <p>In such an implementation, the <code>getFeature</code> method of a
- <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
- conceptually) same object implementing the
- <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
- the parameters are set to
- <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
- <code>3.0</code> 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>
  </div>
  <div class=section id=section-documentxdoctype>
- <h2>The <code>DocumentXDoctype</code> Interface</h2>
+ <h3>The <code>DocumentXDoctype</code> Interface</h3>
+ <p>The <a href="#Document"><code>Document</code></a> nodes
+ <em class=rfc2119>MUST</em> also implement the
+ <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface.</p>
+ <p>An instance of the
+ <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>
+ interface <em class=rfc2119>MUST</em> be able to be obtained by using
+ binding$B!>(Bspecific casting methods on an instance of the
+ <a href="#Document"><code>Document</code></a> interface (if such
+ casting methods are available) or by using the method <code>getFeature</code>
+ with parameter values
+ <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 (if the
+ <a href="#Document"><code>Document</code></a> node supports the
+ feature <code>Core</code> version <code>3.0</code>
+ <span class=ed>[DOM3]</span>).</p>
+ <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
+ <em class=rfc2119>MUST</em> be implemented as following:</p>
  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
+   DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
+     (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
+     raises (DOMException);
+   <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
+     (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
+     raises (DOMException);
+   <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
+     (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
+     raises (DOMException);
+   <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
+     (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
+     raises (DOMException);
+   <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
+     (in DOMString <a href="#createNotation-name"><var>name</var></a>)
+     raises (DOMException);
  }</code></pre>
- <pre class=ed>
+ <dl>
- * The [CODE(DOMi)@en[DocumentXDoctype]] Interface Specification
+ <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
+ method</dt>
+   <dd>
+     <p>This method creates a <code>DocumentType</code> node with the specified
+     name, belonging to the document.</p>
+     <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
+     parameter is the name of the document type.</p>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
+     return a <code>DocumentType</code> node with the following attributes:</p>
+     <dl>
+     <dt><code>attributes</code>, <code>parentNode</code></dt>
+       <dd><code>null</code>.</dd>
+     <dt><code>elementTypes</code>, <code>generalEntities</code>, and
+     <code>notations</code></dt>
+       <dd>Empty <code>NamedNodeMap</code> objects.</dd>
+     <dt><code>entities</code></dt>
+       <dd>The same value as the <code>generalEntities</code> attribute.</dd>
+     <dt><code>childNodes</code></dt>
+       <dd>An empty <code>NodeList</code> object.</dd>
+     <dt><code>internalSubset</code>, <code>publicId</code>, and
+     <code>systemId</code></dt>
+       <dd>Empty strings.</dd>
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
+       <dd><code>false</code>.</dd>
+     <dt><code>nodeName</code></dt>
+       <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
+     <dt><code>ownerDocument</code></dt>
+       <dd>The <code>Document</code> over which the method is invoked.</dd>
+     </dl>
+     <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
+     containing five general entity declarations: <code>amp</code>,
+     <code>lt</code>, <code>gt</code>, <code>quot</code>, and
+     <code>apos</code>.</p>
+   </dd>
+ <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
+ method</dt>
+   <dd>
+     <p>This method creates a <code>ElementTypeDefinition</code> node with the
+     specified name, belonging to the document.</p>
+     <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
+     parameter is the name of the element type defined by the element
+     type definition.</p>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
+     return an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+     node with the following attributes:</p>
+     <dl>
+     <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
+       <dd>An empty <code>NamedNodeMap</code> object.</dd>
+     <dt><code>attributes</code>, <code>parentNode</code></dt>
+       <dd><code>null</code>.</dd>
+     <dt><code>childNodes</code></dt>
+       <dd>An empty <code>NodeList</code> object.</dd>
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
+       <dd><code>false</code>.</dd>
+     <dt><code>nodeName</code></dt>
+       <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
+     <dt><code>ownerDocument</code></dt>
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
+     <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>
+       <dd><code>null</code>.</dd>
+     <dt class=ed>@@ Ensure all attributes are defined</dt>
+     </dl>
+   </dd>
+ <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
+ method</dt>
+   <dd>
+     <p>This method creates a <code>AttributeDefinition</code> node with the
+     specified name, belonging to the document.</p>
+     <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
+     parameter is the name of the attribute defined by the attribute
+     definition.</p>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
+     return an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+     node with the following attributes:</p>
+     <dl>
+     <dt><code>allowedTokens</code></dt>
+       <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>
+     <dt><code>childNodes</code></dt>
+       <dd>An empty <code>NodeList</code> object.</dd>
+     <dt><code>declaredType</code></dt>
+       <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
+     <dt><code>defaultType</code></dt>
+       <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
+       <dd><code>false</code>.</dd>
+     <dt><code>nodeName</code></dt>
+       <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
+     <dt><code>ownerDocument</code></dt>
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
+     <dt class=ed>@@ Ensure all attributes are defined</dt>
+     </dl>
+     <div class=ed>
+     <p>@@ Should we keep these statements?:
+ However, if the &lt;cfg::cfg|xml-id> configuration
+ parameter is set to <code>true</code> and the <var>name</var>
+ is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
+ attribute is set to <code>ID_ATTR</code>.
+ [CODE(DOMa)@en[[[defaultType]]]]?</p>
+     </div>
+   </dd>
+ <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
+ method</dt>
+   <dd>
+     <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
+     with the specified name, which represents a general entity, belonging to
+     the document.</p>
+     <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
+     parameter is the name of the general entity.</p>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
+     an <a href="#Entity"><code>Entity</code></a> node with the following
+     attributes:</p>
+     <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>
+     <dt><code>childNodes</code></dt>
+       <dd>An empty <code>NodeList</code> object.</dd>
+     <dt><code>manakaiDeclarationBaseURI</code>,
+     <code>manakaiEntityBaseURI</code>, and
+     <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
+       <dd>No explicit value is set.</dd>
+     <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
+     <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
+       <dd><code>false</code>.</dd>
+     <dt><code>nodeName</code></dt>
+       <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
+       <dd>
+         <div class="note memo">
+           <p>It is not an error for
+           <a href="#createGeneralEntity-name"><var>name</var></a> matching
+           to the name of one of predefined general parsed entities in
+           <abbr>XML</abbr> or <abbr>HTML</abbr>.  For example,
+           <a href="#createGeneralEntity-name"><var>name</var></a> might be
+           <code>amp</code>, resulting in an
+           <a href="#Entity"><code>Entity</code></a> node
+           with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
+         </div>
+       </dd>
+     <dt><code>ownerDocument</code></dt>
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
+     <dt><code>publicId</code>, and <code>systemId</code></dt>
+       <dd><code>null</code>.</dd>
+       <dd class=ed>@@ publicId and systemId should be empty string?</dd>
+     <dt class=ed>@@ Ensure all attributes are defined</dd>
+     </dl>
+   </dd>
+ <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
+ method</dt>
+   <dd>
+     <p>This method creates a <code>Notation</code> node with the
+     specified name, belonging to the document.</p>
+     <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
+     parameter is the name of the notation.</p>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
+     a <code>Notation</code> node with the following attributes:</p>
+     <dl>
+     <dt><code>attributes</code>,
+     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
+     and <code>parentNode</code></dt>
+       <dd><code>null</code>.</dd>
+     <dt><code>childNodes</code></dt>
+       <dd>An empty <code>NodeList</code> object.</dd>
+     <dt><code>manakaiDeclarationBaseURI</code></dt>
+       <dd>No explicit value is set.</dd>
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
+       <dd><code>false</code>.</dd>
+     <dt><code>nodeName</code></dt>
+       <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
+     <dt><code>ownerDocument</code></dt>
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
+     <dt><code>publicId</code> and <code>systemId</code></dt>
+       <dd><code>null</code>.</dd>
+       <dd class=ed>@@ publicId and systemId should be empty string?</dd>
+     <dt class=ed>@@ Ensure all attributes are defined</dt>
+     </dl>
+   </dd>
+ </dl>
- [1] [[manakai//DOM Extensions]] > New Interfaces >
+ <p>These methods <em class=rfc2119>MUST</em> raise an
- [[DOM XML Document Type Definition]] module >
+ <code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>
- The [CODE(DOMi)@en[[[DocumentXDoctype]]]] Interface
+ if <var>name</var> is <em>not</em> a legal <code>Name</code> according to
+ the <abbr>XML</abbr> version in use, as specified in the
- [2]
+ <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>
- @@ cast
+ <div class="note memo">
- ** Constructors
+ <p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
+ since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not
- [3] The
+ define it for <code>Document</code> methods.</p>
- [DFN@en[[CODE(DOMm)@en[[[createDocumentTypeDefinition]]]] method]]
- returns a [CODE(DOMi)@en[[[DocumentType]]]] node
- or raises a [CODE(DOMi)@en[[[DOMException]]]].
- It creates a [CODE(DOMi)@en[[[DocumentType]]]] node
- of the given name, belonging to the document.
- [3] The
- [DFN@en[[CODE(DOMm)@en[[[createElementTypeDefinition]]]] method]]
- returns an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
- or raises a [CODE(DOMi)@en[[[DOMException]]]].
- It creates an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
- of the given name, belonging to the document.
- [4] The
- [DFN@en[[CODE(DOMm)@en[[[createAttributeDefinition]]]] method]]
- returns an [CODE(DOMi)@en[[[AttributeDefinition]]]] node
- or raises a [CODE(DOMi)@en[[[DOMException]]]].
- It creates an [CODE(DOMi)@en[[[AttributeDefinition]]]] node
- of the given name, belonging to the document.
- [10] The
- [DFN@en[[CODE(DOMm)@en[[[createGeneralEntity]]]] method]]
- returns an [CODE(DOMi)@en[[[Entity]]]] node
- or raises a [CODE(DOMi)@en[[[DOMException]]]].
- It creates an [CODE(DOMi)@en[[[Entity]]]] node,
- which represents a general entity,
- of the given name, belonging to the document.
- [12] The
- [DFN@en[[CODE(DOMm)@en[[[createNotation]]]] method]]
- returns a [CODE(DOMi)@en[[[Notation]]]] node
- or raises a [CODE(DOMi)@en[[[DOMException]]]].
- It creates a [CODE(DOMi)@en[[[Notation]]]] node
- of the given name, belonging to the document.
- [5]
- These method take a parameter [CODE(DOMp)@en[[[name]]]],
- of type [CODE(DOMi)@en[[[DOMString]]]].  It is
- the document type name, element type name,
- or attribute name of the node to be created.
- [6]
- The [CODE(DOMm)@en[[[createDocumentTypeDefinition]]]]
- method [['''MUST''']] create a [CODE(DOMi)@en[[[DocumentType]]]]
- object with the following attribute values:
- - [CODE(DOMa)@en[[[attributes]]]],
- [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[elementTypes]]]],
- [CODE(DOMa)@en[[[generalEntities]]]],
- [CODE(DOMa)@en[[[notations]]]]: Empty
- [CODE(DOMi)@en[[[NamedNodeMap]]]]s.
- - [CODE(DOMa)@en[[[childNodes]]]]: An empty
- [CODE(DOMi)@en[[[NodeList]]]].
- - [CODE(DOMa)@en[[[entities]]]]: The same
- [CODE(DOMi)@en[[[NamedNodeMap]]]] as
- [CODE(DOMa)@en[[[generalEntities]]]].
- - [CODE(DOMa)@en[[[internalSubset]]]],
- [CODE(DOMa)@en[[[publicId]]]], [CODE(DOMa)@en[[[systemId]]]]:
- Empty strings.
- - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- - [CODE(DOMa)@en[[[ownerDocument]]]]: The
- [CODE(DOMi)@en[[[Document]]]] node on which the method
- is invoked.
- In addition, it [['''MUST''']] be marked as containing
- five general entity declarations for XML predefined
- entities, i.e. [CODE(XML)@en[[[amp]]]], [CODE(XML)@en[[[lt]]]],
- [CODE(XML)@en[[[gt]]]], [CODE(XML)@en[[[quot]]]], and
- [CODE(XML)@en[[[apos]]]].
- [8]
- The [CODE(DOMm)@en[[[createElementTypeDefinition]]]]
- method [['''MUST''']] create an
- [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- object with the following attribute values:
- - [CODE(DOMa)@en[[[attributeDefinitions]]]]:
- An empty [CODE(DOMi)@en[[[NamedNodeMap]]]].
- - [CODE(DOMa)@en[[[attributes]]]],
- [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[childNodes]]]]: An empty
- [CODE(DOMi)@en[[[NodeList]]]].
- - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- - [CODE(DOMa)@en[[[ownerDocument]]]]: The
- [CODE(DOMi)@en[[[Document]]]] node on which the method
- is invoked.
- - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
- [CODE(IDL)@en[[[null]]]].
- @@ Ensure all attributes are defined
- [9] The [CODE(DOMm)@en[[[createAttributeDefinition]]]]
- method [['''MUST''']] create an
- [CODE(DOMi)@en[[[AttributeDefinition]]]]
- object with the following attribute values:
- - [CODE(DOMa)@en[[[allowedTokens]]]]:
- An empty [CODE(DOMi)@en[[[DOMStringList]]]].
- - [CODE(DOMa)@en[[[attributes]]]],
- [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[childNodes]]]]: An empty
- [CODE(DOMi)@en[[[NodeList]]]].
- - [CODE(DOMa)@en[[[declaredType]]]]:
- [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
- - [CODE(DOMa)@en[[[defaultType]]]]:
- [CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]].
- - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- - [CODE(DOMa)@en[[[ownerDocument]]]]: The
- [CODE(DOMi)@en[[[Document]]]] node on which the method
- is invoked.
- - [CODE(DOMa)@en[[[ownerElementTypeDefinition]]]]:
- [CODE(IDL)@en[[[null]]]].
- @@ Ensure all attributes are defined
- @@ Should we keep these statements?:
- However, if the <cfg::cfg|xml-id> configuration
- parameter is set to <DOM::true> and the <P::name>
- is <XA::xml:id>, then the [CODE(DOMa)@en[[[declaredType]]]]
- attribute is set to
- <C::AttributeDefinition.ID_ATTR>.
- [CODE(DOMa)@en[[[defaultType]]]]?
- [11] The [CODE(DOMm)@en[[[createGeneralEntity]]]]
- method [['''MUST''']] create an [CODE(DOMi)@en[[[Entity]]]]
- node with the following attribute values:
- - [CODE(DOMa)@en[[[attributes]]]],
- [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[childNodes]]]]: An empty
- [CODE(DOMi)@en[[[NodeList]]]].
- - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
- No explicit value is set.
- - [CODE(DOMa)@en[[[manakaiEntityBaseURI]]]]:
- No explicit value is set.
- - [CODE(DOMa)@en[[[manakaiEntityURI]]]]:
- No explicit value is set.
- - [CODE(DOMa)@en[[[manakaiHasReplacementTree]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- - [CODE(DOMa)@en[[[notationName]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[ownerDocument]]]]: The
- [CODE(DOMi)@en[[[Document]]]] node on which the method
- is invoked.
- - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
- [CODE(IDL)@en[[[null]]]].
- - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].
- @@ Ensure all attributes are defined
- @@ publicId and systemId should be empty string?
- [13] The [CODE(DOMm)@en[[[createNotation]]]]
- method [['''MUST''']] create a [CODE(DOMi)@en[[[Notation]]]]
- node with the following attribute values:
- - [CODE(DOMa)@en[[[attributes]]]],
- [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[childNodes]]]]: An empty
- [CODE(DOMi)@en[[[NodeList]]]].
- - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
- No explicit value is set.
- - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
- [CODE(IDL)@en[[[false]]]].
- - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- - [CODE(DOMa)@en[[[ownerDocument]]]]: The
- [CODE(DOMi)@en[[[Document]]]] node on which the method
- is invoked.
- - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
- [CODE(IDL)@en[[[null]]]].
- - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
- - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].
- @@ Ensure all attributes are defined
- [7]
- These method [['''MUST''']] raise an
- [CODE(DOMi)@en[[[INVALID_CHARACTER_ERR]]]]
- [CODE(DOMi)@en[[[DOMException]]]]
- if the [CODE(DOMp)@en[[[name]]]] is not a legal
- name according to the XML version in use as
- specified in the [CODE(DOMa)@en[[[xmlVersion]]]]
- attribute of the [CODE(DOMi)@en[[[Document]]]] node.
- ;; Non-XML case is intentionally left unspecified for now
- since DOM3 does not define it.
- ;; [CODE(DOMp)@en[[[name]]]] does not have to
- be a namespace qualified name.
- ;; Note also that it is not an error for the
- [CODE(DOMp)@en[[[name]]]] parameter value
- to match to the name of one of predefined general
- parsed entities in XML or HTML.
- ;; If the [CODE(DOMa)@en[[[strictErrorChecking]]]] attribute
- is set to [CODE(IDL)@en[[[false]]]], then the implementation
- is not required to raise this exception.
- Otherwise, these method [['''MUST''']] return
+ <p><var>name</var> does not have to be a namespace qualified name.</p>
- the newly created node.
+ </div>
- </pre>
+ </div>
+ <div class=section id=section-documenttype>
+ <h3>Modifications to the <code id=DocumentType>DocumentType</code>
+ Interface</h3>
+ <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
+ <em class=rfc2119>MAY</em> contain zero or more
+ <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
+ nodes in the <code>NodeList</code> object contained in the
+ <code>childNodes</code> attribute of the
+ <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
+ <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
+ during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
+ document, the <code>NodeList</code> object in the <code>childNodes</code>
+ object <em class=rfc2119>MUST</em> contains the
+ <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
+ nodes representing the processing instructions in the document type
+ definition of the document processed <span class=ed>@@ ref</span> by
+ the <abbr>XML</abbr> processor.  If the
+ <a href="#DocumentType"><code>DocumentType</code></a> node is marked
+ as read$B!>(Bonly, then all the child nodes <em class=rfc2119>MUST</em>
+ also be marked as read$B!>(Bonly.</p>
+ <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is created
+ from a document type declaration information item <span class=ed>@@ ref</span>,
+ the <code>NodeList</code> object in the <code>childNodes</code> attribute
+ of the node <em class=rfc2119>MUST</em> contain the
+ <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
+ created from the processing instruction information items in the list in the
+ [children] property of the document type declaration item in the same
+ order.</p>
+ <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
+ a document type declaration information item, the list in the [children]
+ property <em class=rfc2119>MUST</em> contain the processng instruction
+ information items created from the
+ <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes
+ in the <code>NodeList</code> object in the <code>childNodes</code> attribute
+ of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
+ <p>The implementation of the
+ <a href="#DocumentType"><code>DocumentType</code></a> interface
+ <em class=rfc2119>MUST</em> be modified as following:</p>
+ <pre class=idl><code>// Modifications to the DocumentType interface
+   attribute DOMString <a href="#publicId">publicId</a>;
+   attribute DOMString <a href="#systemId">systemId</a>;
+   attribute DOMString <a href="#internalSubset">internalSubset</a>;
+ </code></pre>
+ <p>The <code id=publicId>publicId</code> attribute and the
+ <code id=systemId>systemId</code> attribute of
+ <a href="#DocumentType"><code>DocumentType</code></a>,
+ <a href="#Entity"><code>Entity</code></a>, and
+ <a href="#Notation"><code>Notation</code></a> interfaces are no longer
+ read$B!>(Bonly.</p>
+ <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+ <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+ exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
+ Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
+ associated to the attribute.  No normalization, relative reference resolution,
+ or lexical validation is performed. <span class=ed>@@ If the new
+ value is <code>null</code>, ...</span></p>
+ <div class="note memo">
+ <p>Setting an invalid identifier might make the node unserializable.
+ Setting a public identifier while leaveing system identifier unspecified
+ would also make the <a href="#DocumentType"><code>DocumentType</code></a>
+ or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
+ </div>
+ <div class=ed>
+ <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
+ </div>
+ <p>The <code id=internalSubset>internalSubset</code> attribute of the
+ <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
+ read$B!>(Bonly.</p>
+ <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+ <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+ exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
+ Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
+ associated to the attribute.  No normalization, or lexical validation is
+ performed. <span class=ed>@@ If the new value is <code>null</code>,
+ ...</span></p>
  </div>
  <div class=section id=section-documenttypedefinition>
- <h2>The <code>DocumentTypeDefinition</code> Interface</h2>
+ <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
- <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
+ <p>The <a href="#DocumentType"><code>DocumentType</code></a> nodes
+ <em class=rfc2119>MUST</em> also implement the
- }</code></pre>
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
+ interface.</p>
- <pre class=ed>
+ <p>An instance of the
- [1] In an implementation that supports the
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
- [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]
+ interface <em class=rfc2119>MUST</em> be able to be obtained by using
- feature, a [CODE(DOMi)@en[[[DocumentType]]]] node
+ binding$B!>(Bspecific casting methods on an instance of the
- must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
+ <a href="#DocumentType"><code>DocumentType</code></a> interface (if such
- interface.  See [[DOM XML Document Type Definition]>>3] for
+ casting methods are available) or by using the method <code>getFeature</code>
- details.
+ with parameter values
+ <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 (if the
- ** Children
+ <a href="#DocumentType"><code>DocumentType</code></a> node supports the
+ feature <code>Core</code> version <code>3.0</code>
- [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]
+ <span class=ed>[DOM3]</span>).</p>
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that
+ <div class="note memo">
- contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
+ <p>This interface is a separated interface from the
- node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
+ <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
- The attribute is read-only.
+ to the <a href="#DocumentType"><code>DocumentType</code></a>,
+ for the historical reason.</p>
- What are contained in this collection depends on how
- the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the
- node was created as the result of parsing of an XML document,
- it [['''MUST''']]  contain all element types whose element type and / or
- attribute definition list declaration are encountered by and provided for the DOM
- implementation from the XML processor.  Note that the XML processor might not
- provide a part of or entire such information depending on the configuration.
- If more than one declarations for an element type or an attribute is available
- at the time of the definition node construction, then declarations other than
- the first ones [['''MUST''']] be discarded.
- The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
+ <p class=ed>Should the interface be merged with
- object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes
+ <a href="#DocumentType"><code>DocumentType</code></a>?</p>
- belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object
+ </div>
- [['''MUST''']] be read-only if and only if the node is read-only.
- Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
- and therefore any change of read-only flag on the node is immediately
- reflected by that of the object.
- [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]
+ <p>The
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
- general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.
+ <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
- The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
+   readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
- The attribute is read-only.
+   readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
+   readonly attribute NamedNodeMap <a href="#notations">notations</a>;
+   <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
+     (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
+   <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
+     (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
+   <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
+     (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
+   void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
+     (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
+     raises (DOMException);
+   void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
+     (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
+     raises (DOMException);
+   void <a href="#setNotationNode">setNotationNode</a>
+     (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
+     raises (DOMException);
+ }</code></pre>
+ <dl>
+ <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
+ type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
+   <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
+   contains all the element type definitions belonging to the
+   <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   <code>NamedNodeMap</code> object that contains all the
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+   nodes belonging to the <code>DocumentType</code> node.  The
+   <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
+   if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
+   object <em class=rfc2119>MUST</em> be <a href="#live">live</a>.</p>
+   <p>If the <code>DocumentType</code> node is created during the process
+   to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
+   requirements are applied:  The <code>NamedNodeMap</code> object in the
+   <a href="#elementTypes"><code>elementType</code></a> attribute
+   <em class=rfc2119>MUST</em> be so transformed that the object contains
+   the <code>ElementTypeDefinition</code> nodes for the element types
+   whose name is presented as the <code>Name</code> of the element type or
+   attribute definition list declarations processed by the <abbr>XML</abbr>
+   processor.  If there are more than one element type declarations for an
+   element type, then the declarations other than the first one
+   <em class=rfc2119>MUST</em> be ignored for the purpose of constructing the
+   <code>NamedNodeMap</code> object.</p></dd>
+ <dt><dfn id=generalEntities class=dom-attr><code>generalEntities</code></dfn>
+ of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
+   <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
+   contains all the general entities belonging to the
+   <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   same value as the <code>entities</code> attribute (defined in the
+   <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
+   node.</p>
+   <div class="note memo">
+     <p>This attribute is part of the interface for historical reason.</p>
+   </div></dd>
+ <!--
  All entities declared in the document type definition
  contained in or referenced from the document entity
  might not be exposed through this collection, depending
-Line 472 
 representing general entities belong to
+Line 913 
 representing general entities belong to
  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
  and therefore any change of read-only flag on the node is immediately
  reflected by that of the object.
+ -->
- The attribute [['''MUST''']] return the same value as the
+ <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
- [CODE(DOMa)@en[[[entites]]]] attribute of the
+ <code>notations</code>, read$B!>(Bonly</code>
- [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.
+   <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
+   contains all the notations belonging to the
- [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]
+   <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
- of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
- is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
- all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
+   same value as the <code>notations</code> attribute (defined in the
- node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
+   <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
- The attribute is read-only.
+   node.</p>
+   <div class="note memo">
+     <p>This attribute is part of the interface for historical reason.</p>
+     <p>Implementations are not required to implement the
+     <code>notations</code> attribute twice (for
+     <a href="#DocumentType"><code>DocumentType</code></a> and
+     <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
+     interfaces); they share exactly same definition.</p>
+   </div></dd>
+ <!--
  If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
  created from an XML document, duplicate notation declarations, if any, in DTD
  [['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]
-Line 507 
 representing notations belong to the nod
+Line 957 
 representing notations belong to the nod
  the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
  and therefore any change of read-only flag on the node is immediately
  reflected by that of the object.
+ -->
+ <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>
+ <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>
+ <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
+ method</dt>
+   <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
+   with the specified name.</p>
+   <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>
+   parameter is the name of the general entity.</p>
+   <p>When invoked, the method <em class=rfc2119>MUST</em> return the
+   <a href="#Entity"><code>Entity</code></a> node,
+   whose <a href="#nodeName"><code>nodeName</code></a> is equal to
+   <a href="#getEntityNode-name"><var>name</var></a>, in the
+   <code>NamedNodeMap</code> object in the
+   <a href="#entities"><code>entities</code></a> attribute of the
+   node.  If there is no such node, it <em class=rfc2119>MUST</em> return
+   <code>null</code>.</p></dd>
+ <dt><dfn id=getNotationNode class=dom-method><code>getNotationNode</code></dfn>,
+ method</dt>
+   <dd><p>Returns the <a href="#Notation"><code>Notation>/code></a> node
+   with the specified name.</p>
+   <p>The
+   <dfn id=getNotationNode-name class=dom-param><var>name</var></dfn>
+   parameter is the name of the notation.</p>
+   <p>When invoked, the method <em class=rfc2119>MUST</em> return the
+   <a href="#Notation"><code>Notation</code></a> node,
+   whose <a href="#nodeName"><code>nodeName</code></a> is equal to
+   <a href="#getNotationNode-name"><var>name</var></a>, in the
+   <code>NamedNodeMap</code> object in the
+   <a href="#notations"><code>notations</code></a> attribute of the
+   node.  If there is no such node, it <em class=rfc2119>MUST</em> return
+   <code>null</code>.</p></dd>
+ <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,
+ method</dt>
+   <dd class=ed>@@</dd>
+ <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,
+ method</dt>
+   <dd class=ed>@@</dd>
+ <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,
+ method</dt>
+   <dd class=ed>@@</dd>
+ </dl>
- A DOM implementation is not required to implement the
+ <div class=ed>
- [CODE(DOMa)@en[[[notations]]]] attribute twice
+ <p>A future version of this interface might define the
- for the [CODE(DOMi)@en[[[DocumentType]]]] and
+ <code>parameterEntities</code> and getter/setter for parameter entities.
- the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;
+ </div>
- the latter is defined to contain the same value as the former.
- ** Open Issues (informative)
- [5] A future version of the interface might define the
- [CODE(DOMa)@en[[[parameterEntities]]]] attribute and
- getter/setter for parameter entities.
- </pre>
  </div>
  <div class=section id=section-elementtypedefinition>
- <h2>The <code>ElementTypeDefinition</code> Interface</h2>
+ <h3>The <code>ElementTypeDefinition</code> Interface</h3>
- <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {
+ <p>The nodes of type
+ <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
+ represents an element type definition.  Such a node
+ <em class=rfc2119>MUST</em> implement the
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ interface, which extends the <a href="#Node"><code>Node</code></a>
+ interface.</p>
+ <p>An element type definition represents a definition of the element type.
+ It is corresponding to the element type declaration in <abbr>DTD</abbr>.
+ However, an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
+ does not represent the element type definition in <abbr>DTD</abbr> itself.
+ Even if there are more than one element type declarations for an element type
+ in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ node for that element type.  In addition, if there are attribute definition
+ declarations for an element type, even when there is no element type
+ declaration for that element type, the <abbr>DOM</abbr> will contain an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ node for that element type.</p>
+ <p>An <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ node cannot be a child of any node.  An
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
+ cannot have any child node.</p>
+ <p>The <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
+ <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> : <a href="#Node">Node</a> {
+   readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
+   readonly attribute NamedNodeMap <a href="#attributeDefinitions">attributeDefinitions</a>;
+   <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
+     (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
+   void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
+     (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-name"><var>node</var></a>)
+     raises (DOMException);
  }</code></pre>
- <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
+ <dl>
+ <dt><dfn id=ownerDocumentTypeDefinition class=dom-attr><code>ownerDocumentTypeDefinition</code></dfn>
+ of type <a href="#DocumentType"><code>DocumentType</code></a>, read$B!>(Bonly</dt>
+   <dd><p>The
+   <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
+   attribute of
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
+   <a href="#Entity"><code>Entity</code></a>, and
+   <a href="#Notation"><code>Notation</code></a> interface contains the
+   <a href="#DocumentType"><code>DocumentType</code></a> node to which the node
+   is attached.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return a
+   <a href="#DocumentType"><code>DocumentType</code></a> node.  It
+   <em class=rfc2119>MUST</em> be such a node that whose
+   <a href="#elementTypes"><code>elementTypes</code></a> (for an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+   node), <a href="#entities"><code>entities</code></a> (for an
+   <a href="#Entity"><code>Entity</code></a> node), or
+   <a href="#notations"><code>notations</code></a> (for a
+   <a href="#Notation"><code>Notation</code></a> node) attribute contains the
+   <code>NamedNodeMap</code> object that contains the node.  If there is no such
+   a <a href="#DocumentType"><code>DocumentType</code></a> node,
+   then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
+ <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>
+ of type NamedNodeMap, read$B!>(Bonly</dt>
+   <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
+   contains all the attribute definitions belonging to the
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
+   node.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   <code>NamedNodeMap</code> object that contains all the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+   belonging to the
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
+   The <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
+   read$B!>(Bonly if and only if the node is read$B!>(Bonly.  The
+   <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be
+   <a href="#live">live</a>.</p>
+   <p>If the
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node
+   is created during the process to create a <abbr>DOM</abbr> from an
+   <abbr>XML</abbr> document, the following requirements are applied:  The
+   <code>NamedNodeMap</code> object in the
+   <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
+   attribute <em class=rfc2119>MUST</em> be so transformed that the object
+   contains the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+   corresponding to the attribute definitions in the attribute definition
+   list declarations processed by the <abbr>XML</abbr> processor and
+   associated to the element type represented by the node.  If there are more
+   than one attribute definitions for an attribute, then the definitions other
+   than the first one <em class=rfc2119>MUST</em> be ignored for the purpose
+   of constructing the <code>NamedNodeMap</code> object.</p></dd>
+ <dt><dfn id=getAttributeDefinitionNode class=dom-method><code>getAttributeDefinitionNode</code></dfn>,
+ method</dt>
+   <dd><p>Return the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+   with the specified name.</p>
+   <p>The
+   <dfn id=getAttributeDefinitionNode-name class=dom-param><var>name</var></dfn>
+   parameter is the name of the attribute.</p>
+   <p>When invoked, the method <em class=rfc2119>MUST</em> return the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node,
+   whose <a href="#nodeName"><code>nodeName</code></a> attribute value is
+   equal to <a href="#getAttributeDefinitionNode-name"><var>name</var></a>,
+   in the <code>NamedNodeMap</code> in the
+   <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
+   attribute of the node.  If there is no such node, it
+   <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
+ <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
+ method</dt>
+   <dd class=ed>@@</dd>
+ </dl>
- [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
+ <div class=ed>
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
+ <p>A future version of the specification might define a set of attributes
- [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
+ and methods for representing and accessing to the content model of the
+ element type.</p>
- [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
+ </div>
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
- [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
- of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
- [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.
- Note that it might be [CODE(IDL)@en[[[null]]]].
- [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
- [['''MUST''']] return the name of the element type.
- [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]
- and [CODE(DOMa)@en[[[textContent]]]] attributes
- of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
- ;; Thus, the setter of these attributes do nothing.
- The setter of the [CODE(DOMa)@en[[[textContent]]]]
- attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- object [['''MUST NOT''']] throw a
- [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
- ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface
- [5] The
- [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
- of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
- interface is defined in [[manakai//DOM Extensions]>>50].</pre>
  </div>
  <div class=section id=section-attributedefinition>
- <h2>The <code>AttributeDefinition</code> Interface</h2>
+ <h3>The <code>AttributeDefinition</code> Interface</h3>
- <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {
+ <p>The nodes of type
+ <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
+ represents an attribute definition.  Such a node
+ <em class=rfc2119>MUST</em> implement the
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> interface,
+ which extends the <a href="#Node"><code>Node</code></a> interface.</p>
+ <p>An attribute definition represents a definition of the attribute
+ associated to an element type.  It is corresponding to the attribute definition
+ in the attribute list declaration in <abbr>DTD</abbr>.  However, an
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node does
+ not represent the attribute definition in <abbr>DTD</abbr> itself.  Even if
+ there are more than one attribute definitions for an attribute of an element
+ type in <abbr>DTD</abbr>, the result <abbr>DOM</abbr> will contain only an
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node for
+ that attribute.</p>
+ <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+ node cannot be a child of any node.  An
+ <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+ can have zero or more child nodes of same kinds as those allowed for
+ <code>Attr</code> nodes <span class=ed>[DOM3]</span>.</p>
+ <p>The <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
+ <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> : <a href="#Node">Node</a> {
+   <span class=comment>// <a href="#DeclaredValueType">DeclaredValueType</a></span>
+   const unsigned short <a href="#NO_TYPE_ATTR">NO_TYPE_ATTR</a> = 0;
+   const unsigned short <a href="#CDATA_ATTR">CDATA_ATTR</a> = 1;
+   const unsigned short <a href="#ID_ATTR">ID_ATTR</a> = 2;
+   const unsigned short <a href="#IDREF_ATTR">IDREF_ATTR</a> = 3;
+   const unsigned short <a href="#IDREFS_ATTR">IDREFS_ATTR</a> = 4;
+   const unsigned short <a href="#ENTITY_ATTR">ENTITY_ATTR</a> = 5;
+   const unsigned short <a href="#ENTITIES_ATTR">ENTITIES_ATTR</a> = 6;
+   const unsigned short <a href="#NMTOKEN_ATTR">NMTOKEN_ATTR</a> = 7;
+   const unsigned short <a href="#NMTOKENS_ATTR">NMTOKENS_ATTR</a> = 8;
+   const unsigned short <a href="#NOTATION_ATTR">NOTATION_ATTR</a> = 9;
+   const unsigned short <a href="#ENUMERATION_ATTR">ENUMERATION_ATTR</a> = 10;
+   const unsigned short <a href="#UNKNOWN_ATTR">UNKNOWN_ATTR</a> = 11;
+   <span class=comment>// <a href="#DefaultValueType">DefaultValueType</a></span>
+   const unsigned short <a href="#UNKNOWN_DEFAULT">UNKNOWN_DEFAULT</a> = 0;
+   const unsigned short <a href="#FIXED_DEFAULT">FIXED_DEFAULT</a> = 1;
+   const unsigned short <a href="#REQUIRED_DEFAULT">REQUIRED_DEFAULT</a> = 2;
+   const unsigned short <a href="#IMPLIED_DEFAULT">IMPLIED_DEFAULT</a> = 3;
+   const unsigned short <a href="#EXPLICIT_DEFAULT">EXPLICIT_DEFAULT</a> = 4;
- }</code></pre>
+   readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
- <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
+   readonly attribute unsigned short <a href="#declaredType">declaredType</a>;
+   readonly attribute DOMStringList <a href="#allowedTokens">allowedTokens</a>;
+   readonly attribute unsigned short <a href="#defaultType">defaultType</a>;
+ }</code></pre>
- [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
+ <dl>
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+ <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
- [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
+ of type
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
- [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
+ read$B!>(Bonly</dt>
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+   <dd><p>The
- [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
- of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
+   which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
- [CODE(DOMi)@en[[[AttributeDefinition]]]] object.
+   node belongs.</p>
- Note that it might be [CODE(IDL)@en[[[null]]]].
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
- [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+   It <em class=rfc2119>MUST</em> be such a node that whose
- [['''MUST''']] return the name of the attribute.
+   <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
+   attribute contains the <code>NamedNodeMap</code> object that contains
- [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
+   the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+   node.  If there is no such an
- [['''MUST''']] return the normalized default value
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
- of the attribute.
+   then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p>
+ <dt><dfn id=declaredType class=dom-attr><code>declaredType</code></dfn> of type
- @@
+ <code>unsigned short</code></dt>
+   <dd><p>The declared type <span class=ed>@@ ref</span> of the attribute.
- [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
+   It is expected that this attribute contains a value from the definition group
- attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
+   <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>.</p>
- object [['''MUST''']] behave as if it were an
- [CODE(DOMi)@en[[[Attr]]]] object.
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   value associated to this attribute.</p>
- The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
+   <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
- [['''MUST''']] behave as if the following algorithm
+   <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
- is performed:
+   exception if the
- = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
- object is read-only, then throw an
+   is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
- [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
+   <em class=rfc2119>MUST</em> set the specified value as the value
- = Remove any child node the node has.
+   associated to this attribute.</p>
- = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
- then create a [CODE(DOMi)@en[[[Text]]]] node
+   <p>If the <code>AttributeDefinition</code> node is created during the process
- whose [CODE(DOMa)@en[[[data]]]] is the new value
+   to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, an
- and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
+   appropriate value from the
+   <a href="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
- ** Definition groups
+   group <em class=rfc2119>MUST</em> be set to the attribute.</p>
- [6] The
+   <!-- DeclaredValueType -->
- [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]
+ <p>The definition group
- contains integers indicating the type of
+ <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
- attribute value:
+ integers indicating the declared type of attributes.  The definition
- ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.
+ group contains the following constants:</p>
- ,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].
- ,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].
+ <table>
- ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].
+ <thead>
- ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].
+ <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
- ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].
+ </thead>
- ,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].
+ <tbody>
- ,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].
+ <tr>
- ,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].
+ <th scope=row><dfn id=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
- ,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].
+ <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
- ,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.
+ <tr>
- ,[CODE(DOMc)@en[[[UNKNOWN_ATTR]]]],[CODE(IDL)[[[11]]]],"The attribute value type is unknown, because no declaration for the attribute has been read but not [CODE(InfoProp)@en[[[all declarations processed]]]] property would be false."
+ <th scope=row><dfn id=CDATA_ATTR class=dom-const><code>CDATA_ATTR</code>
+ <td><code>1</code><td><code>CDATA</code> <span class=ed>[XML]</span>.</tr>
- The type of these constants are
+ <tr>
- [CODE(IDL)@en[[[unsigned]] [[short]]]].
+ <th scope=row><dfn id=ID_ATTR class=dom-const><code>ID_ATTR</code>
+ <td><code>2</code><td><code>ID</code> <span class=ed>[XML]</span>.</tr>
- If no attribute type information is provided,
+ <tr>
- or if the source of that information does not
+ <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
- distinguish [[no value]] and [[unknown]] as in
+ <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
- XML Information Set, then the
+ <tr>
- [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value
+ <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
- [['''MUST''']] be used.
+ <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
- ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
+ <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
- object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
+ <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
- method has [CODE(DOMa)@en[[[declaredType]]]] attribute
+ <tr>
- set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
+ <th scope=row><dfn id=ENTITIES_ATTR class=dom-const><code>ENTITIES_ATTR</code>
+ <td><code>6</code><td><code>ENTITIES</code> <span class=ed>[XML]</span>.</tr>
- If the source of the attribute type information
+ <tr>
- does not distinguish [[no value]] and / or [[unknown]]
+ <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
- and [CODE(XML)@en[[[CDATA]]]], then the
+ <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
- [CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]
+ <tr>
- be used.
+ <th scope=row><dfn id=NMTOKENS_ATTR class=dom-const><code>NMTOKENS_ATTR</code>
+ <td><code>8</code><td><code>NMTOKENS</code> <span class=ed>[XML]</span>.</tr>
- [11]
+ <tr>
- In Perl binding, the objects implementing the
+ <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
- [CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]
+ <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
- also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]
+ <tr>
- constant group.
+ <th scope=row><dfn id=ENUMERATION_ATTR class=dom-const><code>ENUMERATION_ATTR</code>
+ <td><code>10</code><td>Enumeration <span class=ed>[XML]</span>.</tr>
- [7] The
+ <tr>
- [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]
+ <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
- contains integers indicating the type of
+ <td><code>11</code><td>Unknown, because no declaration for the attribute
- default attribute value:
+ has been read but the [all declaration processed] property
- ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.
+ <span class=ed>[INFOSET]</span> would be false.</tr>
- ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.
+ </tbody>
- ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.
+ </table>
- ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].
- ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.
+ <p>If no attribute type information is available, or if the source
+ of the information does not distinguish <q>no value</q> and <q>unknown</q>
- The type of these constants are
+ <span class=ed>[INFOSET]</span>, then the value
- [CODE(IDL)@en[[[unsigned]] [[short]]]].
+ <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
+ <em class=rfc2119>MUST</em> be used.</p>
- If the source of the attribute default value type
- does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]
+ <div class="note memo">
- default and unknown default, then the
+ <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
- [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value
+ created by the
- [['''MUST''']] be used.
+ <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
+ method has its <a href="#declaredType"><code>declaredType</code></a> attribute
- ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
+ set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
- object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
- method has [CODE(DOMa)@en[[[declaredType]]]] attribute
- set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
- ** Tree-relationship Attributes
- [10]
- The
- [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]
- of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface
- is read-only and of type
- [CODE(DOMi)@en[[[ElementTypeDefinition]]]].
- It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
- which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
- belong to.
- If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
- is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]
- list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,
- then the attribute [['''MUST''']] return the
- [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.
- Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].
- ;; This attribute is analogue to the
- [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute
- for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],
- [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]
- nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]
- attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.
- ** Attributes
- [5]
- The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- represents the type of the attribute value.
- This attribute is read-write.
- The type of the attribute is
- [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected
- that this attribute has a value from the definition group
- [CODE(DOM)@en[[[DeclaredValueType]]]].
- The getter [['''MUST''']] return a value associated
- to this attribute.
- The setter [['''MUST''']]
- throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
- [CODE(DOMi)@en[[[DOMException]]]] if the
- [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
- Otherwise, the setter [['''MUST''']] set the specified
- value as the value associated to this attribute.
- If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
- object, then it [['''MUST''']] set a value
- from the [CODE(DOM)@en[[[DeclaredValueType]]]]
- definition group.
- [8]
- The [DFN@en[[CODE(DOMa)@en[[[defaultType]]]] attribute]]
- of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
- represents the type of the attribute default value.
- This attribute is read-write.
- The type of the attribute is
- [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected
- that this attribute has a value from the definition group
- [CODE(DOM)@en[[[DefaultValueType]]]].
- The getter [['''MUST''']] return a value associated
- to this attribute.
- The setter [['''MUST''']]
- throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
- [CODE(DOMi)@en[[[DOMException]]]] if the
- [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
- Otherwise, the setter [['''MUST''']] set the specified
- value as the value associated to this attribute.
- If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
- object, then it [['''MUST''']] set a value
- from the [CODE(DOM)@en[[[DefaultValueType]]]]
- definition group.</pre>
  </div>
+ <p>If the source of the information does not distinguish <q>no value</q>
+ and/or <q>unknown</q> <span class=ed>[INFOSET]</span> and
+ <code>CDATA</code> <span class=ed>[XML]</span>, then the value
+ <a href="#CDATA_ATTR"><code>CDATA_ATTR</code></a> <em class=rfc2119>MUST</em>
+ be used.</p>
+ <p>In Perl binding <span class=ed>[PERLBINDING]</span>, the
+ <code>Attr</code> nodes <em class=rfc2119>MUST</em> implement the
+ <a href="#DeclaredValueType"><code>DeclaredValueType</code></a>
+ definition group.</p>
+   </dd>
+ <dt><dfn id=allowedTokens class=dom-attr><code>allowedTokens</code></dfn> of
+ type <code>DOMStringList</code>, read$B!>(Bonly</dt>
+   <dd><p>The list of allowed attribute values.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   <code>DOMStringList</code> object associated to this attribute.  The object
+   <em class=rfc2119>MAY</em> contain zero or more ordered strings, consist of
+   zero or more characters respectively, possibly with duplications.  The
+   object <em class=rfc2119>MUST</em> be read$B!>(Bonly if and only if the node
+   is read$B!>(Bonly.</p>
+   <p>If the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node is created during the process to create a <abbr>DOM</abbr> from an
+   <abbr>XML</abbr> document, the object <em class=rfc2119>MUST</em> contain
+   the names or name tokens allowed for the attribute defined by the node.
+   If the document is well$B!>(Bformed, the object will be empty unless
+   the <a href="#declaredType"><code>declaredType</code></a> is
+   <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
+   <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>.</p>
+   <p>If the <a href="#declaredType"><code>declaredType</code></a> is different
+   from <a href="#ENUMERATION_ATTR"><code>ENUMERATION_ATTR</code></a> or
+   <a href="#NOTATION_ATTR"><code>NOTATION_ATTR</code></a>, this attribute
+   <em class=rfc2119>MUST</em> be ignored for the purpose of serializing
+   into (part of) <abbr>XML</abbr> document.</p>
+   <div class="note memo">
+     <p>When serializing the node it should be noted that the object might
+     be empty, might contain duplications, and might contain strings that are
+     not names or name tokens.</p>
+   </div></dd>
+ <dt><dfn id=defaultType class=dom-attr><code>defaultType</code></dfn> of
+ type <code>unsigned short</code></dt>
+   <dd><p>The type of the default for the attribute.  It is expected that this
+   attribute contains a value from the definition group
+   <a href="#DefaultValueType"><code>DefaultValueType</code></a>.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+   the value associated to this attribute.</p>
+   <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+   <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+   exception if the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
+   is read$B!>(Bonly <span class=ed>@@ ref</span>.  Otherwise, it
+   <em class=rfc2119>MUST</em> set the specified value as the value
+   associated to this attribute.</p>
+   <p>If the
+   <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node is
+   created during the process to create a <abbr>DOM</abbr> from an
+   <abbr>XML</abbr> document, an appropriate value from the
+   <a href="#DefaultValueType"><code>DefaultValueType</code></a> definition
+   group <em class=rfc2119>MUST</em> be set to the attribute.</p>
+   <!-- DefaultValueType -->
+   <p>The definition group
+   <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
+   contains integers indicating the type of the default for the attribute.
+   The definition group contains the following constans:</p>
+   <table>
+   <thead>
+   <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
+   </thead>
+   <tbody>
+   <tr>
+   <th scope=row><dfn id=UNKNOWN_DEFAULT class=dom-const><code>UNKNOWN_DEFAULT</code></dfn>
+   <td><code>0</code><td>Unknown.</tr>
+   <tr>
+   <th scope=row><dfn id=FIXED_DEFAULT class=dom-const><code>FIXED_DEFAULT</code></dfn>
+   <td><code>1</code><td>Provided explicitly and fixed
+   <span class=ed>@@ ref</span> to that value.</tr>
+   <tr>
+   <th scope=row><dfn id=REQUIRED_DEFAULT class=dom-const><code>REQUIRED_DEFAULT</code></dfn>
+   <td><code>2</code><td>No default value and the attribute have to be
+   explicitly specified.</tr>
+   <tr>
+   <th scope=row><dfn id=IMPLIED_DEFAULT class=dom-const><code>IMPLIED_DEFAULT</code></dfn>
+   <td><code>3</code><td>Implied <span class=ed>@@ ref</span>.</tr>
+   <tr>
+   <th scope=row><dfn id=EXPLICIT_DEFAULT class=dom-const><code>EXPLICIT_DEFAULT</code></dfn>
+   <td><code>4</code><td>Provided explicitly.</tr>
+   </tbody>
+   </table>
+   <p>If the source of the default type does not distinguish
+   implied and unknown default types, then the value
+   <a href="#IMPLIED_DEFAULT"><code>IMPLIED_DEFAULT</code></a>
+   <em class=rfc2119>MUST</em> be used.</p>
+   <div class="note memo">
+   <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node created by the
+   <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
+   method has its <a href="#defaultType"><code>defaultType</code></a>
+   attribute set to
+   <a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</p>
+   </div></dd>
+ </dl>
  </div>
+ <div class=section id=section-entity>
+ <h3>Modifications to the <code id=Entity>Entity</code> Interface</h3>
+ <p>The implementation of the <a href="#Entity"><code>Entity</code></a>
+ interface <em class=rfc2119>MUST</em> be modified as following:</p>
+ <pre class=idl><code>// Modifications to the Entity interface
+   attribute DOMString <a href="#publicId">publicId</a>;
+   attribute DOMString <a href="#systemId">systemId</a>;
+   attribute DOMString <a href="#notationName">notationName</a>;
+   // Additions to the Entity interface
+   attribute DOMString <a href="#hasReplacementTree">hasReplacementTree</a>;
+   readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
+   attribute boolean <a href="#isExternallyDeclared">isExternallyDeclared</a>;
+ </code></pre>
+ <p>The <code id=notationName>notationName</code> attribute of the
+ <a href="#Entity"><code>Entity</code></a> interface is no longer
+ read$B!>(Bonly.</p>
+ <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+ <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+ exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
+ Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the value
+ associated to the attribute.  No lexical validation is performed.  The new
+ value <em class=rfc2119>MAY</em> be <code>null</code>.</p>
+ <dl>
+ <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
+ of type boolean</dt>
+   <dd><p>Whether the structure of the replacement text of the entity
+   is available via the <code>NodeList</code> object in the
+   <code>childNodes</code> attribute of the entity.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+   the value associated to this attribute.</p>
+   <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+   <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+   exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
+   Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the
+   value associated to this attribute.</p>
+   <div class="note memo">
+   <p>The attribute can be set to <code>false</code> even if the
+   <a href="#Entity"><code>Entity</code></a> node has any child node.
+   If the attribute is set to <code>false</code>, then any child node of
+   the <a href="#Entity"><code>Entity</code></a> node ought to be ignored,
+   say, for the purpose of serialization.</p>
+   </div>
+   <p>When an <code>EntityReference</code> node is created by cloning
+   the replacement subtree of the <a href="#Entity"><code>Entity</code></a>
+   node, if the attribute is set to <code>false</code>, then any descendant
+   of the node <em class=rfc2119>MUST</em> be ignored.</p>
+   <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
+   the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
+   the following requirements are applied:  If the entity is an unparsed
+   entity, then the attribute <em class=rfc2119>MUST</em> be set to
+   <code>false</code>.  Otherwise, if the entity is an external entity whose
+   replacement text is not available, or whose replacement text is not converted
+   to a replacement tree, then the attribute <em class=rfc2119>MUST</em> be set
+   to <code>false</code>.  Otherwise, the attribute
+   <em class=rfc2119>MUST</em> be set to <code>true</code>.</p>
+   <div class="note memo">
+   <p>An <a href="#Entity"><code>Entity</code></a> node created by the
+   <a href="#createGeneralEntity"><code>createGeneralEntity</code></a> method
+   has its <a href="#hasReplacementTree"><code>hasReplacementTree</code></a>
+   attribute set to <code>false</code>.</p>
+   </div></dd>
+ <dt><dfn id=isExternallyDeclared class=dom-attr><code>isExternallyDeclared</code></dfn>
+ of type boolean</dt>
+   <dd><p>Whether the entity is declared by an external entity declaration or
+   not.  If the value is <code>true</code>, the entity is declared in an entity
+   declaration in the external subset entity or in an external parameter entity.
+   If the value is <code>false</code>, the entity is declared in an entity
+   declaration in the internal subset, or the node is created in memory.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return
+   the value associated to this attribute.</p>
+   <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
+   <code>NO_MODIFICATION_ALLOWED_ERR</code> <span class=ed>@@ ref</span>
+   exception if the node is read$B!>(Bonly <span class=ed>@@ ref</span>.
+   Otherwise, it <em class=rfc2119>MUST</em> set the specified value as the
+   value associated to this attribute.</p>
+   <p>If the <a href="#Entity"><code>Entity</code></a> node is created during
+   the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document,
+   the following requirements are applied:  If the entity is an unparsed
+   entity, then the attribute <em class=rfc2119>MUST</em> be set to
+   <code>false</code>.  Otherwise, i.e. the entity is a parsed entity, then the
+   attribute <em class=rfc2119>MUST</em> be set to the value of whether the
+   entity is declared by an external markup declaration or not.</p></dd>
+ </dl>
+ </div>
+ <div class=section id=section-notation>
+ <h3>Modifications to the <code id=Notation>Notation</code> Interface</h3>
+ <p>The implementation of the <a href="#Notation"><code>Notation</code></a>
+ interface <em class=rfc2119>MUST</em> be modified as following:</p>
+ <pre class=idl><code>// Modifications to the Notation interface
+   attribute DOMString <a href="#publicId">publicId</a>;
+   attribute DOMString <a href="#systemId">systemId</a>;
+   // Addition to the Notation interface
+   readonly attribute <a href="#DocumentType">DocumentType</a> <a href="#ownerDocumentTypeDefinition">ownerDocumentTypeDefinition</a>;
+ </code></pre>
+ </div>
+ </div>
  <div id="references" class="section reference">
  <h2>References</h2>

 Legend:



Removed from v.1.4
 


changed lines


 
Added in v.1.22
 Legend:



Removed from v.1.4
 


changed lines


 
Added in v.1.22
-Removed from v.1.4
+Added in v.1.22

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24