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

[whatwg at whatwg.org]

Author: ianh
Date: 2009-09-14 01:40:26 -0700 (Mon, 14 Sep 2009)
New Revision: 3840

Modified:
   index
   source
Log:
[e] (0) Try to clarify autocomplete section.

Modified: index
===================================================================
--- index	2009-09-14 07:54:21 UTC (rev 3839)
+++ index	2009-09-14 08:40:26 UTC (rev 3840)
@@ -34720,6 +34720,10 @@
 
   <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 @@
   <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>
 
-  <p>When an <code><a href=#the-input-element>input</a></code> element's <a href=#resulting-autocompletion-state>resulting
+  <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>
+
+  </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

Modified: source
===================================================================
--- source	2009-09-14 07:54:21 UTC (rev 3839)
+++ source	2009-09-14 08:40:26 UTC (rev 3840)
@@ -38603,6 +38603,10 @@
 
   <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,26 +38648,33 @@
   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
   may store the value entered by the user so that if the user returns