[html5] r8611 - [e] (0) Add some explanatory notes to <optgroup> Fixing https://www.w3.org/Bugs/ [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2014-05-07 14:07:03 -0700 (Wed, 07 May 2014)
New Revision: 8611

Modified:
   complete.html
   index
   source
Log:
[e] (0) Add some explanatory notes to <optgroup>
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=25112
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2014-05-07 17:49:39 UTC (rev 8610)
+++ complete.html	2014-05-07 21:07:03 UTC (rev 8611)
@@ -45385,7 +45385,7 @@
            attribute DOMString <a href=#dom-optgroup-label title=dom-optgroup-label>label</a>;
 };</pre>
    </dd>
-  </dl><!--TOPIC:HTML--><!-- v2: make optgroups selectable if they have a value. --><p>The <code><a href=#the-optgroup-element>optgroup</a></code> element <a href=#represents>represents</a> a group of <code><a href=#the-option-element>option</a></code>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-optgroup-element>optgroup</a></code> element <a href=#represents>represents</a> a group of <code><a href=#the-option-element>option</a></code>
   elements with a common label.</p>
 
   <p>The element's group of <code><a href=#the-option-element>option</a></code> elements consists of the <code><a href=#the-option-element>option</a></code>
@@ -45415,6 +45415,10 @@
 
   </div>
 
+  <p class=note>There is no way to select an <code><a href=#the-optgroup-element>optgroup</a></code> element. Only
+  <code><a href=#the-option-element>option</a></code> elements can be selected. An <code><a href=#the-optgroup-element>optgroup</a></code> element merely provides a
+  label for a group of <code><a href=#the-option-element>option</a></code> elements.</p>
+
   <div class=example>
 
    <p>The following snippet shows how a set of lessons from three courses could be offered in a

Modified: index
===================================================================
--- index	2014-05-07 17:49:39 UTC (rev 8610)
+++ index	2014-05-07 21:07:03 UTC (rev 8611)
@@ -45385,7 +45385,7 @@
            attribute DOMString <a href=#dom-optgroup-label title=dom-optgroup-label>label</a>;
 };</pre>
    </dd>
-  </dl><!--TOPIC:HTML--><!-- v2: make optgroups selectable if they have a value. --><p>The <code><a href=#the-optgroup-element>optgroup</a></code> element <a href=#represents>represents</a> a group of <code><a href=#the-option-element>option</a></code>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-optgroup-element>optgroup</a></code> element <a href=#represents>represents</a> a group of <code><a href=#the-option-element>option</a></code>
   elements with a common label.</p>
 
   <p>The element's group of <code><a href=#the-option-element>option</a></code> elements consists of the <code><a href=#the-option-element>option</a></code>
@@ -45415,6 +45415,10 @@
 
   </div>
 
+  <p class=note>There is no way to select an <code><a href=#the-optgroup-element>optgroup</a></code> element. Only
+  <code><a href=#the-option-element>option</a></code> elements can be selected. An <code><a href=#the-optgroup-element>optgroup</a></code> element merely provides a
+  label for a group of <code><a href=#the-option-element>option</a></code> elements.</p>
+
   <div class=example>
 
    <p>The following snippet shows how a set of lessons from three courses could be offered in a

Modified: source
===================================================================
--- source	2014-05-07 17:49:39 UTC (rev 8610)
+++ source	2014-05-07 21:07:03 UTC (rev 8611)
@@ -49777,8 +49777,6 @@
    </dd>
   </dl><!--TOPIC:HTML-->
 
-  <!-- v2: make optgroups selectable if they have a value. -->
-
   <p>The <code>optgroup</code> element <span>represents</span> a group of <code>option</code>
   elements with a common label.</p>
 
@@ -49811,6 +49809,10 @@
 
   </div>
 
+  <p class="note">There is no way to select an <code>optgroup</code> element. Only
+  <code>option</code> elements can be selected. An <code>optgroup</code> element merely provides a
+  label for a group of <code>option</code> elements.</p>
+
   <div class="example">
 
    <p>The following snippet shows how a set of lessons from three courses could be offered in a