[html5] r8417 - [a] (2) Try to clarify <output> and <samp> based on discussions on the WHATWG li [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jan 21 16:28:50 PST 2014


Author: ianh
Date: 2014-01-21 16:28:49 -0800 (Tue, 21 Jan 2014)
New Revision: 8417

Modified:
   complete.html
   index
   source
Log:
[a] (2) Try to clarify <output> and <samp> based on discussions on the WHATWG list
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2014-01-22 00:11:23 UTC (rev 8416)
+++ complete.html	2014-01-22 00:28:49 UTC (rev 8417)
@@ -298,7 +298,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 21 January 2014</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 22 January 2014</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -19062,11 +19062,14 @@
    <dd><a href=#global-attributes>Global attributes</a></dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
-  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-samp-element>samp</a></code> element <a href=#represents>represents</a> (sample) output from a program or
-  computing system.</p>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-samp-element>samp</a></code> element <a href=#represents>represents</a> sample or quoted output from another
+  program or computing system.</p>
 
   <p class=note>See the <code><a href=#the-pre-element>pre</a></code> and <code><a href=#the-kbd-element>kbd</a></code> elements for more details.</p>
 
+  <p class=note>This element can be contrasted with the <code><a href=#the-output-element>output</a></code> element, which can be
+  used to provide immediate output in a Web application.</p>
+
   <div class=example>
    <p>This example shows the <code><a href=#the-samp-element>samp</a></code> element being used
    inline:</p>
@@ -45828,9 +45831,12 @@
   readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
 };</pre>
    </dd>
-  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-output-element>output</a></code> element <a href=#represents>represents</a> the result of a calculation or user
-  action.</p>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-output-element>output</a></code> element <a href=#represents>represents</a> the result of a calculation performed
+  by the application, or the result of a user action.</p>
 
+  <p class=note>This element can be contrasted with the <code><a href=#the-samp-element>samp</a></code> element, which is the
+  appropriate element for quoting the output of other programs run previously.</p>
+
   <p>The <dfn id=attr-output-for title=attr-output-for><code>for</code></dfn> content attribute allows an explicit
   relationship to be made between the result of a calculation and the elements that represent the
   values that went into the calculation or that otherwise influenced the calculation. The <code title=attr-output-for><a href=#attr-output-for>for</a></code> attribute, if specified, must contain a string consisting of an

Modified: index
===================================================================
--- index	2014-01-22 00:11:23 UTC (rev 8416)
+++ index	2014-01-22 00:28:49 UTC (rev 8417)
@@ -298,7 +298,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 21 January 2014</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 22 January 2014</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -19062,11 +19062,14 @@
    <dd><a href=#global-attributes>Global attributes</a></dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
-  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-samp-element>samp</a></code> element <a href=#represents>represents</a> (sample) output from a program or
-  computing system.</p>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-samp-element>samp</a></code> element <a href=#represents>represents</a> sample or quoted output from another
+  program or computing system.</p>
 
   <p class=note>See the <code><a href=#the-pre-element>pre</a></code> and <code><a href=#the-kbd-element>kbd</a></code> elements for more details.</p>
 
+  <p class=note>This element can be contrasted with the <code><a href=#the-output-element>output</a></code> element, which can be
+  used to provide immediate output in a Web application.</p>
+
   <div class=example>
    <p>This example shows the <code><a href=#the-samp-element>samp</a></code> element being used
    inline:</p>
@@ -45828,9 +45831,12 @@
   readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
 };</pre>
    </dd>
-  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-output-element>output</a></code> element <a href=#represents>represents</a> the result of a calculation or user
-  action.</p>
+  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-output-element>output</a></code> element <a href=#represents>represents</a> the result of a calculation performed
+  by the application, or the result of a user action.</p>
 
+  <p class=note>This element can be contrasted with the <code><a href=#the-samp-element>samp</a></code> element, which is the
+  appropriate element for quoting the output of other programs run previously.</p>
+
   <p>The <dfn id=attr-output-for title=attr-output-for><code>for</code></dfn> content attribute allows an explicit
   relationship to be made between the result of a calculation and the elements that represent the
   values that went into the calculation or that otherwise influenced the calculation. The <code title=attr-output-for><a href=#attr-output-for>for</a></code> attribute, if specified, must contain a string consisting of an

Modified: source
===================================================================
--- source	2014-01-22 00:11:23 UTC (rev 8416)
+++ source	2014-01-22 00:28:49 UTC (rev 8417)
@@ -19891,11 +19891,14 @@
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl><!--TOPIC:HTML-->
 
-  <p>The <code>samp</code> element <span>represents</span> (sample) output from a program or
-  computing system.</p>
+  <p>The <code>samp</code> element <span>represents</span> sample or quoted output from another
+  program or computing system.</p>
 
   <p class="note">See the <code>pre</code> and <code>kbd</code> elements for more details.</p>
 
+  <p class="note">This element can be contrasted with the <code>output</code> element, which can be
+  used to provide immediate output in a Web application.</p>
+
   <div class="example">
    <p>This example shows the <code>samp</code> element being used
    inline:</p>
@@ -50272,9 +50275,12 @@
    </dd>
   </dl><!--TOPIC:HTML-->
 
-  <p>The <code>output</code> element <span>represents</span> the result of a calculation or user
-  action.</p>
+  <p>The <code>output</code> element <span>represents</span> the result of a calculation performed
+  by the application, or the result of a user action.</p>
 
+  <p class="note">This element can be contrasted with the <code>samp</code> element, which is the
+  appropriate element for quoting the output of other programs run previously.</p>
+
   <p>The <dfn data-x="attr-output-for"><code>for</code></dfn> content attribute allows an explicit
   relationship to be made between the result of a calculation and the elements that represent the
   values that went into the calculation or that otherwise influenced the calculation. The <code




More information about the Commit-Watchers mailing list