xml/domdtdef/domdtdef-work.en.html

<!DOCTYPE html>
<html lang="en" class="formal-specification status-work-in-progress">
<head>
<title>DOM Document Type Definition Module</title>
<link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">
<link rel="stylesheet" href="http://suika.fam.cx/www/style/def/dom">
<link rel="license" href="http://suika.fam.cx/c/gnu/fdl">
</head>
<body class="has-abstract">

<div class="header">
<h1>DOM Document Type Definition Module</h1>
<h2>Working Draft <time datetime=2007-12-01>1 December 2007</time></h2>

<dl class="versions-uri">
<dt>This Version</dt>
  <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
      >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
<dt>Latest Version</dt>
  <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef"
      >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef</a>&gt;</code></dd>
<dt>Latest Working Draft</dt>
  <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work"
      >http://suika.fam.cx/www/markup/xml/domdtdef/domdtdef-work</a>&gt;</code></dd>
<!-- <dt>Previous Version</dt> -->
<dt>Version History</dt>
  <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>
<dt id=author>Author</dt>
  <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"
      lang=ja>Wakaba</a>
  <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"
      >w@suika.fam.cx</a>&gt;</code></dd>
</dl>

<p class="copyright" lang="en">&#xA9; <time>2007</time> <a
    href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.
