[html5] r4795 - [e] (0) attempt to make this more readable Fixing http://www.w3.org/Bugs/Public/ [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Feb 22 23:03:28 PST 2010
Author: ianh
Date: 2010-02-22 23:03:26 -0800 (Mon, 22 Feb 2010)
New Revision: 4795
Modified:
complete.html
index
source
Log:
[e] (0) attempt to make this more readable
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8716
Modified: complete.html
===================================================================
--- complete.html 2010-02-23 05:53:17 UTC (rev 4794)
+++ complete.html 2010-02-23 07:03:26 UTC (rev 4795)
@@ -19538,7 +19538,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>
@@ -19764,19 +19765,44 @@
<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 —
+ 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>
<dl class=element><dt>Categories</dt>
Modified: index
===================================================================
--- index 2010-02-23 05:53:17 UTC (rev 4794)
+++ index 2010-02-23 07:03:26 UTC (rev 4795)
@@ -19442,7 +19442,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>
@@ -19668,19 +19669,44 @@
<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 —
+ 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>
<dl class=element><dt>Categories</dt>
Modified: source
===================================================================
--- source 2010-02-23 05:53:17 UTC (rev 4794)
+++ source 2010-02-23 07:03:26 UTC (rev 4795)
@@ -20752,6 +20752,9 @@
<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,16 +20996,50 @@
<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 —
+ 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>
More information about the Commit-Watchers
mailing list