Even more editorial cleanup. (whatwg r3274)

Even more editorial cleanup. (whatwg r3274)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2421&r2=1.2422&f=h
http://html5.org/tools/web-apps-tracker?from=3273&to=3274

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2421
retrieving revision 1.2422
diff -u -d -r1.2421 -r1.2422
--- Overview.html 16 Jun 2009 01:09:32 -0000 1.2421
+++ Overview.html 16 Jun 2009 01:12:46 -0000 1.2422
@@ -12032,7 +12032,6 @@
    <dd><a href="#global-attributes">Global attributes</a></dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
-   <!-- XXX should the cite element have a cite attribute? -->
   </dl><p>The <code><a href="#the-cite-element">cite</a></code> element <a href="#represents">represents</a> the title
   of a work (e.g.
   a book,
@@ -12181,9 +12180,14 @@
 
    <pre>&lt;p&gt;&lt;em&gt;Cats are &lt;em&gt;cute&lt;/em&gt; animals!&lt;/em&gt;&lt;/p&gt;</pre>
 
-  </div><!-- XXX should say it is wrong to use as in:
+  </div><!--
 
-   <p><em>Note</em>: ...</p>
+   The following is a bad use of <em>:
+
+     <p><em>Note</em>: ...</p>
+
+   You should use <strong> or <i> for this instead (depending on
+   exactly what you're doing).
 
   --><h4 id="the-strong-element"><span class="secno">4.6.5 </span>The <dfn><code>strong</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
@@ -12420,7 +12424,7 @@
   element is an <code><a href="#the-abbr-element">abbr</a></code> element with a <code title="attr-abbr-title"><a href="#attr-abbr-title">title</a></code> attribute, then the exact value
   of <em>that</em> attribute is the term being defined. Otherwise, it
   is the exact <code>textContent</code> of the <code><a href="#the-dfn-element">dfn</a></code>
-  element that gives the term being defined.</p><!-- XXX that means <dfn>x \n x</dfn> won't match <span>x x</span> --><p>If the <code title="attr-dfn-title"><a href="#attr-dfn-title">title</a></code> attribute of the
+  element that gives the term being defined.</p><!-- note that this means <dfn>x \n x</dfn> won't match <span>x x</span> --><p>If the <code title="attr-dfn-title"><a href="#attr-dfn-title">title</a></code> attribute of the
   <code><a href="#the-dfn-element">dfn</a></code> element is present, then it must contain only the
   term being defined.<p class="note">The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute
   of ancestor elements does not affect <code><a href="#the-dfn-element">dfn</a></code> elements.<p>An <code><a href="#the-a-element">a</a></code> element that links to a <code><a href="#the-dfn-element">dfn</a></code>
@@ -13418,12 +13422,11 @@
    styling of specific elements of the sample output using a
    style sheet.</p>
 
-   <!-- XXX should those nested SAMPs be SPANs? -->
-   <pre>&lt;pre&gt;&lt;samp&gt;&lt;samp class="prompt"&gt;jdoe@mowmow:~$&lt;/samp&gt; &lt;kbd&gt;ssh demo.example.com&lt;/kbd&gt;
+   <pre>&lt;pre&gt;&lt;samp&gt;&lt;span class="prompt"&gt;jdoe@mowmow:~$&lt;/span&gt; &lt;kbd&gt;ssh demo.example.com&lt;/kbd&gt;
 Last login: Tue Apr 12 09:10:17 2005 from mowmow.example.com on pts/1
 Linux demo 2.6.10-grsec+gg3+e+fhs6b+nfs+gr0501+++p3+c4a+gr2b-reslog-v6.189 #1 SMP Tue Feb 1 11:22:36 PST 2005 i686 unknown
 
-&lt;samp class="prompt"&gt;jdoe@demo:~$&lt;/samp&gt; &lt;samp class="cursor"&gt;_&lt;/samp&gt;&lt;/samp&gt;&lt;/pre&gt;</pre>
+&lt;span class="prompt"&gt;jdoe@demo:~$&lt;/span&gt; &lt;span class="cursor"&gt;_&lt;/span&gt;&lt;/samp&gt;&lt;/pre&gt;</pre>
   </div><h4 id="the-kbd-element"><span class="secno">4.6.16 </span>The <dfn><code>kbd</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#phrasing-content-0">Phrasing content</a>.</dd>

Received on Tuesday, 16 June 2009 01:13:34 UTC