[html5] r4791 - [e] (0) Suggest some alternative semantic elements for obsolete ones. Fixing htt [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2010-02-22 20:52:44 -0800 (Mon, 22 Feb 2010)
New Revision: 4791

Modified:
   complete.html
   index
   source
Log:
[e] (0) Suggest some alternative semantic elements for obsolete ones.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=9021

Modified: complete.html
===================================================================
--- complete.html	2010-02-23 02:01:27 UTC (rev 4790)
+++ complete.html	2010-02-23 04:52:44 UTC (rev 4791)
@@ -83975,8 +83975,33 @@
    <dt><dfn id=tt><code>tt</code></dfn></dt>
    <dt><dfn id=u><code>u</code></dfn></dt>
    <dt><dfn id=wbr><code>wbr</code></dfn></dt>
-   <dd><p>Use CSS instead.</dd>
 
+   <dd>
+
+    <p>Use appropriate elements and/or CSS instead.</p>
+
+    <p>For the <code><a href=#s>s</a></code> and <code><a href=#strike>strike</a></code> elements, if
+    they are marking up a removal from the element, consider using the
+    <code><a href=#the-del-element>del</a></code> element instead.</p>
+
+    <p>Where the <code><a href=#tt>tt</a></code> element would have been used for
+    marking up keyboard input, consider the <code><a href=#the-kbd-element>kbd</a></code> element;
+    for variables, consider the <code><a href=#the-var-element>var</a></code> element; for computer
+    code, consider the <code><a href=#the-code-element>code</a></code> element; and for computer
+    output, consider the <code><a href=#the-samp-element>samp</a></code> element.</p>
+
+    <p>Similarly, if the <code><a href=#u>u</a></code> element is being used to
+    indicate emphasis, consider using the <code><a href=#the-em-element>em</a></code> element; if
+    it is being used for marking up keywords, consider the
+    <code><a href=#the-b-element>b</a></code> element; and if it is being used for highlighting
+    text for reference purposes, consider the <code><a href=#the-mark-element>mark</a></code>
+    element.</p>
+
+    <p>See also the <a href=#usage-summary>text-level semantics
+    usage summary</a> for more suggestions with examples.</p>
+
+   </dd>
+
   </dl><hr><p>The following attributes are obsolete (though the elements are
   still part of the language), and must not be used by authors:</p>
 

Modified: index
===================================================================
--- index	2010-02-23 02:01:27 UTC (rev 4790)
+++ index	2010-02-23 04:52:44 UTC (rev 4791)
@@ -78279,8 +78279,33 @@
    <dt><dfn id=tt><code>tt</code></dfn></dt>
    <dt><dfn id=u><code>u</code></dfn></dt>
    <dt><dfn id=wbr><code>wbr</code></dfn></dt>
-   <dd><p>Use CSS instead.</dd>
 
+   <dd>
+
+    <p>Use appropriate elements and/or CSS instead.</p>
+
+    <p>For the <code><a href=#s>s</a></code> and <code><a href=#strike>strike</a></code> elements, if
+    they are marking up a removal from the element, consider using the
+    <code><a href=#the-del-element>del</a></code> element instead.</p>
+
+    <p>Where the <code><a href=#tt>tt</a></code> element would have been used for
+    marking up keyboard input, consider the <code><a href=#the-kbd-element>kbd</a></code> element;
+    for variables, consider the <code><a href=#the-var-element>var</a></code> element; for computer
+    code, consider the <code><a href=#the-code-element>code</a></code> element; and for computer
+    output, consider the <code><a href=#the-samp-element>samp</a></code> element.</p>
+
+    <p>Similarly, if the <code><a href=#u>u</a></code> element is being used to
+    indicate emphasis, consider using the <code><a href=#the-em-element>em</a></code> element; if
+    it is being used for marking up keywords, consider the
+    <code><a href=#the-b-element>b</a></code> element; and if it is being used for highlighting
+    text for reference purposes, consider the <code><a href=#the-mark-element>mark</a></code>
+    element.</p>
+
+    <p>See also the <a href=#usage-summary>text-level semantics
+    usage summary</a> for more suggestions with examples.</p>
+
+   </dd>
+
   </dl><hr><p>The following attributes are obsolete (though the elements are
   still part of the language), and must not be used by authors:</p>
 

Modified: source
===================================================================
--- source	2010-02-23 02:01:27 UTC (rev 4790)
+++ source	2010-02-23 04:52:44 UTC (rev 4791)
@@ -19062,7 +19062,7 @@
 
 
 
-  <h4>Usage summary</h4>
+  <h4 id="usage-summary">Usage summary</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -93316,8 +93316,33 @@
    <dt><dfn><code>tt</code></dfn></dt>
    <dt><dfn><code>u</code></dfn></dt>
    <dt><dfn><code>wbr</code></dfn></dt>
-   <dd><p>Use CSS instead.</p></dd>
 
+   <dd>
+
+    <p>Use appropriate elements and/or CSS instead.</p>
+
+    <p>For the <code>s</code> and <code>strike</code> elements, if
+    they are marking up a removal from the element, consider using the
+    <code>del</code> element instead.</p>
+
+    <p>Where the <code>tt</code> element would have been used for
+    marking up keyboard input, consider the <code>kbd</code> element;
+    for variables, consider the <code>var</code> element; for computer
+    code, consider the <code>code</code> element; and for computer
+    output, consider the <code>samp</code> element.</p>
+
+    <p>Similarly, if the <code>u</code> element is being used to
+    indicate emphasis, consider using the <code>em</code> element; if
+    it is being used for marking up keywords, consider the
+    <code>b</code> element; and if it is being used for highlighting
+    text for reference purposes, consider the <code>mark</code>
+    element.</p>
+
+    <p>See also the <a href="#usage-summary">text-level semantics
+    usage summary</a> for more suggestions with examples.</p>
+
+   </dd>
+
   </dl>
 
   <hr>