- From: Johnny Stenback <jst@netscape.com>
- Date: Wed, 02 Oct 2002 20:12:10 -0700
- To: Philippe Le Hegaret <plh@w3.org>
- Cc: www-dom@w3.org, www-dom-ts <www-dom-ts@w3.org>
- Message-ID: <3D9BB58A.4000800@netscape.com>
Philippe, I just checked in the last of the changes to the DOM Level 2 HTML spec, unless I missed something, it's all done now. See attached diff for a complete list of the changes made. If you have a chance, please do have a look at these and let me know if I missed something, or if some of the changes are incorrect. Many thanks to everyone who was involved in resolving all the issues. -- jst
Index: html.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/html.xml,v
retrieving revision 1.34
diff -u -r1.34 html.xml
--- html.xml 2002/08/21 15:09:03 1.34
+++ html.xml 2002/10/03 02:39:40
@@ -104,10 +104,7 @@
application can use the <code>hasFeature</code> method of the
<code>DOMImplementation</code> interface to determine whether they
are supported or not. The feature string for all the interfaces listed in
- this section is "HTML" and the version is "2.0". Note that, since DOM
- Level 2 HTML is not backward compatible with DOM Level 1 <bibref ref="DOM-Level-1"/>, a DOM Level 2
- HTML implementation must not claim to implement the feature "HTML"
- version "1.0". In order to fully
+ this section is "HTML" and the version is "2.0". In order to fully
support this feature, an implementation needs also to support the "Core"
feature defined in the Document Object Model Level 2 Core <bibref
ref="DOMCore"/> (see also <xspecref
@@ -212,7 +209,7 @@
<div2 id="ID-1019015399">
<head>Miscellaneous Object Definitions</head>
<definitions>
- &html-htmldom;
+ <!-- &html-htmldom; Removed due to lack of implementations -->
&html-htmlcollection;
&html-htmloptionscollection;
</definitions>
Index: definitions/htmlappletelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmlappletelement.xml,v
retrieving revision 1.4
diff -u -r1.4 htmlappletelement.xml
--- htmlappletelement.xml 2002/04/23 20:36:54 1.4
+++ htmlappletelement.xml 2002/10/03 02:39:40
@@ -22,17 +22,21 @@
<attribute type="DOMString" name="height" id="ID-90184867">
<descr><p>Override height. See the <loc href="&html40;/struct/objects.html#adef-height-APPLET">height attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
- <attribute type="DOMString" name="hspace" id="ID-1567197">
- <descr><p>Horizontal space to the left and right of this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-hspace">hspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <attribute type="long" name="hspace" id="ID-1567197">
+ <descr><p>Horizontal space, in pixels, to the left and right of this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-hspace">hspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
<attribute type="DOMString" name="name" id="ID-39843695">
<descr><p>The name of the applet. See the <loc href="&html40;/struct/objects.html#adef-name-APPLET">name attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
<attribute type="DOMString" name="object" id="ID-93681523">
- <descr><p>Serialized applet file. See the <loc href="&html40;/struct/objects.html#adef-object">object attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <descr><p>The value of the "object" attribute. See the
+ <loc href="&html40;/struct/objects.html#adef-object">object
+ attribute definition</loc> in HTML 4.01. This attribute is
+ deprecated in HTML 4.01.
+ </p></descr>
</attribute>
- <attribute type="DOMString" name="vspace" id="ID-22637173">
- <descr><p>Vertical space above and below this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-vspace">vspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <attribute type="long" name="vspace" id="ID-22637173">
+ <descr><p>Vertical space, in pixels, above and below this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-vspace">vspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
<attribute type="DOMString" name="width" id="ID-16526327">
<descr><p>Override width. See the <loc href="&html40;/struct/objects.html#adef-width-APPLET">width attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
Index: definitions/htmlbasefontelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmlbasefontelement.xml,v
retrieving revision 1.3
diff -u -r1.3 htmlbasefontelement.xml
--- htmlbasefontelement.xml 2002/04/23 20:36:54 1.3
+++ htmlbasefontelement.xml 2002/10/03 02:39:40
@@ -8,7 +8,7 @@
<attribute type="DOMString" name="face" id="ID-88128969">
<descr><p>Font face identifier. See the <loc href="&html40;/">face attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
- <attribute type="DOMString" name="size" id="ID-38930424">
- <descr><p>Font size. See the <loc href="&html40;/present/graphics.html#adef-size-BASEFONT">size attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <attribute type="long" name="size" id="ID-38930424">
+ <descr><p>Computed font size. See the <loc href="&html40;/present/graphics.html#adef-size-BASEFONT">size attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
</interface>
Index: definitions/htmlimageelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmlimageelement.xml,v
retrieving revision 1.7
diff -u -r1.7 htmlimageelement.xml
--- htmlimageelement.xml 2002/04/23 20:36:54 1.7
+++ htmlimageelement.xml 2002/10/03 02:39:40
@@ -13,8 +13,8 @@
<descr><p>Alternate text for user agents not rendering the normal content
of this element. See the <loc href="&html40;/struct/objects.html#adef-alt">alt attribute definition</loc> in HTML 4.01.</p></descr>
</attribute>
- <attribute type="long" name="border" id="ID-136671">
- <descr><p>Width of border around image in pixels. See the
+ <attribute type="DOMString" name="border" id="ID-136671">
+ <descr><p>Width of border around image. See the
<loc href="&html40;/struct/objects.html#adef-border-IMG">
border attribute definition</loc> in HTML 4.01. This
attribute is deprecated in HTML 4.01. Note that the type of
Index: definitions/htmlobjectelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmlobjectelement.xml,v
retrieving revision 1.12
diff -u -r1.12 htmlobjectelement.xml
--- htmlobjectelement.xml 2002/08/01 21:25:12 1.12
+++ htmlobjectelement.xml 2002/10/03 02:39:40
@@ -43,8 +43,8 @@
<attribute type="DOMString" name="height" id="ID-88925838">
<descr><p>Override height. See the <loc href="&html40;/struct/objects.html#adef-height-IMG">height attribute definition</loc> in HTML 4.01.</p></descr>
</attribute>
- <attribute type="DOMString" name="hspace" id="ID-17085376">
- <descr><p>Horizontal space to the left and right of this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-hspace">hspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <attribute type="long" name="hspace" id="ID-17085376">
+ <descr><p>Horizontal space, in pixels, to the left and right of this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-hspace">hspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
<attribute type="DOMString" name="name" id="ID-20110362">
<descr><p>Form control or object name when submitted with a form. See the <loc href="&html40;/interact/forms.html#adef-name-INPUT">name attribute definition</loc> in HTML 4.01.</p></descr>
@@ -61,8 +61,8 @@
<attribute type="DOMString" name="useMap" id="ID-6649772">
<descr><p>Use client-side image map. See the <loc href="&html40;/struct/objects.html#adef-usemap">usemap attribute definition</loc> in HTML 4.01.</p></descr>
</attribute>
- <attribute type="DOMString" name="vspace" id="ID-8682483">
- <descr><p>Vertical space above and below this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-vspace">vspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
+ <attribute type="long" name="vspace" id="ID-8682483">
+ <descr><p>Vertical space, in pixels, above and below this image, applet, or object. See the <loc href="&html40;/struct/objects.html#adef-vspace">vspace attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
</attribute>
<attribute type="DOMString" name="width" id="ID-38538620">
<descr><p>Override width. See the <loc href="&html40;/struct/objects.html#adef-width-IMG">width attribute definition</loc> in HTML 4.01.</p></descr>
Index: definitions/htmltableelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmltableelement.xml,v
retrieving revision 1.8
diff -u -r1.8 htmltableelement.xml
--- htmltableelement.xml 2002/04/23 20:36:54 1.8
+++ htmltableelement.xml 2002/10/03 02:39:40
@@ -55,7 +55,7 @@
<code>TBODY</code> elements. </p></descr>
</attribute>
<attribute readonly="yes" type="HTMLCollection" name="tBodies" id="ID-63206416">
- <descr><p>Returns a collection of the defined table bodies. </p></descr>
+ <descr><p>Returns a collection of the table bodies (including implicit ones).</p></descr>
</attribute>
<attribute type="DOMString" name="align" id="ID-23180977">
<descr><p>Specifies the table's position with respect to the rest of the document. See the <loc href="&html40;/struct/tables.html#adef-align-TABLE">align attribute definition</loc> in HTML 4.01. This attribute is deprecated in HTML 4.01.</p></descr>
@@ -162,7 +162,7 @@
<descr><p>Insert a new empty row in the table. The new row is inserted
immediately before and in the same section as the current
<code>index</code>th row in the table. If <code>index</code> is
- equal to the number of rows, the new row is appended. In addition, when
+ -1 or equal to the number of rows, the new row is appended. In addition, when
the table is empty the row is inserted into a <code>TBODY</code> which
is created and inserted into the table.</p>
<note><p>A table row cannot be empty
@@ -172,8 +172,7 @@
<param id="ID-3501423" name="index" type="long" attr="in">
<descr><p>The row number where to insert a new row. This index starts from 0
- and is relative to all the rows contained inside the table,
- regardless of section parentage.</p></descr>
+ and is relative to the logical order (not document order) of all the rows contained inside the table.</p></descr>
</param>
</parameters>
<returns type="HTMLElement">
@@ -182,7 +181,7 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified index is
- greater than the number of rows or if the index is negative.</p>
+ greater than the number of rows or if the index is a negative number other than -1.</p>
</descr>
</exception>
</raises>
@@ -193,8 +192,8 @@
<param id="ID-41440100" name="index" type="long" attr="in">
<descr><p>The index of the row to be deleted. This index starts from 0 and is
- relative to all the rows contained inside the table, regardless of
- section parentage.</p></descr>
+ relative to the logical order (not document order) of all the rows contained inside the table. If the index is -1 the last row in the table is
+ deleted.</p></descr>
</param>
</parameters>
<returns type="void">
@@ -203,7 +202,8 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified index is
- greater than or equal to the number of rows or if the index is negative.</p>
+ greater than or equal to the number of rows or if the index is a
+ negative number other than -1.</p>
</descr>
</exception>
</raises>
Index: definitions/htmltablerowelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmltablerowelement.xml,v
retrieving revision 1.9
diff -u -r1.9 htmltablerowelement.xml
--- htmltablerowelement.xml 2002/04/23 20:36:54 1.9
+++ htmltablerowelement.xml 2002/10/03 02:39:40
@@ -3,8 +3,17 @@
<interface name="HTMLTableRowElement" inherits="HTMLElement" id="ID-6986576">
<descr><p>A row in a table. See the <loc href="&html40;/struct/tables.html#edef-TR">TR element definition</loc> in HTML 4.01.</p></descr>
<attribute type="long" name="rowIndex" id="ID-67347567" readonly="yes">
- <descr><p>The index of this row, relative to the entire table,
- starting from 0. This is in document tree order and not display order. The <code>rowIndex</code> does not take into account sections (<code>THEAD</code>, <code>TFOOT</code>, or <code>TBODY</code>) within the table.</p></descr>
+
+ <descr>
+ <p>This is in logical order and not in document order. The
+ <code>rowIndex</code> does take into account sections
+ (<code>THEAD</code>, <code>TFOOT</code>, or
+ <code>TBODY</code>) within the table, placing
+ <code>THEAD</code> rows first in the index, followed by
+ <code>TBODY</code> rows, followed by <code>TFOOT</code>
+ rows.</p>
+ </descr>
+
</attribute>
<attribute type="long" name="sectionRowIndex" id="ID-79105901"
readonly="yes">
@@ -32,9 +41,9 @@
<descr><p>Vertical alignment of data within cells of this row. See the <loc href="&html40;/struct/tables.html#adef-valign">valign attribute definition</loc> in HTML 4.01.</p></descr>
</attribute>
<method name="insertCell" id="ID-68927016">
- <descr><p>Insert an empty <code>TD</code> cell into this row. If
- <code>index</code> is equal to the number of cells, the new cell is
- appended.</p></descr>
+ <descr><p>Insert an empty <code>TD</code> cell into this row. If
+ <code>index</code> is -1 or equal to the number of cells, the new
+ cell is appended.</p></descr>
<parameters>
<param id="ID-20576436" name="index" type="long" attr="in">
@@ -47,7 +56,7 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified <code>index</code> is
- greater than the number of cells or if the index is negative.</p>
+ greater than the number of cells or if the index is a negative number other than -1.</p>
</descr>
</exception>
</raises>
@@ -57,7 +66,8 @@
<parameters>
<param id="ID-63209996" name="index" type="long" attr="in">
-<descr><p>The index of the cell to delete, starting from 0.</p></descr>
+<descr><p>The index of the cell to delete, starting from 0. If the index is
+-1 the last cell in the row is deleted.</p></descr>
</param>
</parameters>
<returns type="void">
@@ -66,7 +76,8 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified <code>index</code> is
- greater than or equal to the number of cells or if the index is negative.</p>
+ greater than or equal to the number of cells or if the index
+ is a negative number other than -1.</p>
</descr>
</exception>
</raises>
Index: definitions/htmltablesectionelement.xml
===================================================================
RCS file: /w3ccvs/WWW/DOM/Group/drafts/level-2-src/xml/html/definitions/htmltablesectionelement.xml,v
retrieving revision 1.6
diff -u -r1.6 htmltablesectionelement.xml
--- htmltablesectionelement.xml 2002/04/23 20:36:54 1.6
+++ htmltablesectionelement.xml 2002/10/03 02:39:40
@@ -24,7 +24,7 @@
<method name="insertRow" id="ID-93995626">
<descr><p>Insert a row into this section. The new row is inserted
immediately before the current <code>index</code>th row in this
- section. If <code>index</code> is equal to the number of rows in this
+ section. If <code>index</code> is -1 or equal to the number of rows in this
section, the new row is appended.</p></descr>
<parameters>
@@ -40,7 +40,8 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified index is
- greater than the number of rows of if the index is negative.</p>
+ greater than the number of rows of if the index is a negative
+ number other than -1.</p>
</descr>
</exception>
</raises>
@@ -50,7 +51,7 @@
<parameters>
<param id="ID-49711281" name="index" type="long" attr="in">
-<descr><p>The index of the row to be deleted. This index starts from 0 and is
+<descr><p>The index of the row to be deleted, or -1 to delete the last row. This index starts from 0 and is
relative only to the rows contained inside this section, not all
the rows in the table.</p></descr>
</param>
@@ -61,7 +62,7 @@
<raises>
<exception name="DOMException">
<descr><p>INDEX_SIZE_ERR: Raised if the specified index is
- greater than or equal to the number of rows or if the index is negative.</p>
+ greater than or equal to the number of rows or if the index is a negative number other than -1.</p>
</descr>
</exception>
</raises>
Received on Thursday, 3 October 2002 03:56:59 UTC