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

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

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

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

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.19

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24