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>
<h2>The <code>DocumentXDoctype</code> Interface</h2>

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

<pre class=ed>
* The [CODE(DOMi)@en[DocumentXDoctype]] Interface Specification

[1] [[manakai//DOM Extensions]] > New Interfaces >
[[DOM XML Document Type Definition]] module >
The [CODE(DOMi)@en[[[DocumentXDoctype]]]] Interface

[2]
@@ cast

** Constructors

[3] The 
[DFN@en[[CODE(DOMm)@en[[[createDocumentTypeDefinition]]]] method]]
returns a [CODE(DOMi)@en[[[DocumentType]]]] node
or raises a [CODE(DOMi)@en[[[DOMException]]]].
It creates a [CODE(DOMi)@en[[[DocumentType]]]] node 
of the given name, belonging to the document.

[3] The 
[DFN@en[[CODE(DOMm)@en[[[createElementTypeDefinition]]]] method]]
returns an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node
or raises a [CODE(DOMi)@en[[[DOMException]]]].
It creates an [CODE(DOMi)@en[[[ElementTypeDefinition]]]] node 
of the given name, belonging to the document.

[4] The 
[DFN@en[[CODE(DOMm)@en[[[createAttributeDefinition]]]] method]]
returns an [CODE(DOMi)@en[[[AttributeDefinition]]]] node
or raises a [CODE(DOMi)@en[[[DOMException]]]].
It creates an [CODE(DOMi)@en[[[AttributeDefinition]]]] node 
of the given name, belonging to the document.

[10] The 
[DFN@en[[CODE(DOMm)@en[[[createGeneralEntity]]]] method]]
returns an [CODE(DOMi)@en[[[Entity]]]] node
or raises a [CODE(DOMi)@en[[[DOMException]]]].
It creates an [CODE(DOMi)@en[[[Entity]]]] node,
which represents a general entity,
of the given name, belonging to the document.

[12] The
[DFN@en[[CODE(DOMm)@en[[[createNotation]]]] method]]
returns a [CODE(DOMi)@en[[[Notation]]]] node
or raises a [CODE(DOMi)@en[[[DOMException]]]].
It creates a [CODE(DOMi)@en[[[Notation]]]] node
of the given name, belonging to the document.

[5]
These method take a parameter [CODE(DOMp)@en[[[name]]]],
of type [CODE(DOMi)@en[[[DOMString]]]].  It is
the document type name, element type name,
or attribute name of the node to be created.

[6]
The [CODE(DOMm)@en[[[createDocumentTypeDefinition]]]]
method [['''MUST''']] create a [CODE(DOMi)@en[[[DocumentType]]]]
object with the following attribute values:
- [CODE(DOMa)@en[[[attributes]]]],
[CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[elementTypes]]]],
[CODE(DOMa)@en[[[generalEntities]]]],
[CODE(DOMa)@en[[[notations]]]]: Empty
[CODE(DOMi)@en[[[NamedNodeMap]]]]s.
- [CODE(DOMa)@en[[[childNodes]]]]: An empty
[CODE(DOMi)@en[[[NodeList]]]].
- [CODE(DOMa)@en[[[entities]]]]: The same 
[CODE(DOMi)@en[[[NamedNodeMap]]]] as
[CODE(DOMa)@en[[[generalEntities]]]].
- [CODE(DOMa)@en[[[internalSubset]]]],
[CODE(DOMa)@en[[[publicId]]]], [CODE(DOMa)@en[[[systemId]]]]:
Empty strings.
- [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- [CODE(DOMa)@en[[[ownerDocument]]]]: The 
[CODE(DOMi)@en[[[Document]]]] node on which the method
is invoked.

In addition, it [['''MUST''']] be marked as containing
five general entity declarations for XML predefined
entities, i.e. [CODE(XML)@en[[[amp]]]], [CODE(XML)@en[[[lt]]]],
[CODE(XML)@en[[[gt]]]], [CODE(XML)@en[[[quot]]]], and
[CODE(XML)@en[[[apos]]]].

[8]
The [CODE(DOMm)@en[[[createElementTypeDefinition]]]]
method [['''MUST''']] create an 
[CODE(DOMi)@en[[[ElementTypeDefinition]]]]
object with the following attribute values:
- [CODE(DOMa)@en[[[attributeDefinitions]]]]:
An empty [CODE(DOMi)@en[[[NamedNodeMap]]]].
- [CODE(DOMa)@en[[[attributes]]]],
[CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[childNodes]]]]: An empty
[CODE(DOMi)@en[[[NodeList]]]].
- [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- [CODE(DOMa)@en[[[ownerDocument]]]]: The 
[CODE(DOMi)@en[[[Document]]]] node on which the method
is invoked.
- [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
[CODE(IDL)@en[[[null]]]].

@@ Ensure all attributes are defined

[9] The [CODE(DOMm)@en[[[createAttributeDefinition]]]]
method [['''MUST''']] create an 
[CODE(DOMi)@en[[[AttributeDefinition]]]]
object with the following attribute values:
- [CODE(DOMa)@en[[[allowedTokens]]]]:
An empty [CODE(DOMi)@en[[[DOMStringList]]]].
- [CODE(DOMa)@en[[[attributes]]]],
[CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[childNodes]]]]: An empty
[CODE(DOMi)@en[[[NodeList]]]].
- [CODE(DOMa)@en[[[declaredType]]]]:
[CODE(DOMc)@en[[[NO_TYPE_ATTR]]]].
- [CODE(DOMa)@en[[[defaultType]]]]:
[CODE(DOMc)@en[[[UNKNOWN_DEFAULT]]]].
- [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- [CODE(DOMa)@en[[[ownerDocument]]]]: The 
[CODE(DOMi)@en[[[Document]]]] node on which the method
is invoked.
- [CODE(DOMa)@en[[[ownerElementTypeDefinition]]]]:
[CODE(IDL)@en[[[null]]]].

@@ Ensure all attributes are defined

@@ Should we keep these statements?: 
However, if the <cfg::cfg|xml-id> configuration
parameter is set to <DOM::true> and the <P::name>
is <XA::xml:id>, then the [CODE(DOMa)@en[[[declaredType]]]]
attribute is set to
<C::AttributeDefinition.ID_ATTR>.
[CODE(DOMa)@en[[[defaultType]]]]?

[11] The [CODE(DOMm)@en[[[createGeneralEntity]]]]
method [['''MUST''']] create an [CODE(DOMi)@en[[[Entity]]]]
node with the following attribute values:
- [CODE(DOMa)@en[[[attributes]]]],
[CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[childNodes]]]]: An empty
[CODE(DOMi)@en[[[NodeList]]]].
- [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
No explicit value is set.
- [CODE(DOMa)@en[[[manakaiEntityBaseURI]]]]:
No explicit value is set.
- [CODE(DOMa)@en[[[manakaiEntityURI]]]]:
No explicit value is set.
- [CODE(DOMa)@en[[[manakaiHasReplacementTree]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- [CODE(DOMa)@en[[[notationName]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[ownerDocument]]]]: The 
[CODE(DOMi)@en[[[Document]]]] node on which the method
is invoked.
- [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
[CODE(IDL)@en[[[null]]]].
- [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].

@@ Ensure all attributes are defined

@@ publicId and systemId should be empty string?

[13] The [CODE(DOMm)@en[[[createNotation]]]]
method [['''MUST''']] create a [CODE(DOMi)@en[[[Notation]]]]
node with the following attribute values:
- [CODE(DOMa)@en[[[attributes]]]],
[CODE(DOMa)@en[[[parentNode]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[childNodes]]]]: An empty
[CODE(DOMi)@en[[[NodeList]]]].
- [CODE(DOMa)@en[[[manakaiDeclarationBaseURI]]]]:
No explicit value is set.
- [CODE(DOMa)@en[[[manakaiReadOnly]]]]:
[CODE(IDL)@en[[[false]]]].
- [CODE(DOMa)@en[[[nodeName]]]]: [CODE(DOMp)@en[[[name]]]].
- [CODE(DOMa)@en[[[ownerDocument]]]]: The 
[CODE(DOMi)@en[[[Document]]]] node on which the method
is invoked.
- [CODE(DOMa)@en[[[ownerDocumentTypeDefinition]]]]:
[CODE(IDL)@en[[[null]]]].
- [CODE(DOMa)@en[[[publicId]]]]: [CODE(DOM)@en[[[null]]]].
- [CODE(DOMa)@en[[[systemId]]]]: [CODE(DOM)@en[[[null]]]].

@@ Ensure all attributes are defined

[7]
These method [['''MUST''']] raise an
[CODE(DOMi)@en[[[INVALID_CHARACTER_ERR]]]]
[CODE(DOMi)@en[[[DOMException]]]] 
if the [CODE(DOMp)@en[[[name]]]] is not a legal
name according to the XML version in use as 
specified in the [CODE(DOMa)@en[[[xmlVersion]]]]
attribute of the [CODE(DOMi)@en[[[Document]]]] node.

;; Non-XML case is intentionally left unspecified for now
since DOM3 does not define it.

;; [CODE(DOMp)@en[[[name]]]] does not have to
be a namespace qualified name.

;; Note also that it is not an error for the 
[CODE(DOMp)@en[[[name]]]] parameter value
to match to the name of one of predefined general
parsed entities in XML or HTML.

;; If the [CODE(DOMa)@en[[[strictErrorChecking]]]] attribute
is set to [CODE(IDL)@en[[[false]]]], then the implementation
is not required to raise this exception.

Otherwise, these method [['''MUST''']] return
the newly created node.
</pre>

</div>

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

<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>
<h2>The <code>ElementTypeDefinition</code> Interface</h2>

<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>
<h2>The <code>AttributeDefinition</code> Interface</h2>

<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>