[e] (0) Try to clarify autocomplete section.

git-svn-id: http://svn.whatwg.org/webapps@3840 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Sep 14, 2009 · 7f57633 · 7f57633
1 parent eccd680
commit 7f57633
Show file tree

Hide file tree

Showing 2 changed files with 51 additions and 31 deletions.
diff --git a/index b/index
@@ -34720,6 +34720,10 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
 
   <h6 id=the-autocomplete-attribute><span class=secno>4.10.4.2.1 </span>The <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute</h6>
 
+  <p>User agents sometimes have features for helping users fill forms
+  in, for example prefilling the user's address based on earlier user
+  input.</p>
+
   <p>The <dfn id=attr-input-autocomplete title=attr-input-autocomplete><code>autocomplete</code></dfn>
   attribute is an <a href=#enumerated-attribute>enumerated attribute</a>. The attribute has
   three states. The <code title=attr-input-autocomplete-on>on</code>
@@ -34754,21 +34758,26 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
   <p>Each <code><a href=#the-input-element>input</a></code> element has a <dfn id=resulting-autocompletion-state>resulting
   autocompletion state</dfn>, which is either <i title="">on</i> or <i title="">off</i>.</p>
 
-  <p>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
-  the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state,
-  when an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
-  the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
-  and the element has no <a href=#form-owner>form owner</a>, and when an
-  <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code> attribute is in
-  the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
-  and the element's <a href=#form-owner>form owner</a>'s <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute is in
-  the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a> state,
-  the <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting autocompletion
-  state</a> is <i title="">on</i>. Otherwise, the
+  <p>When an <code><a href=#the-input-element>input</a></code> element is in one of the following
+  conditions, the <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting
+  autocompletion state</a> is <i title="">on</i>; otherwise, the
   <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting autocompletion
-  state</a> is <i title="">off</i>.</p>
+  state</a> is <i title="">off</i>:</p>
+
+  <ul class=brief><li>Its <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code>
+   attribute is in the <a href=#attr-input-autocomplete-on-state title=attr-input-autocomplete-on-state>on</a> state.</li>
+
+   <li>Its <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code>
+   attribute is in the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
+   and the element has no <a href=#form-owner>form owner</a>.</li>
+
+   <li>Its <code title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code>
+   attribute is in the <a href=#attr-input-autocomplete-default-state title=attr-input-autocomplete-default-state>default</a> state,
+   and the element's <a href=#form-owner>form owner</a>'s <code title=attr-form-autocomplete><a href=#attr-form-autocomplete>autocomplete</a></code> attribute is in
+   the <a href=#attr-form-autocomplete-on-state title=attr-form-autocomplete-on-state>on</a>
+   state.</li>
 
-  <p>When an <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting
+  </ul><p>When an <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting
   autocompletion state</a> is <i title="">on</i>, the user agent
   may store the value entered by the user so that if the user returns
   to the page, the UA can prefill the form. Otherwise, the user agent

diff --git a/source b/source
@@ -38603,6 +38603,10 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
 
   <h6>The <code title="attr-input-autocomplete">autocomplete</code> attribute</h6>
 
+  <p>User agents sometimes have features for helping users fill forms
+  in, for example prefilling the user's address based on earlier user
+  input.</p>
+
   <p>The <dfn
   title="attr-input-autocomplete"><code>autocomplete</code></dfn>
   attribute is an <span>enumerated attribute</span>. The attribute has
@@ -38644,25 +38648,32 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
   autocompletion state</dfn>, which is either <i title="">on</i> or <i
   title="">off</i>.</p>
 
-  <p>When an <code>input</code> element's <code
-  title="attr-input-autocomplete">autocomplete</code> attribute is in
-  the <span title="attr-input-autocomplete-on-state">on</span> state,
-  when an <code>input</code> element's <code
-  title="attr-input-autocomplete">autocomplete</code> attribute is in
-  the <span
-  title="attr-input-autocomplete-default-state">default</span> state,
-  and the element has no <span>form owner</span>, and when an
-  <code>input</code> element's <code
-  title="attr-input-autocomplete">autocomplete</code> attribute is in
-  the <span
-  title="attr-input-autocomplete-default-state">default</span> state,
-  and the element's <span>form owner</span>'s <code
-  title="attr-form-autocomplete">autocomplete</code> attribute is in
-  the <span title="attr-form-autocomplete-on-state">on</span> state,
-  the <code>input</code> element's <span>resulting autocompletion
-  state</span> is <i title="">on</i>. Otherwise, the
+  <p>When an <code>input</code> element is in one of the following
+  conditions, the <code>input</code> element's <span>resulting
+  autocompletion state</span> is <i title="">on</i>; otherwise, the
   <code>input</code> element's <span>resulting autocompletion
-  state</span> is <i title="">off</i>.</p>
+  state</span> is <i title="">off</i>:</p>
+
+  <ul class="brief">
+
+   <li>Its <code title="attr-input-autocomplete">autocomplete</code>
+   attribute is in the <span
+   title="attr-input-autocomplete-on-state">on</span> state.</li>
+
+   <li>Its <code title="attr-input-autocomplete">autocomplete</code>
+   attribute is in the <span
+   title="attr-input-autocomplete-default-state">default</span> state,
+   and the element has no <span>form owner</span>.</li>
+
+   <li>Its <code title="attr-input-autocomplete">autocomplete</code>
+   attribute is in the <span
+   title="attr-input-autocomplete-default-state">default</span> state,
+   and the element's <span>form owner</span>'s <code
+   title="attr-form-autocomplete">autocomplete</code> attribute is in
+   the <span title="attr-form-autocomplete-on-state">on</span>
+   state.</li>
+
+  </ul>
 
   <p>When an <code>input</code> element's <span>resulting
   autocompletion state</span> is <i title="">on</i>, the user agent