Skip to content

Commit

Permalink
[e] (0) attempt to make this more readable
Browse files Browse the repository at this point in the history
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
  • Loading branch information
Hixie committed Feb 23, 2010
1 parent fbda196 commit 796a0e8
Show file tree
Hide file tree
Showing 3 changed files with 118 additions and 29 deletions.
46 changes: 36 additions & 10 deletions complete.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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>



Expand Down
46 changes: 36 additions & 10 deletions index
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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>



Expand Down
55 changes: 46 additions & 9 deletions source
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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>

Expand Down

0 comments on commit 796a0e8

Please sign in to comment.