Permission is granted to copy, distribute and/or modify this document
under the terms of the <a rel="license"
href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>,
Version 1.2
or any later version published by the <a
href="http://www.fsf.org/">Free Software Foundation</a>;
with no Invariant Sections, no Front$B!>(BCover Texts, and no Back$B!>(BCover
Texts.  A copy of the license is
available at <code class="URI">&lt;<a
    href="http://www.gnu.org/copyleft/fdl.html"
    rel="license">http://www.gnu.org/copyleft/fdl.html</a>&gt;</code>.</p>
</div>

<div id="abstract" class="section">
<h2>Abstract</h2>

<div class="ed issue">...</div>

</div>

<div id="status" class="section">
<h2>Status of This Document</h2>

<p class=section-info><em>This section describes the status of this document
at the time of its publication.  Other documents
might supersede this document.</em></p>

<p>This document is a working draft, produced as part of the 
<a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a> 
project.  It might be updated, replaced, or obsoleted by
other documents at any time.  It is inappropriate to
cite this document as other than <q>work in progress</q>.</p>

<p>Comments on this document are welcome and
may be sent to the <a href="#author">author</a>.</p>

<p>Translations of thie document might be available.
The English version of the document is the only
normative version.</p>
</div>

<div id="introduction" class="section">
<h2>Introduction</h2>

<p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>

<div class="issue ed">
<p>This is a work-in-progress specification for DOM Document Type
Definition module, as implemented by manakai and 
<a href="http://suika.fam.cx/gate/2005/sw/DOM%20XML%20Document%20Type%20Definition">partially documented in the SuikaWiki</a>.</p>
</div>

<p>The <dfn id=term-dom-dtdef><abbr>DOM</abbr> Document Type Definition</dfn>
module is a set of <abbr>DOM</abbr> interfaces, including both new
interfaces and modifications to existing <abbr>DOM</abbr> interfaces,
over which <abbr>DOM</abbr> applications are able to access to the
definitions of the document type.</p>

<p>Interfaces defined in this specification are partially modeled from
early drafts of <abbr>DOM</abbr> level 1 <span class=ed>@@ ref</span>,
<abbr>DOM</abbr> Abstract Schema level 3 <span class=ed>@@ ref</span>, and
<abbr>XML</abbr> Schema <abbr>API</abbr>, but are not compatible with
any of them as a whole.</p>
</div>

<div class="section" id="terminology">
<h2>Terminology</h2>

<p>The key words <q><em class="rfc2119">MUST</em></q>,
<q><em class="rfc2119">MUST NOT</em></q>,
<q><em class="rfc2119">SHOULD</em></q>,
<q><em class="rfc2119">SHOULD NOT</em></q>, and
<q><em class=rfc2119>MAY</em></q> in this
document are to be interpreted as described in 
<a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr> 
2119</a>
<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>

<!-- Strictly speaking the paragraph below is not part of terminology. -->
<p>All examples and notes in this specification are non$B!>(Bnormative,
as are all sections explicitly marked non$B!>(Bnormative.  Everything
else in this specification is normative.</p>

<p><span class=ed>Algorithm is normative but non-normative</span>.
In addition, the order in which <a href="#errors">errors</a> are
raised is undefined.</p>

<p class=ed><var>A</var> object is an object implementing <var>A</var>
interface.</p>

<p class=ed>@@ ref to DOM Binding Spec</p>
</div>

<div class=section id=dom-dtdef>
<h2><abbr>DOM</abbr> Document Type Definition Module</h2>

<p>The <abbr>DOM</abbr> Document Type Definition module, version 3.0, 
consists of three interfaces:</p>
<ul>
<li><a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a></li>
<li><a href="#DocumentTypeDefinition"><code>DocumentTypeDefinition</code></a></li>
<li><a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a></li>
<li><a href="#AttributeDefinition"><code>AttributeDefinition</code></a></li>
</ul>

<p>In addition, it adds methods, attributes, and/or constants to interfaces 
<a href="#Node"><code>Node</code></a>,
<a href="#Entity"><code>Entity</code></a>,
<a href="#EntityReference"><code>EntityReference</code></a>, and
<a href="#Notation"><code>Notation</code></a>.
It modifies semantics of some of methods and attributes in
<a href="#Node"><code>Node</code></a> and
<a href="#ProcessingInstruction"><code>ProcessingInstruction</code></a> 
interfaces, for the support of new interfaces.</p>

<div class=section id=features>
<h3>Feature Name</h3>

<p>In a <abbr>DOM</abbr> implementation that supports the version 3.0 of 
the <abbr>DOM</abbr> Document Type Definition module, the 
<code>hasFeature</code> method of a <code>DOMImplementation</code> object 
<em class=rfc2119>MUST</em> return <code>true</code> when the parameters are
set to <code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and 
<code>3.0</code> respectively.</p>

<p>In such an implementation, the <code>getFeature</code> method of a 
<code>Document</code> object <em class=rfc2119>MUST</em> return the (at least
conceptually) same object implementing the
<a href="#DocumentXDoctype"><code>DocumentXDoctype</code></a> interface when
the parameters are set to 
<code>http://suika.fam.cx/www/2006/feature/XDoctype</code> and 
<code>3.0</code> respectively.  Likewise, any method that takes one or more
feature names with or without version number, including the methods
<code>hasFeature</code> and <code>getFeature</code>, 
<em class=rfc2119>MUST</em> behave in a manner consistent with the 
aforementioned cases.</p>
</div>

<div class=section id=section-documentxdoctype>
<h3>The <code>DocumentXDoctype</code> Interface</h3>

<pre class=idl><code>interface <dfn id=DocumentXDoctype><code>DocumentXDoctype</code></dfn> {
  DocumentType <a href="#createDocumentTypeDefinition">createDocumentTypeDefinition</a>
    (in DOMString <a href="#createDocumentTypeDefinition-name"><var>name</var></a>)
    raises (DOMException);
  ElementTypeDefinition <a href="#createElementTypeDefinition">createElementTypeDefinition</a>
    (in DOMString <a href="#createElementTypeDefinition-name"><var>name</var></a>)
    raises (DOMException);
  AttributeDefinition <a href="#createAttributeDefinition">createAttributeDefinition</a>
    (in DOMString <a href="#createAttributeDefinition-name"><var>name</var></a>)
    raises (DOMException);
  Entity <a href="#createGeneralEntity">createGeneralEntityDefinition</a>
    (in DOMString <a href="#createGeneralEntity-name"><var>name</var></a>)
    raises (DOMException);
  Notation <a href="#createNotation">createNotation</a>
    (in DOMString <a href="#createNotation-name"><var>name</var></a>)
    raises (DOMException);
}</code></pre>

<div class=ed>@@ cast definition</div>

<dl>
<dt><dfn id=createDocumentTypeDefinition class=dom-method><code>createDocumentTypeDefinition</code></dfn>,
method</dt>
  <dd>
    <p>This method creates a <code>DocumentType</code> node with the specified
    name, belonging to the document.</p>
    <p>The <dfn id=createDocumentTypeDefinition-name class=dom-param><var>name</var></dfn>
    parameter is the name of the document type.</p>

    <p>When invoked, the method <em class=rfc2119>MUST</em> create and
    return a <code>DocumentType</code> node with the following attributes:</p>
    <dl>
    <dt><code>attributes</code>, <code>parentNode</code></dt>
      <dd><code>null</code>.</dd>
    <dt><code>elementTypes</code>, <code>generalEntities</code>, and
    <code>notations</code></dt>
      <dd>Empty <code>NamedNodeMap</code> objects.</dd>
    <dt><code>entities</code></dt>
      <dd>The same value as the <code>generalEntities</code> attribute.</dd>
    <dt><code>childNodes</code></dt>
      <dd>An empty <code>NodeList</code> object.</dd>
    <dt><code>internalSubset</code>, <code>publicId</code>, and
    <code>systemId</code></dt>
      <dd>Empty strings.</dd>
    <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
      <dd><code>false</code>.</dd>
    <dt><code>nodeName</code></dt>
      <dd><a href="#createDocumentTypeDefinition-name"><var>name</var></a>.</dd>
    <dt><code>ownerDocument</code></dt>
      <dd>The <code>Document</code> over which the method is invoked.</dd>
    </dl>
    <p>In addition, the method <em class=rfc2119>MUST</em> be marked as 
    containing five general entity declarations: <code>amp</code>,
    <code>lt</code>, <code>gt</code>, <code>quot</code>, and
    <code>apos</code>.</p>
  </dd>
<dt><dfn id=createElementTypeDefinition class=dom-method><code>createElementTypeDefinition</code></dfn>,
method</dt>
  <dd>
    <p>This method creates a <code>ElementTypeDefinition</code> node with the
    specified name, belonging to the document.</p>
    <p>The <dfn id=createElementTypeDefinition-name class=dom-param><var>name</var></dfn>
    parameter is the name of the element type defined by the element
    type definition.</p>

    <p>When invoked, the method <em class=rfc2119>MUST</em> create and 
    return an
    <a href="#ElementTypeDefinition"><code>ElementTypeDefinition</code></a>
    node with the following attributes:</p>
    <dl>
    <dt><a href="#attributeDefinitions"><code>attributeDefinitions</code></a></dt>
      <dd>An empty <code>NamedNodeMap</code> object.</dd>
    <dt><code>attributes</code>, <code>parentNode</code></dt>
      <dd><code>null</code>.</dd>
    <dt><code>childNodes</code></dt>
      <dd>An empty <code>NodeList</code> object.</dd>
    <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
      <dd><code>false</code>.</dd>
    <dt><code>nodeName</code></dt>
      <dd><a href="#createElementTypeDefinition-name"><var>name</var></a>.</dd>
    <dt><code>ownerDocument</code></dt>
      <dd>The <code>Document</code> node over which the method is invoked.</dd>
    <dt><a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a></dt>
      <dd><code>null</code>.</dd>
    <dt class=ed>@@ Ensure all attributes are defined</dt>
    </dl>
  </dd>
<dt><dfn id=createAttributeDefinition class=dom-method><code>createAttributeDefinition</code></dfn>,
method</dt>
  <dd>
    <p>This method creates a <code>AttributeDefinition</code> node with the
    specified name, belonging to the document.</p>
    <p>The <dfn id=createAttributeDefinition-name class=dom-param><var>name</var></dfn>
    parameter is the name of the attribute defined by the attribute
    definition.</p>

    <p>When invoked, the method <em class=rfc2119>MUST</em> create and 
    return an
    <a href="#AttributeDefinition"><code>AttributeDefinition</code></a>
    node with the following attributes:</p>
    <dl>
    <dt><code>allowedTokens</code></dt>
      <dd>An empty <code>DOMStringList</code> object.</dd>
    <dt><code>attributes</code>,
    <a href="#ownerElementTypeDefinition"><code>ownerElementTypeDefinition</code></a>,
    and <code>parentNode</code></dt>
      <dd><code>null</code>.</dd>
    <dt><code>childNodes</code></dt>
      <dd>An empty <code>NodeList</code> object.</dd>
    <dt><code>declaredType</code></dt>
      <dd><a href="#NO_TYPE_ATTR"><code>NO_TYPE_ATTR</code></a>.</dd>
    <dt><code>defaultType</code></dt>
      <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>
    <dt><code>nodeName</code></dt>
      <dd><a href="#createAttributeDefinition-name"><var>name</var></a>.</dd>
    <dt><code>ownerDocument</code></dt>
      <dd>The <code>Document</code> node over which the method is invoked.</dd>
    <dt class=ed>@@ Ensure all attributes are defined</dt>
    </dl>

    <div class=ed>
    <p>@@ Should we keep these statements?: 
However, if the &lt;cfg::cfg|xml-id> configuration
parameter is set to <code>true</code> and the <var>name</var>
is <code>xml:id</code>, then the [CODE(DOMa)@en[[[declaredType]]]]
attribute is set to <code>ID_ATTR</code>.
[CODE(DOMa)@en[[[defaultType]]]]?</p>
    </div>
  </dd>
<dt><dfn id=createGeneralEntity class=dom-method><code>createGeneralEntity</code></dfn>,
method</dt>
  <dd>
    <p>This method creates a <a href="#Entity"><code>Entity</code></a> node
    with the specified name, which represents a general entity, belonging to
    the document.</p>
    <p>The <dfn id=createGeneralEntity-name class=dom-param><var>name</var></dfn>
    parameter is the name of the general entity.</p>

    <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
    an <a href="#Entity"><code>Entity</code></a> node with the following
    attributes:</p>
    <dl>
    <dt><code>attributes</code>, <code>notationName</code>,
    <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
    and <code>parentNode</code></dt>
      <dd><code>null</code>.</dd>
    <dt><code>childNodes</code></dt>
      <dd>An empty <code>NodeList</code> object.</dd>
    <dt><code>manakaiDeclarationBaseURI</code>,
    <code>manakaiEntityBaseURI</code>, and
    <code>manakaiEntityURI</code> <span class=ed>@@ ref</span></dt>
      <dd>No explicit value is set.</dd>
    <dt><code>manakaiHasReplacementTree</code> and
    <code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
      <dd><code>false</code>.</dd>
    <dt><code>nodeName</code></dt>
      <dd><a href="#createGeneralEntity-name"><var>name</var></a>.</dd>
      <dd>
        <div class="note memo">
          <p>It is not an error for
          <a href="#createGeneralEntity-name"><var>name</var></a> matching
          to the name of one of predefined general parsed entities in
          <abbr>XML</abbr> or <abbr>HTML</abbr>.  For example, 
          <a href="#createGeneralEntity-name"><var>name</var></a> might be
          <code>amp</code>, resulting in an
          <a href="#Entity"><code>Entity</code></a> node
          with its <code>nodeName</code> attribute set to <code>amp</code>.</p>
        </div>
      </dd>
    <dt><code>ownerDocument</code></dt>
      <dd>The <code>Document</code> node over which the method is invoked.</dd>
    <dt><code>publicId</code>, and <code>systemId</code></dt>
      <dd><code>null</code>.</dd>
      <dd class=ed>@@ publicId and systemId should be empty string?</dd>
    <dt class=ed>@@ Ensure all attributes are defined</dd>
    </dl>
  </dd>
<dt><dfn id=createNotation class=dom-method><code>createNotation</code></dfn>,
method</dt>
  <dd>
    <p>This method creates a <code>Notation</code> node with the
    specified name, belonging to the document.</p>
    <p>The <dfn id=createNotation-name class=dom-param><var>name</var></dfn>
    parameter is the name of the notation.</p>

    <p>When invoked, the method <em class=rfc2119>MUST</em> create and return
    a <code>Notation</code> node with the following attributes:</p>
    <dl>
    <dt><code>attributes</code>,
    <a href="#ownerDocumentTypeDefinition"><code>ownerDocumentTypeDefinition</code></a>,
    and <code>parentNode</code></dt>
      <dd><code>null</code>.</dd>
    <dt><code>childNodes</code></dt>
      <dd>An empty <code>NodeList</code> object.</dd>
    <dt><code>manakaiDeclarationBaseURI</code></dt>
      <dd>No explicit value is set.</dd>
    <dt><code>manakaiReadOnly</code> <span class=ed>[manakai]</span></dt>
      <dd><code>false</code>.</dd>
    <dt><code>nodeName</code></dt>
      <dd><a href="#createNotation-name"><var>name</var></a>.</dd>
    <dt><code>ownerDocument</code></dt>
      <dd>The <code>Document</code> node over which the method is invoked.</dd>
    <dt><code>publicId</code> and <code>systemId</code></dt>
      <dd><code>null</code>.</dd>
      <dd class=ed>@@ publicId and systemId should be empty string?</dd>
    <dt class=ed>@@ Ensure all attributes are defined</dt>
    </dl>
  </dd>
</dl>

<p>These methods <em class=rfc2119>MUST</em> raise an
<code>INVALID_CHARACTER_ERR</code> exception <span class=ed>@@ ref</span>
if <var>name</var> is <em>not</em> a legal <code>Name</code> according to
the <abbr>XML</abbr> version in use, as specified in the 
<code>xmlVersion</code> attribute of the <code>Document</code> node.</p>

<div class="note memo">
<p>Non$B!>(B<abbr>XML</abbr> case is intentionally left unspecified for now,
since <abbr>DOM3</abbr> specification <span class=ed>@@ ref</span> does not
define it for <code>Document</code> methods.</p>

<p><var>name</var> does not have to be a namespace qualified name.</p>

<p>If the <code>strictErrorChecking</code> attribute of the 
<code>Document</code> node is <code>false</code>, the methods are
not required to raise the exception <span class=ed>[DOM3]</span>.</p>
</div>

</div>

<div class=section id=section-documenttypedefinition>
<h3>The <code>DocumentTypeDefinition</code> Interface</h3>

<pre class=idl><code>interface <dfn id=DocumentTypeDefinition><code>DocumentTypeDefinition</code></dfn> {
  
}</code></pre>

<pre class=ed>
[1] In an implementation that supports the 
[CODE(URI)@en[[[http://suika.fam.cx/www/2006/feature/XDoctype]]]]
feature, a [CODE(DOMi)@en[[[DocumentType]]]] node
must implement the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
interface.  See [[DOM XML Document Type Definition]>>3] for
details.


** Children

[2] The [DFN@en[[CODE(DOMa)@en[[[elementTypes]]]] attribute]]
of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that 
contains all element types belongs to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
The attribute is read-only.

What are contained in this collection depends on how
the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node was created.  If the
node was created as the result of parsing of an XML document,
it [['''MUST''']]  contain all element types whose element type and / or 
attribute definition list declaration are encountered by and provided for the DOM
implementation from the XML processor.  Note that the XML processor might not 
provide a part of or entire such information depending on the configuration.
If more than one declarations for an element type or an attribute is available 
at the time of the definition node construction, then declarations other than 
the first ones [['''MUST''']] be discarded.

The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
object that contains all the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] nodes
belong to the node.  The returned [CODE(DOMi)@en[[[NamedNodeMap]]]] object
[['''MUST''']] be read-only if and only if the node is read-only.
Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
and therefore any change of read-only flag on the node is immediately
reflected by that of the object.

[3] The [DFN@en[[CODE(DOMa)@en[[[generalEntities]]]] attribute]]
of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains all the
general entities belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node.
The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
The attribute is read-only.

All entities declared in the document type definition
contained in or referenced from the document entity
might not be exposed through this collection, depending
on the information provided by the XML processor for
the DOM implementation.  In particular, it might not
contain any entity if entity references are expanded
at the parse time.  An implementation [['''MUST NOT''']]
expose an [CODE(DOMi)@en[[[Entity]]]] node whose [CODE(DOMa)@en[[[nodeName]]]]
is equal to the name of one of five predefined general entities in
XML through the collection as the result of parsing of an XML
document that has no error.  Duplicate entity declarations are also discarded.

The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
object that contains all the [CODE(DOMi)@en[[[Entity]]]] nodes
representing general entities belong to the node.  The returned 
[CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if 
the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
and therefore any change of read-only flag on the node is immediately
reflected by that of the object.

The attribute [['''MUST''']] return the same value as the
[CODE(DOMa)@en[[[entites]]]] attribute of the 
[CODE(DOMi)@en[[[DocumentType]]]] interface on the same node.

[4] The [DFN@en[[CODE(DOMa)@en[[[notations]]]] attribute]]
of the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interface
is a live [CODE(DOMi)@en[[[NamedNodeMap]]]] object that contains
all the notations belong to the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]]
node.  The type of the attribute is [CODE(DOMi)@en[[[NamedNodeMap]]]].
The attribute is read-only.

If the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] node is
created from an XML document, duplicate notation declarations, if any, in DTD 
[['''MUST NOT''']] result in a node in the [CODE(DOMi)@en[[[NamedNodeMap]]]]
object and only the first declaration [['''MUST''']] be
made available as a [CODE(DOMi)@en[[[Notation]]]] node.

;; This definition is based on one for the 
[CODE(DOMa)@en[[[notations]]]] attribute of the
[CODE(DOMi)@en[[[DocumentType]]]] interface in DOM XML module.
Since duplication is violation to the Validity Constraint,
XML parsers might vary on how notations are notified to
the application.  In particular, [CODE(InfoProp)@en[[[notations]]]]
property of the document information item in XML Information Set
is so defined that in case ''any'' notation is declared for 
multiple times then the property has no value.

The attribute [['''MUST''']] return the [CODE(DOMi)@en[[[NamedNodeMap]]]]
object that contains all the [CODE(DOMi)@en[[[Notation]]]] nodes
representing notations belong to the node.  The returned 
[CODE(DOMi)@en[[[NamedNodeMap]]]] object [['''MUST''']] be read-only if and only if 
the node is read-only. Note that the [CODE(DOMi)@en[[[NamedNodeMap]]]] object is live
and therefore any change of read-only flag on the node is immediately
reflected by that of the object.

A DOM implementation is not required to implement the
[CODE(DOMa)@en[[[notations]]]] attribute twice
for the [CODE(DOMi)@en[[[DocumentType]]]] and
the [CODE(DOMi)@en[[[DocumentTypeDefinition]]]] interfaces;
the latter is defined to contain the same value as the former.


** Open Issues (informative)

[5] A future version of the interface might define the
[CODE(DOMa)@en[[[parameterEntities]]]] attribute and 
getter/setter for parameter entities.
</pre>
</div>

<div class=section id=section-elementtypedefinition>
<h3>The <code>ElementTypeDefinition</code> Interface</h3>

<pre class=idl><code>interface <dfn id=ElementTypeDefinition><code>ElementTypeDefinition</code></dfn> {
  
}</code></pre>

<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members

[3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
[['''MUST''']] return [CODE(IDL)@en[[[null]]]].

[4] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
[['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
[CODE(DOMi)@en[[[ElementTypeDefinition]]]] object.
Note that it might be [CODE(IDL)@en[[[null]]]].

[1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] object
[['''MUST''']] return the name of the element type.

[2] The getters of the [CODE(DOMa)@en[[[nodeValue]]]] 
and [CODE(DOMa)@en[[[textContent]]]] attributes
of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
object [['''MUST''']] return [CODE(IDL)@en[[[null]]]].

;; Thus, the setter of these attributes do nothing.

The setter of the [CODE(DOMa)@en[[[textContent]]]]
attribute of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
object [['''MUST NOT''']] throw a 
[CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].

** The [CODE(DOMi)@en[ElementTypeDefinition]] Interface

[5] The 
[DFN@en[[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute]]
of the [CODE(DOMi)@en[[[ElementTypeDefinition]]]]
interface is defined in [[manakai//DOM Extensions]>>50].</pre>
</div>

<div class=section id=section-attributedefinition>
<h3>The <code>AttributeDefinition</code> Interface</h3>

<pre class=idl><code>interface <dfn id=AttributeDefinition><code>AttributeDefinition</code></dfn> {
  
}</code></pre>

<pre class=ed>** Modifications to [CODE(DOMi)@en[[[Node]]]] members

[3] The getter of the [CODE(DOMa)@en[[[attributes]]]] attribute
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
[['''MUST''']] return [CODE(IDL)@en[[[null]]]].

[9] The getter of the [CODE(DOMa)@en[[[baseURI]]]] attribute
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
[['''MUST''']] return the [CODE(DOMa)@en[[[baseURI]]]]
of the [CDOE(DOMa)@en[[[ownerDocument]]]] of the
[CODE(DOMi)@en[[[AttributeDefinition]]]] object.
Note that it might be [CODE(IDL)@en[[[null]]]].

[1] The getter of the [CODE(DOMa)@en[[[nodeName]]]] attribute
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
[['''MUST''']] return the name of the attribute.

[2] The getter of the [CODE(DOMa)@en[[[nodeValue]]]] attribute
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
[['''MUST''']] return the normalized default value
of the attribute.

@@

[4] The getter of the [CODE(DOMa)@en[[[textContent]]]]
attribute of an [CODE(DOMi)@en[[[AttributeDefinition]]]] 
object [['''MUST''']] behave as if it were an
[CODE(DOMi)@en[[[Attr]]]] object.

The setter of the [CODE(DOMa)@en[[[textContent]]]] attribute
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object
[['''MUST''']] behave as if the following algorithm
is performed:
= If the [CODE(DOMi)@en[[[AttributeDefinition]]]]
object is read-only, then throw an
[CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]].
= Remove any child node the node has.
= If the new value is not empty and not [CODE(IDL)@en[[[null]]]],
then create a [CODE(DOMi)@en[[[Text]]]] node
whose [CODE(DOMa)@en[[[data]]]] is the new value
and append it to the [CODE(DOMi)@en[[[AttributeDefinition]]]].

** Definition groups

[6] The
[DFN@en[definition group [CODE(DOM)@en[[[DeclaredValueType]]]]]]
contains integers indicating the type of 
attribute value:
,[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]],[CODE(IDL)[[[0]]]],The attribute value type corresponding to [[no value]] in XML Information Set.
,[CODE(DOMc)@en[[[CDATA_ATTR]]]],[CODE(IDL)[[[1]]]],The attribute value type is [CODE(XML)@en[[[CDATA]]]].
,[CODE(DOMc)@en[[[ID_ATTR]]]],[CODE(IDL)[[[2]]]],The attribute value type is [CODE(XML)@en[[[ID]]]].
,[CODE(DOMc)@en[[[IDREF_ATTR]]]],[CODE(IDL)[[[3]]]],The attribute value type is [CODE(XML)@en[[[IDREF]]]].
,[CODE(DOMc)@en[[[IDREFS_ATTR]]]],[CODE(IDL)[[[4]]]],The attribute value type is [CODE(XML)@en[[[IDREFS]]]].
,[CODE(DOMc)@en[[[ENTITY_ATTR]]]],[CODE(IDL)[[[5]]]],The attribute value type is [CODE(XML)@en[[[ENTITY]]]].
,[CODE(DOMc)@en[[[ENTITIES_ATTR]]]],[CODE(IDL)[[[6]]]],The attribute value type is [CODE(XML)@en[[[ENTITIES]]]].
,[CODE(DOMc)@en[[[NMTOKEN_ATTR]]]],[CODE(IDL)[[[7]]]],The attribute value type is [CODE(XML)@en[[[NMTOKEN]]]].
,[CODE(DOMc)@en[[[NMTOKENS_ATTR]]]],[CODE(IDL)[[[8]]]],The attribute value type is [CODE(XML)@en[[[NMTOKENS]]]].
,[CODE(DOMc)@en[[[NOTATION_ATTR]]]],[CODE(IDL)[[[9]]]],The attribute value type is [CODE(XML)@en[[[NOTATION]]]].
,[CODE(DOMc)@en[[[ENUMERATION_ATTR]]]],[CODE(IDL)[[[10]]]],The attribute value is enumeration type.
,[CODE(DOMc)@en[[[UNKNOWN_ATTR]]]],[CODE(IDL)[[[11]]]],"The attribute value type is unknown, because no declaration for the attribute has been read but not [CODE(InfoProp)@en[[[all declarations processed]]]] property would be false."

The type of these constants are 
[CODE(IDL)@en[[[unsigned]] [[short]]]].

If no attribute type information is provided,
or if the source of that information does not 
distinguish [[no value]] and [[unknown]] as in
XML Information Set, then the 
[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]] value 
[['''MUST''']] be used.

;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
method has [CODE(DOMa)@en[[[declaredType]]]] attribute
set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].

If the source of the attribute type information
does not distinguish [[no value]] and / or [[unknown]]
and [CODE(XML)@en[[[CDATA]]]], then the
[CODE(DOMc)@en[[[CDATA_ATTR]]]] value [['''MUST''']]
be used.

[11]
In Perl binding, the objects implementing the 
[CODE(DOMi)@en[[[Attr]]]] interface [['''MUST''']]
also implement the [CODE(DOM)@en[[[DeclaredValueType]]]]
constant group.

[7] The
[DFN@en[definition group [CODE(DOM)@en[[[DefaultValueType]]]]]]
contains integers indicating the type of 
default attribute value:
,[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]],[CODE(IDL)[[[0]]]],The default value is unknown.
,[CODE(DOMc)@en[[[FIXED_DEFAULT]]]],[CODE(IDL)[[[1]]]],The default value is provided and the attribute is [CODE(XML)@en[#[[FIXED]]]] to that value.
,[CODE(DOMc)@en[[[REQUIRED_DEFAULT]]]],[CODE(IDL)[[[2]]]],An attribute specification is [CODE(XML)@en[#[[REQUIRED]]]] for the attribute.
,[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]],[CODE(IDL)[[[3]]]],The default value is [CODE(XML)@en[#[[IMPLIED]]]].
,[CODE(DOMc)@en[[[EXPLICIT_DEFAULT]]]],[CODE(IDL)[[[4]]]],The default value is provided but the attribute is not fixed to it.

The type of these constants are 
[CODE(IDL)@en[[[unsigned]] [[short]]]].

If the source of the attribute default value type
does not distinguish the [CODE(XML)@en[#[[IMPLIED]]]]
default and unknown default, then the 
[CODE(DOMc)@en[[[IMPLIED_DEFAULT]]]] value
[['''MUST''']] be used.

;; A newly created [CODE(DOMi)@en[[[AttributeDefinition]]]]
object by [CODE(DOMm)@en[[[createAttributeDefinition]]]]
method has [CODE(DOMa)@en[[[declaredType]]]] attribute
set to [CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].

** Tree-relationship Attributes

[10] 
The 
[DFN@en[[CODE(DOMa)@en[[[ownerElementTypeDefinition]]]] attribute]]
of the [CODE(DOMi)@en[[[AttributeDefinition]]]] interface
is read-only and of type 
[CODE(DOMi)@en[[[ElementTypeDefinition]]]].
It is the [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
which the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
belong to.

If the [CODE(DOMi)@en[[[AttributeDefinition]]]] node
is included in the [CODE(DOMa)@en[[[attributeDefinitions]]]]
list of an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node,
then the attribute [['''MUST''']] return the
[CODE(DOMi)@en[[[ElementTypeDefinition]]]] node.
Otherwise, it [['''MUST''']] return [CODE(DOM)@en[[[null]]]].

;; This attribute is analogue to the
[CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]] attribute
for [CODE(DOMi)@en[[[ElementTypeDefinition]]]],
[CODE(DOMi)@en[[[Entity]]]], and [CODE(DOMi)@en[[[Notation]]]]
nodes, or the [CODE(DOMa)@en[[[ownerElement]]]]
attribute for [CODE(DOMi)@en[[[Attr]]]] nodes.

** Attributes

[5]
The [DFN@en[[CODE(DOMa)@en[[[declaredType]]]] attribute]]
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object 
represents the type of the attribute value.

This attribute is read-write.
The type of the attribute is 
[CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected 
that this attribute has a value from the definition group
[CODE(DOM)@en[[[DeclaredValueType]]]].

The getter [['''MUST''']] return a value associated
to this attribute.

The setter [['''MUST''']]
throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
[CODE(DOMi)@en[[[DOMException]]]] if the 
[CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
Otherwise, the setter [['''MUST''']] set the specified
value as the value associated to this attribute.

If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
object, then it [['''MUST''']] set a value 
from the [CODE(DOM)@en[[[DeclaredValueType]]]] 
definition group.

[8]
The [DFN@en[[CODE(DOMa)@en[[[defaultType]]]] attribute]]
of an [CODE(DOMi)@en[[[AttributeDefinition]]]] object 
represents the type of the attribute default value.

This attribute is read-write.
The type of the attribute is 
[CODE(IDL)@en[[[unsigned]] [[short]]]].  It is expected 
that this attribute has a value from the definition group
[CODE(DOM)@en[[[DefaultValueType]]]].

The getter [['''MUST''']] return a value associated
to this attribute.

The setter [['''MUST''']]
throw a [CODE(DOMc)@en[[[NO_MODIFICATION_ALLOWED_ERR]]]]
[CODE(DOMi)@en[[[DOMException]]]] if the 
[CODE(DOMi)@en[[[AttributeDefinition]]]] object is read-only.
Otherwise, the setter [['''MUST''']] set the specified
value as the value associated to this attribute.

If a parser create an [CODE(DOMi)@en[[[AttributeDefinition]]]]
object, then it [['''MUST''']] set a value 
from the [CODE(DOM)@en[[[DefaultValueType]]]] 
definition group.</pre>
</div>

</div>


<div id="references" class="section reference">
<h2>References</h2>

<div id="normative-references" class="section normative reference">
<h3>Normative References</h3>

<dl>
<dt id=ref-DOM3CORE>DOM3CORE</dt>
  <dd class=ed>@@ W3C DOM Level 3 Core</dd>
<dt id=ref-DOMDTDEF>DOMDTDEF</dt>
  <dd class=ed>@@ manakai's extension to DOM for document type definitions</dd>
<dt id="ref-KEYWORDS">KEYWORDS</dt>
  <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in 
  <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,
  <abbr title="Internet Engineering Task Force">IETF</abbr> 
  <a href="urn:ietf:bcp:14"><abbr title="Best Current Practice">BCP</abbr> 
  14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, 
  <time datetime=1997-03>March 1997</time>.
  <em>This</em> version of the specification is referenced.</dd>
<dt id=ref-INFOSET>INFOSET</dt>
  <dd class=ed>@@</dd>
<dt id=ref-XML10">XML10</dt>
  <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible
  Markup Language (<abbr>XML</abbr>) 1.0 (Fourth Edition)</a></cite>,
  <abbr>W3C</abbr> Recommendation, <time datetime=2006-08-16>16 August 
  2006</time>, edited in place <time datetime=2006-09-29>29 September
  2006</time>.  Tje latest version of the specification is available at
  <code class=uri>&lt;<a href="http://www.w3.org/TR/xml">http://www.w3.org/TR/xml</a>&gt;</code>.
  <em>This</em> version of the specification is referenced.</dd>
<dt id=ref-XML11>XML11</dt>
  <dd class=ed>@@</dd>
</dl>
</div>

<div id="informative-references" class="section informative reference">
<h3>Non$B!>(Bnormative References</h3>

<dl class=ed>
<dt id=ref-CSS>CSS</dt>
  <dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading
  Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)
  Specification</a></cite>, 
  <abbr title="World Wide Web Consortium">W3C</abbr> Candidate
  Recommendation, <time datetime=2007-07-19>19 July 2007</time>.
  Work in progress.  The latest version of the specification is
  available at 
  <code class=URI>&lt;<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd>
<dt id=ref-CSSOM>CSSOM</dt>
  <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&amp;content-type=text/html;%20charset=utf-8">Cascading
  Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>,
  <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,
  <time datetime=2007-06-18>18 June 2007</time>.  Work in progress.
  The latest Editor's Draft of the specification is available at
  <code class=URI>&lt;<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd>
<dt id=ref-HTML5>HTML5</dt>
  <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
  <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
  Working Draft.  Work in progress.</dd>
<dt id=ref-SAPI>SAPI</dt>
  <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&amp;content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>,
  <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,
  <time datetime=2007-08-29>29 August 2007</time>.  Work in progress.
  The latest Editor's Draft of the specification is available at
  <code class=URI>&lt;<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.
  The latest published version of the specification is available at
  <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>
<dt id=XBL2>XBL2</dt>
  <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>
  2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.
  Work in progress.  The latest
  <abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished
  version of the specification is available at
  <code class=URI>&lt;<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd>
<dt id=ref-XML5>XML5</dt>
  <dd class=ed>@@</dd>
</dl>
</div>

</div>

</body>
</html>