[html5] r6223 - [e] (0) Simplify the non-normative descriptions of index getters to avoid confus [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jun 14 14:56:05 PDT 2011


Author: ianh
Date: 2011-06-14 14:56:03 -0700 (Tue, 14 Jun 2011)
New Revision: 6223

Modified:
   complete.html
   index
   source
Log:
[e] (0) Simplify the non-normative descriptions of index getters to avoid confusing readers (the specifics of edge cases are rather subtle).
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12299

Modified: complete.html
===================================================================
--- complete.html	2011-06-14 02:08:00 UTC (rev 6222)
+++ complete.html	2011-06-14 21:56:03 UTC (rev 6223)
@@ -7691,7 +7691,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLCollection-namedItem><a href=#dom-htmlcollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7700,7 +7699,6 @@
    <dd>
     <p>Returns the first item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var>
     from the collection.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
     <p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
     <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
     <code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -7775,7 +7773,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7785,7 +7782,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then an <code><a href=#htmlallcollection>HTMLAllCollection</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
     <p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
     <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
     <code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -7874,7 +7870,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLFormControlsCollection-namedItem><a href=#dom-htmlformcontrolscollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7884,7 +7879,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code><a href=#radionodelist>RadioNodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
    </dd>
 
    <dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -7994,7 +7988,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLOptionsCollection-namedItem><a href=#dom-htmloptionscollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -8004,7 +7997,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
    </dd>
 
    <dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-add><a href=#dom-htmloptionscollection-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -8172,16 +8164,19 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the element with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> = <var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-namedItem><a href=#dom-htmlpropertiescollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
-   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
     <p>Returns a <code><a href=#propertynodelist>PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>.</p>
    </dd>
 
+   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
+   <dd>
+    <p>Returns a <code><a href=#propertynodelist>PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>. The <var title="">name</var> index has to be one of the values listed in the <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code> list.</p>
+   </dd>
+
    <dt><var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code></dt>
    <dd>
     <p>Returns a <code>DOMStringList</code> with the <a href=#property-names>property names</a> of the elements in the collection.</p>
@@ -8263,7 +8258,6 @@
    <dt><var title="">tokenlist</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the token with index <var title="">index</var>. The tokens are returned in the order they are found in the underlying string.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">hastoken</var> = <var title="">tokenlist</var> . <code title=dom-tokenlist-contains><a href=#dom-tokenlist-contains>contains</a></code>(<var title="">token</var>)</dt>
@@ -41840,8 +41834,6 @@
     <code><a href=#nodelist>NodeList</a></code> object containing all those elements is
     returned.</p>
 
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
-
    </dd>
 
    <dt><var title="">form</var> . <code title=dom-form-submit><a href=#dom-form-submit>submit</a></code>()</dt>
@@ -48463,7 +48455,6 @@
    <dt><var title="">select</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -73712,8 +73703,6 @@
 
     <p>Returns the entry with index <var title="">index</var> in the undo history.</p>
 
-    <p>Returns null if <var title="">index</var> is out of range.</p>
-
    </dd>
 
    <dt><var title="">undoManager</var> . <code title=dom-UndoManager-position><a href=#dom-undomanager-position>position</a></code></dt>

Modified: index
===================================================================
--- index	2011-06-14 02:08:00 UTC (rev 6222)
+++ index	2011-06-14 21:56:03 UTC (rev 6223)
@@ -7681,7 +7681,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLCollection-namedItem><a href=#dom-htmlcollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7690,7 +7689,6 @@
    <dd>
     <p>Returns the first item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var>
     from the collection.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
     <p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
     <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
     <code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -7765,7 +7763,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7775,7 +7772,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then an <code><a href=#htmlallcollection>HTMLAllCollection</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
     <p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
     <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
     <code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -7864,7 +7860,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLFormControlsCollection-namedItem><a href=#dom-htmlformcontrolscollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7874,7 +7869,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code><a href=#radionodelist>RadioNodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
    </dd>
 
    <dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -7984,7 +7978,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title=dom-HTMLOptionsCollection-namedItem><a href=#dom-htmloptionscollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -7994,7 +7987,6 @@
    <dd>
     <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
    </dd>
 
    <dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-add><a href=#dom-htmloptionscollection-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -8162,16 +8154,19 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the element with index <var title="">index</var> from the collection. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> = <var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-namedItem><a href=#dom-htmlpropertiescollection-nameditem>namedItem</a></code>(<var title="">name</var>)</dt>
-   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
     <p>Returns a <code><a href=#propertynodelist>PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>.</p>
    </dd>
 
+   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
+   <dd>
+    <p>Returns a <code><a href=#propertynodelist>PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>. The <var title="">name</var> index has to be one of the values listed in the <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code> list.</p>
+   </dd>
+
    <dt><var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code></dt>
    <dd>
     <p>Returns a <code>DOMStringList</code> with the <a href=#property-names>property names</a> of the elements in the collection.</p>
@@ -8253,7 +8248,6 @@
    <dt><var title="">tokenlist</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the token with index <var title="">index</var>. The tokens are returned in the order they are found in the underlying string.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">hastoken</var> = <var title="">tokenlist</var> . <code title=dom-tokenlist-contains><a href=#dom-tokenlist-contains>contains</a></code>(<var title="">token</var>)</dt>
@@ -41833,8 +41827,6 @@
     <code><a href=#nodelist>NodeList</a></code> object containing all those elements is
     returned.</p>
 
-    <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
-
    </dd>
 
    <dt><var title="">form</var> . <code title=dom-form-submit><a href=#dom-form-submit>submit</a></code>()</dt>
@@ -48456,7 +48448,6 @@
    <dt><var title="">select</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree order</a>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
@@ -73731,8 +73722,6 @@
 
     <p>Returns the entry with index <var title="">index</var> in the undo history.</p>
 
-    <p>Returns null if <var title="">index</var> is out of range.</p>
-
    </dd>
 
    <dt><var title="">undoManager</var> . <code title=dom-UndoManager-position><a href=#dom-undomanager-position>position</a></code></dt>

Modified: source
===================================================================
--- source	2011-06-14 02:08:00 UTC (rev 6222)
+++ source	2011-06-14 21:56:03 UTC (rev 6223)
@@ -7618,7 +7618,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-namedItem">namedItem</code>(<var title="">name</var>)</dt>
@@ -7627,7 +7626,6 @@
    <dd>
     <p>Returns the first item with <span title="concept-id">ID</span> or name <var title="">name</var>
     from the collection.</p>
-    <p>Returns null if no element with that <span title="concept-id">ID</span> or name could be found.</p>
     <p>Only <code>a</code>, <code>applet</code>, <code>area</code>,
     <code>embed</code>, <code>form</code>, <code>frame</code>,
     <code>frameset</code>, <code>iframe</code>, <code>img</code>, and
@@ -7719,7 +7717,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLAllCollection-namedItem">namedItem</code>(<var title="">name</var>)</dt>
@@ -7729,7 +7726,6 @@
    <dd>
     <p>Returns the item with <span title="concept-id">ID</span> or name <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then an <code>HTMLAllCollection</code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <span title="concept-id">ID</span> or name could be found.</p>
     <p>Only <code>a</code>, <code>applet</code>, <code>area</code>,
     <code>embed</code>, <code>form</code>, <code>frame</code>,
     <code>frameset</code>, <code>iframe</code>, <code>img</code>, and
@@ -7836,7 +7832,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLFormControlsCollection-namedItem">namedItem</code>(<var title="">name</var>)</dt>
@@ -7846,7 +7841,6 @@
    <dd>
     <p>Returns the item with <span title="concept-id">ID</span> or <code title="attr-fe-name">name</code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code>RadioNodeList</code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <span title="concept-id">ID</span> or <code title="attr-fe-name">name</code> could be found.</p>
    </dd>
 
    <dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -7986,7 +7980,6 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLOptionsCollection-namedItem">namedItem</code>(<var title="">name</var>)</dt>
@@ -7996,7 +7989,6 @@
    <dd>
     <p>Returns the item with <span title="concept-id">ID</span> or <code title="attr-option-name">name</code> <var title="">name</var> from the collection.</p>
     <p>If there are multiple matching items, then a <code>NodeList</code> object containing all those elements is returned.</p>
-    <p>Returns null if no element with that <span title="concept-id">ID</span> could be found.</p>
    </dd>
 
    <dt><var title="">collection</var> . <code title="dom-HTMLOptionsCollection-add">add</code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -8213,16 +8205,19 @@
    <dt><var title="">collection</var>(<var title="">index</var>)</dt>
    <dd>
     <p>Returns the element with index <var title="">index</var> from the collection. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> = <var title="">collection</var> . <code title="dom-HTMLPropertiesCollection-namedItem">namedItem</code>(<var title="">name</var>)</dt>
-   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
    <dt><var title="">collection</var>(<var title="">name</var>)</dt>
    <dd>
     <p>Returns a <code>PropertyNodeList</code> object containing any elements that add a property named <var title="">name</var>.</p>
    </dd>
 
+   <dt><var title="">collection</var>[<var title="">name</var>]</dt>
+   <dd>
+    <p>Returns a <code>PropertyNodeList</code> object containing any elements that add a property named <var title="">name</var>. The <var title="">name</var> index has to be one of the values listed in the <code title="dom-HTMLPropertiesCollection-names">names</code> list.</p>
+   </dd>
+
    <dt><var title="">collection</var> . <code title="dom-HTMLPropertiesCollection-names">names</code></dt>
    <dd>
     <p>Returns a <code>DOMStringList</code> with the <span>property names</span> of the elements in the collection.</p>
@@ -8317,7 +8312,6 @@
    <dt><var title="">tokenlist</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the token with index <var title="">index</var>. The tokens are returned in the order they are found in the underlying string.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">hastoken</var> = <var title="">tokenlist</var> . <code title="dom-tokenlist-contains">contains</code>(<var title="">token</var>)</dt>
@@ -46849,10 +46843,6 @@
     <code>NodeList</code> object containing all those elements is
     returned.</p>
 
-    <p>Returns null if no element with that <span
-    title="concept-id">ID</span> or <code
-    title="attr-fe-name">name</code> could be found.</p>
-
    </dd>
 
    <dt><var title="">form</var> . <code title="dom-form-submit">submit</code>()</dt>
@@ -54485,7 +54475,6 @@
    <dt><var title="">select</var>[<var title="">index</var>]</dt>
    <dd>
     <p>Returns the item with index <var title="">index</var> from the <span title="concept-select-option-list">list of options</span>. The items are sorted in <span>tree order</span>.</p>
-    <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
    <dt><var title="">element</var> = <var title="">select</var> . <code title="dom-select-item">namedItem</code>(<var title="">name</var>)</dt>
@@ -84309,8 +84298,6 @@
 
     <p>Returns the entry with index <var title="">index</var> in the undo history.</p>
 
-    <p>Returns null if <var title="">index</var> is out of range.</p>
-
    </dd>
 
    <dt><var title="">undoManager</var> . <code title="dom-UndoManager-position">position</code></dt>




More information about the Commit-Watchers mailing list