[html5] r6176 - [e] (0) Clarify the <details> element's semantics.

[whatwg at whatwg.org]

Author: ianh
Date: 2011-06-02 15:40:53 -0700 (Thu, 02 Jun 2011)
New Revision: 6176

Modified:
   complete.html
   index
   source
Log:
[e] (0) Clarify the <details> element's semantics.

Modified: complete.html
===================================================================
--- complete.html	2011-06-02 01:16:04 UTC (rev 6175)
+++ complete.html	2011-06-02 22:40:53 UTC (rev 6176)
@@ -52281,24 +52281,28 @@
   <code><a href=#the-summary-element>summary</a></code> element, the user agent should provide its own
   legend (e.g. "Details").</span></p>
 
+  <p>The rest of the element's contents <a href=#represents>represents</a> the
+  additional information or controls.</p>
+
   <p>The <dfn id=attr-details-open title=attr-details-open><code>open</code></dfn>
   content attribute is a <a href=#boolean-attribute>boolean attribute</a>. If present,
-  it indicates that the details are to be shown to the user. If the
-  attribute is absent, the details are not to be shown.</p>
+  it indicates that both the summary and the additional information is
+  to be shown to the user. If the attribute is absent, only the
+  summary is to be shown.</p>
 
   <div class=impl>
 
   <p>When the element is created, if the attribute is absent, the
-  details should be hidden; if the attribute is absent, the details
-  should be shown. Subsequently, if the attribute is removed, then the
-  details should be hidden; if the attribute is added, the details
-  should be shown.</p>
+  additional information should be hidden; if the attribute is absent,
+  that information should be shown. Subsequently, if the attribute is
+  removed, then the information should be hidden; if the attribute is
+  added, the information should be shown.</p>
 
-  <p>The user agent should allow the user to request that the details
-  be shown or hidden. To honor a request for the details to be shown,
-  the user agent must set the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute on the element to
+  <p>The user agent should allow the user to request that the
+  additional information be shown or hidden. To honor a request for
+  the details to be shown, the user agent must set the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute on the element to
   the value <code title="">open</code>. To honor a request for the
-  details to be hidden, the user agent must remove the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute from the
+  information to be hidden, the user agent must remove the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute from the
   element.</p>
 
   <p>The <dfn id=dom-details-open title=dom-details-open><code>open</code></dfn> IDL

Modified: index
===================================================================
--- index	2011-06-02 01:16:04 UTC (rev 6175)
+++ index	2011-06-02 22:40:53 UTC (rev 6176)
@@ -52270,24 +52270,28 @@
   <code><a href=#the-summary-element>summary</a></code> element, the user agent should provide its own
   legend (e.g. "Details").</span></p>
 
+  <p>The rest of the element's contents <a href=#represents>represents</a> the
+  additional information or controls.</p>
+
   <p>The <dfn id=attr-details-open title=attr-details-open><code>open</code></dfn>
   content attribute is a <a href=#boolean-attribute>boolean attribute</a>. If present,
-  it indicates that the details are to be shown to the user. If the
-  attribute is absent, the details are not to be shown.</p>
+  it indicates that both the summary and the additional information is
+  to be shown to the user. If the attribute is absent, only the
+  summary is to be shown.</p>
 
   <div class=impl>
 
   <p>When the element is created, if the attribute is absent, the
-  details should be hidden; if the attribute is absent, the details
-  should be shown. Subsequently, if the attribute is removed, then the
-  details should be hidden; if the attribute is added, the details
-  should be shown.</p>
+  additional information should be hidden; if the attribute is absent,
+  that information should be shown. Subsequently, if the attribute is
+  removed, then the information should be hidden; if the attribute is
+  added, the information should be shown.</p>
 
-  <p>The user agent should allow the user to request that the details
-  be shown or hidden. To honor a request for the details to be shown,
-  the user agent must set the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute on the element to
+  <p>The user agent should allow the user to request that the
+  additional information be shown or hidden. To honor a request for
+  the details to be shown, the user agent must set the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute on the element to
   the value <code title="">open</code>. To honor a request for the
-  details to be hidden, the user agent must remove the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute from the
+  information to be hidden, the user agent must remove the <code title=attr-details-open><a href=#attr-details-open>open</a></code> attribute from the
   element.</p>
 
   <p>The <dfn id=dom-details-open title=dom-details-open><code>open</code></dfn> IDL

Modified: source
===================================================================
--- source	2011-06-02 01:16:04 UTC (rev 6175)
+++ source	2011-06-02 22:40:53 UTC (rev 6176)
@@ -59061,25 +59061,29 @@
   <code>summary</code> element, the user agent should provide its own
   legend (e.g. "Details").</span></p>
 
+  <p>The rest of the element's contents <span>represents</span> the
+  additional information or controls.</p>
+
   <p>The <dfn title="attr-details-open"><code>open</code></dfn>
   content attribute is a <span>boolean attribute</span>. If present,
-  it indicates that the details are to be shown to the user. If the
-  attribute is absent, the details are not to be shown.</p>
+  it indicates that both the summary and the additional information is
+  to be shown to the user. If the attribute is absent, only the
+  summary is to be shown.</p>
 
   <div class="impl">
 
   <p>When the element is created, if the attribute is absent, the
-  details should be hidden; if the attribute is absent, the details
-  should be shown. Subsequently, if the attribute is removed, then the
-  details should be hidden; if the attribute is added, the details
-  should be shown.</p>
+  additional information should be hidden; if the attribute is absent,
+  that information should be shown. Subsequently, if the attribute is
+  removed, then the information should be hidden; if the attribute is
+  added, the information should be shown.</p>
 
-  <p>The user agent should allow the user to request that the details
-  be shown or hidden. To honor a request for the details to be shown,
-  the user agent must set the <code
+  <p>The user agent should allow the user to request that the
+  additional information be shown or hidden. To honor a request for
+  the details to be shown, the user agent must set the <code
   title="attr-details-open">open</code> attribute on the element to
   the value <code title="">open</code>. To honor a request for the
-  details to be hidden, the user agent must remove the <code
+  information to be hidden, the user agent must remove the <code
   title="attr-details-open">open</code> attribute from the
   element.</p>