[html5] r6705 - [e] (0) Change the way this is phrased to try to make it less confusing. Fixing [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Oct 19 15:58:21 PDT 2011


Author: ianh
Date: 2011-10-19 15:58:20 -0700 (Wed, 19 Oct 2011)
New Revision: 6705

Modified:
   complete.html
   index
   source
Log:
[e] (0) Change the way this is phrased to try to make it less confusing.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=14049

Modified: complete.html
===================================================================
--- complete.html	2011-10-19 22:42:54 UTC (rev 6704)
+++ complete.html	2011-10-19 22:58:20 UTC (rev 6705)
@@ -49008,22 +49008,19 @@
   <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn>
   attribute gives the number of options to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
   have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a>
-  greater than zero. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present,
-  then the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute's
-  default value is 4. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
-  then the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute's
-  default value is 1.</p>
+  greater than zero.</p>
 
   <div class=impl>
 
   <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a
   <code><a href=#the-select-element>select</a></code> element is the result of applying the
   <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
-  element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if it
-  has one and parsing it is successful. If applying those rules to the
-  attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, the
-  element's <a href=#concept-select-size title=concept-select-size>display size</a> is
-  the default value of the attribute.</p>
+  element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if
+  it has one and parsing it is successful. If applying those rules to
+  the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the
+  element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4
+  if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+  content attribute is present, and 1 otherwise.</p>
 
   </div>
 
@@ -49327,12 +49324,15 @@
   <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes
   must <a href=#reflect>reflect</a> the respective content attributes of the
   same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
-  attribute has a default value of zero (which for historical reasons
-  is different from the default value of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute that it
-  reflects).</p> <!-- see bug 12288 for compat reasons why .size
-  allows zero (it's not limited to values greater than zero) even
-  though that value really makes no sense -->
+  attribute has a default value of zero.</p> <!-- see bug 12288 for
+  compat reasons why .size allows zero (it's not limited to values
+  greater than zero) even though that value really makes no sense -->
 
+  <p class=note>For historical reasons, the default value of the
+  <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not
+  return the actual size used, which, in the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1
+  or 4 depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
+
   <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code>
   attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
   methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The

Modified: index
===================================================================
--- index	2011-10-19 22:42:54 UTC (rev 6704)
+++ index	2011-10-19 22:58:20 UTC (rev 6705)
@@ -49008,22 +49008,19 @@
   <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn>
   attribute gives the number of options to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
   have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a>
-  greater than zero. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present,
-  then the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute's
-  default value is 4. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
-  then the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute's
-  default value is 1.</p>
+  greater than zero.</p>
 
   <div class=impl>
 
   <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a
   <code><a href=#the-select-element>select</a></code> element is the result of applying the
   <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
-  element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if it
-  has one and parsing it is successful. If applying those rules to the
-  attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, the
-  element's <a href=#concept-select-size title=concept-select-size>display size</a> is
-  the default value of the attribute.</p>
+  element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if
+  it has one and parsing it is successful. If applying those rules to
+  the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the
+  element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4
+  if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+  content attribute is present, and 1 otherwise.</p>
 
   </div>
 
@@ -49327,12 +49324,15 @@
   <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes
   must <a href=#reflect>reflect</a> the respective content attributes of the
   same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
-  attribute has a default value of zero (which for historical reasons
-  is different from the default value of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute that it
-  reflects).</p> <!-- see bug 12288 for compat reasons why .size
-  allows zero (it's not limited to values greater than zero) even
-  though that value really makes no sense -->
+  attribute has a default value of zero.</p> <!-- see bug 12288 for
+  compat reasons why .size allows zero (it's not limited to values
+  greater than zero) even though that value really makes no sense -->
 
+  <p class=note>For historical reasons, the default value of the
+  <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not
+  return the actual size used, which, in the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1
+  or 4 depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
+
   <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code>
   attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
   methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The

Modified: source
===================================================================
--- source	2011-10-19 22:42:54 UTC (rev 6704)
+++ source	2011-10-19 22:58:20 UTC (rev 6705)
@@ -54864,25 +54864,20 @@
   attribute gives the number of options to show to the user. The <code
   title="attr-select-size">size</code> attribute, if specified, must
   have a value that is a <span>valid non-negative integer</span>
-  greater than zero. If the <code
-  title="attr-select-multiple">multiple</code> attribute is present,
-  then the <code title="attr-select-size">size</code> attribute's
-  default value is 4. If the <code
-  title="attr-select-multiple">multiple</code> attribute is absent,
-  then the <code title="attr-select-size">size</code> attribute's
-  default value is 1.</p>
+  greater than zero.</p>
 
   <div class="impl">
 
   <p>The <dfn title="concept-select-size">display size</dfn> of a
   <code>select</code> element is the result of applying the
   <span>rules for parsing non-negative integers</span> to the value of
-  element's <code title="attr-select-size">size</code> attribute, if it
-  has one and parsing it is successful. If applying those rules to the
-  attribute's value is not successful, or if the <code
-  title="attr-select-size">size</code> attribute is absent, the
-  element's <span title="concept-select-size">display size</span> is
-  the default value of the attribute.</p>
+  element's <code title="attr-select-size">size</code> attribute, if
+  it has one and parsing it is successful. If applying those rules to
+  the attribute's value is not successful, or if the <code
+  title="attr-select-size">size</code> attribute is absent, then the
+  element's <span title="concept-select-size">display size</span> is 4
+  if the element's <code title="attr-select-multiple">multiple</code>
+  content attribute is present, and 1 otherwise.</p>
 
   </div>
 
@@ -55260,13 +55255,17 @@
   <dfn title="dom-select-size"><code>size</code></dfn> IDL attributes
   must <span>reflect</span> the respective content attributes of the
   same name. The <code title="dom-select-size">size</code> IDL
-  attribute has a default value of zero (which for historical reasons
-  is different from the default value of the <code
-  title="attr-select-size">size</code> content attribute that it
-  reflects).</p> <!-- see bug 12288 for compat reasons why .size
-  allows zero (it's not limited to values greater than zero) even
-  though that value really makes no sense -->
+  attribute has a default value of zero.</p> <!-- see bug 12288 for
+  compat reasons why .size allows zero (it's not limited to values
+  greater than zero) even though that value really makes no sense -->
 
+  <p class="note">For historical reasons, the default value of the
+  <code title="dom-select-size">size</code> IDL attribute does not
+  return the actual size used, which, in the absence of the <code
+  title="attr-select-size">size</code> content attribute, is either 1
+  or 4 depending on the presence of the <code
+  title="attr-select-multiple">multiple</code> attribute.</p>
+
   <p>The <code title="dom-cva-willValidate">willValidate</code>, <code
   title="dom-cva-validity">validity</code>, and <code
   title="dom-cva-validationMessage">validationMessage</code>




More information about the Commit-Watchers mailing list