- From: poot <cvsmail@w3.org>
- Date: Fri, 17 Jun 2011 05:52:36 -0400
- To: public-html-diffs@w3.org
hixie: Simplify the non-normative descriptions of index getters to avoid
confusing readers (the specifics of edge cases are rather subtle).
(whatwg r6223)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4987&r2=1.4988&f=h
http://html5.org/tools/web-apps-tracker?from=6222&to=6223
===================================================================
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 Friday, 17 June 2011 09:52:38 UTC