/[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.25 by wakaba, Sat Dec 8 13:41:36 2007 UTC revision 1.31 by wakaba, Sun Jun 15 08:08:05 2008 UTC
# Line 10  Line 10 
10    
11  <div class="header">  <div class="header">
12  <h1>DOM Document Type Definition Module</h1>  <h1>DOM Document Type Definition Module</h1>
13  <h2>Working Draft <time datetime=2007-12-08>8 December 2007</time></h2>  <h2><!-- First Edition -->Working Draft
14    <time datetime=2008-06-15>15 June 2008</time></h2>
15    
16  <dl class="versions-uri">  <dl class="versions-uri">
17  <dt>This Version</dt>  <dt>This Version</dt>
18    <!--
19      <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-20071209"
20          >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-20071209</a>&gt;</code></dd>
21    -->
22    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
23        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
24  <dt>Latest Version</dt>  <dt>Latest Version</dt>
# Line 22  Line 27 
27  <dt>Latest Working Draft</dt>  <dt>Latest Working Draft</dt>
28    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
29        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>        >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
30  <!-- <dt>Previous Version</dt> -->  <dt>Previous Stable Version</dt>
31      <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-20071209"
32          >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-20071209</a>&gt;</code></dd>
33  <dt>Version History</dt>  <dt>Version History</dt>
34    <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>    <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>
35  <dt id=author>Author</dt>  <dt id=author>Author</dt>
# Line 32  Line 39 
39        >w@suika.fam.cx</a>&gt;</code></dd>        >w@suika.fam.cx</a>&gt;</code></dd>
40  </dl>  </dl>
41    
42  <p class="copyright" lang="en">&#xA9; <time>2007</time> <a  <p class="copyright" lang="en">&#xA9; <time>2007</time>$B!>(B<time>2008</time> <a
43      href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.      href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.
44  Permission is granted to copy, distribute and/or modify this document  Permission is granted to copy, distribute and/or modify this document
45  under the terms of the <a rel="license"  under the terms of the <a rel="license"
# Line 59  applications are able to access to the d Line 66  applications are able to access to the d
66  <div id="status" class="section">  <div id="status" class="section">
67  <h2>Status of This Document</h2>  <h2>Status of This Document</h2>
68    
69  <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
70  at the time of its publication.  Other documents  time of its publication.  Other documents might supersede this document.</p>
71  might supersede this document.</em></p>  
72    <p>This document is a specification<!-- working draft -->,
73  <p>This document is a working draft, produced as part of the  produced as part of the
74  <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> project.  
75  project.  It might be updated, replaced, or obsoleted by  It might be updated, replaced, or obsoleted by other documents at any time.  
76  other documents at any time.  It is inappropriate to  <!-- It is inappropriate to cite this document as other than
77  cite this document as other than <q>work in progress</q>.</p>  <q>work in progress</q>. --></p>
78    
79  <p>Comments on this document are welcome and  <p>Comments on this document are welcome and
80  may be sent to the <a href="#author">author</a>.</p>  may be sent to the <a href="#author">author</a>.</p>
81    
82  <p>Translations of thie document might be available.  <p>Translations of this document might be available.
83  The English version of the document is the only  The English version of the document is the only
84  normative version.</p>  normative version.</p>
85  </div>  </div>
# Line 105  they are not compatible with any of them Line 112  they are not compatible with any of them
112  <h3>Terminology</h3>  <h3>Terminology</h3>
113    
114  <p>All examples and notes in this specification are non$B!>(Bnormative,  <p>All examples and notes in this specification are non$B!>(Bnormative,
115  as are all sections explicitly marked non$B!>(Bnormative.  Everything  as are all sections explicitly marked non$B!>(Bnormative.</p>
116  else in this specification is normative.</p>  
117    <p class=ed>Known issues are marked like this.  They are non$B!>(Bnormative.  <!--
118    However, this paragraph itself is normative.  One may argue that this paragraph
119    is non$B!>(Bnormative, because this paragraph is marked as an editor's note.
120    Anyway, the other editor's notes are non$B!>(Bnormative. --></p>
121    
122    <p>Everything else in this document is normative.</p>
123    
124  <p>The key words <q><em class="rfc2119">MUST</em></q>,  <p>The key words <q><em class="rfc2119">MUST</em></q>,
125  <q><em class="rfc2119">MUST NOT</em></q>, and <q><em class=rfc2119>MAY</em></q>  <q><em class="rfc2119">MUST NOT</em></q>, and <q><em class=rfc2119>MAY</em></q>
# Line 171  instance of Line 184  instance of
184  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
185  with same  with same
186  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a>  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#prod-identifier"><code>identifier</code></a>
187  part as that of any instance of  part as that of an instance of
188  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
189  in the <i>patch</i>, then the former instance of  in the <i>patch</i>, then the former instance of
190  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>  <a href="http://www.w3.org/TR/2007/WD-DOM-Bindings-20071017/#proddef-InterfaceMember"><code>InterfaceMember</code></a>
# Line 224  tree to <abbr>XML</abbr> document conver Line 237  tree to <abbr>XML</abbr> document conver
237  <abbr>DOM</abbr> Tree Converter</dt>  <abbr>DOM</abbr> Tree Converter</dt>
238    <dd>A software component that converts an <abbr>XML</abbr> information set    <dd>A software component that converts an <abbr>XML</abbr> information set
239    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>    <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>
240    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
241    any particular way for the convertion, but it defines constraints for    any particular way for the conversion, but it defines constraints for
242    such processing.</dd>    such processing.</dd>
243  <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>
244  Information Set Converter</dt>  Information Set Converter</dt>
245    <dd>A software component that converts a <abbr>DOM</abbr> tree into    <dd>A software component that converts a <abbr>DOM</abbr> tree into
246    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
247    any particular way for the convertion, but it defines constraints for    any particular way for the conversion, but it defines constraints for
248    such processing.</dd>    such processing.</dd>
249  </dl>  </dl>
250  </div>  </div>
# Line 299  these kinds of nodes, methods and attrib Line 312  these kinds of nodes, methods and attrib
312  <dl>  <dl>
313  <dt><code id=attributes>attributes</code>,  <dt><code id=attributes>attributes</code>,
314  <code id=localName>localName</code>,  <code id=localName>localName</code>,
 <code id=manakaiLocalName>manakaiLocalName</code>  
 <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite>,  
315  <code id=namespaceURI>namespaceURI</code>, and  <code id=namespaceURI>namespaceURI</code>, and
316  <code id=prefix>prefix</code></dt>  <code id=prefix>prefix</code></dt>
317    <dd>    <dd>
# Line 391  these kinds of nodes, methods and attrib Line 402  these kinds of nodes, methods and attrib
402    the values of the <code>DOMStringList</code> objects in the    the values of the <code>DOMStringList</code> objects in the
403    <a href="#allowedTokens"><code>allowedTokens</code></a> attributes    <a href="#allowedTokens"><code>allowedTokens</code></a> attributes
404    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
405    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
406    may be different), with an additional constraint that the number of the    may be different), with an additional constraint that the number of the
407    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
408    of the items equal to the string in another list.</p></li>    of the items equal to the string in another list.</p></li>
409    </ul></dd>    </ul></dd>
410    <dt><code id=manakaiLocalName>manakaiLocalName</code>
411    <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
412      <dd><p class=section-info>This entry is applied only to implementations
413      that support this attribute.</p>
414    
415      <p>On getting, the attributes <em class=rfc2119>MUST</em> return
416      <code>null</code>.</p></dd>
417  <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and  <dt><code id=lookupNamespaceURI>lookupNamespaceURI</code> and
418  <code id=lookupPrefix>lookupPrefix</code></dt>  <code id=lookupPrefix>lookupPrefix</code></dt>
419    <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 675  method</dt> Line 693  method</dt>
693      <dt><code>manakaiDeclarationBaseURI</code>,      <dt><code>manakaiDeclarationBaseURI</code>,
694      <code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code>      <code>manakaiEntityBaseURI</code>, and <code>manakaiEntityURI</code>
695      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
696        <dd>No explicit value is set.</dd>        <dd><p class=section-info>This entry is applied only to implementations
697      <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a></dt>        that support these attributes.</p>
698        <dd><code>false</code>.</dd>  
699          <p>No explicit value is set.</p></dd>
700        <dt><a href="#hasReplacementTree"><code>hasReplacementTree</code></a> and
701        <a href="#isExternallyDeclared"><code>isExternallyDeclared</code></a></dt>
702          <dd><p><code>false</code>.</p></dd>
703      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
704        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>        <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
705        <dd>        <dd>
# Line 720  method</dt> Line 742  method</dt>
742        <dd>An empty <code>NodeList</code> object.</dd>        <dd>An empty <code>NodeList</code> object.</dd>
743      <dt><code>manakaiDeclarationBaseURI</code>      <dt><code>manakaiDeclarationBaseURI</code>
744      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>      <cite class="bibref normative">[<a href="#ref-MANAKAI">MANAKAI</a>]</cite></dt>
745        <dd>No explicit value is set.</dd>        <dd><p class=section-info>This entry is applied only to implementations
746          that support these attributes.</p>
747    
748          <p>No explicit value is set.</p></dd>
749      <dt><code>nodeName</code></dt>      <dt><code>nodeName</code></dt>
750        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>        <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
751      <dt><code>ownerDocument</code></dt>      <dt><code>ownerDocument</code></dt>
752        <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
753          the method is invoked.</p></dd>
754      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>      <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
755      and <code>parentNode</code></dt>      and <code>parentNode</code></dt>
756        <dd><code>null</code>.</dd>        <dd><code>null</code>.</dd>
# Line 764  Interface</h3> Line 790  Interface</h3>
790    
791  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface  <p>A <a href="#DocumentType"><code>DocumentType</code></a> interface
792  <em class=rfc2119>MAY</em> contain zero or more  <em class=rfc2119>MAY</em> contain zero or more
793  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes in the <code>NodeList</code> object
794  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  
795  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
796    
797  <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
798  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>
799  document, the <code>NodeList</code> object in the <code>childNodes</code>  document, the <code>NodeList</code> object in the <code>childNodes</code>
800  object <em class=rfc2119>MUST</em> contains the  object <em class=rfc2119>MUST</em> contains the
801  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a>  <code>ProcessingInstruction</code> nodes representing the processing
802  nodes representing the processing instructions in the document type  instructions in the document type definition of the document processed
 definition of the document processed  
803  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,  <cite class="bibref normative">[<a href="#ref-XML10">XML10</a>,
804  <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
805  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 790  type declaration information item</a> Line 814  type declaration information item</a>
814  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,  <cite class="bibref normative">[<a href="#ref-INFOSET">INFOSET</a>]</cite>,
815  the <code>NodeList</code> object in the <code>childNodes</code> attribute  the <code>NodeList</code> object in the <code>childNodes</code> attribute
816  of the node <em class=rfc2119>MUST</em> contain the  of the node <em class=rfc2119>MUST</em> contain the
817  <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  <code>ProcessingInstruction</code> nodes created from any
 created from any  
818  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.pi">processing
819  instruction information items</a> in the list in the [children] property of the  instruction information items</a> in the list in the [children] property of the
820  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document  <a href="http://www.w3.org/TR/2004/REC-xml-infoset-20040204/#infoitem.doctype">document
# Line 800  type declaration item</a> in the same or Line 823  type declaration item</a> in the same or
823  <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
824  a document type declaration information item, the list in the [children]  a document type declaration information item, the list in the [children]
825  property <em class=rfc2119>MUST</em> contain the processng instruction  property <em class=rfc2119>MUST</em> contain the processng instruction
826  information items created from the  information items created from the <code>ProcessingInstruction</code> nodes
 <a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> nodes  
827  in the <code>NodeList</code> object in the <code>childNodes</code> attribute  in the <code>NodeList</code> object in the <code>childNodes</code> attribute
828  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>  of the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
829    
# Line 828  read$B!>(Bonly.</p> Line 850  read$B!>(Bonly.</p>
850  <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>
851  set the specified value as the value associated to the attribute.  No  set the specified value as the value associated to the attribute.  No
852  normalization, relative reference resolution, or lexical validation is  normalization, relative reference resolution, or lexical validation is
853  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
854  mpty string be set?</span></p>  empty string be set?</span></p>
855    
856  <div class="note memo">  <div class="note memo">
857  <p>Setting an invalid identifier might make the node unserializable.  <p>Setting an invalid identifier might make the node unserializable.
858  Setting a public identifier while leaveing system identifier unspecified  Setting a public identifier while leaving system identifier unspecified
859  would also make the <a href="#DocumentType"><code>DocumentType</code></a>  would also make the <a href="#DocumentType"><code>DocumentType</code></a>
860  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>  or <a href="#Entity"><code>Entity</code></a> node unserializable.</p>
861  </div>  </div>
# Line 876  and <a href="#feature-XDoctype-3.0"><cod Line 898  and <a href="#feature-XDoctype-3.0"><cod
898  feature <code>Core</code> version <code>3.0</code>  feature <code>Core</code> version <code>3.0</code>
899  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>  <cite class="bibref normative">[<a href="#ref-DOM3CORE">DOM3CORE</a>]</cite>).</p>
900    
 <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>  
   
901  <p>The  <p>The
902  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>  <a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a>
903  interface <em class=rfc2119>MUST</em> be implemented as the following  interface <em class=rfc2119>MUST</em> be implemented as the following
# Line 979  and therefore any change of read-only fl Line 991  and therefore any change of read-only fl
991  reflected by that of the object.  reflected by that of the object.
992  -->  -->
993  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type  <dt><dfn id=notations class=dom-attr><code>notations</code></dfn> of type
994  <code>notations</code>, read$B!>(Bonly</code>  <code>NamedNodeMap</code>, read$B!>(Bonly</code>
995    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
996    contains all the notations belonging to the    contains all the notations belonging to the
997    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>    <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
# Line 1040  method</dt> Line 1052  method</dt>
1052    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the    <a href="#elementTypes"><code>elementTypes</code></a> attribute of the
1053    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
1054    <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>  
1055  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,  <dt><dfn id=getGeneralEntityNode class=dom-method><code>getGeneralEntityNode</code></dfn>,
1056  method</dt>  method</dt>
1057    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node    <dd><p>Returns the <a href="#Entity"><code>Entity</code></a> node
1058    with the specified name.</p>    with the specified name.</p>
1059    
1060    <p>The <dfn id=getEntityNode-name class=dom-param><var>name</var></dfn>    <p>The
1061      <dfn id=getGeneralEntityNode-name class=dom-param><var>name</var></dfn>
1062    parameter is the name of the general entity.</p>    parameter is the name of the general entity.</p>
1063    
1064    <p>When invoked, the method <em class=rfc2119>MUST</em> return the    <p>When invoked, the method <em class=rfc2119>MUST</em> return the
1065    <a href="#Entity"><code>Entity</code></a> node,    <a href="#Entity"><code>Entity</code></a> node,
1066    whose <a href="#nodeName"><code>nodeName</code></a> is equal to    whose <a href="#nodeName"><code>nodeName</code></a> is equal to
1067    <a href="#getEntityNode-name"><var>name</var></a>, in the    <a href="#getGeneralEntityNode-name"><var>name</var></a>, in the
1068    <code>NamedNodeMap</code> object in the    <code>NamedNodeMap</code> object in the
1069    <a href="#entities"><code>entities</code></a> attribute of the    <a href="#entities"><code>entities</code></a> attribute of the
1070    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 1093  method</dt> Line 1088  method</dt>
1088    <code>null</code>.</p></dd>    <code>null</code>.</p></dd>
1089  <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,  <dt><dfn id=setElementTypeDefinitionNode class=dom-method><code>setElementTypeDefinitionNode</code></dfn>,
1090  method</dt>  method</dt>
1091    <dd class=ed>@@</dd>    <dd><p>Associate an
1092      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1093      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1094    
1095      <p>The
1096      <dfn id=setElementTypeDefinitionNode-node class=dom-param><var>node</var></dfn>
1097      parameter is the node to associate.</p>
1098    
1099      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1100      to <a href="#algorithm-attach-node">attach a node</a>, where
1101      <a href="#attach-node-n"><var>n</var></a> is the
1102      <a href="#DocumentType"><code>DocumentType</code></a> node,
1103      <a href="#attach-node-l"><var>l</var></a> is the
1104      <a href="#elementTypes"><code>elementTypes</code></a> attribute value of the
1105      <a href="#DocumentType"><code>DocumentType</code></a> node,
1106      <a href="#attach-node-node"><var>node</var></a> is the
1107      <a href="#setElementTypeDefinitionNode-node"><var>node</var></a>, and
1108      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1109      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1110      attribute.</p></dd>
1111  <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,  <dt><dfn id=setGeneralEntityNode class=dom-method><code>setGeneralEntityNode</code></dfn>,
1112  method</dt>  method</dt>
1113    <dd class=ed>@@</dd>    <dd><p>Associate an <a href="#Entity"><code>Entity</code></a>
1114      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1115    
1116      <p>The
1117      <dfn id=setGeneralEntityNode-node class=dom-param><var>node</var></dfn>
1118      parameter is the node to associate.</p>
1119    
1120      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1121      to <a href="#algorithm-attach-node">attach a node</a>, where
1122      <a href="#attach-node-n"><var>n</var></a> is the
1123      <a href="#DocumentType"><code>DocumentType</code></a> node,
1124      <a href="#attach-node-l"><var>l</var></a> is the
1125      <a href="#entities"><code>entities</code></a> attribute value of the
1126      <a href="#DocumentType"><code>DocumentType</code></a> node,
1127      <a href="#attach-node-node"><var>node</var></a> is the
1128      <a href="#setGeneralEntityNode-node"><var>node</var></a>, and
1129      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1130      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1131      attribute.</p></dd>
1132  <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,  <dt><dfn id=setNotationNode class=dom-method><code>setNotationNode</code></dfn>,
1133  method</dt>  method</dt>
1134    <dd class=ed>@@</dd>    <dd><p>Associate an <a href="#Notation"><code>Notation</code></a>
1135      node with the <a href="#DocumentType"><code>DocumentType</code></a> node.</p>
1136    
1137      <p>The <dfn id=setNotationNode-node class=dom-param><var>node</var></dfn>
1138      parameter is the node to associate.</p>
1139    
1140      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1141      to <a href="#algorithm-attach-node">attach a node</a>, where
1142      <a href="#attach-node-n"><var>n</var></a> is the
1143      <a href="#DocumentType"><code>DocumentType</code></a> node,
1144      <a href="#attach-node-l"><var>l</var></a> is the
1145      <a href="#notations"><code>notations</code></a> attribute value of the
1146      <a href="#DocumentType"><code>DocumentType</code></a> node,
1147      <a href="#attach-node-node"><var>node</var></a> is the
1148      <a href="#setNotationNode-node"><var>node</var></a>, and
1149      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1150      <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>
1151      attribute.</p></dd>
1152  </dl>  </dl>
1153    
1154    <p>When a <dfn id=algorithm-attach-node title="attach a node">node is
1155    attached</dfn>, the rules below, with parameters
1156    <dfn id=attach-node-n><var>n</var></dfn>,
1157    <dfn id=attach-node-l><var>l</var></dfn>,
1158    <dfn id=attach-node-node><var>node</var></dfn>, and
1159    <dfn id=attach-node-owner-attr><var>owner-attr</var></dfn>,
1160    <em class=rfc2119>MUST</em> be followed:</p>
1161      <ol>
1162      <li><p>Let
1163      <dfn id=attach-node-r><var>r</var></dfn> be the node in
1164      <var>l</var> whose <code>nodeName</code> attribute value is equal to the
1165      <code>nodeName</code> attribute value of <var>node</var>, if any.</p></li>
1166      <li><p>If <var>r</var> is different from <code>null</code> and <var>r</var>
1167      is same node as <var>node</var>, then abort these steps.</p></li>
1168      <li><p>If <var>n</var> is <a href="#read-only">read$B!>(Bonly</a>, then raise a
1169      <code>NO_MODIFICATION_ALLOWED_ERR</code> and abort these steps.</p></li>
1170      <li><p>If the <code>ownerDocument</code> attribute value of <var>node</var>
1171      is different from that of <var>n</var>, then raise a
1172      <code>WRONG_DOCUMENT_ERR</code> and abort these steps.</p></li>
1173      <li><p>If the value of the attribute <var>owner-attr</var> of <var>node</var>
1174      is different from <code>null</code>, then raise a
1175      <code>HIERARCHY_REQUEST_ERR</code> and abort these steps.</p></li>
1176      <li><p>If <var>r</var> is a node, then remove it from <var>r</var>.</p>
1177    
1178      <div class="note memo">
1179      <p>By the removal of <var>r</var>, the attribute <var>owner-attr</var> of
1180      <var>r</var> is set to <code>null</code>.</p>
1181      </div></li>
1182      <li><p>Add <var>node</var> to <var>l</var>.</p>
1183    
1184      <div class="note memo">
1185      <p>By the addition of <var>node</var>, the attribute <var>owner-attr</var> of
1186      <var>node</var> is set to <var>n</var>.</p>
1187      </div></li>
1188      </ol>
1189    
1190  <div class=ed>  <div class=ed>
1191  <p>A future version of this interface might define the  <p>A future version of this interface might define the
1192  <code>parameterEntities</code> and getter/setter for parameter entities.  <code>parameterEntities</code> and getter/setter for parameter entities.
# Line 1149  interface <em class=rfc2119>MUST</em> be Line 1234  interface <em class=rfc2119>MUST</em> be
1234    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>    <a href="#AttributeDefinition">AttributeDefinition</a> <a href="#getAttributeDefinitionNode">getAttributeDefinitionNode</a>
1235      (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);      (in DOMString <a href="#getAttributeDefinitionNode-name"><var>name</var></a>);
1236    void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>    void <a href="#setAttributeDefinitionNode">setAttributeDefinitionNode</a>
1237      (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>)
1238      raises (DOMException);      raises (DOMException);
1239  }</code></pre>  }</code></pre>
1240    
# Line 1178  of type <a href="#DocumentType"><code>Do Line 1263  of type <a href="#DocumentType"><code>Do
1263    a <a href="#DocumentType"><code>DocumentType</code></a> node,    a <a href="#DocumentType"><code>DocumentType</code></a> node,
1264    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>    then <code>null</code> <em class=rfc2119>MUST</em> be returned.</p></dd>
1265  <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>  <dt><dfn id=attributeDefinitions class=dom-attr><code>attributeDefinitions</code></dfn>
1266  of type NamedNodeMap, read$B!>(Bonly</dt>  of type <code>NamedNodeMap</code>, read$B!>(Bonly</dt>
1267    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that    <dd><p>A <a href="#live">live</a> <code>NamedNodeMap</code> object that
1268    contains all the attribute definitions belonging to the    contains all the attribute definitions belonging to the
1269    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
# Line 1231  method</dt> Line 1316  method</dt>
1316    <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>    <em class=rfc2119>MUST</em> return <code>null</code>.</p></dd>
1317  <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,  <dt><dfn id=setAttributeDefinitionNode class=dom-method><code>setAttributeDefinitionNode</code></dfn>,
1318  method</dt>  method</dt>
1319    <dd class=ed>@@</dd>    <dd><p>Associate an
1320      <a href="#AttributeDefinition"><code>AttributeDefinition</code></a> node with
1321      the
1322      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1323      node.</p>
1324    
1325      <p>The
1326      <dfn id=setAttributeDefinitionNode-node class=dom-param><var>node</var></dfn>
1327      parameter is the node to associate.</p>
1328    
1329      <p>When invoked, the method <em class=rfc2119>MUST</em> follow the rules
1330      to <a href="#algorithm-attach-node">attach a node</a>, where
1331      <a href="#attach-node-n"><var>n</var></a> is the
1332      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
1333      node, <a href="#attach-node-l"><var>l</var></a> is the
1334      <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1335      attribute value of the
1336      <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node,
1337      <a href="#attach-node-node"><var>node</var></a> is the
1338      <a href="#setAttributeDefinitionNode-node"><var>node</var></a>, and
1339      <a href="#attach-node-owner-attr"><var>owner-attr</var></a> is the
1340      <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>
1341      attribute.</p></dd>
1342  </dl>  </dl>
1343    
1344  <div class=ed>  <div class=ed>
# Line 1313  read$B!>(Bonly</dt> Line 1420  read$B!>(Bonly</dt>
1420    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an    <p>On getting, the attribute <em class=rfc2119>MUST</em> return an
1421    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a> node.
1422    It <em class=rfc2119>MUST</em> be such a node that whose    It <em class=rfc2119>MUST</em> be such a node that whose
1423    <a href="#attributeDefinitons"><code>attributeDefinitions</code></a>    <a href="#attributeDefinitions"><code>attributeDefinitions</code></a>
1424    attribute contains the <code>NamedNodeMap</code> object that contains    attribute contains the <code>NamedNodeMap</code> object that contains
1425    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>    the <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
1426    node.  If there is no such an    node.  If there is no such an
# Line 1514  type <code>unsigned short</code></dt> Line 1621  type <code>unsigned short</code></dt>
1621    <p>The definition group    <p>The definition group
1622    <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>    <dfn id=DefaultValueType><code>DefaultValueType</code></dfn>
1623    contains integers indicating the type of the default for the attribute.    contains integers indicating the type of the default for the attribute.
1624    The definition group contains the following constans:</p>    The definition group contains the following constants:</p>
1625    
1626    <table>    <table>
1627    <thead>    <thead>
# Line 1592  validation is performed.  The new value Line 1699  validation is performed.  The new value
1699    
1700  <dl>  <dl>
1701  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>  <dt><dfn id=hasReplacementTree class=dom-attr><code>hasReplacementTree</code></dfn>
1702  of type boolean</dt>  of type <code>boolean</code></dt>
1703    <dd><p>Whether the structure of the replacement text of the entity    <dd><p>Whether the structure of the replacement text of the entity
1704    is available via the <code>NodeList</code> object in the    is available via the <code>NodeList</code> object in the
1705    <code>childNodes</code> attribute of the entity.</p>    <code>childNodes</code> attribute of the entity.</p>
# Line 1636  of type boolean</dt> Line 1743  of type boolean</dt>
1743    attribute set to <code>false</code>.</p>    attribute set to <code>false</code>.</p>
1744    </div></dd>    </div></dd>
1745  <dt><dfn id=isExternallyDeclared class=dom-attr><code>isExternallyDeclared</code></dfn>  <dt><dfn id=isExternallyDeclared class=dom-attr><code>isExternallyDeclared</code></dfn>
1746  of type boolean</dt>  of type <code>boolean</code></dt>
1747    <dd><p>Whether the entity is declared by an external entity declaration or    <dd><p>Whether the entity is declared by an external entity declaration or
1748    not.  If the value is <code>true</code>, the entity is declared in an entity    not.  If the value is <code>true</code>, the entity is declared in an entity
1749    declaration in the external subset entity or in an external parameter entity.    declaration in the external subset entity or in an external parameter entity.
# Line 1727  interface <em class=rfc2119>MUST</em> be Line 1834  interface <em class=rfc2119>MUST</em> be
1834    <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions">    <dd><cite><a href="http://suika.fam.cx/gate/2005/sw/manakai/DOM%20Extensions">
1835    manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft.  Work in    manakai's <abbr>DOM</abbr> Extensions</a></cite>, editor's draft.  Work in
1836    progress.</dd>    progress.</dd>
1837  <dt id=ref-XML10">XML10</dt>  <dt id=ref-XML10>XML10</dt>
1838    <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
1839    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,    Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
1840    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August    <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August
# Line 1753  interface <em class=rfc2119>MUST</em> be Line 1860  interface <em class=rfc2119>MUST</em> be
1860  <dt id=ref-DOM1WD>DOM1WD</dt>  <dt id=ref-DOM1WD>DOM1WD</dt>
1861    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-971209/">Document Object    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-971209/">Document Object
1862    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1863    <time datetime=1997-12-09>9 December 1998</time>.</dd>    <time datetime=1997-12-09>9 December 1997</time>.</dd>
1864    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object    <dd><cite><a href="http://www.w3.org/TR/WD-DOM-19980318/">Document Object
1865    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,    Model Specification</a></cite>, <abbr>W3C</abbr> Working Draft,
1866    <time datetime=1998-03-18>18 March 1998</time>.</dd>    <time datetime=1998-03-18>18 March 1998</time>.</dd>
Legend:
Removed from v.1.25  
changed lines
  Added in v.1.31
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24