/[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.24 by wakaba, Sat Dec 8 13:10:28 2007 UTC revision 1.28 by wakaba, Sun Dec 9 10:03:20 2007 UTC
# Line 59  applications are able to access to the d Line 59  applications are able to access to the d
59  <div id="status" class="section">  <div id="status" class="section">
60  <h2>Status of This Document</h2>  <h2>Status of This Document</h2>
61    
62  <p class=section-info><em>This section describes the status of this document  <p class=section-info>This section describes the status of this document at the
63  at the time of its publication.  Other documents  time of its publication.  Other documents might supersede this document.</p>
 might supersede this document.</em></p>  
64    
65  <p>This document is a working draft, produced as part of the  <p>This document is a working draft, produced as part of the
66  <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>
# Line 72  cite this document as other than <q>work Line 71  cite this document as other than <q>work
71  <p>Comments on this document are welcome and  <p>Comments on this document are welcome and
72  may be sent to the <a href="#author">author</a>.</p>  may be sent to the <a href="#author">author</a>.</p>
73    
74  <p>Translations of thie document might be available.  <p>Translations of this document might be available.
75  The English version of the document is the only  The English version of the document is the only
76  normative version.</p>  normative version.</p>
77  </div>  </div>
# Line 224  tree to <abbr>XML</abbr> document conver Line 223  tree to <abbr>XML</abbr> document conver
223  <abbr>DOM</abbr> Tree Converter</dt>  <abbr>DOM</abbr> Tree Converter</dt>
224    <dd>A software component that converts an <abbr>XML</abbr> information set    <dd>A software component that converts an <abbr>XML</abbr> information set
225    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
226    into a <abbr>DOM</abbr> tree.  Note that this documetn does not define    into a <abbr>DOM</abbr> tree.  Note that this document does not define
227    any particular way for the convertion, but it defines constraints for    any particular way for the conversion, but it defines constraints for
228    such processing.</dd>    such processing.</dd>
229  <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>  <dt id=category-dom-infoset><abbr>DOM</abbr> Tree to <abbr>XML</abbr>
230  Information Set Converter</dt>  Information Set Converter</dt>
231    <dd>A software component that converts a <abbr>DOM</abbr> tree into    <dd>A software component that converts a <abbr>DOM</abbr> tree into
232    an <abbr>XML</abbr> information set.  Note that this documetn does not define    an <abbr>XML</abbr> information set.  Note that this document does not define
233    any particular way for the convertion, but it defines constraints for    any particular way for the conversion, but it defines constraints for
234    such processing.</dd>    such processing.</dd>
235  </dl>  </dl>
236  </div>  </div>
# Line 297  these kinds of nodes, methods and attrib Line 296  these kinds of nodes, methods and attrib
296  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>  <a href="#Node"><code>Node</code></a> interface must behave as following:</p>
297    
298  <dl>  <dl>
299  <dt><code id=attributes>attributes</code></dt>  <dt><code id=attributes>attributes</code>,
300    <code id=localName>localName</code>,
301    <code id=namespaceURI>namespaceURI</code>, and
302    <code id=prefix>prefix</code></dt>
303    <dd>    <dd>
304      <p>On getting, the attribute <em class=rfc2119>MUST</em> return      <p>On getting, the attributes <em class=rfc2119>MUST</em> return
305      <code>null</code>.</p>      <code>null</code>.</p>
306    </dd>    </dd>
307  <dt><code id=baseURI>baseURI</code></dt>  <dt><code id=baseURI>baseURI</code></dt>
# Line 386  these kinds of nodes, methods and attrib Line 388  these kinds of nodes, methods and attrib
388    the values of the <code>DOMStringList</code> objects in the    the values of the <code>DOMStringList</code> objects in the
389    <a href="#allowedTokens"><code>allowedTokens</code></a> attributes    <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
390    are equal, i.e. their <code>length</code> attribute values are equal and    are equal, i.e. their <code>length</code> attribute values are equal and
391    each string exists in a list is contained in another list (their indeces    each string exists in a list is contained in another list (their indecies
392    may be different), with an additional constraint that the number of the    may be different), with an additional constraint that the number of the
393    items that are equal to a string in a list is equal to the number    items that are equal to a string in a list is equal to the number
394    of the items equal to the string in another list.</p></li>    of the items equal to the string in another list.</p></li>
395    </ul></dd>    </ul></dd>
396    <dt><code id=manakaiLocalName>manakaiLocalName</code>
397    <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
398      <dd><p class=section-info>This entry is applied only to implementations
399      that support this attribute.</p>
400    
401      <p>On getting, the attributes <em class=rfc2119>MUST</em> return
402      <code>null</code>.</p></dd>
403  <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and  <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and
404  <code id=lookupPrefix>lookupPrefix</code></dt>  <code id=lookupPrefix>lookupPrefix</code></dt>
405    <dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return    <dd><p>When invoked, the methods <em class=rfc2119>MUST</em> return
# Line 567  method</dt> Line 576  method</dt>
576      <a href="#publicId"><code>publicId</code></a>, and      <a href="#publicId"><code>publicId</code></a>, and
577      <a href="#systemId"><code>systemId</code></a></dt>      <a href="#systemId"><code>systemId</code></a></dt>
578        <dd>Empty strings.</dd>        <dd>Empty strings.</dd>
     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
       <dd><code>false</code>.</dd>  
579      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
580        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
581      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
582        <dd>The <a href="#Document"><code>Document</code></a> node over which the        <dd>The <a href="#Document"><code>Document</code></a> node over which the
583        method is invoked.</dd>        method is invoked.</dd>
584      </dl>      </dl>
585        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
586        <a href="#read-only">read$B!>(Bonly</a>.</p>
587      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as      <p>In addition, the method <em class=rfc2119>MUST</em> be marked as
588      containing five general entity declarations: <code>amp</code>,      containing five general entity declarations: <code>amp</code>,
589      <code>lt</code>, <code>gt</code>, <code>quot</code>, and      <code>lt</code>, <code>gt</code>, <code>quot</code>, and
# Line 596  method</dt> Line 605  method</dt>
605      <dl>      <dl>
606      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>      <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
607        <dd>An empty <code>NamedNodeMap</code> object.</dd>        <dd>An empty <code>NamedNodeMap</code> object.</dd>
     <dt><a href="#attributes"><code>attributes</code></a>,  
     <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
608      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
609        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
       <dd><code>false</code>.</dd>  
610      <dt><a href="#nodeName"><code>nodeName</code></a></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
611        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
612      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
613        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
614      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
615        and <code>parentNode</code></dt>
616        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dt>  
617      </dl>      </dl>
618        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
619        <a href="#read-only">read$B!>(Bonly</a>.</p>
620    </dd>    </dd>
621  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,  <dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
622  method</dt>  method</dt>
# Line 628  method</dt> Line 634  method</dt>
634      <dl>      <dl>
635      <dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt>      <dt><a href="#allowedTokens"><code>allowedTokens</code></a></dt>
636        <dd>An empty <code>DOMStringList</code> object.</dd>        <dd>An empty <code>DOMStringList</code> object.</dd>
     <dt><a href="#attributes"><code>attributes</code></a>,  
     <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
637      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
638        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
639      <dt><a href="#declaredType"><code>declaredType</code></a></dt>      <dt><a href="#declaredType"><code>declaredType</code></a></dt>
640        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>        <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
641      <dt><a href="#defaultType"><code>defaultType</code></a></dt>      <dt><a href="#defaultType"><code>defaultType</code></a></dt>
642        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>        <dd><a href="#UNKNOWN_DEFAULT"><code>UNKNOWN_DEFAULT</code></a>.</dd>
     <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>  
       <dd><code>false</code>.</dd>  
643      <dt><a href="#nodeName"><code>nodeName</code></a></dt>      <dt><a href="#nodeName"><code>nodeName</code></a></dt>
644        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>        <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
645      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
646        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
647      <dt class=ed>@@ Ensure all attributes are defined</dt>      <dt><a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>
648        and <code>parentNode</code></dt>
649          <dd><code>null</code>.</dd>
650      </dl>      </dl>
651        <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
652        <a href="#read-only">read$B!>(Bonly</a>.</p>
653    
654      <!-- This requirement, if not droped, should be part of xml-id spec.      <!-- This requirement, if not droped, should be part of xml-id spec.
655      <div class=ed>      <div class=ed>
# Line 670  method</dt> Line 674  method</dt>
674      an <a href="#Entity"><code>Entity</code></a> node with the following      an <a href="#Entity"><code>Entity</code></a> node with the following
675      attributes:</p>      attributes:</p>
676      <dl>      <dl>
     <dt><code>attributes</code>,  
     <a href="#notationName"><code>notationName</code></a>,  
     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
677      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
678        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
679      <dt><code>manakaiDeclarationBaseURI</code>,      <dt><code>manakaiDeclarationBaseURI</code>,
680      <code>manakaiEntityBaseURI</code>, and      <code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code>
681      <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
682        <dd>No explicit value is set.</dd>        <dd><p class=section-info>This entry is applied only to implementations
683          that support these attributes.</p>
684    
685          <p>No explicit value is set.</p></dd>
686      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
687      <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>      <a href="#isExternallyDeclared"><code>isExternallyDeclared</code></a></dt>
688        <dd><code>false</code>.</dd>        <dd><p><code>false</code>.</p></dd>
689      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
690        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
691        <dd>        <dd>
# Line 698  method</dt> Line 700  method</dt>
700            with its <code>nodeName</code> attribute set to <code>amp</code>.</p>            with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
701          </div>          </div>
702        </dd>        </dd>
703        <dt><a href="#notationName"><code>notationName</code></a>,
704        <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
705        and <code>parentNode</code></dt>
706          <dd><code>null</code>.</dd>
707      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
708        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd>The <code>Document</code> node over which the method is invoked.</dd>
709      <dt><a href="#publicId"><code>publicId</code></a> and      <dt><a href="#publicId"><code>publicId</code></a> and
710      <a href="#systemId"><code>systemId</code></a></dt>      <a href="#systemId"><code>systemId</code></a></dt>
711        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
712        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dd>  
713      </dl>      </dl>
714    </dd>    <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
715      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
716  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,  <dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
717  method</dt>  method</dt>
718    <dd>    <dd>
# Line 718  method</dt> Line 724  method</dt>
724      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return      <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
725      a <code>Notation</code> node with the following attributes:</p>      a <code>Notation</code> node with the following attributes:</p>
726      <dl>      <dl>
     <dt><code>attributes</code>,  
     <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,  
     and <code>parentNode</code></dt>  
       <dd><code>null</code>.</dd>  
727      <dt><code>childNodes</code></dt>      <dt><code>childNodes</code></dt>
728        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
729      <dt><code>manakaiDeclarationBaseURI</code></dt>      <dt><code>manakaiDeclarationBaseURI</code>
730        <dd>No explicit value is set.</dd>      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
731      <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>        <dd><p class=section-info>This entry is applied only to implementations
732        <dd><code>false</code>.</dd>        that support these attributes.</p>
733    
734          <p>No explicit value is set.</p></dd>
735      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
736        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
737      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
738        <dd>The <code>Document</code> node over which the method is invoked.</dd>        <dd><p>The <a href="#Document"><code>Document</code></a> node over which
739          the method is invoked.</p></dd>
740        <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
741        and <code>parentNode</code></dt>
742          <dd><code>null</code>.</dd>
743      <dt><a href="#publicId"><code>publicId</code></a> and      <dt><a href="#publicId"><code>publicId</code></a> and
744      <a href="#systemId"><code>systemId</code></a></dt>      <a href="#systemId"><code>systemId</code></a></dt>
745        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
746        <dd class=ed>@@ publicId and systemId should be empty string?</dd>        <dd class=ed>@@ publicId and systemId should be empty string?</dd>
     <dt class=ed>@@ Ensure all attributes are defined</dt>  
747      </dl>      </dl>
748    </dd>    <p>The returned node <em class=rfc2119>MUST NOT</em> be marked as
749      <a href="#read-only">read$B!>(Bonly</a>.</p></dd>
750  </dl>  </dl>
751    
752  <p>These methods <em class=rfc2119>MUST</em> raise an  <p>These methods <em class=rfc2119>MUST</em> raise an
# Line 768  Interface</h3> Line 776  Interface</h3>
776    
777  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
778  <em class=rfc2119>MAY</em> contain zero or more  <em class=rfc2119>MAY</em> contain zero or more
779  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes in the <code>NodeList</code> object
780  nodes in the <code>NodeList</code> object contained in the  contained in the <code>childNodes</code> attribute of the
 <code>childNodes</code> attribute of the  
781  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
782    
783  <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created  <p>If the <a href="#DocumentType"><code>DocumentType</code></a> node is created
784  during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>  during the process to create a <abbr>DOM</abbr> from an <abbr>XML</abbr>
785  document, the <code>NodeList</code> object in the <code>childNodes</code>  document, the <code>NodeList</code> object in the <code>childNodes</code>
786  object <em class=rfc2119>MUST</em> contains the  object <em class=rfc2119>MUST</em> contains the
787  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes representing the processing
788  nodes representing the processing instructions in the document type  instructions in the document type definition of the document processed
 definition of the document processed  
789  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
790  <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor.  If  <a href="#ref-XML11">XML11</a>]</cite> by the <abbr>XML</abbr> processor.  If
791  the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as  the <a href="#DocumentType"><code>DocumentType</code></a> node is marked as
# Line 794  type declaration information item</a> Line 800  type declaration information item</a>
800  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
801  the <code>NodeList</code> object in the <code>childNodes</code> attribute  the <code>NodeList</code> object in the <code>childNodes</code> attribute
802  of the node <em class=rfc2119>MUST</em> contain the  of the node <em class=rfc2119>MUST</em> contain the
803  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  <code>ProcessingInstruction</code> nodes created from any
804  created from the processing instruction information items in the list in the  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing
805  [children] property of the document type declaration item in the same  instruction information items</a> in the list in the [children] property of the
806  order.</p>  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
807    type declaration item</a> in the same order.</p>
808    
809  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to  <p>If a <a href="#DocumentType"><code>DocumentType</code></a> node is mapped to
810  a document type declaration information item, the list in the [children]  a document type declaration information item, the list in the [children]
811  property <em class=rfc2119>MUST</em> contain the processng instruction  property <em class=rfc2119>MUST</em> contain the processng instruction
812  information items created from the  information items created from the <code>ProcessingInstruction</code> nodes
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
813  in the <code>NodeList</code> object in the <code>childNodes</code> attribute  in the <code>NodeList</code> object in the <code>childNodes</code> attribute
814  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
815    
# Line 830  read$B!>(Bonly.</p> Line 836  read$B!>(Bonly.</p>
836  <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>  <a href="#read-only">read$B!>(Bonly</a>.  Otherwise, it <em class=rfc2119>MUST</em>
837  set the specified value as the value associated to the attribute.  No  set the specified value as the value associated to the attribute.  No
838  normalization, relative reference resolution, or lexical validation is  normalization, relative reference resolution, or lexical validation is
839  performed. <span class=ed>@@ If the new value is <code>null</code>, should an e  performed. <span class=ed>@@ If the new value is <code>null</code>, should an
840  mpty string be set?</span></p>  empty string be set?</span></p>
841    
842  <div class="note memo">  <div class="note memo">
843  <p>Setting an invalid identifier might make the node unserializable.  <p>Setting an invalid identifier might make the node unserializable.
844  Setting a public identifier while leaveing system identifier unspecified  Setting a public identifier while leaving system identifier unspecified
845  would also make the <a href="#DocumentType"><code>DocumentType</code></a>  would also make the <a href="#DocumentType"><code>DocumentType</code></a>
846  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
847  </div>  </div>
# Line 878  and <a href="#feature-XDoctype-3.0"><cod Line 884  and <a href="#feature-XDoctype-3.0"><cod
884  feature <code>Core</code> version <code>3.0</code>  feature <code>Core</code> version <code>3.0</code>
885  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
886    
 <div class="note memo">  
 <p>This interface is a separated interface from the  
 <a href="#DocumentType"><code>DocumentType</code></a>, not a set of extensions  
 to the <a href="#DocumentType"><code>DocumentType</code></a>,  
 for the historical reason.</p>  
   
 <p class=ed>Should the interface be merged with  
 <a href="#DocumentType"><code>DocumentType</code></a>?</p>  
 </div>  
   
887  <p>The  <p>The
888  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
889  interface <em class=rfc2119>MUST</em> be implemented as the following  interface <em class=rfc2119>MUST</em> be implemented as the following
# Line 952  of type <code>NamedNodeMap</code>, read Line 948  of type <code>NamedNodeMap</code>, read
948    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
949        
950    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the    <p>On getting, the attribute <em class=rfc2119>MUST</em> return the
951    same value as the <code>entities</code> attribute (defined in the    same value as the <code id=entities>entities</code> attribute (defined in the
952    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same    <a href="#DocumentType"><code>DocumentType</code></a> interface) of the same
953    node.</p>    node.</p>
954    
# Line 1042  method</dt> Line 1038  method</dt>
1038    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
1039    node.  If there is no such node, it <em class=rfc2119>MUST</em> return    node.  If there is no such node, it <em class=rfc2119>MUST</em> return
1040    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
 <dt><dfn id=getElementTypeDefinitionNode class=dom-method><code>getElementTypeDefinitionNode</code></dfn>,  
 method</dt>  
   <dd><p>Returns the  
   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node  
   with the specified name.</p>  
   
   <p>The  
   <dfn id=getElementTypeDefinitionNode-name class=dom-param><var>name</var></dfn>  
   parameter is the name of the element type.</p>  
   
   <p>When invoked, the method <em class=rfc2119>MUST</em> return the  
   <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,  
   whose <a href="#nodeName"><code>nodeName</code></a> is equal to  
   <a href="#getElementTypeDefinitionNode-name"><var>name</var></a>, in the  
   <code>NamedNodeMap</code> object in the  
   <a href="#elementTypes"><code>elementTypes</code></a> attribute of the  
   node.  If there is no such node, it <em class=rfc2119>MUST</em> return  
   <code>null</code>.</p></dd>  
1041  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
1042  method</dt>  method</dt>
1043    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
1044    with the specified name.</p>    with the specified name.</p>
1045    
1046    <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>    <p>The
1047      <dfn id=getGeneralEntityNode-name class=dom-param><var>name</var></dfn>
1048    parameter is the name of the general entity.</p>    parameter is the name of the general entity.</p>
1049    
1050    <p>When invoked, the method <em class=rfc2119>MUST</em> return the    <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1051    <a href="#Entity"><code>Entity</code></a> node,    <a href="#Entity"><code>Entity</code></a> node,
1052    whose <a href="#nodeName"><code>nodeName</code></a> is equal to    whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1053    <a href="#getEntityNode-name"><var>name</var></a>, in the    <a href="#getGeneralEntityNode-name"><var>name</var></a>, in the
1054    <code>NamedNodeMap</code> object in the    <code>NamedNodeMap</code> object in the
1055    <a href="#entities"><code>entities</code></a> attribute of the    <a href="#entities"><code>entities</code></a> attribute of the
1056    node.  If there is no such node, it <em class=rfc2119>MUST</em> return    node.  If there is no such node, it <em class=rfc2119>MUST</em> return
# Line 1095  method</dt> Line 1074  method</dt>
1074    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
1075  <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,  <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,
1076  method</dt>  method</dt>
1077    <dd class=ed>@@</dd>    <dd><p>Associate an
1078      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1079      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1080    
1081      <p>The
1082      <dfn id=setElementTypeDefinitionNode-node class=dom-param><var>node</var></dfn>
1083      parameter is the node to associate.</p>
1084    
1085      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1086      to <a href="#algorithm-attach-node">attach a node</a>, where
1087      <a href="#attach-node-n"><var>n</var></a> is the
1088      <a href="#DocumentType"><code>DocumentType</code></a> node,
1089      <a href="#attach-node-l"><var>l</var></a> is the
1090      <a href="#elementTypes"><code>elementTypes</code></a> attribute value of the
1091      <a href="#DocumentType"><code>DocumentType</code></a> node,
1092      <a href="#attach-node-node"><var>node</var></a> is the
1093      <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>, and
1094      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1095      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1096      attribute.</p></dd>
1097  <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,  <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,
1098  method</dt>  method</dt>
1099    <dd class=ed>@@</dd>    <dd><p>Associate an <a href="#Entity"><code>Entity</code></a>
1100      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1101    
1102      <p>The
1103      <dfn id=setGeneralEntityNode-node class=dom-param><var>node</var></dfn>
1104      parameter is the node to associate.</p>
1105    
1106      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1107      to <a href="#algorithm-attach-node">attach a node</a>, where
1108      <a href="#attach-node-n"><var>n</var></a> is the
1109      <a href="#DocumentType"><code>DocumentType</code></a> node,
1110      <a href="#attach-node-l"><var>l</var></a> is the
1111      <a href="#entities"><code>entities</code></a> attribute value of the
1112      <a href="#DocumentType"><code>DocumentType</code></a> node,
1113      <a href="#attach-node-node"><var>node</var></a> is the
1114      <a href="#setGeneralEntityNode-node"><var>node</var></a>, and
1115      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1116      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1117      attribute.</p></dd>
1118  <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,  <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,
1119  method</dt>  method</dt>
1120    <dd class=ed>@@</dd>    <dd><p>Associate an <a href="#Notation"><code>Notation</code></a>
1121      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1122    
1123      <p>The <dfn id=setNotationNode-node class=dom-param><var>node</var></dfn>
1124      parameter is the node to associate.</p>
1125    
1126      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1127      to <a href="#algorithm-attach-node">attach a node</a>, where
1128      <a href="#attach-node-n"><var>n</var></a> is the
1129      <a href="#DocumentType"><code>DocumentType</code></a> node,
1130      <a href="#attach-node-l"><var>l</var></a> is the
1131      <a href="#notations"><code>notations</code></a> attribute value of the
1132      <a href="#DocumentType"><code>DocumentType</code></a> node,
1133      <a href="#attach-node-node"><var>node</var></a> is the
1134      <a href="#setNotationNode-node"><var>node</var></a>, and
1135      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1136      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1137      attribute.</p></dd>
1138  </dl>  </dl>
1139    
1140    <p>When a <dfn id=algorithm-attach-node title="attach a node">node is
1141    attached</dfn>, the rules below, with parameters
1142    <dfn id=attach-node-n><var>n</var></dfn>,
1143    <dfn id=attach-node-l><var>l</var></dfn>,
1144    <dfn id=attach-node-node><var>node</var></dfn>, and
1145    <dfn id=attach-node-owner-attr><var>owner-attr</var></dfn>,
1146    <em class=rfc2119>MUST</em> be followed:</p>
1147      <ol>
1148      <li><p>Let
1149      <dfn id=attach-node-r><var>r</var></dfn> be the node in
1150      <var>l</var> whose <code>nodeName</code> attribute value is equal to the
1151      <code>nodeName</code> attribute value of <var>node</var>, if any.</p></li>
1152      <li><p>If <var>r</var> is different from <code>null</code> and <var>r</var>
1153      is same node as <var>node</var>, then abort these steps.</p></li>
1154      <li><p>If <var>n</var> is <a href="#read-only">read$B!>(Bonly</a>, then raise a
1155      <code>NO_MODIFICATION_ALLOWED_ERR</code> and abort these steps.</p></li>
1156      <li><p>If the <code>ownerDocument</code> attribute value of <var>node</var>
1157      is different from that of <var>n</var>, then raise a
1158      <code>WRONG_DOCUMENT_ERR</code> and abort these steps.</p></li>
1159      <li><p>If the value of the attribute <var>owner-attr</var> of <var>node</var>
1160      is different from <code>null</code>, then raise a
1161      <code>HIERARCHY_REQUEST_ERR</code> and abort these steps.</p></li>
1162      <li><p>If <var>r</var> is a node, then remove it from <var>r</var>.</p>
1163    
1164      <div class="note memo">
1165      <p>By the removal of <var>r</var>, the attribute <var>owner-attr</var> of
1166      <var>r</var> is set to <code>null</code>.</p>
1167      </div></li>
1168      <li><p>Add <var>node</var> to <var>l</var>.</p>
1169    
1170      <div class="note memo">
1171      <p>By the addition of <var>node</var>, the attribute <var>owner-attr</var> of
1172      <var>node</var> is set to <var>n</var>.</p>
1173      </div></li>
1174      </ol>
1175    
1176  <div class=ed>  <div class=ed>
1177  <p>A future version of this interface might define the  <p>A future version of this interface might define the
1178  <code>parameterEntities</code> and getter/setter for parameter entities.  <code>parameterEntities</code> and getter/setter for parameter entities.
# Line 1151  interface <em class=rfc2119>MUST</em> be Line 1220  interface <em class=rfc2119>MUST</em> be
1220    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
1221      (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);      (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
1222    void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>    void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
1223      (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-name"><var>node</var></a>)      (in <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#setAttributeDefinitionNode-node"><var>node</var></a>)
1224      raises (DOMException);      raises (DOMException);
1225  }</code></pre>  }</code></pre>
1226    
# Line 1233  method</dt> Line 1302  method</dt>
1302    <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>    <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
1303  <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,  <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
1304  method</dt>  method</dt>
1305    <dd class=ed>@@</dd>    <dd><p>Associate an
1306      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node with
1307      the
1308      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1309      node.</p>
1310    
1311      <p>The
1312      <dfn id=setAttributeDefinitionNode-node class=dom-param><var>node</var></dfn>
1313      parameter is the node to associate.</p>
1314    
1315      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1316      to <a href="#algorithm-attach-node">attach a node</a>, where
1317      <a href="#attach-node-n"><var>n</var></a> is the
1318      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1319      node, <a href="#attach-node-l"><var>l</var></a> is the
1320      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1321      attribute value of the
1322      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1323      <a href="#attach-node-node"><var>node</var></a> is the
1324      <a href="#setAttributeDefinitionNode-node"><var>node</var></a>, and
1325      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1326      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>
1327      attribute.</p></dd>
1328  </dl>  </dl>
1329    
1330  <div class=ed>  <div class=ed>
# Line 1315  read$B!>(Bonly</dt> Line 1406  read$B!>(Bonly</dt>
1406    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
1407    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1408    It <em class=rfc2119>MUST</em> be such a node that whose    It <em class=rfc2119>MUST</em> be such a node that whose
1409    <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1410    attribute contains the <code>NamedNodeMap</code> object that contains    attribute contains the <code>NamedNodeMap</code> object that contains
1411    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1412    node.  If there is no such an    node.  If there is no such an
# Line 1516  type <code>unsigned short</code></dt> Line 1607  type <code>unsigned short</code></dt>
1607    <p>The definition group    <p>The definition group
1608    <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>    <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
1609    contains integers indicating the type of the default for the attribute.    contains integers indicating the type of the default for the attribute.
1610    The definition group contains the following constans:</p>    The definition group contains the following constants:</p>
1611    
1612    <table>    <table>
1613    <thead>    <thead>
# Line 1725  interface <em class=rfc2119>MUST</em> be Line 1816  interface <em class=rfc2119>MUST</em> be
1816    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,    14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
1817    <time datetime=1997-03>March 1997</time>.    <time datetime=1997-03>March 1997</time>.
1818    <em>This</em> version of the specification is referenced.</dd>    <em>This</em> version of the specification is referenced.</dd>
1819  <dt id=ref-XML10">XML10</dt>  <dt id=ref-MANAKAI>MANAKAI</dt>
1820      <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions">
1821      manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft.  Work in
1822      progress.</dd>
1823    <dt id=ref-XML10>XML10</dt>
1824    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible    <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible
1825    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
1826    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
Legend:
Removed from v.1.24  
changed lines
  Added in v.1.28
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24