/[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.27 by wakaba, Sun Dec 9 09:58:05 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 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 391  these kinds of nodes, methods and attrib Line 393  these kinds of nodes, methods and attrib
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 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 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.27
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24