[e] (0) Use WebIDL for this instead of prose

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20495 Affected topics: DOM APIs git-svn-id: http://svn.whatwg.org/webapps@7621 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Dec 30, 2012 · 1b619cf · 1b619cf
1 parent 64a46d3
commit 1b619cf
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 18 deletions.
diff --git a/complete.html b/complete.html
@@ -41461,7 +41461,7 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-table-tbodies title=dom-table-tBodies>tBodies</a>;
   <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-createtbody title=dom-table-createTBody>createTBody</a>();
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-table-rows title=dom-table-rows>rows</a>;
-  <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-insertrow title=dom-table-insertRow>insertRow</a>(optional long index);
+  <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-insertrow title=dom-table-insertRow>insertRow</a>(optional long index = -1);
   void <a href=#dom-table-deleterow title=dom-table-deleteRow>deleteRow</a>(long index);
            attribute boolean <a href=#dom-table-sortable title=dom-table-sortable>sortable</a>;
   void <a href=#dom-table-stopsorting title=dom-table-stopSorting>stopSorting</a>();
@@ -41624,10 +41624,10 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
     <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <code><a href=#the-tr-element>tr</a></code> elements of the table.</p>
    </dd>
 
-   <dt><var title="">tr</var> = <var title="">table</var> . <code title=dom-table-insertRow><a href=#dom-table-insertrow>insertRow</a></code>(<var title="">index</var>)</dt>
+   <dt><var title="">tr</var> = <var title="">table</var> . <code title=dom-table-insertRow><a href=#dom-table-insertrow>insertRow</a></code>( [ <var title="">index</var> ] )</dt>
    <dd>
     <p>Creates a <code><a href=#the-tr-element>tr</a></code> element, along with a <code><a href=#the-tbody-element>tbody</a></code> if required, inserts them into the table at the position given by the argument, and returns the <code><a href=#the-tr-element>tr</a></code>.</p>
-    <p>The position is relative to the rows in the table. The index &minus;1 is equivalent to inserting at the end of the table.</p>
+    <p>The position is relative to the rows in the table. The index &minus;1, which is the default if the argument is omitted, is equivalent to inserting at the end of the table.</p>
     <p>If the given position is less than &minus;1 or greater than the number of rows, throws an <code><a href=#indexsizeerror>IndexSizeError</a></code> exception.</p>
    </dd>
 
@@ -41773,7 +41773,7 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
    the last <code><a href=#the-tbody-element>tbody</a></code> element in the table, and return the
    <code><a href=#the-tr-element>tr</a></code> element.</dd>
 
-   <dt>If <var title="">index</var> is missing, equal to &minus;1, or
+   <dt>If <var title="">index</var> is &minus;1 or
    equal to the number of items in <code title=dom-table-rows><a href=#dom-table-rows>rows</a></code> collection:</dt>
 
    <dd>The method must create a <code><a href=#the-tr-element>tr</a></code> element, and append it
@@ -42273,7 +42273,7 @@ <h4 id=the-tbody-element><span class=secno>4.9.5 </span>The <dfn><code>tbody</co
    <dd>
     <pre class=idl>interface <dfn id=htmltablesectionelement>HTMLTableSectionElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-tbody-rows title=dom-tbody-rows>rows</a>;
-  <a href=#htmlelement>HTMLElement</a> <a href=#dom-tbody-insertrow title=dom-tbody-insertRow>insertRow</a>(optional long index);
+  <a href=#htmlelement>HTMLElement</a> <a href=#dom-tbody-insertrow title=dom-tbody-insertRow>insertRow</a>(optional long index = -1);
   void <a href=#dom-tbody-deleterow title=dom-tbody-deleteRow>deleteRow</a>(long index);
 };</pre>
     <p>The <code><a href=#htmltablesectionelement>HTMLTableSectionElement</a></code> interface is also
@@ -42325,7 +42325,7 @@ <h4 id=the-tbody-element><span class=secno>4.9.5 </span>The <dfn><code>tbody</co
   collection, the method must throw an <code><a href=#indexsizeerror>IndexSizeError</a></code>
   exception.</p>
 
