[e] (0) attempt to make this more readable

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8716 git-svn-id: http://svn.whatwg.org/webapps@4795 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 23, 2010 · 796a0e8 · 796a0e8
1 parent fbda196
commit 796a0e8
Show file tree

Hide file tree

Showing 3 changed files with 118 additions and 29 deletions.
diff --git a/complete.html b/complete.html
@@ -19538,7 +19538,8 @@ <h6 id=a-key-part-of-the-content><span class=secno>4.8.1.1.9 </span>A key part o
     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>
@@ -19764,16 +19765,41 @@ <h6 id=guidance-for-markup-generators><span class=secno>4.8.1.1.13 </span>Guidan
 
   <h6 id=guidance-for-conformance-checkers><span class=secno>4.8.1.1.14 </span>Guidance for conformance checkers</h6>
 
-  <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>
+  <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>
 
 
 

diff --git a/index b/index
@@ -19442,7 +19442,8 @@ of various sizes."&gt;</strong></pre>
     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>
@@ -19668,16 +19669,41 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
 
   <h6 id=guidance-for-conformance-checkers><span class=secno>4.8.1.1.14 </span>Guidance for conformance checkers</h6>
 
-  <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>
+  <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>
 
 
 

diff --git a/source b/source
@@ -20752,6 +20752,9 @@ of various sizes."></strong></pre>
 
     <ul>
 
+     <!-- when editing this list, don't forget to update the "Guidance
+     for conformance checkers" section below -->
+
      <li>The <code title="attr-title">title</code> attribute is
      present and has a non-empty value.</li>
 
@@ -20993,15 +20996,49 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   <h6>Guidance for conformance checkers</h6>
 
   <p>A conformance checker must report the lack of an <code
-  title="attr-img-alt">alt</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>meta</code> element with a
-  <code title="attr-meta-name">name</code> attribute whose value is an
-  <span>ASCII case-insensitive</span> match for the string "<code
-  title="meta-generator">generator</code>".</p>
+  title="attr-img-alt">alt</code> attribute as an error unless one of
+  the conditions listed below applies:</p>
+
+  <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">title</code> attribute is present
+   and has a non-empty value (as <a href="#unknown-images">described
+   above</a>).</li>
+
+   <li>The <code>img</code> element is in a <code>figure</code>
+   element that contains a <code>figcaption</code> element that
+   contains content other than <span>inter-element whitespace</span>
+   (as <a href="#unknown-images">described above</a>).</li>
+
+   <li>The <code>img</code> element is part of the only
+   <span>paragraph</span> directly in its <span
+   title="concept-section">section</span>, and is the only
+   <code>img</code> element without an <code
+   title="attr-img-alt">alt</code> attribute in its section, and its
+   <span title="concept-section">section</span> 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>meta</code> element with a <code
+   title="attr-meta-name">name</code> attribute whose value is an
+   <span>ASCII case-insensitive</span> match for the string "<code
+   title="meta-generator">generator</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>