[] (0) Fix HTMLSelectElement's collection-related IDL and non-normati…

…ve prose. Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=21735 Affected topics: DOM APIs git-svn-id: http://svn.whatwg.org/webapps@7893 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jun 4, 2013 · a1f319f · a1f319f
1 parent cb92db3
commit a1f319f
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 19 deletions.
diff --git a/complete.html b/complete.html
@@ -50413,8 +50413,8 @@ <h4 id=the-select-element><span class=secno>4.10.9 </span>The <dfn><code>select<
 
   readonly attribute <a href=#htmloptionscollection>HTMLOptionsCollection</a> <a href=#dom-select-options title=dom-select-options>options</a>;
            attribute unsigned long <a href=#dom-select-length title=dom-select-length>length</a>;
-  getter <a href=#element>Element</a> <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
-  object <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
+  getter <a href=#element>Element</a>? <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
+  (<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>)? <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
   void <a href=#dom-select-add title=dom-select-add>add</a>((<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>) element, optional (<a href=#htmlelement>HTMLElement</a> or long)? before = null);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(long index);
   <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>setter creator</a> void (unsigned long index, <a href=#htmloptionelement>HTMLOptionElement</a>? option);
@@ -50600,10 +50600,7 @@ <h4 id=the-select-element><span class=secno>4.10.9 </span>The <dfn><code>select<
    <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>
    <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 <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</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 the first 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 <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
 
     <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
 

diff --git a/index b/index
@@ -50413,8 +50413,8 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
   readonly attribute <a href=#htmloptionscollection>HTMLOptionsCollection</a> <a href=#dom-select-options title=dom-select-options>options</a>;
            attribute unsigned long <a href=#dom-select-length title=dom-select-length>length</a>;
-  getter <a href=#element>Element</a> <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
-  object <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
+  getter <a href=#element>Element</a>? <a href=#dom-select-item title=dom-select-item>item</a>(unsigned long index);
+  (<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>)? <a href=#dom-select-nameditem title=dom-select-namedItem>namedItem</a>(DOMString name);
   void <a href=#dom-select-add title=dom-select-add>add</a>((<a href=#htmloptionelement>HTMLOptionElement</a> or <a href=#htmloptgroupelement>HTMLOptGroupElement</a>) element, optional (<a href=#htmlelement>HTMLElement</a> or long)? before = null);
   void <a href=#dom-select-remove title=dom-select-remove>remove</a>(long index);
   <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>setter creator</a> void (unsigned long index, <a href=#htmloptionelement>HTMLOptionElement</a>? option);
@@ -50600,10 +50600,7 @@ You cannot submit this form when the field is incorrect.</samp></pre>
    <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>
    <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 <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</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 the first 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 <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
 
     <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
 

diff --git a/source b/source
@@ -1,4 +1,4 @@
-<!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
+        <!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
  !
  !   Adding a new element involves editing the following sections:
  !    - section for the element itself
@@ -55320,8 +55320,8 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
   readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
            attribute unsigned long <span title="dom-select-length">length</span>;
-  getter <span>Element</span> <span title="dom-select-item">item</span>(unsigned long index);
-  object <span title="dom-select-namedItem">namedItem</span>(DOMString name);
+  getter <span>Element</span>? <span title="dom-select-item">item</span>(unsigned long index);
+  (<span>HTMLOptionElement</span> or <span>HTMLOptGroupElement</span>)? <span title="dom-select-namedItem">namedItem</span>(DOMString name);
   void <span title="dom-select-add">add</span>((<span>HTMLOptionElement</span> or <span>HTMLOptGroupElement</span>) element, optional (<span>HTMLElement</span> or long)? before = null);
   void <span title="dom-select-remove">remove</span>(long index);
   <span title="dom-HTMLOptionsCollection-setter">setter creator</span> void (unsigned long index, <span>HTMLOptionElement</span>? option);
@@ -55546,13 +55546,10 @@ You cannot submit this form when the field is incorrect.</samp></pre>
    <dt><var title="">element</var> = <var title="">select</var> . <code title="dom-select-item">namedItem</code>(<var title="">name</var>)</dt>
    <dd>
 
-    <p>Returns the item with <span title="concept-id">ID</span> or <code
+    <p>Returns the first item with <span title="concept-id">ID</span> or <code
     title="attr-option-name">name</code> <var title="">name</var> from the <span
     title="concept-select-option-list">list of options</span>.</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>