-  <p>If <var title="">index</var> is missing, equal to &minus;1, or
+  <p>If <var title="">index</var> is &minus;1 or
   equal to the number of items in the <code title=dom-tbody-rows><a href=#dom-tbody-rows>rows</a></code> collection, the method must
   create a <code><a href=#the-tr-element>tr</a></code> element, append it to the element <var title="">table section</var>, and return the newly created
   <code><a href=#the-tr-element>tr</a></code> element.</p>

diff --git a/index b/index
@@ -41461,7 +41461,7 @@ function AddCloud(data, x, y) { ... }</pre>
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-table-tbodies title=dom-table-tBodies>tBodies</a>;
   <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-createtbody title=dom-table-createTBody>createTBody</a>();
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-table-rows title=dom-table-rows>rows</a>;
-  <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-insertrow title=dom-table-insertRow>insertRow</a>(optional long index);
+  <a href=#htmlelement>HTMLElement</a> <a href=#dom-table-insertrow title=dom-table-insertRow>insertRow</a>(optional long index = -1);
   void <a href=#dom-table-deleterow title=dom-table-deleteRow>deleteRow</a>(long index);
            attribute boolean <a href=#dom-table-sortable title=dom-table-sortable>sortable</a>;
   void <a href=#dom-table-stopsorting title=dom-table-stopSorting>stopSorting</a>();
@@ -41624,10 +41624,10 @@ function AddCloud(data, x, y) { ... }</pre>
     <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <code><a href=#the-tr-element>tr</a></code> elements of the table.</p>
    </dd>
 
-   <dt><var title="">tr</var> = <var title="">table</var> . <code title=dom-table-insertRow><a href=#dom-table-insertrow>insertRow</a></code>(<var title="">index</var>)</dt>
+   <dt><var title="">tr</var> = <var title="">table</var> . <code title=dom-table-insertRow><a href=#dom-table-insertrow>insertRow</a></code>( [ <var title="">index</var> ] )</dt>
    <dd>
     <p>Creates a <code><a href=#the-tr-element>tr</a></code> element, along with a <code><a href=#the-tbody-element>tbody</a></code> if required, inserts them into the table at the position given by the argument, and returns the <code><a href=#the-tr-element>tr</a></code>.</p>
-    <p>The position is relative to the rows in the table. The index &minus;1 is equivalent to inserting at the end of the table.</p>
+    <p>The position is relative to the rows in the table. The index &minus;1, which is the default if the argument is omitted, is equivalent to inserting at the end of the table.</p>
     <p>If the given position is less than &minus;1 or greater than the number of rows, throws an <code><a href=#indexsizeerror>IndexSizeError</a></code> exception.</p>
    </dd>
 
@@ -41773,7 +41773,7 @@ function AddCloud(data, x, y) { ... }</pre>
    the last <code><a href=#the-tbody-element>tbody</a></code> element in the table, and return the
    <code><a href=#the-tr-element>tr</a></code> element.</dd>
 
-   <dt>If <var title="">index</var> is missing, equal to &minus;1, or
+   <dt>If <var title="">index</var> is &minus;1 or
    equal to the number of items in <code title=dom-table-rows><a href=#dom-table-rows>rows</a></code> collection:</dt>
 
    <dd>The method must create a <code><a href=#the-tr-element>tr</a></code> element, and append it
@@ -42273,7 +42273,7 @@ the cell that corresponds to the values of the two dice.
    <dd>
     <pre class=idl>interface <dfn id=htmltablesectionelement>HTMLTableSectionElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
   readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-tbody-rows title=dom-tbody-rows>rows</a>;
-  <a href=#htmlelement>HTMLElement</a> <a href=#dom-tbody-insertrow title=dom-tbody-insertRow>insertRow</a>(optional long index);
+  <a href=#htmlelement>HTMLElement</a> <a href=#dom-tbody-insertrow title=dom-tbody-insertRow>insertRow</a>(optional long index = -1);
   void <a href=#dom-tbody-deleterow title=dom-tbody-deleteRow>deleteRow</a>(long index);
 };</pre>
     <p>The <code><a href=#htmltablesectionelement>HTMLTableSectionElement</a></code> interface is also
@@ -42325,7 +42325,7 @@ the cell that corresponds to the values of the two dice.
   collection, the method must throw an <code><a href=#indexsizeerror>IndexSizeError</a></code>
   exception.</p>
 
