[e] (0) Suggest some alternative semantic elements for obsolete ones.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=9021 git-svn-id: http://svn.whatwg.org/webapps@4791 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 23, 2010 · 31390f7 · 31390f7
1 parent 9379b8a
commit 31390f7
Show file tree

Hide file tree

Showing 3 changed files with 79 additions and 4 deletions.
diff --git a/complete.html b/complete.html
@@ -83975,7 +83975,32 @@ <h3 id=non-conforming-features><span class=secno>15.2 </span>Non-conforming feat
    <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>

diff --git a/index b/index
@@ -78279,7 +78279,32 @@ time:empty { binding: <i title="">time</i>; }</pre>
    <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>

diff --git a/source b/source
@@ -19062,7 +19062,7 @@ wormhole connection.&lt;/mark>&lt;/p></pre>
 
 
 
-  <h4>Usage summary</h4>
+  <h4 id="usage-summary">Usage summary</h4>
 
   <p><i>This section is non-normative.</i></p>
 
@@ -93316,7 +93316,32 @@ time:empty { binding: <i title="">time</i>; }</pre>
    <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>