/[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.1 by wakaba,
Sun Dec  2 04:19:12 2007 UTC
+revision 1.21 by wakaba,
Sat Dec  8 07:01:08 2007 UTC
 Line 1
  <!DOCTYPE html>
  <html lang="en" class="formal-specification status-work-in-progress">
  <head>
- <title>manakai's XML Conformance Checking</title>
+ <title>DOM Document Type Definition Module</title>
  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">
+ <link rel="stylesheet" href="http://suika.fam.cx/www/style/def/dom">
  <link rel="license" href="http://suika.fam.cx/c/gnu/fdl">
- <style>
-   a[id]::before {
-     content: "[" attr(id) "]";
-     color: gray;
-     font-size: 70%;
-     font-family: Courier New, monospace;
-     vertical-align: 60%;
-   }
- </style>
  </head>
  <body class="has-abstract">
  <div class="header">
- <h1>manakai's <abbr>XML</abbr> Conformance Checking</h1>
+ <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>
-   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work"
+   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
-       >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work</a>&gt;</code></dd>
+       >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
  <dt>Latest Version</dt>
-   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc"
+   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef"
-       >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc</a>&gt;</code></dd>
+       >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef</a>&gt;</code></dd>
  <dt>Latest Working Draft</dt>
-   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work"
+   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
-       >http://suika.fam.cx/www/markup/xml/xmlcc/xmlcc-work</a>&gt;</code></dd>
+       >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
  <!-- <dt>Previous Version</dt> -->
  <dt>Version History</dt>
-   <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/xml/xmlcc/xmlcc-work.en.html">http://suika.fam.cx/gate/cvs/markup/xml/xmlcc/xmlcc-work.en.html</a>&gt;</code></dd>
+   <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/xml/domdtdef/domdtdef-work.en.html">http://suika.fam.cx/gate/cvs/markup/xml/domdtdef/domdtdef-work.en.html</a>&gt;</code></dd>
- </dl>
+ <dt id=author>Author</dt>
- <dl class="authors" id="author">
- <dt>Author</dt>
    <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"
        lang=ja>Wakaba</a>
    <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"
-Line 72 
 at the time of its publication.  Other d
+Line 62 
 at the time of its publication.  Other d
  might supersede this document.</em></p>
  <p>This document is a working draft, produced as part of the
- <a href="http://suika.fam.cx/www/markup/html/whatpm/readme">Whatpm</a>
- subproject of the
  <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>
  project.  It might be updated, replaced, or obsoleted by
  other documents at any time.  It is inappropriate to
-Line 92 
 normative version.</p>
+Line 80 
 normative version.</p>
  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
- <div class="issue ed">...</div>
+ <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,
+ over which <abbr>DOM</abbr> applications are able to access to the
+ definitions of the document type.</p>
+ <p>Interfaces defined in this specification are partially modeled from
+ early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>,
+ <abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and
+ <abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with
+ any of them as a whole.</p>
  </div>
  <div class="section" id="terminology">
-Line 118 
 else in this specification is normative.
+Line 120 
 else in this specification is normative.
  <p><span class=ed>Algorithm is normative but non-normative</span>.
  In addition, the order in which <a href="#errors">errors</a> are
  raised is undefined.</p>
- </div>
+ <p class=ed><var>A</var> object is an object implementing <var>A</var>
+ interface.</p>
- <div class=section id=error-categories>
+ <p class=ed>@@ ref to DOM Binding Spec</p>
- <h2>Error Classification</h2>
- <p class=ed>If a <code>Document</code> node has no
+ <p>If the <code>strictErrorChecking</code> attribute of the
- xml-well-formedness-error, entity-error, and unknown-error,
+ <code>Document</code> node is <code>false</code>, the methods are
- then it is well-formed.  If a well-formed <code>Document</code>
+ not required to raise exceptions <span class=ed>[DOM3]</span>.</p>
- node has no xml-validity-error, it is valid.</p>
+ <div class=ed>
+ <p>Conformant product classes: implementation, XML parser (XML document ->
+ DOM converter), XML serializer (DOM -> XML document covnerter).
+ XML Infoset -> DOM converter, and DOM -> XML Infoset converter.</p>
+ </div>
+ </div>
- <div class="note memo">
+ <div class=section id=dom-dtdef>
- <p>A well$B!>(Bformed <code>Document</code> can be safely serialized
+ <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
- into a well$B!>(Bformed XML document.  A valid <code>Document</code>
- can be easily serialized into a valid XML document.</p>
+ <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
+ introduces four interfaces:
+ <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a>,
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>,
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
+ and <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>.
+ In addition, it modifies existing interfaces
+ <a href="#Node"><code>Node</code></a>,
+ <a href="#Document"><code>Document</code></a>,
+ <a href="#DocumentType"><code>DocumentType</code></a>,
+ <a href="#Entity"><code>Entity</code></a>, and
+ <a href="#Notation"><code>Notation</code></a>.</p>
+ <div class=section id=features>
+ <h3>Feature Name</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
+ <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.</p>
+ <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
+ <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>
+ and <a href="#feature-XDoctype-3.0"><code>3.0</code></a> respectively.
+ Likewise, any method that takes one or more feature names with or without
+ version number, including the methods <code>hasFeature</code> and
+ <code>getFeature</code>, <em class=rfc2119>MUST</em> behave in a manner
+ consistent with the aforementioned cases.</p>
  </div>
- <p class=ed>To be a conforming <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-validating">validating XML processor</a>,
+ <div class=section id=section-node>
- ...</p>
+ <h3>Modifications to the <code id=Node>Node</code> Interface</h3>
- <p>Errors are classified into these
+ <p>The implementation of the
- <dfn id=error-category title="error category">error categories</dfn>:</p>
+ <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 id=errors>
+ <dl>
- <dt><dfn id=entity-error><code>entity-error</code></dfn></dt>
+ <dt><code id=attributes>attributes</code></dt>
    <dd>
-     <p class=ed>@@</p>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
-     <div class="note memo">
+     <code>null</code>.</p>
-       <p>This <span class=ed>algorithm</span> does not support
-       <abbr>DOM</abbr> tree with one or more <code>EntityReference</code>
-       nodes.  It is expected that any entity references are expanded
-       at the parse time and any unexpandable entity references
-       make parse time errors raised so that never result in
-       <abbr>DOM</abbr> tree with <code>EntityReference</code> nodes.</p>
-     </div>
    </dd>
- <dt><dfn id=round-trip-error><code>round-trip-error</code></dfn></dt>
+ <dt><code id=baseURI>baseURI</code></dt>
-   <dd class=ed>@@</dd>
- <dt><dfn id=round-trip-warning><code>round-trip-warning</code></dfn></dt>
    <dd>
-     <p>A <a href="#round-trip-warning"><code>round-trip-warning</code></a>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
-     will be raised when a construct, which might not be restored to the same
+     value of the <a href="#baseURI"><code>baseURI</code></a> attribute
-     construct when it is serialized and then re-parsed by a conforming
+     of the node in the <code>ownerDocument</code> attribute of the node.
-     processor, is encountered.</p>
+     Note that the value might be <code>null</code>.</p>
-     <div class="example memo">
-       <p>For a <code>Comment</code> node a
-       <a href="#round-trip-warning"><code>round-trip-warning</code></a> will
-       be raised, since <abbr>XML</abbr> processors are not required to
-       report texts of comments for applications.</p>
-     </div>
    </dd>
- <dt class=ed><dfn id=unknown-error><code>unknown-error</code></dfn>?</dt>
+ <dt><code id=cloneNode>cloneNode</code></dt>
+   <dd class=ed>@@</dd>
+   <dd class=ed>@@ If Attr and AttributeDefinition is inconsistent, then ...</dd>
+ <dt><code id=compareDocumentPosition>compareDocumentPosition</code></dt>
    <dd class=ed>@@</dd>
- <dt><dfn id=xml-misc-error><code>xml-misc-error</code></dt>
+ <dt><code id=isDefaultNamespace>isDefaultNamespace</code></dt>
-   <dd>An <abbr>XML</abbr> <i>error</i> (<abbr>XML</abbr> 1.0
+   <dd><p>When invoked, the method <em class=rfc2119>MUST</em> return
-   <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>
+   <code>false</code>.</p></dd>
-   <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-error">error</a> /
+ <dt><code id=isEqualNode>isEqualNode</code></dt>
-   <abbr>XML</abbr> 1.1
+   <dd><p>For the <a href="#isEqualNode"><code>isEqualNode</code></a> method,
-   <cite class="bibref normative">[<a href="#ref-XML11">XML11</a>]</cite>
+   following items are added to the list of conditions for equality:</p>
-   <a href="@@/#dt-error">error</a>)
-   that is not classified to any other <a href="#error-category">error
+   <ul>
-   category</a>.</dd>
+   <li>
- <dt><dfn id=xml-misc-fatal-error><code>xml-misc-fatal-error</code></dt>
+     <p>If the nodes are <a href="#DocumentType"><code>DocumentType</code></a>
-   <dd>An <abbr>XML</abbr> <i>fatal error</i> (<abbr>XML</abbr> 1.0
+     and at least one of them has the support for the feature
-   <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>
+     <a href="#feature-XDoctype"><code>http://suika.fam.cx/www/2006/feature/XDoctype</code></a>:</p>
-   <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-fatal">fatal
+     <ul>
-   error</a> / <abbr>XML</abbr> 1.1
+     <li>they are equal according to <abbr>DOM</abbr> level 3 definition
-   <cite class="bibref normative">[<a href="#ref-XML11">XML11</a>]</cite>
+     <span class=ed>@@ ref</span>, and
-   <a href="@@/#dt-fatal">fatal error</a>)
+     <li>either:
-   that is not classified to any other <a href="#error-category">error
+       <ul><!--
-   category</a>. <span class=ed>@@ What errors fall into this category?</span></dd>
+       <li>both of them does not support the feature
- <dt><dfn id=xml-misc-recommendation><code>xml-misc-recommendation</code></dfn></dt>
+       <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>An
+     <p>If the node is an
-     <a href="#xml-misc-recommendation"><code>xml-misc-recommendation</code></a>
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
-     will be raised if a <em class=rfc2119>SHOULD</em>$B!>(Blevel requirement
+     On getting, the attribute <em class=rfc2119>MUST</em> return the
-     in <abbr>XML</abbr> specification is not met.</p>
+     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><dfn id=xml-validity-error><code>xml-validity-error</code></dfn></dt>
+ <dt><code id=nodeType>nodeType</code></dt>
-   <dd>A violation of validity constraint in XML document.</dd>
+   <dd>
- <dt><dfn id=xml-well-formedness-error><code>xml-well-formedness-error</code></dfn></dt>
+     <p>On getting, the attribute <em class=rfc2119>MUST</em> return
-   <dd><p>If an <code>xml-well-formedness-error</code> is raised,
+     <a href="#ELEMENT_TYPE_DEFINITION_NODE"><code>ELEMENT_TYPE_DEFINITION_NODE</code></a>
-   it would not be possible to generate an XML serialization that
+     (if the node is an
-   would match to the appropriate production rule and that would not
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>) or
-   violate to any well$B!>(Bformedness constraint in XML
+     <a href="#ATTRIBUTE_DEFINITION_NODE"><code>ATTRIBUTE_DEFINITION_NODE</code></a>
-   specification <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
+     (if the node is an
-   <a href="#ref-XML11">XML11</a>]</cite>.</p></dd>
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>).</p>
- </dl>
+     <!-- NodeType -->
- <div class=ed><p>@@ TODO: #dt-atuseroption at user option
+ <p>Two constants are added to the <code id=NodeType>NodeType</code>
- (MAY or MUST), #dt-compat for compatibility,
+ definition group of the <a href="#Node"><code>Node</code></a> interface as
- #dt-interop for interoperability</p></div>
+ following:</p>
+ <table>
- </div>
+ <thead>
+ <tr><th scope=col>Name<th scope=col>Value<th scope=col>Description</tr>
- <div class=section id=parsing-xml>
+ </thead>
- <h2>Parsing <abbr>XML</abbr> Document</h2>
+ <tbody>
+ <tr>
- <ul>
+ <th scope=row><dfn id=ELEMENT_TYPE_DEFINITION_NODE class=dom-const><code>ELEMENT_TYPE_DEFINITION_NODE</code></dfn>
- <li>If the <abbr>XML</abbr> document does not begin with an
+ <td><code>81001</code><td>The node is an
- <abbr>XML</abbr> declaration, then raise an
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>.</tr>
- <a href="#xml-misc-recommentation" id=xmr-xml-decl><code>xml-misc-recommendation</code></a>.</li>
+ <tr>
- <li>If the replacement text of an entity declaration is
+ <th scope=row><dfn id=ATTRIBUTE_DEFINITION_NODE class=dom-const><code>ATTRIBUTE_DEFINITION_NODE</code></dfn>
- <code>&lt;</code>, then raise an
+ <td><code>81002</code><td>The node is an
- <a href="#xml-misc-warning" id=xmw-entity-value-lt><code>xml-misc-warning</code></a>.<!--
+ <a href="#ElementTypeDefinition"><code>AttributeDefinition</code></a>.</tr>
- "strongly advised to avoid" in a Note in Section 2.3 of [XML10], [XML11].
+ </tbody>
- --></li>
+ </table>
- <li>If there is an element type declaration whose <code>Name</code>
+   </dd>
- value is already declared, then raise an
+ <dt><code id=nodeValue>nodeValue</code> and
- <a href="#xml-validity-error" id=vc-edunique><code>xml-validity-error</code></a>.</li>
+ <code id=textContent>textContent</code></dt>
- <li>If attribute definition whose <code>Name</code> is
+   <dd>
- <code>xml:space</code> has <span class=ed>declared type different from
+     <p>If the node is an
- (default|preserve), (default), or (preserve)</span>, then raise an
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>:
- <a href="#xml-misc-error" id=xme-ad-xml-space><code>xml-misc-error</code></a>.
+     On getting, the attributes <em class=rfc2119>MUST</em> return
- <span class=ed>@@ duplication with
+     <code>null</code>.</p>
- <a href="#xml-at-xml-space">#xml-at-xml-space</a>.<!--
- <!ATTLIST e xml:space CDATA #IMPLIED xml:space CDATA #IMPLIED> --></span></li>
- <li>If an empty-element tag is used for an element which is <em>not</em>
- declared <code>EMPTY</code>, then raise an
- <a href="#xml-misc-recommentation" id=xmr-emptyelemtag-not-empty><code>xml-misc-recommendation</code></a>.</li>
- <li>If an empty-element tag is <em>not</em> used for an element which is
- declared <code>EMPTY</code>, then raise an
- <a href="#xml-misc-recommentation" id=xmr-empty-not-emptyelemtag><code>xml-misc-recommendation</code></a>.</li>
- <!--
- #vc-PEinMarkupDecl Validity constraint: Proper Declaration/PE Nesting
- #wfc-PEinInternalSubset Well-formedness constraint: PEs in Internal Subset
- #ExtSubset Well-formedness constraint: External Subset
- #PE-between-Decls Well-formedness constraint: PE Between Declarations
- #GIMatch Well-formedness constraint: Element Type Match
- #uniqattspec Well-formedness constraint: Unique Att Spec
- #NoExternalRefs Well-formedness constraint: No External Entity References
- #CleanAttrVals Well-formedness constraint: No < in Attribute Values
- #vc-PEinGroup Validity constraint: Proper Group/PE Nesting
- "For interoperability, if a parameter-entity reference appears in a choice, seq, or Mixed construct, its replacement text SHOULD contain at least one non-blank character, and neither the first nor last non-blank character of the replacement text SHOULD be a connector (| or ,)."
- "For interoperability, an XML processor MAY at user option issue a warning when more than one attribute-list declaration is provided for a given element type, or more than one attribute definition is provided for a given attribute, but this is not an error."
- #condsec-nesting Validity constraint: Proper Conditional Section/PE Nesting
- #wf-Legalchar Well-formedness constraint: Legal Character
- #textent Well-formedness constraint: Parsed Entity
- #norecursion Well-formedness constraint: No Recursion
- #indtd Well-formedness constraint: In DTD
- "External parsed entities SHOULD each begin with a text declaration."
- "It is an error for a reference to an unparsed entity to appear in the EntityValue in an entity declaration."
- #UniqueNotationName Validity constraint: Unique Notation Name
- @@ Need detailed review, but maybe should be in parsing phase
- #vc-check-rmd Validity constraint: Standalone Document Declaration
- @@ Need dtailed review
- #wf-entdeclared Well-formedness constraint: Entity Declared
- #vc-entdeclared Validity constraint: Entity Declared
- "For interoperability, valid documents SHOULD declare the entities amp, lt, gt, apos, quot, in the form specified in 4.6 Predefined Entities."
- "If the entities lt or amp are declared, they MUST be declared as internal entities whose replacement text is a character reference to the respective character (less-than sign or ampersand) being escaped; the double escaping is REQUIRED for these entities so that references to them produce a well-formed result. If the entities gt, apos, or quot are declared, they MUST be declared as internal entities whose replacement text is the single character being escaped (or a character reference to that character; the double escaping here is OPTIONAL but harmless)."
- @@ flaged and then reported in DOM check phase
- "Entities encoded in UTF-16 MUST and entities encoded in UTF-8 MAY begin with the Byte Order Mark"
- "In the absence of external character encoding information (such as MIME headers), parsed entities which are stored in an encoding other than UTF-8 or UTF-16 MUST begin with a text declaration"
- "In an encoding declaration, the values "UTF-8", "UTF-16", "ISO-10646-UCS-2", and "ISO-10646-UCS-4" SHOULD be used for the various encodings and transformations of Unicode / ISO/IEC 10646, the values "ISO-8859-1", "ISO-8859-2", ... "ISO-8859-n" (where n is the part number) SHOULD be used for the parts of ISO 8859, and the values "ISO-2022-JP", "Shift_JIS", and "EUC-JP" SHOULD be used for the various encoded forms of JIS X-0208-1997. It is RECOMMENDED that character encodings registered (as charsets) with the Internet Assigned Numbers Authority [IANA-CHARSETS], other than those just listed, be referred to using their registered names; other encodings SHOULD use names starting with an "x-" prefix."
- @@ in parsing phase
+     <div class="note memo">
+       <p>Thus, on setting the attributes does nothing
+       <span class=ed>[DOM3]</span>.</p>
+     </div>
- "It is a fatal error when an XML processor encounters an entity with an encoding that it is unable to process. It is a fatal error if an XML entity is determined (via default, encoding declaration, or higher-level protocol) to be in a certain encoding but contains byte sequences that are not legal in that encoding."
+     <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>
+ <dt class=ed>@@ ...</dt>
+ </dl>
- -->
- </ul>
  </div>
- <div class="section" id=checking-dom>
+ <div class=section id=section-document>
- <h2>Checking <abbr>DOM</abbr></h2>
+ <h3>Modifications to the <code id=Document>Document</code> Interface</h3>
- <p>The following algorithms and definitions are applied to
- <abbr>XML</abbr> documents; especially, they are not applied
- to <abbr>HTML</abbr> documents.<!-- TODO: ref to HTML5 --></p>
- <div class=section id=definitions>
- <h3>Definitions</h3>
- <p>The <dfn id=xml-version><abbr>XML</abbr> version</dfn> of a node is
- the <abbr>XML</abbr> version of the document to which the node belongs.
- For a <code>Documemt</code> node, the <abbr>XML</abbr> version
- of the document is the value of the <code>xmlVersion</code>
- attribute of the node.  For a <code>DocumentType</code> node whose
- <code>ownerDocument</code> attribute is set to <code>null</code>,
- the <abbr>XML</abbr> version of the document is <code>1.0</code><!--
- since createDocumentType [DOM3CORE] assumes XML 1.0 [XML10TE] -->.
- For any other node, the <abbr>XML</abbr> version of the document
- is that of the <code>Document</code> node contained in the
- <code>ownerDocument</code> attribute of the node.</p>
- </div>
- <div class=section id=checking-components>
- <h3>Conformance Checking Algorithms for Components</h3>
- <p>To
- <dfn id=algorithm-to-validate-an-xml-character-data title="validate an XML string">to
- validate an <abbr>XML</abbr> string (<dfn id=var-s><var>s</var></dfn>)</dfn>,
- the following algorithm <em class=rfc2119>MUST</em> be used:</p>
- <ol>
- <li>If <var>s</var> contains a character that is <em>not</em> in
- the character class <a href="#class-Char10"><code>Char10</code></a>,
- then raise an
- <a href="#xml-well-formedness-error" id=wfe-illegal-char><code>xml-well-formedness-error</code></a>.</li>
- <li>If <var>s</var> contains a character that is in the character
- class <a href="#class-CompatChar10"><code>CompatChar10</code></a>,
- then raise an
- <a href="#xml-misc-warning" id=xmw-compat-char><code>xml-misc-warning</code></a>.</li>
- <li>If <var>s</var> contains a character that is in the character
- class <a href="#class-ControlChar10"><code>ControlChar10</code></a>,
- then raise an
- <a href="#xml-misc-warning" id=xmw-control-char><code>xml-misc-warning</code></a>.</li>
- <li class=ed>@@ XML 1.1 support</li>
- <li>If <var>s</var> contains a <code class=char>U+000D</code>
- <code class=charname>CARRIAGE RETURN</code> character, then
- raise a
- <a href="#round-trip-error" id=rte-cr><code>round-trip-error</code></a>.
- <span class=ed>@@ We should not raise duplicate errors for U+000D
- in attribute values.  In addition, we should support a mode where
- U+000D will be serialized as &#x000D; (so that no round-trip-error
- will be raised).</span></li>
- </ol>
- <p>To
- <dfn id=algorithm-to-validate-a-name title="validate a Name">validate a
- <code>Name</code> (<dfn id=var-name-s><var>s</var></dfn>)</dfn>, the following
- algorithm <em class=rfc2119>MUST</em> be used:</p>
- <ol>
- <li>If <var>s</var> is an empty string, then raise an
- <a href="#xml-well-formedness-error" id=wfe-name-empty><code>xml-well-formedness-error</code></a>.
- Abort these steps.</li>
- <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate
- <var>s</var> as an <abbr>XML</abbr> string</a>.</li>
- <li>If the first character in <var>s</var> is a character that is
- <em>not</em> in the character class
- <a href="#class-NameStartChar10"><code>NameStartChar10</code></a>, then raise
- an
- <a href="#xml-well-formedness-error" id=wfe-name-startchar><code>xml-well-formedness-error</code></a>.</li>
- <li>If a character other than the first character in <var>s</var> is a
- character that is <em>not</em> in the character class
- <a href="#class-NameChar10"><code>NameChar10</code></a>, then raise an
- <a href="#xml-well-formedness-error" id=wfe-name-char><code>xml-well-formedness-error</code></a>.</li>
- <li>If <var>s</var> begins with the string <code>xml</code> (in any
- case combination), then raise an
- <a href="#xml-misc-warning" id=xmw-reserved-name><code>xml-misc-warning</code></a>.
- <span class=ed>@@ except for attribute names <code>xml:lang</code>,
- <code>xml:space</code>, <code>xml:base</code>, <code>xml:id</code>,
- <code>xmlns</code>, <code>xmlns:<var>*</var></code>,
- pi name <code>xml-stylesheet</code>.</span><!--
- "names beginning with a match to (('X'|'x')('M'|'m')('L'|'l')) are reserved for standardization in this or future versions of this specification.":
- xmlns, xml-stylesheet, xml:base and xml:id specifications violate to this sentense!
- --></li>
- <!-- COLON in Name is a lowercase "should not" in a Note of [XML10],
- [XML11]. -->
- <li class=ed>@@ XML 1.1 support</li>
- </ol>
- <p>To
- <dfn id=algorithm-to-validate-an-ncname title="validate an NCName">validate
- an <code>NCName</code> (<dfn id=var-ncname-s><var>s</var></dfn>)</dfn>, the
- following algorithm <em class=rfc2119>MUST</em> be used:</p>
- <ol>
- <li><a href="#algorithm-to-validate-a-name" title="validate a Name">Validate
- <var>s</var> as a <code>Name</code></a>.</li>
- <li class=ed>@@</li>
- </ol>
- <p>To
- <dfn id=algorithm-to-validate-a-public-identifier title="validate a public identifier">validate
- a public identifier (<dfn id=var-pid><var>pid</var></dfn>)</dfn>, the
- following algorithm <em class=rfc2119>MUST</em> be used:</p>
- <ol>
- <li>If <var>pid</var> is <code>null</code>, abort these steps.</li>
- <li>If <var>pid</var> contains a character that is <em>not</em> in the
- character class <a href="#class-PubidChar"><code>PubidChar</code></a>, then
- raise an
- <a href="#xml-well-formedness-error" id=wfe-pubid-char><code>xml-well-formedness-error</code></a>.</li>
-   <li>If <var>pid</var> contains one of <code class=char>U+0009</code>
-   <code class=charname>CHARACTER TABULATION</code>,
-   <code class=char>U+000A</code> <code class=charname>CARRIAGE RETURN</code>,
-   and <code class=char>U+000D</code> <code class=charname>LINE FEED</code>
-   characters, if the first character of <var>pid</var> is
-   <code class=char>U+0020</code> <code class=charname>SPACE</code> character,
-   if the last character of <var>pid</var> is <code class=char>U+0020</code>
-   <code class=charname>SPACE</code> character, or if there is a
-   <code class=char>U+0020</code> <code class=charname>SPACE</code> character
-   immediately followed by another <code class=char>U+0020</code>
-   <code class=charname>SPACE</code> character in <var>pid</var>, then it is a
-   <a href="#round-trip-error" id=rte-pubid-space><code>round-trip-error</code></a>.
-   <span class=ed>Is this really a roundtripness problem?  XML spec
-   does only define the way to match public identifiers in fact, no
-   canonical form.</span></li>
- </ol>
- <p>To
- <dfn id=algorithm-to-validate-a-system-identifier title="validate a system identifier">validate
- a system identifier (<dfn id=var-sid><var>sid</var></dfn>)</dfn>, the
- following algorithm <em class=rfc2119>MUST</em> be used:</p>
- <ol>
-   <li>If <var>sid</var> is <code>null</code>, abort these steps.</li>
- <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate
- <var>sid</var> as an <abbr>XML</abbr> string</a>.</li>
-   <li>If <var>sid</var> contains both <code class=char>U+0022</code>
-   <code class=charname>QUOTATION MARK</code> (<code class=char>"</code>) and
-   <code class=char>U+0027</code> <code class=charname>APOSTROPHE</code>
-   (<code class=char>'</code>) characters, raise an
-   <a href="#xml-well-formedness-error" id=wfe-sid-lit><code>xml-well-formedness-error</code></a>.</li>
-   <li>If <var>sid</var> contains at least one <code class=char>U+0023</code>
-   <code class=charname>NUMBER SIGN</code> (<code class=char>#</code>)
-   character, then raise an
-   <a href="#xml-misc-error" id=xme-sid-fragment><code>xml-misc-error</code></a>.</li>
-   <li class=ed>@@ If <var>sid</var> cannot be converted to a URI
-   reference, then raise a fact-level error (xml-misc-warning?).<!--
-   XML 1.0 has no conformance language for system identifier being
-   a URI reference. --></li>
- </ol>
+ <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>
- <div class=section id=checking-node>
+ <div class=section id=section-documentxdoctype>
- <h3>Checking <code>Node</code></h3>
+ <h3>The <code>DocumentXDoctype</code> Interface</h3>
- <p>The algorithm <dfn title="to check a node" id=algorithm-to-check-a-node>to
+ <p>The <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface
- check a node (<dfn id=var-n><var>n</var></dfn>)</dfn> is defined as
+ <em class=rfc2119>MUST</em> be implemented as following:</p>
- following:</p>
+ <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
- <dl class=switch>
+   DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
- <dt>If <var>n</var> is an <code>Attr</code> node</dt>
+     (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
-   <dd>
+     raises (DOMException);
-     <ol>
+   <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
+     (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
-     <code>localName</code> attribute value as an <code>NCName</code></a>.</li>
+     raises (DOMException);
-     <li>If the <code>prefix</code> attribute value is different from
+   <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#createAttributeDefinition">createAttributeDefinition</a>
-     <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate
+     (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
-     the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>
+     raises (DOMException);
-     <li>For each node <dfn id=var-attr-nc><var>n<sub><var>c</var></sub></var></dfn> in the
+   <a href="#Entity">Entity</a> <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
-     <code>childNodes</code> list of <var>n</var>,
+     (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
-       <ol>
+     raises (DOMException);
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a
+   <a href="#Notation">Notation</a> <a href="#createNotation">createNotation</a>
-       <code>Text</code> or <code>EntityReference</code> node, then it is an
+     (in DOMString <a href="#createNotation-name"><var>name</var></a>)
-       <a href="#xml-well-formedness-error" id=wfe-attr-child><code>xml-well-formedness-error</code></a>.</li>
+     raises (DOMException);
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an
+ }</code></pre>
-       <code>EntityReference</code> node, then it is an
-       <a href="#entity-error" id=ee-attr-er><code>entity-error</code></a>.</li>
+ <div class=ed>@@ cast definition</div>
-       <li>Otherwise,
-       <a href="#algorithm-to-check-a-node" title="check a node">check
+ <dl>
-       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>
+ <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
-       </ol></li>
+ method</dt>
-     <li>If <code>nodeName</code> attribute of <var>n</var> is
-     <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>
-     and <code>value</code> attribute of <var>n</var> is neither
-     <code>default</code> nor <code>preserve</code>, then it is an
-     <a href="#xml-misc-error" id=xme-attr-xml-space><code>xml-misc-error</code></a>.<!--
-     Note that <!ATTLIST e xml:space (default|preserve) "a">...
-     <e xml:space="default"/> is conforming and valid. --></li>
-     <li class=ed>@@ xml:lang value is not a language tag [RFC 3066 or its
-     successor] or an empty string, then xml-misc-warning
-     (a "fact"-level error; not an XML error).</li>
-     <li class=ed>@@ <code>specified</code>,
-     <code>manakaiAttributeType</code> (#ValueType Validity constraint: Attribute Value Type)</li>
-     <!-- xml:space MUST be declared to be valid. -->
-     <li>Let <dfn id=var-v><var>v</var></dfn> be the value of the
-     attribute <code>value</code> of <var>n</var>.</li>
-     <li>Validate the <var>n</var> against the <span class=ed>declared
-     type</span> as following:
-       <dl class=switch>
-       <dt class=ed><code>ID_ATTR</code></dt>
-         <dd>
-           <ol>
-           <li><span class=ed>Validate <var>v</var> as an
-           <code>Name</code>.</span>  If it fails, then raise an
-           <a href="#xml-validity-error" id=vc-id-name><code>xml-validity-error</code></a>.</li>
-           <li><span class=ed>If <code>ID</code> <var>v</var> is defined,</span>
-           then raise an
-           <a href="#xml-validity-error" id=vc-id-duplication><code>xml-validity-error</code></a>.</li>
-           </ol>
-         </dd>
-       <dt class=ed>IDREF_ATTR</dt>
-         <dd>
-           <ol>
-           <li><span class=ed>Validate <var>v</var> as an
-           <code>Name</code>.</span>  If it fails, then raise an
-           <a href="#xml-validity-error" id=vc-idref-name><code>xml-validity-error</code></a>.</li>
-           <li><span class=ed>If <code>ID</code> <var>v</var> is NOT
-           defined,</span> then raise an
-           <a href="#xml-validity-error" id=vc-idref-match><code>xml-validity-error</code></a>.</li>
-           </ol>
-         </dd>
-       <dt class=ed>IDREFS_ATTR</dt>
-         <dd class=ed>@@</dd>
-       <dt class=ed>ENTITY_ATTR</dt>
-         <dd>
-           <ol>
-           <li><span class=ed>Validate <var>v</var> as an
-           <code>Name</code>.</span>  If it fails, then raise an
-           <a href="#xml-validity-error" id=vc-entname-name><code>xml-validity-error</code></a>.</li>
-           <li><span class=ed>If <code>Entity</code> <var>v</var> is NOT
-           defined,</span> then raise an
-           <a href="#xml-validity-error" id=vc-entname-match><code>xml-validity-error</code></a>.</li>
-           </ol>
-         </dd>
-       <dt class=ed>ENTITIES_ATTR</dt>
-         <dd class=ed>@@</dd>
-       <dt class=ed>NMTOKEN_ATTR</dt>
-         <dd>
-           <ol>
-           <li><span class=ed>Validate <var>v</var> as an
-           <code>Nmtoken</code>.</span>  If it fails, then raise an
-           <a href="#xml-validity-error" id=vc-nmtok-name><code>xml-validity-error</code></a>.</li>
-           </ol>
-         </dd>
-       <dt class=ed>NMTOKENS_ATTR</dt>
-         <dd class=ed>@@</dd>
-       <dt class=ed>NOTATION_ATTR</dt>
-         <dd class=ed><var>v</var> must be one of enumerated values.
-         If not, then raise an
-         <a href="#xml-validity-error" id=vc-notatn-match><code>xml-validity-error</code></a>.</dd>
-       <dt class=ed>ENUMERATED_ATTR</dt>
-         <dd class=ed><var>v</var> must be one of enumerated values.
-         If not, then raise an
-         <a href="#xml-validity-error" id=vc-enum><code>xml-validity-error</code></a>.</dd>
-       <dt class=ed>@@</dt>
-       </dl>
-     </li>
-     <li>If <span class=ed>type ID and default is NOT #IMPLIED or #REQUIRED</span>, then
-     raise an
-     <a href="#xml-validity-error" id=vc-id-default><code>xml-validity-error</code></a>.</li>
-     <li class=ed>@@ #FixedAttr Validity constraint: Fixed Attribute Default</li>
-     <li class=ed>@@ strict serialization error for U+000D, U+000A, and
-     U+0009 characters, leading/trailing U+0020, and U+0020{2,} string?</li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is an <code>AttributeDefinition</code> node</dt>
-   <dd>
-     <ol>
-     <li class=ed></li>
-     <li>If <code>nodeName</code> attribute of <var>n</var> is
-     <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>
-     and <span class=ed>its declared type is different from (default|preserve),
-     (default), or (preserve)</span>, then raise an
-     <a href="#xml-misc-error" id=xme-at-xml-space><code>xml-misc-error</code></a>.</li>
-     <li>For each node <dfn id=var-ad-nc><var>n<sub><var>c</var></sub></var></dfn> in the
-     <code>childNodes</code> list of <var>n</var>,
-       <ol>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a
-       <code>Text</code> or <code>EntityReference</code> node, then it is an
-       <a href="#xml-well-formedness-error" id=wfe-at-child><code>xml-well-formedness-error</code></a>.</li>
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an
-       <code>EntityReference</code> node, then it is an
-       <a href="#entity-error" id=ee-at-er><code>entity-error</code></a>.</li>
-       <li>Otherwise,
-       <a href="#algorithm-to-check-a-node" title="check a node">check
-       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>
-       </ol></li>
-     <li class=ed>If <code>NOTATION_ATTR</code>, enumerated values MUST
-     be declared.  If not, then raise an
-     <a href="#xml-validity-error" id=vc-notatn-declared><code>xml-validity-error</code></a>.</li>
-     <li class=ed>If <code>NOTATION_ATTR</code> or <code>ENUMERATED_ATTR</code>,
-     values MUST all be distinct.  If not, then raise an
-     <a href="#xml-validity-error" id=vc-no-duplicate-tokens><code>xml-validity-error</code></a>.</li>
-     <li class=ed>If <code>NOTATION_ATTR</code> on an <code>EMPTY</code>
-     element, then raise an
-     <a href="#xml-validity-error" id=vc-no-notation-empty><code>xml-validity-error</code></a>.</li>
-     <li class=ed>@@ #defattrvalid Validity constraint: Attribute Default Value Syntactically Correct</li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>CDATASection</code> node</dt>
-   <dd>
-     <ol>
-     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the
-     <code>data</code> attribute value as an <abbr>XML</abbr> character
-     data</a>.</li>
-     <li>If the <code>data</code> attribute value contains
-     a string <code>]]></code>, then raise an
-     <a href="#xml-well-formedness-error" id=wfe-cs-mse><code>xml-well-formedness-error</code></a>.<!-- "for compatibility" --></li>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
-     any nodes, they are in
-     <a href="#xml-well-formedness-error" id=wfe-cs-child><code>xml-well-formedness-error</code></a>.</li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>Comment</code> node</dt>
-   <dd>
-     <ol>
-     <li>Raise an
-     <a href="#round-trip-warning" id=rtw-comment><code>round-trip-warning</code></a>.</li>
-     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the
-     <code>data</code> attribute value as an <abbr>XML</abbr> character
-     data</a>.</li>
-     <li>If the <code>data</code> attribute value contains
-     a string <code>--</code>, or if it ends with a character
-     <code>-</code>, then raise an
-     <a href="#xml-well-formedness-error" id=wfe-comment-com><code>xml-well-formedness-error</code></a>.<!--
-     "for compatibility" --></li>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
-     any nodes, they are in
-     <a href="#xml-well-formedness-error" id=wfe-comment-child><code>xml-well-formedness-error</code></a>.</li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>Document</code> node</dt>
-   <dd>
-     <ol>
-     <li>If <a href="#xml-version"><abbr>XML</abbr> version</a> of <var>n</var>
-     is different from <code>1.0</code> or <code>1.1</code>,
-     then it is an <code class=ed>unknown-error?</code>.</li>
-     <li>If the <code>xmlEncoding</code> attribute value does <em>not</em>
-     match to <code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code>
-     <span class=ed>@@ formal def</span>, then it is an
-     <a href="#xml-well-formedness-error" id=wfe-encoding><code>xml-well-formedness-error</code></a>.</li>
-     <li>The <code>childNodes</code> list of <var>n</var> have to
-     consist of zero or more <code>Comment</code> and/or
-     <code>ProcessingInstruction</code> nodes, followed by
-     an optional <code>DocumentType</code> node, followed
-     by zero or more <code>Comment</code> and/or
-     <code>ProcessingInstruction</code> nodes, followed by
-     an <code>Element</code> node, followed
-     by zero or more <code>Comment</code> and/or
-     <code>ProcessingInstruction</code> nodes.  Any violation to this is an
-     <a href="#xml-well-formedness-error" id=wfe-document-child><code>xml-well-formedness-error</code></a>.</li>
-     <li>For each node <dfn id=var-document-nc><var>n<sub><var>c</var></sub></var></dfn>
-     in the <code>childNodes</code> list of <var>n</var>,
-       <ol>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an
-       <code>EntityReference</code> node, then
-       <a href="#algorithm-to-check-a-node" title="check a node">check
-       <var>n<sub><var>c</var></sub></var></a> recursively.</li>
-       </ol></li>
-     <li class=ed>@@ <code>allDeclarationsProcessed</code></li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>DocumentFragment</code> node</dt>
-   <dd>
-     <ol>
-     <li>For each node <dfn id=var-df-nc><var>n<sub><var>c</var></sub></var></dfn>
-     in the <code>childNodes</code> list of <var>n</var>,
-       <ol>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an
-       <code>Element</code>, <code>Text</code>, <code>CDATASection</code>,
-       <code>Comment</code>, <code>ProcessingInstruction</code>, or
-       <code>EntityReference</code> node, then it is an
-       <a href="#xml-well-formedness-error" id=wfe-df-child><code>xml-well-formedness-error</code></a>.</li>
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an
-       <code>EntityReference</code> node, then it is an
-       <a href="#entity-error" id=ee-df-er><code>entity-error</code></a>.</li>
-       <li>Otherwise,
-       <a href="#algorithm-to-check-a-node" title="check a node">check
-       <var>n<sub><var>c</var></sub></var></a> recursively.</li>
-       </ol></li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>DocumentType</code> node</dt>
-   <dd>
-     <ol>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
-     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>
-     <li>Follow the following substeps:
-       <ol>
-       <li>If <code>ownerDocument</code> attribute of <var>n</var> is
-       <code>null</code>, then abort these substeps.</li>
-       <li>If <code>documentElement</code> attribute of the node
-       set to <code>ownerDocument</code> attribute of <var>n</var> is
-       <code>null</code>, then abort these substeps.</li>
-       <li>If <code>nodeName</code> attribute of the node set to
-       <code>documentElement</code> attribute of the node set to
-       <code>ownerDocument</code> attribute of <var>n</var> is
-       different from <code>nodeName</code> of <var>n</var>,
-       then raise an
-       <a href="#xml-validity-error" id=vc-roottype><code>xml-validity-error</code></a>.</li></li>
-       </ol>
-     </li>
-     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate
-     the <code>publicId</code> attribute value as a public identifier</a>.</li>
-     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate
-     the <code>systemId</code> attribute value as a system identifier</a>.</li>
-     <li>If the <code>publicId</code> attribute value of <var>n</var> is
-     <em>not</em> <code>null</code> and the <code>systemId</code> attribute
-     value of <var>n</var> is <code>null</code>, then raise an
-     <a href="#xml-well-formedness-error" id=wfe-dt-sid><code>xml-well-formedness-error</code></a>.
-     <span class=ed>@@ publicId == null?  Or, publicId == ""</span></li>
-     <li>For each node <dfn id=var-dt-nc><var>n<sub><var>c</var></sub></var></dfn>
-     in the <code>childNodes</code> list of <var>n</var>,
-       <ol>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a
-       <code>ProcessingInstruction</code> node, then it is an
-       <a href="#xml-well-formedness-error" id=wfe-dt-child><code>xml-well-formedness-error</code></a>.
-       <span class=ed>@@ ref to manakai's extensions</span></li>
-       <li>Otherwise, <!-- if n_c is not an EntityReference node, -->
-       <a href="#algorithm-to-check-a-node" title="check a node">check
-       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>
-       </ol></li>
-     <li>For each node in the <code>entities</code>, <code>notations</code>,
-     and <code>elementTypes</code> lists of <var>n</var>,
-     <a href="#algorithm-to-check-a-node" title="check a node">check the
-     node</a> recursively.</li>
-     <li class=ed>@@ externally declared?</li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is an <code>Element</code> node</dt>
-   <dd>
-     <ol>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
-     <code>localName</code> attribute value as an <code>NCName</code></a>.</li>
-     <li>If the <code>prefix</code> attribute value is different from
-     <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate
-     the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>
-     <li>For each node <dfn id=var-element-nc><var>n<sub><var>c</var></sub></var></dfn>
-     in the <code>childNodes</code> list of <var>n</var>,
-       <ol>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an
-       <code>Element</code>,
-       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,
-       <code>ProcessingInstruction</code>, or
-       <code>EntityReference</code> node, then it is an
-       <a href="#xml-well-formedness-error" id=wfe-element-child><code>xml-well-formedness-error</code></a>.</li>
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an
-       <code>EntityReference</code> node, then it is an
-       <a href="#entity-error" id=ee-element-er><code>entity-error</code></a>.</li>
-       <li>Otherwise,
-       <a href="#algorithm-to-check-a-node" title="check a node">check
-       <var>n<sub><var>c</var></sub></var></a> recursively.</li>
-       </ol></li>
-     <li class=ed>@@ #elementvalid Validity constraint: Element Valid</li>
-     <li>Let <var>attrs</var> be the value of the <code>attribute</code>
-     attribute of <var>n</var>.  Check conformance of <var>attrs</var>
-     as following:
-       <ol>
-       <li>If <var>attrs</var> contains an <code>Attr</code> node whose
-       <code>nodeName</code> attribute value is equal to that of another
-       <code>Attr</code> node in <var>attrs</var>, then raise an
-       <a href="#xml-well-formedness-error" id=wfe-uniqattspec><code>xml-well-formedness-error</code></a>.<!--
-       #uniqattspec Well-formedness constraint: Unique Att Spec --></li>
-       <li class=ed>@@ #RequiredAttr Validity constraint: Required Attribute</li>
-       </ol>
-     </li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is an <code>ElementTypeDefinition</code> node</dt>
    <dd>
-     <ol>
+     <p>This method creates a <code>DocumentType</code> node with the specified
-     <li class=ed></li>
+     name, belonging to the document.</p>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
+     <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
-     any nodes, they are in
+     parameter is the name of the document type.</p>
-     <a href="#xml-well-formedness-error" id=wfe-et-child><code>xml-well-formedness-error</code></a>.</li>
-     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#elemdecls">At user option, an XML processor MAY issue a warning when a declaration mentions an element type for which no declaration is provided, but this is not an error.</q></li>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
-     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#sec-element-content">For compatibility, it is an error if the content model allows an element to match more than one occurrence of an element type in the content model. </q></li>
+     return a <code>DocumentType</code> node with the following attributes:</p>
-     <li class=ed>@@ #vc-MixedChildrenUnique
+     <dl>
-     Validity constraint: No Duplicate Types</li>
+     <dt><code>attributes</code>, <code>parentNode</code></dt>
-     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#attdecls">At user option, an XML processor MAY issue a warning if attributes are declared for an element type not itself declared, but this is not an error.</q></li>
+       <dd><code>null</code>.</dd>
-     <li>If there is more than one <code>AttributeDefinition</code> node
+     <dt><code>elementTypes</code>, <code>generalEntities</code>, and
-     with <span class=ed>attribute type <code>ID</code></span> in the
+     <code>notations</code></dt>
-     <code>NamedNodeMap</code> list contained in the
+       <dd>Empty <code>NamedNodeMap</code> objects.</dd>
-     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an
+     <dt><code>entities</code></dt>
-     <a href="#xml-validity-error" id=vc-one-id-per-el><code>xml-validity-error</code></a>.</li>
+       <dd>The same value as the <code>generalEntities</code> attribute.</dd>
-     <li>If there is more than one <code>AttributeDefinition</code> node
+     <dt><code>childNodes</code></dt>
-     with <span class=ed>attribute type <code>NOTATION</code></span> in the
+       <dd>An empty <code>NodeList</code> object.</dd>
-     <code>NamedNodeMap</code> list contained in the
+     <dt><code>internalSubset</code>, <code>publicId</code>, and
-     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an
+     <code>systemId</code></dt>
-     <a href="#xml-validity-error" id=vc-one-notation-per><code>xml-validity-error</code></a>.</li>
+       <dd>Empty strings.</dd>
-     <li class=ed>"For interoperability, the same Nmtoken  SHOULD NOT occur more than once in the enumerated attribute types of a single element type."</li>
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
-     </ol>
+       <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>If <var>n</var> is an <code>Entity</code> node whose
+ <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
- <code>notationName</code> attribute value is <code>null</code> (i.e. a
+ method</dt>
- parsed entity)</dt>
    <dd>
-     <ol>
+     <p>This method creates a <code>ElementTypeDefinition</code> node with the
-     <li>Raise an
+     specified name, belonging to the document.</p>
-     <a href="#entity-error" id=ee-entity-node><code>entity-error</code></a>.</li>
+     <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
+     parameter is the name of the element type defined by the element
-     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>
+     type definition.</p>
-     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate
-     the <code>publicId</code> attribute value as a public identifier</a>.</li>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
-     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate
+     return an
-     the <code>systemId</code> attribute value as a system identifier</a>.</li>
+     <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
-     <li>If the <code>publicId</code> attribute value of <var>n</var> is
+     node with the following attributes:</p>
-     <em>not</em> <code>null</code> and the <code>systemId</code> attribute
+     <dl>
-     value of <var>n</var> is <code>null</code>, then raise an
+     <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
-     <a href="#xml-well-formedness-error" id=wfe-entity-sid><code>xml-well-formedness-error</code></a>.</li>
+       <dd>An empty <code>NamedNodeMap</code> object.</dd>
-     <li>For each node <dfn id=var-entity-nc><var>n<sub><var>c</var></sub></var></dfn>
+     <dt><code>attributes</code>, <code>parentNode</code></dt>
-     in the <code>childNodes</code> list of <var>n</var>,
+       <dd><code>null</code>.</dd>
-       <ol>
+     <dt><code>childNodes</code></dt>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an
+       <dd>An empty <code>NodeList</code> object.</dd>
-       <code>Element</code>,
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
-       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,
+       <dd><code>false</code>.</dd>
-       <code>ProcessingInstruction</code>, or <code>EntityReference</code>
+     <dt><code>nodeName</code></dt>
-       node, then it is an
+       <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
-       <a href="#xml-well-formedness-error" id=wfe-entity-child><code>xml-well-formedness-error</code></a>.</li>
+     <dt><code>ownerDocument</code></dt>
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
-       <code>EntityReference</code> node, then it is an
+     <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>
-       <a href="#entity-error" id=ee-er-er><code>entity-error</code></a>.</li>
+       <dd><code>null</code>.</dd>
-       <li>Otherwise,
+     <dt class=ed>@@ Ensure all attributes are defined</dt>
-       <a href="#algorithm-to-check-a-node" title="check a node">check
+     </dl>
-       <var>n<sub><var>c</var></sub></var></a> recursively.</li>
-       </ol></li>
-     </ol>
    </dd>
- <dt>If <var>n</var> is an <code>Entity</code> node whose
+ <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
- <code>notationName</code> attribute value is <em>not</em> <code>null</code>
+ method</dt>
- (i.e. an unparsed entity)</dt>
    <dd>
-     <ol>
+     <p>This method creates a <code>AttributeDefinition</code> node with the
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
+     specified name, belonging to the document.</p>
-     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>
+     <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
-     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate
+     parameter is the name of the attribute defined by the attribute
-     the <code>publicId</code> attribute value as a public identifier</a>.</li>
+     definition.</p>
-     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate
-     the <code>systemId</code> attribute value as a system identifier</a>.</li>
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and
-     <li>If the <code>systemId</code> attribute value of <var>n</var> is
+     return an
-     <code>null</code>, then raise an
+     <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
-     <a href="#xml-well-formedness-error" id=wfe-uentity-sid><code>xml-well-formedness-error</code></a>.</li>
+     node with the following attributes:</p>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
+     <dl>
-     <code>notationName</code> attribute value of <var>n</var> as an
+     <dt><code>allowedTokens</code></dt>
-     <code>NCName</code></a>.</li>
+       <dd>An empty <code>DOMStringList</code> object.</dd>
-     <li class=ed>@@ #not-declared Validity constraint: Notation Declared</li>
+     <dt><code>attributes</code>,
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
+     <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,
-     any nodes, they are in
+     and <code>parentNode</code></dt>
-     <a href="#xml-well-formedness-error" id=wfe-uentity-child><code>xml-well-formedness-error</code></a>.</li>
+       <dd><code>null</code>.</dd>
-     </ol>
+     <dt><code>childNodes</code></dt>
-   </dd>
+       <dd>An empty <code>NodeList</code> object.</dd>
- <dt>If <var>n</var> is an <code>EntityReference</code> node</dt>
+     <dt><code>declaredType</code></dt>
-   <dd>
+       <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
-     <ol>
+     <dt><code>defaultType</code></dt>
-     <li>An <a href="#entity-error" id=ee-er-node><code>entity-error</code></a>.</li>
+       <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
+     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
-     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>
+       <dd><code>false</code>.</dd>
-     <li>For each node <dfn id=var-er-nc><var>n<sub><var>c</var></sub></var></dfn>
+     <dt><code>nodeName</code></dt>
-     in the <code>childNodes</code> list of <var>n</var>,
+       <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
-       <ol>
+     <dt><code>ownerDocument</code></dt>
-       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an
+       <dd>The <code>Document</code> node over which the method is invoked.</dd>
-       <code>Element</code>,
+     <dt class=ed>@@ Ensure all attributes are defined</dt>
-       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,
+     </dl>
-       <code>ProcessingInstruction</code>, or <code>EntityReference</code>
-       node, then it is an
+     <div class=ed>
-       <a href="#xml-well-formedness-error" id=wfe-er-child><code>xml-well-formedness-error</code></a>.</li>
+     <p>@@ Should we keep these statements?:
-       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is <em>not</em> an
+ However, if the &lt;cfg::cfg|xml-id> configuration
-       <code>EntityReference</code> node, then it is an
+ parameter is set to <code>true</code> and the <var>name</var>
-       <a href="#entity-error" id=ee-entity-er><code>entity-error</code></a>.</li>
+ is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
-       <li>Otherwise,
+ attribute is set to <code>ID_ATTR</code>.
-       <a href="#algorithm-to-check-a-node" title="check a node">check
+ [CODE(DOMa)@en[[[defaultType]]]]?</p>
-       <var>n<sub><var>c</var></sub></var></a> recursively.</li>
+     </div>
-       </ol></li>
-     </ol>
-   </dd>
- <dt>If <var>n</var> is a <code>Notation</code> node</dt>
-   <dd>
-     <ol>
-     <li><a href="#algorithm-to-validate-an-ncname">Validate the
-     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>
-     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate
-     the <code>publicId</code> attribute value as a public identifier</a>.</li>
-     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate
-     the <code>systemId</code> attribute value as a system identifier</a>.</li>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
-     any nodes, they are in
-     <a href="#xml-well-formedness-error" id=wfe-notation-child><code>xml-well-formedness-error</code></a>.</li>
-     </ol>
    </dd>
- <dt>If <var>n</var> is a <code>ProcessingInstruction</code> node</dt>
+ <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
+ method</dt>
    <dd>
-     <ol>
+     <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
-     <li>If the <code>target</code> attribute value matches to the string
+     with the specified name, which represents a general entity, belonging to
-     <code>xml</code> in any case combination, then raise a
+     the document.</p>
-     <a href="#xml-well-formedness-error" id=wfe-pi-xml><code>xml-well-formedness-error</code></a>.</li>
+     <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
-     <li>Otherwise, <a href="#algorithm-to-validate-an-ncname">validate the
+     parameter is the name of the general entity.</p>
-     <code>target</code> attribute value as an <code>NCName</code></a>.</li>
-     <li>Then,
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
-     <a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">validate
+     an <a href="#Entity"><code>Entity</code></a> node with the following
-     the <code>data</code> attribute value as an <abbr>XML</abbr> character
+     attributes:</p>
-     data</a>.</li>
+     <dl>
-     <li>If the <code>data</code> attribute value contains a string
+     <dt><code>attributes</code>, <code>notationName</code>,
-     <code>?></code>, then raise a
+     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
-     <a href="#xml-well-formedness-error" id=wfe-pi-pic><code>xml-well-formedness-error</code></a>.</li>
+     and <code>parentNode</code></dt>
-     <li>If the <code>data</code> attribute value starts with either
+       <dd><code>null</code>.</dd>
-     <code class=char>U+0009</code> <code class=charname>CHARACTER
+     <dt><code>childNodes</code></dt>
-     TABULATION</code>, <code class=char>U+000A</code> <code class=charname>LINE
+       <dd>An empty <code>NodeList</code> object.</dd>
-     FEED</code>, <code class=char>U+000D</code> <code class=charname>CARRIAGE
+     <dt><code>manakaiDeclarationBaseURI</code>,
-     RETURN</code>, or <code class=char>U+0020</code>
+     <code>manakaiEntityBaseURI</code>, and
-     <code class=charname>SPACE</code> character, then raise a
+     <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
-     <a href="#round-trip-error" id=rte-pi-s><code>round-trip-error</code></a>.</li>
+       <dd>No explicit value is set.</dd>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
+     <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
-     any nodes, then raise an
+     <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
-     <a href="#xml-well-formedness-error" id=wfe-pi-child><code>xml-well-formedness-error</code></a>.</li>
+       <dd><code>false</code>.</dd>
-     </ol>
+     <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>If <var>n</var> is a <code>Text</code> node</dt>
+ <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
+ method</dt>
    <dd>
-     <ol>
+     <p>This method creates a <code>Notation</code> node with the
-     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the
+     specified name, belonging to the document.</p>
-     <code>data</code> attribute value as an <abbr>XML</abbr> character
+     <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
-     data</a>.</li>
+     parameter is the name of the notation.</p>
-     <li>If the <code>childNodes</code> list of <var>n</var> contains
-     any nodes, they are in
+     <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
-     <a href="#xml-well-formedness-error" id=wfe-text-child><code>xml-well-formedness-error</code></a>.</li>
+     a <code>Notation</code> node with the following attributes:</p>
-     </ol>
+     <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>
- <dt>Otherwise</dt>
-   <dd><span class=ed>xml-well-formedness-error?  unknown-error?</span></dd>
  </dl>
+ <p>These methods <em class=rfc2119>MUST</em> raise an
+ <code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>
+ 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
+ <code>xmlVersion</code> attribute of the <code>Document</code> node.</p>
+ <div class="note memo">
+ <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
+ define it for <code>Document</code> methods.</p>
+ <p><var>name</var> does not have to be a namespace qualified name.</p>
  </div>
  </div>
- <div id=classes class=section>
- <h2>Character Classes</h2>
- <p>This section defines a couple of character classes.
+ <div class=section id=section-documenttype>
- These classes are referred to by algorithms specified above.</p>
+ <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>
- <p>Character class <dfn id=class-Char10><code>Char10</code></dfn>
- contains the following characters:</p>
- <ul>
- <li><code class=char>U+0009</code> <code class=charname>CHARACTER
- TABULATION</code></li>
- <li><code class=char>U+000A</code> <code class=charname>LINE FEED</code></li>
- <li><code class=char>U+000D</code> <code class=charname>CARRIAGE
- RETURN</code></li>
- <li><code class=char>U+0020</code> <code class=charname>SPACE</code>
- .. <code class=char>U+D7FF</code></li>
- <li><code class=char>U+E000</code> .. <code class=char>U+FFFD</code>
- <code class=charname>REPLACEMENT CHARACTER</code></li>
- <li><code class=char>U+10000</code> .. <code class=char>U+10FFFF</code></li>
- </ul>
- <div class="note memo">
- <p>This character class contains all characters allowed in the production rule
- <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Char"><code>Char</code></a>
- of <abbr>XML</abbr> 1.0
- <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>
- </div>
- <p>Character class <dfn id=class-CompatChar10><code>CompatChar10</code></dfn>
- contains the following characters:</p>
- <ul>
- <li class=ed>@@ <q>Document authors are encouraged to avoid "compatibility characters", as defined in section 6.8 of [Unicode @@ Unicode 2.0 @@] (see also D21 in section 3.6 of [Unicode3]).</q></li>
- </ul>
- <p>Character class <dfn id=class-ControlChar10><code>ControlChar10</code></dfn>
- contains the following characters:</p>
- <ul>
- <li><code class=char>U+007F</code> <code class=charname>DELETE</code> ..
- <code class=char>U+0084</code> <code class=charname>INDEX</code></li>
- <li><code class=char>U+0086</code> <code class=charname>START OF SELECTED
- AREA</code> .. <code class=char>U+009F</code> <code class=charname>APPLICATION
- PROGRAM COMMAND</code></li>
- <li><code class=char>U+FDD0</code> .. <code class=char>U+FDEF</code></li>
- <li><code class=char>U+1FFFE</code> .. <code class=char>U+1FFFF</code></li>
- <li><code class=char>U+2FFFE</code> .. <code class=char>U+2FFFF</code></li>
- <li><code class=char>U+3FFFE</code> .. <code class=char>U+3FFFF</code></li>
- <li><code class=char>U+4FFFE</code> .. <code class=char>U+4FFFF</code></li>
- <li><code class=char>U+5FFFE</code> .. <code class=char>U+5FFFF</code></li>
- <li><code class=char>U+6FFFE</code> .. <code class=char>U+6FFFF</code></li>
- <li><code class=char>U+7FFFE</code> .. <code class=char>U+7FFFF</code></li>
- <li><code class=char>U+8FFFE</code> .. <code class=char>U+8FFFF</code></li>
- <li><code class=char>U+9FFFE</code> .. <code class=char>U+9FFFF</code></li>
- <li><code class=char>U+AFFFE</code> .. <code class=char>U+AFFFF</code></li>
- <li><code class=char>U+BFFFE</code> .. <code class=char>U+BFFFF</code></li>
- <li><code class=char>U+CFFFE</code> .. <code class=char>U+CFFFF</code></li>
- <li><code class=char>U+DFFFE</code> .. <code class=char>U+DFFFF</code></li>
- <li><code class=char>U+EFFFE</code> .. <code class=char>U+EFFFF</code></li>
- <li><code class=char>U+FFFFE</code> .. <code class=char>U+FFFFF</code></li>
- <li><code class=char>U+10FFFE</code> .. <code class=char>U+10FFFF</code></li>
- </ul>
  <div class="note memo">
- <p>This character class contains the characters listed in the Note in
+ <p>Setting an invalid identifier might make the node unserializable.
- <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#charsets">Section 2.2</a>
+ Setting a public identifier while leaveing system identifier unspecified
- of <abbr>XML</abbr> 1.0
+ would also make the <a href="#DocumentType"><code>DocumentType</code></a>
- <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>,
+ or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
- as amended by
- <a href="http://www.w3.org/XML/xml-V10-4e-errata#E02">errata</a>.</p>
  </div>
- <p>The character class <dfn id=class-NameStartChar10><code>NameStartChar10</code></dfn>
+ <div class=ed>
- contains the following characters:</p>
+ <p>ISSUE: In HTML5, Firefox 1.5, and Opera 9, not specifying public or system identifier results in empty strings.</p>
- <ul class=ed>
+ </div>
- </ul>
- <div class="note memo">
+ <p>The <code id=internalSubset>internalSubset</code> attribute of the
- <p>This character class contains all characters allowed as the first character
+ <a href="#DocumentType"><code>DocumentType</code></a> interface is no longer
- of a string matching to the production rule
+ read$B!>(Bonly.</p>
- <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>
- of <abbr>XML</abbr> 1.0
+ <p>On setting, the attribute <em class=rfc2119>MUST</em> raise a
- <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>
+ <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>
- <p>The character class <dfn id=class-NameChar10><code>NameChar10</code></dfn>
+ <div class=section id=section-documenttypedefinition>
- contains the following characters:</p>
+ <h3>The <code>DocumentTypeDefinition</code> Interface</h3>
- <ul>
- <li>The characters in the character class
- <a href="#class-NameStartChar10">NameStartChar10</a>.</li>
- <li class=ed></li>
- </ul>
  <div class="note memo">
- <p>This character class contains all characters allowed as the second
+ <p>This interface is a separated interface from the
- character of a string matching to the production rule
+ <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions
- <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>
+ to the <a href="#DocumentType"><code>DocumentType</code></a>,
- of <abbr>XML</abbr> 1.0
+ for the historical reason.</p>
- <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>
+ </div>
- </div>
+ <p>The
- <p>The character class <dfn id=class-PubidChar><code>PubidChar</code></dfn>
+ <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
- contains the following characters:</p>
+ interface <em class=rfc2119>MUST</em> be implemented as following:</p>
- <ul>
+ <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
- <li><code class=char>U+0009</code> <code class=charname>CHARACTER
+   readonly attribute NamedNodeMap <a href="#elementTypes">elementTypes</a>;
- TABULATION</code></li>
+   readonly attribute NamedNodeMap <a href="#generalEntities">generalEntities</a>;
- <li><code class=char>U+000A</code> <code class=charname>LINE FEED</code></li>
+   readonly attribute NamedNodeMap <a href="#notations">notations</a>;
- <li><code class=char>U+000D</code> <code class=charname>CARRIAGE
- RETURN</code></li>
+   <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#getElementTypeDefinitionNode">getElementTypeDefinitionNode</a>
- <li><code class=char>U+0020</code> <code class=charname>SPACE</code></li>
+     (in DOMString <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>);
- <li><code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code>
+   <a href="#Entity">Entity</a> <a href="#getGeneralEntityNode">getGeneralEntityNode</a>
- (<code class=char>!</code>)</li>
+     (in DOMString <a href="#getGeneralEntityNode-name"><var>name</var></a>);
- <li><code class=char>U+0023</code> <code class=charname>DOLLAR SIGN</code>
+   <a href="#Notation">Notation</a> <a href="#getNotationNode">getNotationNode</a>
- (<code class=char>$</code>)</li>
+     (in DOMString <a href="#getNotationNode-name"><var>name</var></a>);
- <li><code class=char>U+0024</code> <code class=charname>NUMBER SIGN</code>
- (<code class=char>#</code>)</li>
+   void <a href="#setElementTypeDefinitionNode">setElementTypeDefinitionNode</a>
- <li><code class=char>U+0025</code> <code class=charname>PERCENT SIGN</code>
+     (in DOMString <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>)
- (<code class=char>%</code>)</li>
+     raises (DOMException);
- <li><code class=char>U+0027</code> <code class=charname>APOSTROPHE</code>
+   void <a href="#setGeneralEntityNode">setGeneralEntityNode</a>
- (<code class=char>'</code>)</li>
+     (in DOMString <a href="#setGeneralEntityNode-node"><var>node</var></a>)
- <li><code class=char>U+0028</code> <code class=charname>LEFT PARENTHESIS</code>
+     raises (DOMException);
- (<code class=char>(</code>)</li>
+   void <a href="#setNotationNode">setNotationNode</a>
- <li><code class=char>U+0029</code> <code class=charname>RIGHT
+     (in DOMString <a href="#setNotationNode-node"><var>node</var></a>)
- PARENTHESIS</code> (<code class=char>)</code>)</li>
+     raises (DOMException);
- <li><code class=char>U+002A</code> <code class=charname>ASTERISK</code>
+ }</code></pre>
- (<code class=char>*</code>)</li>
- <li><code class=char>U+002B</code> <code class=charname>PLUS SIGN</code>
+ <pre class=ed>
- (<code class=char>+</code>)</li>
+ [1] In an implementation that supports the
- <li><code class=char>U+002C</code> <code class=charname>COMMA</code>
+ [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]
- (<code class=char>,</code>)</li>
+ feature, a [CODE(DOMi)@en[[[DocumentType]]]] node
- <li><code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>
+ must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
- (<code class=char>-</code>)</li>
+ interface.  See [[DOM XML Document Type Definition]>>3] for
- <li><code class=char>U+002E</code> <code class=charname>FULL STOP</code>
+ details.
- (<code class=char>.</code>)</li>
+ </pre>
- <li><code class=char>U+002F</code> <code class=charname>SOLIDUS</code>
- (<code class=char>/</code>)</li>
+ <dl>
- <li><code class=char>U+0030</code> <code class=charname>DIGIT ZERO</code>
+ <dt><dfn id=elementTypes class=dom-attr><code>elementTypes</code></dfn> of
- (<code class=char>0</code>) .. <code class=char>U+0039</code>
+ type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
- <code class=charname>DIGIT NINE</code> (<code class=char>9</code>)</li>
+   <dd><p>A live <code>NamedNodeMap</code> object that contains all the element
- <li><code class=char>U+003A</code> <code class=charname>COLON</code>
+   type definitions belonging to the <code>DocumentType</code> node.</p>
- (<code class=char>:</code>)</li>
- <li><code class=char>U+003B</code> <code class=charname>SEMICOLON</code>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
- (<code class=char>;</code>)</li>
+   <code>NamedNodeMap</code> object that contains all the
- <li><code class=char>U+003D</code> <code class=charname>EQUAL SIGN</code>
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
- (<code class=char>=</code>)</li>
+   nodes belonging to the <code>DocumentType</code> node.  The
- <li><code class=char>U+003F</code> <code class=charname>QUESTION MARK</code>
+   <code>NamedNodeMap</code> object <em class=rfc2119>MUST</em> be read$B!>(Bonly
- (<code class=char>?</code>)</li>
+   if and only if the node is read$B!>(Bonly.  The <code>NamedNodeMap</code>
- <li><code class=char>U+0040</code> <code class=charname>COMMERCIAL AT</code>
+   object <em class=rfc2119>MUST</em> be live and the same object
- (<code class=char>@</code>)</li>
+   <em class=rfc2119>MUST</em> be returned for any invocation.</p>
- <li><code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER
- A</code> (<code class=char>A</code>) .. <code class=char>U+005A</code>
+   <p>If the <code>DocumentType</code> node is created during the process
- <code class=charname>LATIN CAPITAL LETTER Z</code>
+   to create a <abbr>DOM</abbr> from an <abbr>XML</abbr> document, the following
- (<code class=char>Z</code>)</li>
+   requirements are applied:  The <code>NamedNodeMap</code> object in the
- <li><code class=char>U+005F</code> <code class=charname>LOW LINE</code>
+   <a href="#elementTypes"><code>elementType</code></a> attribute
- (<code class=char>_</code>)</li>
+   <em class=rfc2119>MUST</em> be so transformed that the object contains
- <li><code class=char>U+0061</code> <code class=charname>LATIN CAPITAL LETTER
+   the <code>ElementTypeDefinition</code> nodes for the element types
- A</code> (<code class=char>A</code>) .. <code class=char>U+007A</code>
+   whose name is presented as the <code>Name</code> of the element type or
- <code class=charname>LATIN CAPITAL LETTER Z</code>
+   attribute definition list declarations processed by the <abbr>XML</abbr>
- (<code class=char>Z</code>)</li>
+   processor.  If there are more than one element type declarations for an
- </ul>
+   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 live <code>NamedNodeMap</code> object that contains all the general
+   entities belonging to the <code>DocumentType</code> 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
+   <code>DocumentType</code> 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
+ on the information provided by the XML processor for
+ the DOM implementation.  In particular, it might not
+ contain any entity if entity references are expanded
+ at the parse time.  An implementation [['''MUST NOT''']]
+ expose an [CODE(DOMi)@en[[[Entity]]]] node whose [CODE(DOMa)@en[[[nodeName]]]]
+ is equal to the name of one of five predefined general entities in
+ XML through the collection as the result of parsing of an XML
+ document that has no error.  Duplicate entity declarations are also discarded.
+ The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
+ object that contains all the [CODE(DOMi)@en[[[Entity]]]] nodes
+ representing general entities belong to the node.  The returned
+ [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''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.
+ -->
+ <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
+ <code>notations</code>, read$B!>(Bonly</code>
+   <dd><p>A live <code>NamedNodeMap</code> object that contains all the
+   notations belonging to the <code>DocumentType</code> node.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
+   same value as the <code>notations</code> attribute (defined in the
+   <code>DocumentType</code> interface) of the same 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 <code>DocumentType</code>
+     and <code>DocumentTypeDefinition</code> 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]]]]
+ object and only the first declaration [['''MUST''']] be
+ made available as a [CODE(DOMi)@en[[[Notation]]]] node.
+ ;; This definition is based on one for the
+ [CODE(DOMa)@en[[[notations]]]] attribute of the
+ [CODE(DOMi)@en[[[DocumentType]]]] interface in DOM XML module.
+ Since duplication is violation to the Validity Constraint,
+ XML parsers might vary on how notations are notified to
+ the application.  In particular, [CODE(InfoProp)@en[[[notations]]]]
+ property of the document information item in XML Information Set
+ is so defined that in case ''any'' notation is declared for
+ multiple times then the property has no value.
+ The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
+ object that contains all the [CODE(DOMi)@en[[[Notation]]]] nodes
+ representing notations belong to the node.  The returned
+ [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''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.
+ -->
+ <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>
+ <div class=ed>
+ <p>A future version of this interface might define the
+ <code>parameterEntities</code> and getter/setter for parameter entities.
+ </div>
+ </div>
+ <div class=section id=section-elementtypedefinition>
+ <h3>The <code>ElementTypeDefinition</code> Interface</h3>
+ <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>
+ <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 live <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 live and
+   the same object <em class=rfc2119>MUST</em> be returned for any
+   invocation.</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>
+ <div class=ed>
+ <p>A future version of the specification might define a set of attributes
+ and methods for representing and accessing to the content model of the
+ element type.</p>
+ </div>
+ </div>
+ <div class=section id=section-attributedefinition>
+ <h3>The <code>AttributeDefinition</code> Interface</h3>
+ <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;
+   readonly attribute <a href="#ElementTypeDefinition">ElementTypeDefinition</a> <a href="#ownerElementTypeDefinition">ownerElementTypeDefinition</a>;
+   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>
+ <dl>
+ <dt><dfn id=ownerElementTypeDefinition class=dom-attr><code>ownerElementTypeDefinition</code></dfn>
+ of type
+ <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>,
+ read$B!>(Bonly</dt>
+   <dd><p>The
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> to
+   which the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node belongs.</p>
+   <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
+   It <em class=rfc2119>MUST</em> be such a node that whose
+   <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>
+   attribute contains the <code>NamedNodeMap</code> object that contains
+   the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
+   node.  If there is no such an
+   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
+   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.
+   It is expected that this attribute contains a value from the definition group
+   <a href="#DeclaredValueType"><code>DeclaredValueType</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 <code>AttributeDefinition</code> 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="#DeclaredValueType"><code>DeclaredValueType</code></a> constant
+   group <em class=rfc2119>MUST</em> be set to the attribute.</p>
+   <!-- DeclaredValueType -->
+ <p>The definition group
+ <dfn id=DeclaredValueType><code>DeclaredValueType</code></dfn> contains
+ integers indicating the declared type of attributes.  The definition
+ group contains the following constants:</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=NO_TYPE_ATTR class=dom-const><code>NO_TYPE_ATTR</code>
+ <td><code>0</code><td>No value <span class=ed>[INFOSET]</span>.</tr>
+ <tr>
+ <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>
+ <tr>
+ <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>
+ <tr>
+ <th scope=row><dfn id=IDREF_ATTR class=dom-const><code>IDREF_ATTR</code>
+ <td><code>3</code><td><code>IDREF</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=IDREFS_ATTR class=dom-const><code>IDREFS_ATTR</code>
+ <td><code>4</code><td><code>IDREFS</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <th scope=row><dfn id=ENTITY_ATTR class=dom-const><code>ENTITY_ATTR</code>
+ <td><code>5</code><td><code>ENTITY</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <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>
+ <tr>
+ <th scope=row><dfn id=NMTOKEN_ATTR class=dom-const><code>NMTOKEN_ATTR</code>
+ <td><code>7</code><td><code>NMTOKEN</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <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>
+ <tr>
+ <th scope=row><dfn id=NOTATION_ATTR class=dom-const><code>NOTATION_ATTR</code>
+ <td><code>9</code><td><code>NOTATION</code> <span class=ed>[XML]</span>.</tr>
+ <tr>
+ <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>
+ <tr>
+ <th scope=row><dfn id=UNKNOWN_ATTR class=dom-const><code>UNKNOWN_ATTR</code>
+ <td><code>11</code><td>Unknown, because no declaration for the attribute
+ has been read but the [all declaration processed] property
+ <span class=ed>[INFOSET]</span> would be false.</tr>
+ </tbody>
+ </table>
+ <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>
+ <span class=ed>[INFOSET]</span>, then the value
+ <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>
+ <em class=rfc2119>MUST</em> be used.</p>
  <div class="note memo">
- <p>This character class contains all characters allowed in the production rule
+ <p>An <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node
- <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-PubidChar"><code>PubidChar</code></a>
+ created by the
- of <abbr>XML</abbr> 1.0
+ <a href="#createAttributeDefinition"><code>createAttributeDefinition</code></a>
- <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>
+ method has its <a href="#declaredType"><code>declaredType</code></a> attribute
+ set to <a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</p>
+ </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>

 Legend:



Removed from v.1.1
 


changed lines


 
Added in v.1.21
 Legend:



Removed from v.1.1
 


changed lines


 
Added in v.1.21
-Removed from v.1.1
+Added in v.1.21

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24