DOM interfaces in the XML DOM sources

The DOM specifications are completely written in XML. Everything
else (HTML, IDL, Java) is generated using a DOM generator [1].

The XML sources of the DOM specifications can be found in the zip
files available from the Overview page of each spec.

A zip with all DOM Level 2 recommendations files is available from
the DOMTR [2].

Anyway proposal to improve the markup is welcome.

Here is for example the NodeList interface:

<interface name="NodeList" id="ID-536297177">
  <descr>
    <p>The <code>NodeList</code> interface provides the abstraction of an
      ordered collection of nodes, without defining or constraining how this
      collection is implemented. <code>NodeList</code> objects in the DOM are
      <termref def="td-live">live</termref>.</p>
    <p>The items in the <code>NodeList</code> are accessible via an
      integral index, starting from 0.</p>
  </descr>

  <method name="item" id="ID-844377136">
    <descr>
      <p>Returns the <code>index</code>th item in the collection. If
        <code>index</code> is greater than or equal to the number of nodes in
        the list, this returns <code>null</code>.</p>
    </descr>
    <parameters>
      <param name="index" type="unsigned long" attr="in">
        <descr>
          <p>Index into the collection.</p>
        </descr>
      </param>
    </parameters>
    <returns type="Node">
      <descr>
        <p>The node at the <code>index</code>th position in the
          <code>NodeList</code>, or <code>null</code> if that is not a valid
          index.</p>
      </descr>
    </returns>
    <raises>
      <!-- No exceptions -->
    </raises>
  </method>

  <attribute type="unsigned long" readonly="yes" name="length"
             id="ID-203510337">
    <descr>
      <p>The number of nodes in the list. The range of valid child node indices
        is 0 to <code>length-1</code> inclusive.</p>
    </descr>
  </attribute>
</interface>

Philippe

[1] http://dev.w3.org/cvsweb/java/classes/org/w3c/tools/specgenerator/
[2] http://www.w3.org/DOM/DOMTR

Received on Tuesday, 29 May 2001 13:49:09 UTC