[e] (0) Add some explanatory notes to <optgroup>

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=25112 Affected topics: HTML git-svn-id: http://svn.whatwg.org/webapps@8611 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · May 7, 2014 · b5ea59e · b5ea59e
1 parent 1dbd5ea
commit b5ea59e
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 4 deletions.
diff --git a/complete.html b/complete.html
@@ -45385,7 +45385,7 @@ <h4 id=the-optgroup-element><span class=secno>4.10.9 </span>The <dfn><code>optgr
            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 @@ <h4 id=the-optgroup-element><span class=secno>4.10.9 </span>The <dfn><code>optgr
 
   </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

diff --git a/index b/index
@@ -45385,7 +45385,7 @@ You cannot submit this form when the field is incorrect.</samp></pre>
            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 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
   </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

diff --git a/source b/source
@@ -49777,8 +49777,6 @@ You cannot submit this form when the field is incorrect.</samp></pre>
    </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 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
   </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