/[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.5 by wakaba, Sun Dec 2 05:32:03 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-01>1 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  <div class=section id=error-categories>  <p class=ed><var>A</var> object is an object implementing <var>A</var>
125  <h2>Error Classification</h2>  interface.</p>
126    
127  <p class=ed>If a <code>Document</code> node has no  <p class=ed>@@ ref to DOM Binding Spec</p>
 xml-well-formedness-error, entity-error, and unknown-error,  
 then it is well-formed.  If a well-formed <code>Document</code>  
 node has no xml-validity-error, it is valid.</p>  
   
 <div class="note memo">  
 <p>A well$B!>(Bformed <code>Document</code> can be safely serialized  
 into a well$B!>(Bformed XML document.  A valid <code>Document</code>  
 can be easily serialized into a valid XML document.</p>  
128  </div>  </div>
129    
130  <p class=ed>To be a conforming <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#dt-validating">validating XML processor</a>,  <div class=section id=dom-dtdef>
131  ...</p>  <h2><abbr>DOM</abbr> Document Type Definition Module</h2>
   
 <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>  
   
 </div>  
   
 <div class=section id=parsing-xml>  
 <h2>Parsing <abbr>XML</abbr> Document</h2>  
132    
133    <p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0,
134    consists of three interfaces:</p>
135  <ul>  <ul>
136  <li>If the <abbr>XML</abbr> document does not begin with an  <li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>
137  <abbr>XML</abbr> declaration, then raise an  <li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>
138  <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>
139  <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."  
   
 -->  
140  </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>  
   
 </div>  
141    
142  <div class=section id=checking-node>  <p>In addition, it adds methods, attributes, and/or constants to interfaces
143  <h3>Checking <code>Node</code></h3>  <a href="#Node"><code>Node</code></a>,
144    <a href="#Entity"><code>Entity</code></a>,
145  <p>The algorithm <dfn title="to check a node" id=algorithm-to-check-a-node>to  <a href="#EntityReference"><code>EntityReference</code></a>, and
146  check a node (<dfn id=var-n><var>n</var></dfn>)</dfn> is defined as  <a href="#Notation"><code>Notation</code></a>.
147  following:</p>  It modifies semantics of some of methods and attributes in
148  <dl class=switch>  <a href="#Node"><code>Node</code></a> and
149  <dt>If <var>n</var> is an <code>Attr</code> node</dt>  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>
150    <dd>  interfaces, for the support of new interfaces.</p>
151      <ol>  
152      <li><a href="#algorithm-to-validate-an-ncname">Validate the  <div class=section id=features>
153      <code>localName</code> attribute value as an <code>NCName</code></a>.</li>  <h3>Feature Name</h3>
154      <li>If the <code>prefix</code> attribute value is different from  
155      <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate  <p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of
156      the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>  the <abbr>DOM</abbr> Document Type Definition module, the
157      <li>For each node <dfn id=var-attr-nc><var>n<sub><var>c</var></sub></var></dfn> in the  <code>hasFeature</code> method of a <code>DOMImplementation</code> object
158      <code>childNodes</code> list of <var>n</var>,  <em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
159        <ol>  set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
160        <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a  <code>3.0</code> respectively.</p>
161        <code>Text</code> or <code>EntityReference</code> node, then it is an  
162        <a href="#xml-well-formedness-error" id=wfe-attr-child><code>xml-well-formedness-error</code></a>.</li>  <p>In such an implementation, the <code>getFeature</code> method of a
163        <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  <code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
164        <code>EntityReference</code> node, then it is an  conceptually) same object implementing the
165        <a href="#entity-error" id=ee-attr-er><code>entity-error</code></a>.</li>  <a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
166        <li>Otherwise,  the parameters are set to
167        <a href="#algorithm-to-check-a-node" title="check a node">check  <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and
168        <var>n<sub><var>c</var></sub></var></a> recusrively.</li>  <code>3.0</code> respectively.  Likewise, any method that takes one or more
169        </ol></li>  feature names with or without version number, including the methods
170      <li>If <code>nodeName</code> attribute of <var>n</var> is  <code>hasFeature</code> and <code>getFeature</code>,
171      <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>  <em class=rfc2119>MUST</em> behave in a manner consistent with the
172      and <code>value</code> attribute of <var>n</var> is neither  aforementioned cases.</p>
173      <code>default</code> nor <code>preserve</code>, then it is an  </div>
174      <a href="#xml-misc-error" id=xme-attr-xml-space><code>xml-misc-error</code></a>.<!--  
175      Note that <!ATTLIST e xml:space (default|preserve) "a">...  <div class=section id=section-documentxdoctype>
176      <e xml:space="default"/> is conforming and valid. --></li>  <h2>The <code>DocumentXDoctype</code> Interface</h2>
177      <li class=ed>@@ xml:lang value is not a language tag [RFC 3066 or its  
178      successor] or an empty string, then xml-misc-warning  <pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
179      (a "fact"-level error; not an XML error).</li>    DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
180      <li class=ed>@@ <code>specified</code>,      (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
181      <code>manakaiAttributeType</code> (#ValueType Validity constraint: Attribute Value Type)</li>      raises (DOMException);
182      <!-- xml:space MUST be declared to be valid. -->    ElementTypeDefinition <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
183      <li>Let <dfn id=var-v><var>v</var></dfn> be the value of the      (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
184      attribute <code>value</code> of <var>n</var>.</li>      raises (DOMException);
185      <li>Validate the <var>n</var> against the <span class=ed>declared    AttributeDefinition <a href="#createAttributeDefinition">createAttributeDefinition</a>
186      type</span> as following:      (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
187        <dl class=switch>      raises (DOMException);
188        <dt class=ed><code>ID_ATTR</code></dt>    Entity <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
189          <dd>      (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
190            <ol>      raises (DOMException);
191            <li><span class=ed>Validate <var>v</var> as an    Notation <a href="#createNotation">createNotation</a>
192            <code>Name</code>.</span>  If it fails, then raise an      (in DOMString <a href="#createNotation-name"><var>name</var></a>)
193            <a href="#xml-validity-error" id=vc-id-name><code>xml-validity-error</code></a>.</li>      raises (DOMException);
194            <li><span class=ed>If <code>ID</code> <var>v</var> is defined,</span>  }</code></pre>
195            then raise an    
196            <a href="#xml-validity-error" id=vc-id-duplication><code>xml-validity-error</code></a>.</li>  <div class=ed>@@ cast definition</div>
197            </ol>  
198          </dd>  <dl>
199        <dt class=ed>IDREF_ATTR</dt>  <dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
200          <dd>  method</dt>
201            <ol>    <dd>
202            <li><span class=ed>Validate <var>v</var> as an      <p>This method creates a <code>DocumentType</code> node with the specified
203            <code>Name</code>.</span>  If it fails, then raise an      name, belonging to the document.</p>
204            <a href="#xml-validity-error" id=vc-idref-name><code>xml-validity-error</code></a>.</li>      <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
205            <li><span class=ed>If <code>ID</code> <var>v</var> is NOT      parameter is the name of the document type.</p>
206            defined,</span> then raise an    
207            <a href="#xml-validity-error" id=vc-idref-match><code>xml-validity-error</code></a>.</li>      <p>When invoked, the method <em class=rfc2119>MUST</em> create and
208            </ol>      return a <code>DocumentType</code> node with the following attributes:</p>
209          </dd>      <dl>
210        <dt class=ed>IDREFS_ATTR</dt>      <dt><code>attributes</code>, <code>parentNode</code></dt>
211          <dd class=ed>@@</dd>        <dd><code>null</code>.</dd>
212        <dt class=ed>ENTITY_ATTR</dt>      <dt><code>elementTypes</code>, <code>generalEntities</code>, and
213          <dd>      <code>notations</code></dt>
214            <ol>        <dd>Empty <code>NamedNodeMap</code> objects.</dd>
215            <li><span class=ed>Validate <var>v</var> as an      <dt><code>entities</code></dt>
216            <code>Name</code>.</span>  If it fails, then raise an        <dd>The same value as the <code>generalEntities</code> attribute.</dd>
217            <a href="#xml-validity-error" id=vc-entname-name><code>xml-validity-error</code></a>.</li>      <dt><code>childNodes</code></dt>
218            <li><span class=ed>If <code>Entity</code> <var>v</var> is NOT        <dd>An empty <code>NodeList</code> object.</dd>
219            defined,</span> then raise an        <dt><code>internalSubset</code>, <code>publicId</code>, and
220            <a href="#xml-validity-error" id=vc-entname-match><code>xml-validity-error</code></a>.</li>      <code>systemId</code></dt>
221            </ol>        <dd>Empty strings.</dd>
222          </dd>      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
223        <dt class=ed>ENTITIES_ATTR</dt>        <dd><code>false</code>.</dd>
224          <dd class=ed>@@</dd>      <dt><code>nodeName</code></dt>
225        <dt class=ed>NMTOKEN_ATTR</dt>        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
226          <dd>      <dt><code>ownerDocument</code></dt>
227            <ol>        <dd>The <code>Document</code> over which the method is invoked.</dd>
228            <li><span class=ed>Validate <var>v</var> as an      </dl>
229            <code>Nmtoken</code>.</span>  If it fails, then raise an      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
230            <a href="#xml-validity-error" id=vc-nmtok-name><code>xml-validity-error</code></a>.</li>      containing five general entity declarations: <code>amp</code>,
231            </ol>      <code>lt</code>, <code>gt</code>, <code>quot</code>, and
232          </dd>      <code>apos</code>.</p>
233        <dt class=ed>NMTOKENS_ATTR</dt>    </dd>
234          <dd class=ed>@@</dd>  <dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
235        <dt class=ed>NOTATION_ATTR</dt>  method</dt>
236          <dd class=ed><var>v</var> must be one of enumerated values.    <dd>
237          If not, then raise an      <p>This method creates a <code>ElementTypeDefinition</code> node with the
238          <a href="#xml-validity-error" id=vc-notatn-match><code>xml-validity-error</code></a>.</dd>      specified name, belonging to the document.</p>
239        <dt class=ed>ENUMERATED_ATTR</dt>      <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
240          <dd class=ed><var>v</var> must be one of enumerated values.      parameter is the name of the element type defined by the element
241          If not, then raise an      type definition.</p>
242          <a href="#xml-validity-error" id=vc-enum><code>xml-validity-error</code></a>.</dd>    </dd>
243        <dt class=ed>@@</dt>  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
244        </dl>  method</dt>
245      </li>    <dd>
246      <li>If <span class=ed>type ID and default is NOT #IMPLIED or #REQUIRED</span>, then      <p>This method creates a <code>AttributeDefinition</code> node with the
247      raise an      specified name, belonging to the document.</p>
248      <a href="#xml-validity-error" id=vc-id-default><code>xml-validity-error</code></a>.</li>      <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
249      <li class=ed>@@ #FixedAttr Validity constraint: Fixed Attribute Default</li>      parameter is the name of the attribute defined by the attribute
250      <li class=ed>@@ strict serialization error for U+000D, U+000A, and      definition.</p>
251      U+0009 characters, leading/trailing U+0020, and U+0020{2,} string?</li>    </dd>
252      </ol>  <dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
253    </dd>  method</dt>
254  <dt>If <var>n</var> is an <code>AttributeDefinition</code> node</dt>    <dd>
255    <dd>      <p>This method creates a <code>Entity</code> node with the
256      <ol>      specified name, which represents a general entity, belonging to the
257      <li class=ed></li>      document.</p>
258      <li>If <code>nodeName</code> attribute of <var>n</var> is      <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
259      <code>xml:space</code> <span class=ed>@@ or {xml namespace}:space ?</span>      parameter is the name of the general entity.</p>
260      and <span class=ed>its declared type is different from (default|preserve),    </dd>
261      (default), or (preserve)</span>, then raise an  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
262      <a href="#xml-misc-error" id=xme-at-xml-space><code>xml-misc-error</code></a>.</li>  method</dt>
263      <li>For each node <dfn id=var-ad-nc><var>n<sub><var>c</var></sub></var></dfn> in the    <dd>
264      <code>childNodes</code> list of <var>n</var>,      <p>This method creates a <code>Notation</code> node with the
265        <ol>      specified name, belonging to the document.</p>
266        <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a      <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
267        <code>Text</code> or <code>EntityReference</code> node, then it is an      parameter is the name of the notation.</p>
       <a href="#xml-well-formedness-error" id=wfe-at-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-at-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>  
       </ol></li>  
     <li class=ed>If <code>NOTATION_ATTR</code>, enumerated values MUST  
     be declared.  If not, then raise an  
     <a href="#xml-validity-error" id=vc-notatn-declared><code>xml-validity-error</code></a>.</li>  
     <li class=ed>If <code>NOTATION_ATTR</code> or <code>ENUMERATED_ATTR</code>,  
     values MUST all be distinct.  If not, then raise an  
     <a href="#xml-validity-error" id=vc-no-duplicate-tokens><code>xml-validity-error</code></a>.</li>  
     <li class=ed>If <code>NOTATION_ATTR</code> on an <code>EMPTY</code>  
     element, then raise an  
     <a href="#xml-validity-error" id=vc-no-notation-empty><code>xml-validity-error</code></a>.</li>  
     <li class=ed>@@ #defattrvalid Validity constraint: Attribute Default Value Syntactically Correct</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>CDATASection</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the  
     <code>data</code> attribute value as an <abbr>XML</abbr> character  
     data</a>.</li>  
     <li>If the <code>data</code> attribute value contains  
     a string <code>]]></code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-cs-mse><code>xml-well-formedness-error</code></a>.<!-- "for compatibility" --></li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-cs-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Comment</code> node</dt>  
   <dd>  
     <ol>  
     <li>Raise an  
     <a href="#round-trip-warning" id=rtw-comment><code>round-trip-warning</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-xml-character-data" title="validate an XML string">Validate the  
     <code>data</code> attribute value as an <abbr>XML</abbr> character  
     data</a>.</li>  
     <li>If the <code>data</code> attribute value contains  
     a string <code>--</code>, or if it ends with a character  
     <code>-</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-comment-com><code>xml-well-formedness-error</code></a>.<!--  
     "for compatibility" --></li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-comment-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Document</code> node</dt>  
   <dd>  
     <ol>  
     <li>If <a href="#xml-version"><abbr>XML</abbr> version</a> of <var>n</var>  
     is different from <code>1.0</code> or <code>1.1</code>,  
     then it is an <code class=ed>unknown-error?</code>.</li>  
     <li>If the <code>xmlEncoding</code> attribute value does <em>not</em>  
     match to <code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code>  
     <span class=ed>@@ formal def</span>, then it is an  
     <a href="#xml-well-formedness-error" id=wfe-encoding><code>xml-well-formedness-error</code></a>.</li>  
     <li>The <code>childNodes</code> list of <var>n</var> have to  
     consist of zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes, followed by  
     an optional <code>DocumentType</code> node, followed  
     by zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes, followed by  
     an <code>Element</code> node, followed  
     by zero or more <code>Comment</code> and/or  
     <code>ProcessingInstruction</code> nodes.  Any violation to this is an  
     <a href="#xml-well-formedness-error" id=wfe-document-child><code>xml-well-formedness-error</code></a>.</li>  
     <li>For each node <dfn id=var-document-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>EntityReference</code> node, then  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     <li class=ed>@@ <code>allDeclarationsProcessed</code></li>  
     </ol>  
268    </dd>    </dd>
 <dt>If <var>n</var> is a <code>DocumentFragment</code> node</dt>  
   <dd>  
     <ol>  
     <li>For each node <dfn id=var-df-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>, <code>Text</code>, <code>CDATASection</code>,  
       <code>Comment</code>, <code>ProcessingInstruction</code>, or  
       <code>EntityReference</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-df-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-df-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>DocumentType</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>Follow the following substeps:  
       <ol>  
       <li>If <code>ownerDocument</code> attribute of <var>n</var> is  
       <code>null</code>, then abort these substeps.</li>  
       <li>If <code>documentElement</code> attribute of the node  
       set to <code>ownerDocument</code> attribute of <var>n</var> is  
       <code>null</code>, then abort these substeps.</li>  
       <li>If <code>nodeName</code> attribute of the node set to  
       <code>documentElement</code> attribute of the node set to  
       <code>ownerDocument</code> attribute of <var>n</var> is  
       different from <code>nodeName</code> of <var>n</var>,  
       then raise an  
       <a href="#xml-validity-error" id=vc-roottype><code>xml-validity-error</code></a>.</li></li>  
       </ol>  
     </li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>publicId</code> attribute value of <var>n</var> is  
     <em>not</em> <code>null</code> and the <code>systemId</code> attribute  
     value of <var>n</var> is <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-dt-sid><code>xml-well-formedness-error</code></a>.  
     <span class=ed>@@ publicId == null?  Or, publicId == ""</span></li>  
     <li>For each node <dfn id=var-dt-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> a  
       <code>ProcessingInstruction</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-dt-child><code>xml-well-formedness-error</code></a>.  
       <span class=ed>@@ ref to manakai's extensions</span></li>  
       <li>Otherwise, <!-- if n_c is not an EntityReference node, -->  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recusrively.</li>  
       </ol></li>  
     <li>For each node in the <code>entities</code>, <code>notations</code>,  
     and <code>elementTypes</code> lists of <var>n</var>,  
     <a href="#algorithm-to-check-a-node" title="check a node">check the  
     node</a> recursively.</li>  
     <li class=ed>@@ externally declared?</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Element</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>localName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>If the <code>prefix</code> attribute value is different from  
     <code>null</code>, then <a href="#algorithm-to-validate-an-ncname">validate  
     the <code>prefix</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>For each node <dfn id=var-element-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or  
       <code>EntityReference</code> node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-element-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-element-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     <li class=ed>@@ #elementvalid Validity constraint: Element Valid</li>  
     <li>Let <var>attrs</var> be the value of the <code>attribute</code>  
     attribute of <var>n</var>.  Check conformance of <var>attrs</var>  
     as following:  
       <ol>  
       <li>If <var>attrs</var> contains an <code>Attr</code> node whose  
       <code>nodeName</code> attribute value is equal to that of another  
       <code>Attr</code> node in <var>attrs</var>, then raise an  
       <a href="#xml-well-formedness-error" id=wfe-uniqattspec><code>xml-well-formedness-error</code></a>.<!--  
       #uniqattspec Well-formedness constraint: Unique Att Spec --></li>  
       <li class=ed>@@ #RequiredAttr Validity constraint: Required Attribute</li>  
       </ol>  
     </li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>ElementTypeDefinition</code> node</dt>  
   <dd>  
     <ol>  
     <li class=ed></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-et-child><code>xml-well-formedness-error</code></a>.</li>  
     <li class=ed>@@ <q cite="http://www.w3.org/TR/2006/REC-xml-20060816/#elemdecls">At user option, an XML processor MAY issue a warning when a declaration mentions an element type for which no declaration is provided, but this is not an error.</q></li>  
     <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>  
     <li class=ed>@@ #vc-MixedChildrenUnique  
     Validity constraint: No Duplicate Types</li>  
     <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>  
     <li>If there is more than one <code>AttributeDefinition</code> node  
     with <span class=ed>attribute type <code>ID</code></span> in the  
     <code>NamedNodeMap</code> list contained in the  
     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an  
     <a href="#xml-validity-error" id=vc-one-id-per-el><code>xml-validity-error</code></a>.</li>  
     <li>If there is more than one <code>AttributeDefinition</code> node  
     with <span class=ed>attribute type <code>NOTATION</code></span> in the  
     <code>NamedNodeMap</code> list contained in the  
     <code>attributeDefinitions</code> attribute of <var>n</var>, then raise an  
     <a href="#xml-validity-error" id=vc-one-notation-per><code>xml-validity-error</code></a>.</li>  
     <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>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Entity</code> node whose  
 <code>notationName</code> attribute value is <code>null</code> (i.e. a  
 parsed entity)</dt>  
   <dd>  
     <ol>  
     <li>Raise an  
     <a href="#entity-error" id=ee-entity-node><code>entity-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>publicId</code> attribute value of <var>n</var> is  
     <em>not</em> <code>null</code> and the <code>systemId</code> attribute  
     value of <var>n</var> is <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-entity-sid><code>xml-well-formedness-error</code></a>.</li>  
     <li>For each node <dfn id=var-entity-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or <code>EntityReference</code>  
       node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-entity-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-er-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>Entity</code> node whose  
 <code>notationName</code> attribute value is <em>not</em> <code>null</code>  
 (i.e. an unparsed entity)</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>systemId</code> attribute value of <var>n</var> is  
     <code>null</code>, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-uentity-sid><code>xml-well-formedness-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>notationName</code> attribute value of <var>n</var> as an  
     <code>NCName</code></a>.</li>  
     <li class=ed>@@ #not-declared Validity constraint: Notation Declared</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-uentity-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is an <code>EntityReference</code> node</dt>  
   <dd>  
     <ol>  
     <li>An <a href="#entity-error" id=ee-er-node><code>entity-error</code></a>.</li>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>For each node <dfn id=var-er-nc><var>n<sub><var>c</var></sub></var></dfn>  
     in the <code>childNodes</code> list of <var>n</var>,  
       <ol>  
       <li>If <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>Element</code>,  
       <code>Text</code>, <code>CDATASection</code>, <code>Comment</code>,  
       <code>ProcessingInstruction</code>, or <code>EntityReference</code>  
       node, then it is an  
       <a href="#xml-well-formedness-error" id=wfe-er-child><code>xml-well-formedness-error</code></a>.</li>  
       <li>Otherwise, if <var>n<sub><var>c</var></sub></var> is <em>not</em> an  
       <code>EntityReference</code> node, then it is an  
       <a href="#entity-error" id=ee-entity-er><code>entity-error</code></a>.</li>  
       <li>Otherwise,  
       <a href="#algorithm-to-check-a-node" title="check a node">check  
       <var>n<sub><var>c</var></sub></var></a> recursively.</li>  
       </ol></li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Notation</code> node</dt>  
   <dd>  
     <ol>  
     <li><a href="#algorithm-to-validate-an-ncname">Validate the  
     <code>nodeName</code> attribute value as an <code>NCName</code></a>.</li>  
     <li><a href="#algorithm-to-validate-a-public-identifier" title="validate a public identifier">Validate  
     the <code>publicId</code> attribute value as a public identifier</a>.</li>  
     <li><a href="#algorithm-to-validate-a-system-identifier" title="validate a system identifier">Validate  
     the <code>systemId</code> attribute value as a system identifier</a>.</li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-notation-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>ProcessingInstruction</code> node</dt>  
   <dd>  
     <ol>  
     <li>If the <code>target</code> attribute value matches to the string  
     <code>xml</code> in any case combination, then raise a  
     <a href="#xml-well-formedness-error" id=wfe-pi-xml><code>xml-well-formedness-error</code></a>.</li>  
     <li>Otherwise, <a href="#algorithm-to-validate-an-ncname">validate the  
     <code>target</code> attribute value as an <code>NCName</code></a>.</li>  
     <li>Then,  
     <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 a  
     <a href="#xml-well-formedness-error" id=wfe-pi-pic><code>xml-well-formedness-error</code></a>.</li>  
     <li>If the <code>data</code> attribute value starts with either  
     <code class=char>U+0009</code> <code class=charname>CHARACTER  
     TABULATION</code>, <code class=char>U+000A</code> <code class=charname>LINE  
     FEED</code>, <code class=char>U+000D</code> <code class=charname>CARRIAGE  
     RETURN</code>, or <code class=char>U+0020</code>  
     <code class=charname>SPACE</code> character, then raise a  
     <a href="#round-trip-error" id=rte-pi-s><code>round-trip-error</code></a>.</li>  
     <li>If the <code>childNodes</code> list of <var>n</var> contains  
     any nodes, then raise an  
     <a href="#xml-well-formedness-error" id=wfe-pi-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>If <var>n</var> is a <code>Text</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>childNodes</code> list of <var>n</var> contains  
     any nodes, they are in  
     <a href="#xml-well-formedness-error" id=wfe-text-child><code>xml-well-formedness-error</code></a>.</li>  
     </ol>  
   </dd>  
 <dt>Otherwise</dt>  
   <dd><span class=ed>xml-well-formedness-error?  unknown-error?</span></dd>  
269  </dl>  </dl>
270    
271  </div>  <pre class=ed>
272    
273    [8]
274    The [CODE(DOMm)@en[[[createElementTypeDefinition]]]]
275    method [['''MUST''']] create an
276    [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
277    object with the following attribute values:
278    - [CODE(DOMa)@en[[[attributeDefinitions]]]]:
279    An empty [CODE(DOMi)@en[[[NamedNodeMap]]]].
280    - [CODE(DOMa)@en[[[attributes]]]],
281    [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
282    - [CODE(DOMa)@en[[[childNodes]]]]: An empty
283    [CODE(DOMi)@en[[[NodeList]]]].
284    - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
285    [CODE(IDL)@en[[[false]]]].
286    - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
287    - [CODE(DOMa)@en[[[ownerDocument]]]]: The
288    [CODE(DOMi)@en[[[Document]]]] node on which the method
289    is invoked.
290    - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
291    [CODE(IDL)@en[[[null]]]].
292    
293    @@ Ensure all attributes are defined
294    
295    [9] The [CODE(DOMm)@en[[[createAttributeDefinition]]]]
296    method [['''MUST''']] create an
297    [CODE(DOMi)@en[[[AttributeDefinition]]]]
298    object with the following attribute values:
299    - [CODE(DOMa)@en[[[allowedTokens]]]]:
300    An empty [CODE(DOMi)@en[[[DOMStringList]]]].
301    - [CODE(DOMa)@en[[[attributes]]]],
302    [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
303    - [CODE(DOMa)@en[[[childNodes]]]]: An empty
304    [CODE(DOMi)@en[[[NodeList]]]].
305    - [CODE(DOMa)@en[[[declaredType]]]]:
306    [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
307    - [CODE(DOMa)@en[[[defaultType]]]]:
308    [CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]].
309    - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
310    [CODE(IDL)@en[[[false]]]].
311    - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
312    - [CODE(DOMa)@en[[[ownerDocument]]]]: The
313    [CODE(DOMi)@en[[[Document]]]] node on which the method
314    is invoked.
315    - [CODE(DOMa)@en[[[ownerElementTypeDefinition]]]]:
316    [CODE(IDL)@en[[[null]]]].
317    
318    @@ Ensure all attributes are defined
319    
320    @@ Should we keep these statements?:
321    However, if the <cfg::cfg|xml-id> configuration
322    parameter is set to <DOM::true> and the <P::name>
323    is <XA::xml:id>, then the [CODE(DOMa)@en[[[declaredType]]]]
324    attribute is set to
325    <C::AttributeDefinition.ID_ATTR>.
326    [CODE(DOMa)@en[[[defaultType]]]]?
327    
328    [11] The [CODE(DOMm)@en[[[createGeneralEntity]]]]
329    method [['''MUST''']] create an [CODE(DOMi)@en[[[Entity]]]]
330    node with the following attribute values:
331    - [CODE(DOMa)@en[[[attributes]]]],
332    [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
333    - [CODE(DOMa)@en[[[childNodes]]]]: An empty
334    [CODE(DOMi)@en[[[NodeList]]]].
335    - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
336    No explicit value is set.
337    - [CODE(DOMa)@en[[[manakaiEntityBaseURI]]]]:
338    No explicit value is set.
339    - [CODE(DOMa)@en[[[manakaiEntityURI]]]]:
340    No explicit value is set.
341    - [CODE(DOMa)@en[[[manakaiHasReplacementTree]]]]:
342    [CODE(IDL)@en[[[false]]]].
343    - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
344    [CODE(IDL)@en[[[false]]]].
345    - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
346    - [CODE(DOMa)@en[[[notationName]]]]: [CODE(DOM)@en[[[null]]]].
347    - [CODE(DOMa)@en[[[ownerDocument]]]]: The
348    [CODE(DOMi)@en[[[Document]]]] node on which the method
349    is invoked.
350    - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
351    [CODE(IDL)@en[[[null]]]].
352    - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
353    - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].
354    
355    @@ Ensure all attributes are defined
356    
357    @@ publicId and systemId should be empty string?
358    
359    [13] The [CODE(DOMm)@en[[[createNotation]]]]
360    method [['''MUST''']] create a [CODE(DOMi)@en[[[Notation]]]]
361    node with the following attribute values:
362    - [CODE(DOMa)@en[[[attributes]]]],
363    [CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
364    - [CODE(DOMa)@en[[[childNodes]]]]: An empty
365    [CODE(DOMi)@en[[[NodeList]]]].
366    - [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
367    No explicit value is set.
368    - [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
369    [CODE(IDL)@en[[[false]]]].
370    - [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
371    - [CODE(DOMa)@en[[[ownerDocument]]]]: The
372    [CODE(DOMi)@en[[[Document]]]] node on which the method
373    is invoked.
374    - [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
375    [CODE(IDL)@en[[[null]]]].
376    - [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
377    - [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].
378    
379    @@ Ensure all attributes are defined
380    
381    [7]
382    These method [['''MUST''']] raise an
383    [CODE(DOMi)@en[[[INVALID_CHARACTER_ERR]]]]
384    [CODE(DOMi)@en[[[DOMException]]]]
385    if the [CODE(DOMp)@en[[[name]]]] is not a legal
386    name according to the XML version in use as
387    specified in the [CODE(DOMa)@en[[[xmlVersion]]]]
388    attribute of the [CODE(DOMi)@en[[[Document]]]] node.
389    
390    ;; Non-XML case is intentionally left unspecified for now
391    since DOM3 does not define it.
392    
393    ;; [CODE(DOMp)@en[[[name]]]] does not have to
394    be a namespace qualified name.
395    
396    ;; Note also that it is not an error for the
397    [CODE(DOMp)@en[[[name]]]] parameter value
398    to match to the name of one of predefined general
399    parsed entities in XML or HTML.
400    
401    ;; If the [CODE(DOMa)@en[[[strictErrorChecking]]]] attribute
402    is set to [CODE(IDL)@en[[[false]]]], then the implementation
403    is not required to raise this exception.
404    
405    Otherwise, these method [['''MUST''']] return
406    the newly created node.
407    </pre>
408    
409    </div>
410    
411    <div class=section id=section-documenttypedefinition>
412    <h2>The <code>DocumentTypeDefinition</code> Interface</h2>
413    
414    <pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
415      
416    }</code></pre>
417    
418    <pre class=ed>
419    [1] In an implementation that supports the
420    [CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]
421    feature, a [CODE(DOMi)@en[[[DocumentType]]]] node
422    must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
423    interface.  See [[DOM XML Document Type Definition]>>3] for
424    details.
425    
426    
427    ** Children
428    
429    [2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]
430    of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
431    is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that
432    contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
433    node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
434    The attribute is read-only.
435    
436    What are contained in this collection depends on how
437    the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the
438    node was created as the result of parsing of an XML document,
439    it [['''MUST''']]  contain all element types whose element type and / or
440    attribute definition list declaration are encountered by and provided for the DOM
441    implementation from the XML processor.  Note that the XML processor might not
442    provide a part of or entire such information depending on the configuration.
443    If more than one declarations for an element type or an attribute is available
444    at the time of the definition node construction, then declarations other than
445    the first ones [['''MUST''']] be discarded.
446    
447    The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
448    object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes
449    belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object
450    [['''MUST''']] be read-only if and only if the node is read-only.
451    Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
452    and therefore any change of read-only flag on the node is immediately
453    reflected by that of the object.
454    
455    [3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]
456    of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
457    is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the
458    general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.
459    The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
460    The attribute is read-only.
461    
462    All entities declared in the document type definition
463    contained in or referenced from the document entity
464    might not be exposed through this collection, depending
465    on the information provided by the XML processor for
466    the DOM implementation.  In particular, it might not
467    contain any entity if entity references are expanded
468    at the parse time.  An implementation [['''MUST NOT''']]
469    expose an [CODE(DOMi)@en[[[Entity]]]] node whose [CODE(DOMa)@en[[[nodeName]]]]
470    is equal to the name of one of five predefined general entities in
471    XML through the collection as the result of parsing of an XML
472    document that has no error.  Duplicate entity declarations are also discarded.
473    
474    The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
475    object that contains all the [CODE(DOMi)@en[[[Entity]]]] nodes
476    representing general entities belong to the node.  The returned
477    [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if
478    the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
479    and therefore any change of read-only flag on the node is immediately
480    reflected by that of the object.
481    
482    The attribute [['''MUST''']] return the same value as the
483    [CODE(DOMa)@en[[[entites]]]] attribute of the
484    [CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.
485    
486    [4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]
487    of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
488    is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains
489    all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
490    node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
491    The attribute is read-only.
492    
493    If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
494    created from an XML document, duplicate notation declarations, if any, in DTD
495    [['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]
496    object and only the first declaration [['''MUST''']] be
497    made available as a [CODE(DOMi)@en[[[Notation]]]] node.
498    
499    ;; This definition is based on one for the
500    [CODE(DOMa)@en[[[notations]]]] attribute of the
501    [CODE(DOMi)@en[[[DocumentType]]]] interface in DOM XML module.
502    Since duplication is violation to the Validity Constraint,
503    XML parsers might vary on how notations are notified to
504    the application.  In particular, [CODE(InfoProp)@en[[[notations]]]]
505    property of the document information item in XML Information Set
506    is so defined that in case ''any'' notation is declared for
507    multiple times then the property has no value.
508    
509    The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
510    object that contains all the [CODE(DOMi)@en[[[Notation]]]] nodes
511    representing notations belong to the node.  The returned
512    [CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if
513    the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
514    and therefore any change of read-only flag on the node is immediately
515    reflected by that of the object.
516    
517    A DOM implementation is not required to implement the
518    [CODE(DOMa)@en[[[notations]]]] attribute twice
519    for the [CODE(DOMi)@en[[[DocumentType]]]] and
520    the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;
521    the latter is defined to contain the same value as the former.
522    
523    
524    ** Open Issues (informative)
525    
526    [5] A future version of the interface might define the
527    [CODE(DOMa)@en[[[parameterEntities]]]] attribute and
528    getter/setter for parameter entities.
529    </pre>
530    </div>
531    
532    <div class=section id=section-elementtypedefinition>
533    <h2>The <code>ElementTypeDefinition</code> Interface</h2>
534    
535    <pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {
536      
537    }</code></pre>
538    
539    <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
540    
541    [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
542    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
543    [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
544    
545    [4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
546    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
547    [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
548    of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
549    [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.
550    Note that it might be [CODE(IDL)@en[[[null]]]].
551    
552    [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
553    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
554    [['''MUST''']] return the name of the element type.
555    
556    [2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]]
557    and [CODE(DOMa)@en[[[textContent]]]] attributes
558    of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
559    object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
560    
561    ;; Thus, the setter of these attributes do nothing.
562    
563    The setter of the [CODE(DOMa)@en[[[textContent]]]]
564    attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
565    object [['''MUST NOT''']] throw a
566    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
567    
568    ** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface
569    
570    [5] The
571    [DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
572    of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
573    interface is defined in [[manakai//DOM Extensions]>>50].</pre>
574    </div>
575    
576    <div class=section id=section-attributedefinition>
577    <h2>The <code>AttributeDefinition</code> Interface</h2>
578    
579    <pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {
580      
581    }</code></pre>
582    
583    <pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members
584    
585    [3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
586    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
587    [['''MUST''']] return [CODE(IDL)@en[[[null]]]].
588    
589    [9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
590    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
591    [['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
592    of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
593    [CODE(DOMi)@en[[[AttributeDefinition]]]] object.
594    Note that it might be [CODE(IDL)@en[[[null]]]].
595    
596    [1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
597    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
598    [['''MUST''']] return the name of the attribute.
599    
600    [2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
601    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
602    [['''MUST''']] return the normalized default value
603    of the attribute.
604    
605    @@
606    
607    [4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
608    attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]]
609    object [['''MUST''']] behave as if it were an
610    [CODE(DOMi)@en[[[Attr]]]] object.
611    
612    The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
613    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
614    [['''MUST''']] behave as if the following algorithm
615    is performed:
616    = If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
617    object is read-only, then throw an
618    [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
619    = Remove any child node the node has.
620    = If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
621    then create a [CODE(DOMi)@en[[[Text]]]] node
622    whose [CODE(DOMa)@en[[[data]]]] is the new value
623    and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].
624    
625    ** Definition groups
626    
627    [6] The
628    [DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]
629    contains integers indicating the type of
630    attribute value:
631    ,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.
632    ,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].
633    ,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].
634    ,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].
635    ,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].
636    ,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].
637    ,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].
638    ,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].
639    ,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].
640    ,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].
641    ,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.
642    ,[CODE(DOMc)@en[[[UNKNOWN_ATTR]]]],[CODE(IDL)[[[11]]]],"The attribute value type is unknown, because no declaration for the attribute has been read but not [CODE(InfoProp)@en[[[all declarations processed]]]] property would be false."
643    
644    The type of these constants are
645    [CODE(IDL)@en[[[unsigned]] [[short]]]].
646    
647    If no attribute type information is provided,
648    or if the source of that information does not
649    distinguish [[no value]] and [[unknown]] as in
650    XML Information Set, then the
651    [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value
652    [['''MUST''']] be used.
653    
654    ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
655    object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
656    method has [CODE(DOMa)@en[[[declaredType]]]] attribute
657    set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
658    
659    If the source of the attribute type information
660    does not distinguish [[no value]] and / or [[unknown]]
661    and [CODE(XML)@en[[[CDATA]]]], then the
662    [CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]
663    be used.
664    
665    [11]
666    In Perl binding, the objects implementing the
667    [CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]
668    also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]
669    constant group.
670    
671    [7] The
672    [DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]
673    contains integers indicating the type of
674    default attribute value:
675    ,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.
676    ,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.
677    ,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.
678    ,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].
679    ,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.
680    
681    The type of these constants are
682    [CODE(IDL)@en[[[unsigned]] [[short]]]].
683    
684    If the source of the attribute default value type
685    does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]
686    default and unknown default, then the
687    [CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value
688    [['''MUST''']] be used.
689    
690    ;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
691    object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
692    method has [CODE(DOMa)@en[[[declaredType]]]] attribute
693    set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
694    
695    ** Tree-relationship Attributes
696    
697    [10]
698    The
699    [DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]
700    of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface
701    is read-only and of type
702    [CODE(DOMi)@en[[[ElementTypeDefinition]]]].
703    It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
704    which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
705    belong to.
706    
707    If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
708    is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]
709    list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,
710    then the attribute [['''MUST''']] return the
711    [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.
712    Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].
713    
714    ;; This attribute is analogue to the
715    [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute
716    for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],
717    [CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]
718    nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]
719    attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.
720    
721    ** Attributes
722    
723    [5]
724    The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]
725    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
726    represents the type of the attribute value.
727    
728    This attribute is read-write.
729    The type of the attribute is
730    [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected
731    that this attribute has a value from the definition group
732    [CODE(DOM)@en[[[DeclaredValueType]]]].
733    
734    The getter [['''MUST''']] return a value associated
735    to this attribute.
736    
737    The setter [['''MUST''']]
738    throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
739    [CODE(DOMi)@en[[[DOMException]]]] if the
740    [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
741    Otherwise, the setter [['''MUST''']] set the specified
742    value as the value associated to this attribute.
743    
744    If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
745    object, then it [['''MUST''']] set a value
746    from the [CODE(DOM)@en[[[DeclaredValueType]]]]
747    definition group.
748    
749    [8]
750    The [DFN@en[[CODE(DOMa)@en[[[defaultType]]]] attribute]]
751    of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
752    represents the type of the attribute default value.
753    
754    This attribute is read-write.
755    The type of the attribute is
756    [CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected
757    that this attribute has a value from the definition group
758    [CODE(DOM)@en[[[DefaultValueType]]]].
759    
760    The getter [['''MUST''']] return a value associated
761    to this attribute.
762    
763    The setter [['''MUST''']]
764    throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
765    [CODE(DOMi)@en[[[DOMException]]]] if the
766    [CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
767    Otherwise, the setter [['''MUST''']] set the specified
768    value as the value associated to this attribute.
769    
770    If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
771    object, then it [['''MUST''']] set a value
772    from the [CODE(DOM)@en[[[DefaultValueType]]]]
773    definition group.</pre>
774  </div>  </div>
775    
 <div id=classes class=section>  
 <h2>Character Classes</h2>  
   
 <p>This section defines a couple of character classes.  
 These classes are referred to by algorithms specified above.</p>  
   
 <p>Character class <dfn id=class-Char10><code>Char10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li><code class=char>U+0009</code> <code class=charname>CHARACTER  
 TABULATION</code></li>  
 <li><code class=char>U+000A</code> <code class=charname>LINE FEED</code></li>  
 <li><code class=char>U+000D</code> <code class=charname>CARRIAGE  
 RETURN</code></li>  
 <li><code class=char>U+0020</code> <code class=charname>SPACE</code>  
 .. <code class=char>U+D7FF</code></li>  
 <li><code class=char>U+E000</code> .. <code class=char>U+FFFD</code>  
 <code class=charname>REPLACEMENT CHARACTER</code></li>  
 <li><code class=char>U+10000</code> .. <code class=char>U+10FFFF</code></li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed in the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Char"><code>Char</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
 </div>  
   
 <p>Character class <dfn id=class-CompatChar10><code>CompatChar10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li class=ed>@@ <q>Document authors are encouraged to avoid "compatibility characters", as defined in section 6.8 of [Unicode @@ Unicode 2.0 @@] (see also D21 in section 3.6 of [Unicode3]).</q></li>  
 </ul>  
   
 <p>Character class <dfn id=class-ControlChar10><code>ControlChar10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li><code class=char>U+007F</code> <code class=charname>DELETE</code> ..  
 <code class=char>U+0084</code> <code class=charname>INDEX</code></li>  
 <li><code class=char>U+0086</code> <code class=charname>START OF SELECTED  
 AREA</code> .. <code class=char>U+009F</code> <code class=charname>APPLICATION  
 PROGRAM COMMAND</code></li>  
 <li><code class=char>U+FDD0</code> .. <code class=char>U+FDEF</code></li>  
 <li><code class=char>U+1FFFE</code> .. <code class=char>U+1FFFF</code></li>  
 <li><code class=char>U+2FFFE</code> .. <code class=char>U+2FFFF</code></li>  
 <li><code class=char>U+3FFFE</code> .. <code class=char>U+3FFFF</code></li>  
 <li><code class=char>U+4FFFE</code> .. <code class=char>U+4FFFF</code></li>  
 <li><code class=char>U+5FFFE</code> .. <code class=char>U+5FFFF</code></li>  
 <li><code class=char>U+6FFFE</code> .. <code class=char>U+6FFFF</code></li>  
 <li><code class=char>U+7FFFE</code> .. <code class=char>U+7FFFF</code></li>  
 <li><code class=char>U+8FFFE</code> .. <code class=char>U+8FFFF</code></li>  
 <li><code class=char>U+9FFFE</code> .. <code class=char>U+9FFFF</code></li>  
 <li><code class=char>U+AFFFE</code> .. <code class=char>U+AFFFF</code></li>  
 <li><code class=char>U+BFFFE</code> .. <code class=char>U+BFFFF</code></li>  
 <li><code class=char>U+CFFFE</code> .. <code class=char>U+CFFFF</code></li>  
 <li><code class=char>U+DFFFE</code> .. <code class=char>U+DFFFF</code></li>  
 <li><code class=char>U+EFFFE</code> .. <code class=char>U+EFFFF</code></li>  
 <li><code class=char>U+FFFFE</code> .. <code class=char>U+FFFFF</code></li>  
 <li><code class=char>U+10FFFE</code> .. <code class=char>U+10FFFF</code></li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains the characters listed in the Note in  
 <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>  
776  </div>  </div>
777    
 <p>The character class <dfn id=class-NameStartChar10><code>NameStartChar10</code></dfn>  
 contains the following characters:</p>  
 <ul class=ed>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed as the first character  
 of a string matching to the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
 </div>  
778    
 <p>The character class <dfn id=class-NameChar10><code>NameChar10</code></dfn>  
 contains the following characters:</p>  
 <ul>  
 <li>The characters in the character class  
 <a href="#class-NameStartChar10">NameStartChar10</a>.</li>  
 <li class=ed></li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed as the second  
 character of a string matching to the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-Name"><code>Name</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
 </div>  
779    
 <p>The character class <dfn id=class-PubidChar><code>PubidChar</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></li>  
 <li><code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code>  
 (<code class=char>!</code>)</li>  
 <li><code class=char>U+0023</code> <code class=charname>DOLLAR SIGN</code>  
 (<code class=char>$</code>)</li>  
 <li><code class=char>U+0024</code> <code class=charname>NUMBER SIGN</code>  
 (<code class=char>#</code>)</li>  
 <li><code class=char>U+0025</code> <code class=charname>PERCENT SIGN</code>  
 (<code class=char>%</code>)</li>  
 <li><code class=char>U+0027</code> <code class=charname>APOSTROPHE</code>  
 (<code class=char>'</code>)</li>  
 <li><code class=char>U+0028</code> <code class=charname>LEFT PARENTHESIS</code>  
 (<code class=char>(</code>)</li>  
 <li><code class=char>U+0029</code> <code class=charname>RIGHT  
 PARENTHESIS</code> (<code class=char>)</code>)</li>  
 <li><code class=char>U+002A</code> <code class=charname>ASTERISK</code>  
 (<code class=char>*</code>)</li>  
 <li><code class=char>U+002B</code> <code class=charname>PLUS SIGN</code>  
 (<code class=char>+</code>)</li>  
 <li><code class=char>U+002C</code> <code class=charname>COMMA</code>  
 (<code class=char>,</code>)</li>  
 <li><code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>  
 (<code class=char>-</code>)</li>  
 <li><code class=char>U+002E</code> <code class=charname>FULL STOP</code>  
 (<code class=char>.</code>)</li>  
 <li><code class=char>U+002F</code> <code class=charname>SOLIDUS</code>  
 (<code class=char>/</code>)</li>  
 <li><code class=char>U+0030</code> <code class=charname>DIGIT ZERO</code>  
 (<code class=char>0</code>) .. <code class=char>U+0039</code>  
 <code class=charname>DIGIT NINE</code> (<code class=char>9</code>)</li>  
 <li><code class=char>U+003A</code> <code class=charname>COLON</code>  
 (<code class=char>:</code>)</li>  
 <li><code class=char>U+003B</code> <code class=charname>SEMICOLON</code>  
 (<code class=char>;</code>)</li>  
 <li><code class=char>U+003D</code> <code class=charname>EQUAL SIGN</code>  
 (<code class=char>=</code>)</li>  
 <li><code class=char>U+003F</code> <code class=charname>QUESTION MARK</code>  
 (<code class=char>?</code>)</li>  
 <li><code class=char>U+0040</code> <code class=charname>COMMERCIAL AT</code>  
 (<code class=char>@</code>)</li>  
 <li><code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER  
 A</code> (<code class=char>A</code>) .. <code class=char>U+005A</code>  
 <code class=charname>LATIN CAPITAL LETTER Z</code>  
 (<code class=char>Z</code>)</li>  
 <li><code class=char>U+005F</code> <code class=charname>LOW LINE</code>  
 (<code class=char>_</code>)</li>  
 <li><code class=char>U+0061</code> <code class=charname>LATIN CAPITAL LETTER  
 A</code> (<code class=char>A</code>) .. <code class=char>U+007A</code>  
 <code class=charname>LATIN CAPITAL LETTER Z</code>  
 (<code class=char>Z</code>)</li>  
 </ul>  
 <div class="note memo">  
 <p>This character class contains all characters allowed in the production rule  
 <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#NT-PubidChar"><code>PubidChar</code></a>  
 of <abbr>XML</abbr> 1.0  
 <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>]</cite>.</p>  
 </div>  
780    
 </div>  
781    
782  <div id="references" class="section reference">  <div id="references" class="section reference">
783  <h2>References</h2>  <h2>References</h2>
Legend:
Removed from v.1.1  
changed lines
  Added in v.1.5
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24