html5/spec Overview.html,1.2512,1.2513

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv4588

Modified Files:
	Overview.html 
Log Message:
Further tweak the new warnings section; remove the specific mention of <caption> as an alternative to summary='', describe what <a name> was for, and require that conformance checkers not call docs with warnings an unqualified 'valid'. (whatwg r3381)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2512
retrieving revision 1.2513
diff -u -d -r1.2512 -r1.2513
--- Overview.html	8 Jul 2009 19:06:08 -0000	1.2512
+++ Overview.html	8 Jul 2009 19:42:14 -0000	1.2513
@@ -63696,14 +63696,17 @@
   the string "<code title="">text/javascript</code>". The attribute
   should be entirely omitted instead (with the value "<code title="">JavaScript</code>", it has no effect), or replaced with use
   of the <code title="attr-script-type"><a href="#attr-script-type">type</a></code> attribute.<p>Authors should not specify the <code title="attr-a-name"><a href="#attr-a-name">name</a></code> attribute on <code><a href="#the-a-element">a</a></code>
-  elements. If the attribute is present, its value must not be the
-  empty string. The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute should
-  be used instead.<p>Authors should not specify the <dfn id="attr-table-summary" title="attr-table-summary"><code>summary</code></dfn> attribute on
+  elements.If the attribute is present, its value must not be the
+  empty string. In earlier versions of the language, this attribute
+  served a similar role as the <code title="attr-id"><a href="#the-id-attribute">id</a></code>
+  attribute. The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute should be
+  used instead.<p>Authors should not specify the <dfn id="attr-table-summary" title="attr-table-summary"><code>summary</code></dfn> attribute on
   <code><a href="#the-table-element">table</a></code> elements. <!-- 2.65% pages --> This attribute was
   suggested in earlier versions of the language as a technique for
   providing explanatory text for complex tables for users of screen
-  readers. The <code><a href="#the-caption-element">caption</a></code> element or one of the other <a href="#table-descriptions">techniques</a> described in the
-  <code><a href="#the-table-element">table</a></code> section should be used instead.<div class="impl">
+  readers. One of the <a href="#table-descriptions">techniques</a>
+  described in the <code><a href="#the-table-element">table</a></code> section should be used
+  instead.<div class="impl">
 
   <h4 id="warnings-for-obsolete-but-conforming-features"><span class="secno">12.1.1 </span>Warnings for obsolete but conforming features</h4>
 
@@ -63743,7 +63746,15 @@
    <li><p>The presence of a <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code> attribute on a
    <code><a href="#the-table-element">table</a></code> element.</li> <!-- 2.65% pages -->
 
-  </ul></div><h3 id="non-conforming-features"><span class="secno">12.2 </span>Non-conforming features</h3><p>Elements in the following list are entirely obsolete, and must
+  </ul><p>Conformance checkers must distinguish between pages that have no
+  conformance errors and have none of these obsolete features, and
+  pages that have no conformance errors but do have some of these
+  obsolete features.</p>
+
+  <p class="example">For example, a validator could report some pages
+  as "Valid HTML5" and others as "Valid HTML5 with warnings".</p>
+
+  </div><h3 id="non-conforming-features"><span class="secno">12.2 </span>Non-conforming features</h3><p>Elements in the following list are entirely obsolete, and must
   not be used by authors:<dl><!-- alphabetical by first element in the group, except CSS goes last --><dt><code><a href="#the-applet-element">applet</a></code></dt>
    <dd><p>Use <code><a href="#the-embed-element">embed</a></code> or <code><a href="#the-object-element">object</a></code> instead.</dd>

Received on Wednesday, 8 July 2009 19:42:26 UTC