-  <p>If <var title="">index</var> is missing, equal to &minus;1, or
+  <p>If <var title="">index</var> is &minus;1 or
   equal to the number of items in the <code title=dom-tbody-rows><a href=#dom-tbody-rows>rows</a></code> collection, the method must
   create a <code><a href=#the-tr-element>tr</a></code> element, append it to the element <var title="">table section</var>, and return the newly created
   <code><a href=#the-tr-element>tr</a></code> element.</p>

diff --git a/source b/source
@@ -48477,7 +48477,7 @@ function AddCloud(data, x, y) { ... }</pre>
   readonly attribute <span>HTMLCollection</span> <span title="dom-table-tBodies">tBodies</span>;
   <span>HTMLElement</span> <span title="dom-table-createTBody">createTBody</span>();
   readonly attribute <span>HTMLCollection</span> <span title="dom-table-rows">rows</span>;
-  <span>HTMLElement</span> <span title="dom-table-insertRow">insertRow</span>(optional long index);
+  <span>HTMLElement</span> <span title="dom-table-insertRow">insertRow</span>(optional long index = -1);
   void <span title="dom-table-deleteRow">deleteRow</span>(long index);
            attribute boolean <span title="dom-table-sortable">sortable</span>;
   void <span title="dom-table-stopSorting">stopSorting</span>();
@@ -48671,10 +48671,10 @@ function AddCloud(data, x, y) { ... }</pre>
     <p>Returns an <code>HTMLCollection</code> of the <code>tr</code> elements of the table.</p>
    </dd>
 
-   <dt><var title="">tr</var> = <var title="">table</var> . <code title="dom-table-insertRow">insertRow</code>(<var title="">index</var>)</dt>
+   <dt><var title="">tr</var> = <var title="">table</var> . <code title="dom-table-insertRow">insertRow</code>( [ <var title="">index</var> ] )</dt>
    <dd>
     <p>Creates a <code>tr</code> element, along with a <code>tbody</code> if required, inserts them into the table at the position given by the argument, and returns the <code>tr</code>.</p>
-    <p>The position is relative to the rows in the table. The index &#x2212;1 is equivalent to inserting at the end of the table.</p>
+    <p>The position is relative to the rows in the table. The index &#x2212;1, which is the default if the argument is omitted, is equivalent to inserting at the end of the table.</p>
     <p>If the given position is less than &#x2212;1 or greater than the number of rows, throws an <code>IndexSizeError</code> exception.</p>
    </dd>
 
@@ -48833,7 +48833,7 @@ function AddCloud(data, x, y) { ... }</pre>
    the last <code>tbody</code> element in the table, and return the
    <code>tr</code> element.</dd>
 
-   <dt>If <var title="">index</var> is missing, equal to &#x2212;1, or
+   <dt>If <var title="">index</var> is &#x2212;1 or
    equal to the number of items in <code
    title="dom-table-rows">rows</code> collection:</dt>
 
@@ -49382,7 +49382,7 @@ the cell that corresponds to the values of the two dice.
    <dd>
     <pre class="idl">interface <dfn>HTMLTableSectionElement</dfn> : <span>HTMLElement</span> {
   readonly attribute <span>HTMLCollection</span> <span title="dom-tbody-rows">rows</span>;
-  <span>HTMLElement</span> <span title="dom-tbody-insertRow">insertRow</span>(optional long index);
+  <span>HTMLElement</span> <span title="dom-tbody-insertRow">insertRow</span>(optional long index = -1);
   void <span title="dom-tbody-deleteRow">deleteRow</span>(long index);
 };</pre>
     <p>The <code>HTMLTableSectionElement</code> interface is also
@@ -49443,7 +49443,7 @@ the cell that corresponds to the values of the two dice.
   collection, the method must throw an <code>IndexSizeError</code>
   exception.</p>
 
-  <p>If <var title="">index</var> is missing, equal to &#x2212;1, or
+  <p>If <var title="">index</var> is &#x2212;1 or
   equal to the number of items in the <code
   title="dom-tbody-rows">rows</code> collection, the method must
   create a <code>tr</code> element, append it to the element <var