W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2011

html5/spec Overview.html,1.4987,1.4988

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 14 Jun 2011 21:56:14 +0000
To: public-html-commits@w3.org
Message-Id: <E1QWbao-0002qG-NR@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv10903

Modified Files:
	Overview.html 
Log Message:
Simplify the non-normative descriptions of index getters to avoid confusing readers (the specifics of edge cases are rather subtle). (whatwg r6223)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4987
retrieving revision 1.4988
diff -u -d -r1.4987 -r1.4988
--- Overview.html	14 Jun 2011 02:08:09 -0000	1.4987
+++ Overview.html	14 Jun 2011 21:56:10 -0000	1.4988
@@ -6635,7 +6635,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>
@@ -6644,7 +6643,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
@@ -6710,7 +6708,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>
@@ -6720,7 +6717,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
@@ -6800,7 +6796,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>
@@ -6810,7 +6805,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>
@@ -6909,7 +6903,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>
@@ -6919,7 +6912,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>
@@ -7074,7 +7066,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>
@@ -31262,8 +31253,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>
@@ -36758,7 +36747,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>
Received on Tuesday, 14 June 2011 21:56:16 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 14 June 2011 21:56:19 GMT