hixie: attempt to make this more readable (whatwg r4795)

hixie: attempt to make this more readable (whatwg r4795)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3841&r2=1.3842&f=h
http://html5.org/tools/web-apps-tracker?from=4794&to=4795

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3841
retrieving revision 1.3842
diff -u -d -r1.3841 -r1.3842
--- Overview.html 23 Feb 2010 05:53:23 -0000 1.3841
+++ Overview.html 23 Feb 2010 07:03:32 -0000 1.3842
@@ -16722,7 +16722,8 @@
     attribute's value may be omitted, but one of the following
     conditions must be met as well:</p>
 
-    <ul><li>The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute is
+    <ul><!-- when editing this list, don't forget to update the "Guidance
+     for conformance checkers" section below --><li>The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute is
      present and has a non-empty value.</li>
 
      <li>The <code><a href="#the-img-element">img</a></code> element is in a <code><a href="#the-figure-element">figure</a></code>
@@ -16917,16 +16918,41 @@
 
   <h6 id="guidance-for-conformance-checkers"><span class="secno">4.8.1.1.14 </span>Guidance for conformance checkers</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
 
-  <p>A conformance checker must report the lack of an <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute as an error unless either
-  the conditions listed above for <a href="#unknown-images">images
-  whose contents are not known</a> apply, or the conformance checker
-  has been configured to assume that the document is an e-mail or
-  document intended for a specific person who is known to be able to
-  view images, or the document has a <code><a href="#meta">meta</a></code> element with a
-  <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code> attribute whose value is an
-  <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="meta-generator"><a href="#meta-generator">generator</a></code>".</p>
+  <p>A conformance checker must report the lack of an <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute as an error unless one of
+  the conditions listed below applies:</p>
 
-  </div><h4 id="the-iframe-element"><span class="secno">4.8.2 </span>The <dfn><code>iframe</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/100">ISSUE-100</a> (srcdoc) and <a href="http://www.w3.org/html/wg/tracker/issues/103">ISSUE-103</a> (srcdoc-xml-escaping) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
+  <ul><!-- don't forget to update the list in the id="unknown-images"
+   section above when editing this list --><li>The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute is present
+   and has a non-empty value (as <a href="#unknown-images">described
+   above</a>).</li>
+
+   <li>The <code><a href="#the-img-element">img</a></code> element is in a <code><a href="#the-figure-element">figure</a></code>
+   element that contains a <code><a href="#the-figcaption-element">figcaption</a></code> element that
+   contains content other than <a href="#inter-element-whitespace">inter-element whitespace</a>
+   (as <a href="#unknown-images">described above</a>).</li>
+
+   <li>The <code><a href="#the-img-element">img</a></code> element is part of the only
+   <a href="#paragraph">paragraph</a> directly in its <a href="#concept-section" title="concept-section">section</a>, and is the only
+   <code><a href="#the-img-element">img</a></code> element without an <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute in its section, and its
+   <a href="#concept-section" title="concept-section">section</a> has an associated
+   heading (as <a href="#unknown-images">described above</a>).</li>
+
+   <!-- the following are additional entries not included in the
+   aforementioned list, as they apply only to  -->
+
+   <li>The conformance checker has been configured to assume that the
+   document is an e-mail or document intended for a specific person
+   who is known to be able to view images.</li>
+
+   <li>The document has a <code><a href="#meta">meta</a></code> element with a <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code> attribute whose value is an
+   <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="meta-generator"><a href="#meta-generator">generator</a></code>". (This case does not
+   represent a case where the document is conforming, only that the
+   generator could not determine appropriate alternative text &mdash;
+   validators are required to not show an error in this case to
+   discourage markup generators from including bogus alternative text
+   purely in an attempt to silence validators.)</li>
+
+  </ul></div><h4 id="the-iframe-element"><span class="secno">4.8.2 </span>The <dfn><code>iframe</code></dfn> element</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/100">ISSUE-100</a> (srcdoc) and <a href="http://www.w3.org/html/wg/tracker/issues/103">ISSUE-103</a> (srcdoc-xml-escaping) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content">Flow content</a>.</dd>
    <dd><a href="#phrasing-content">Phrasing content</a>.</dd>
    <dd><a href="#embedded-content">Embedded content</a>.</dd>

Received on Tuesday, 23 February 2010 07:04:29 UTC