[e] (0) Make a number of clarifications for authors. (forms-related s…

…tuff) git-svn-id: http://svn.whatwg.org/webapps@4002 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Sep 25, 2009 · f44b6f2 · f44b6f2
1 parent 8f10e8c
commit f44b6f2
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 12 deletions.
diff --git a/index b/index
@@ -35006,7 +35006,8 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
 
   <p>The <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state
   indicates that the user agent is to use the <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute on the
-  element's <a href=#form-owner>form owner</a> instead.</p>
+  element's <a href=#form-owner>form owner</a> instead. (By default, the <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute of
+  <code><a href=#the-form-element>form</a></code> elements is in the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a> state.)</p>
 
   <div class=impl>
 
@@ -35363,15 +35364,11 @@ You cannot complete this form until the field is correct.</samp></pre>
   something like <samp>The text you have entered does not match the
   required pattern. Birthday</samp>, which is not useful.</p>
 
-  <div class=impl>
-
   <p>UAs may still show the <code><a href=#the-title-element-0>title</a></code> in non-error situations
   (for example, as a tooltip when hovering over the control), so
   authors should be careful not to word <code><a href=#the-title-element-0>title</a></code>s as if an
   error has necessarily occurred.</p>
 
-  </div>
-
 
 
   <h6 id=the-min-and-max-attributes><span class=secno>4.10.5.2.9 </span>The <code title=attr-input-min><a href=#attr-input-min>min</a></code> and <code title=attr-input-max><a href=#attr-input-max>max</a></code> attributes</h6>
@@ -35594,7 +35591,8 @@ You cannot complete this form until the field is correct.</samp></pre>
     <p>Can be set, to change the value.</p>
 
     <p>Throws an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception if it is
-    set when the control is a file upload control.</p>
+    set to any value other than the empty string when the control is a
+    file upload control.</p>
 
    </dd>
 
@@ -35616,6 +35614,9 @@ You cannot complete this form until the field is correct.</samp></pre>
     <p>Returns a <code>FileList</code> object listing the <a href=#concept-input-type-file-selected title=concept-input-type-file-selected>selected files</a> of
     the form control.</p>
 
+    <p>Throws an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception if the
+    control isn't a file control.</p>
+
    </dd>
 
    <dt><var title="">input</var> . <code title=dom-input-valueAsDate><a href=#dom-input-valueasdate>valueAsDate</a></code> [ = <var title="">value</var> ]</dt>

diff --git a/source b/source
@@ -38948,7 +38948,10 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
   title="attr-input-autocomplete-default-state">default</span> state
   indicates that the user agent is to use the <code
   title="attr-form-autocomplete">autocomplete</code> attribute on the
-  element's <span>form owner</span> instead.</p>
+  element's <span>form owner</span> instead. (By default, the <code
+  title="attr-form-autocomplete">autocomplete</code> attribute of
+  <code>form</code> elements is in the <span
+  title="attr-form-autocomplete-on-state">on</span> state.)</p>
 
   <div class="impl">
 
@@ -39343,15 +39346,11 @@ You cannot complete this form until the field is correct.</samp></pre>
   something like <samp>The text you have entered does not match the
   required pattern. Birthday</samp>, which is not useful.</p>
 
-  <div class="impl">
-
   <p>UAs may still show the <code>title</code> in non-error situations
   (for example, as a tooltip when hovering over the control), so
   authors should be careful not to word <code>title</code>s as if an
   error has necessarily occurred.</p>
 
-  </div>
-
 
 
   <h6>The <code title="attr-input-min">min</code> and <code
@@ -39617,7 +39616,8 @@ You cannot complete this form until the field is correct.</samp></pre>
     <p>Can be set, to change the value.</p>
 
     <p>Throws an <code>INVALID_ACCESS_ERR</code> exception if it is
-    set when the control is a file upload control.</p>
+    set to any value other than the empty string when the control is a
+    file upload control.</p>
 
    </dd>
 
@@ -39642,6 +39642,9 @@ You cannot complete this form until the field is correct.</samp></pre>
     title="concept-input-type-file-selected">selected files</span> of
     the form control.</p>
 
+    <p>Throws an <code>INVALID_STATE_ERR</code> exception if the
+    control isn't a file control.</p>
+
    </dd>
 
    <dt><var title="">input</var> . <code title="dom-input-valueAsDate">valueAsDate</code> [ = <var title="">value</var> ]</dt>