[html5] r7183 - [e] (0) Mention the validator silencing in the definition of the keyword that ca [...]
whatwg at whatwg.org
whatwg at whatwg.org
Thu Jul 19 16:14:08 PDT 2012
Author: ianh
Date: 2012-07-19 16:14:07 -0700 (Thu, 19 Jul 2012)
New Revision: 7183
Modified:
complete.html
index
source
Log:
[e] (0) Mention the validator silencing in the definition of the keyword that causes it. Also, clean up some of the related markup (this will be an ongoing thing as I come across such markup).
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17870
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2012-07-19 23:03:09 UTC (rev 7182)
+++ complete.html 2012-07-19 23:14:07 UTC (rev 7183)
@@ -1486,7 +1486,7 @@
(e.g. a wife sending her husband photos of their child) to
nonetheless include textual alternatives to those images, because
of <a href=http://lists.w3.org/Archives/Public/public-html/2011Apr/0451.html>a
- working group decision from April 2011</a>.</li>
+ working group decision from April 2011</a>.</li><!--FORK-->
<li>The W3C HTML specification does not state that the
<code><a href=#the-img-element>img</a></code> element's <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code>
@@ -1524,7 +1524,7 @@
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0555.html>first</a>,
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0731.html>second</a>,
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0785.html>third</a>.
- </li><!--FORK--><!--TITLE-->
+ </li><!--FORK-->
<li>The W3C HTML specification omits some advice about how to
remove focus outlines in an accessible manner (instead only urging
@@ -14979,6 +14979,14 @@
</div>
+ <p class=note>This metadata name causes conformance checkers to
+ <a href=#guidance-for-conformance-checkers>silently ignore</a>
+ certain conformance errors that are inevitable when using
+ state-of-the-art editing software, to discourage such editors from
+ replacing those errors with even more incorrect markup that
+ state-of-the-art automated conformance checkers cannot distinguish
+ from valid markup.</p>
+
</dd>
<dt><dfn id=meta-keywords title=meta-keywords><code>keywords</code></dfn></dt>
@@ -20508,7 +20516,6 @@
</div>
-<!--FORK--><!--TITLE-->
<div class=example>
<p>The previous example could also be more succintly written as
@@ -20527,7 +20534,6 @@
</figure></pre>
</div>
-<!--FORK--><!--TITLE-->
<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -24356,7 +24362,7 @@
caption information for the image, derived as follows:</p>
<ol><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--TITLE--><!-- this is not omitted for some reason; see http://www.w3.org/html/wg/wiki/ChangeProposals/notitlev2#Details --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ of 'critical-no-alt' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
@@ -25319,9 +25325,8 @@
be met as well:</p>
<ul><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
+ of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
present and has a non-empty value.</li>
-<!--FORK--><!--TITLE-->
<li id=figcaption-as-alt-condition>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
@@ -25520,10 +25525,9 @@
the conditions listed below applies:</p>
<ul><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
+ of 'critical-no-alt' --><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>
-<!--FORK--><!--TITLE-->
<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 satisfies <a href=#figcaption-as-alt-condition>the
@@ -25532,11 +25536,9 @@
<!-- the following are additional entries not included in the
aforementioned list, as they apply only to conformance checkers -->
-<!--FORK-->
<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>
-<!--FORK-->
<li>The document has a <code><a href=#the-meta-element>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
@@ -60453,7 +60455,6 @@
<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>
-<!--FORK--><!--TITLE-->
<hr><p>For short inline annotations, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute should be used.</p>
<div class=example>
@@ -60469,15 +60470,10 @@
closing for lunch</span>.</pre>
</div>
-<!--FORK--><!--TITLE-->
- <hr><p>For
-<!--FORK--><!--TITLE-->
- longer
-<!--FORK--><!--TITLE-->
- annotations, the <code><a href=#the-a-element>a</a></code> element should be used, pointing to
- an element later in the document. The convention is that the
- contents of the link be a number in square brackets.</p>
+ <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
+ used, pointing to an element later in the document. The convention
+ is that the contents of the link be a number in square brackets.</p>
<div class=example>
Modified: index
===================================================================
--- index 2012-07-19 23:03:09 UTC (rev 7182)
+++ index 2012-07-19 23:14:07 UTC (rev 7183)
@@ -1486,7 +1486,7 @@
(e.g. a wife sending her husband photos of their child) to
nonetheless include textual alternatives to those images, because
of <a href=http://lists.w3.org/Archives/Public/public-html/2011Apr/0451.html>a
- working group decision from April 2011</a>.</li>
+ working group decision from April 2011</a>.</li><!--FORK-->
<li>The W3C HTML specification does not state that the
<code><a href=#the-img-element>img</a></code> element's <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code>
@@ -1524,7 +1524,7 @@
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0555.html>first</a>,
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0731.html>second</a>,
<a href=http://lists.w3.org/Archives/Public/public-html/2012Mar/0785.html>third</a>.
- </li><!--FORK--><!--TITLE-->
+ </li><!--FORK-->
<li>The W3C HTML specification omits some advice about how to
remove focus outlines in an accessible manner (instead only urging
@@ -14979,6 +14979,14 @@
</div>
+ <p class=note>This metadata name causes conformance checkers to
+ <a href=#guidance-for-conformance-checkers>silently ignore</a>
+ certain conformance errors that are inevitable when using
+ state-of-the-art editing software, to discourage such editors from
+ replacing those errors with even more incorrect markup that
+ state-of-the-art automated conformance checkers cannot distinguish
+ from valid markup.</p>
+
</dd>
<dt><dfn id=meta-keywords title=meta-keywords><code>keywords</code></dfn></dt>
@@ -20508,7 +20516,6 @@
</div>
-<!--FORK--><!--TITLE-->
<div class=example>
<p>The previous example could also be more succintly written as
@@ -20527,7 +20534,6 @@
</figure></pre>
</div>
-<!--FORK--><!--TITLE-->
<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -24356,7 +24362,7 @@
caption information for the image, derived as follows:</p>
<ol><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--TITLE--><!-- this is not omitted for some reason; see http://www.w3.org/html/wg/wiki/ChangeProposals/notitlev2#Details --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ of 'critical-no-alt' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
@@ -25319,9 +25325,8 @@
be met as well:</p>
<ul><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
+ of 'critical-no-alt' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
present and has a non-empty value.</li>
-<!--FORK--><!--TITLE-->
<li id=figcaption-as-alt-condition>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
@@ -25520,10 +25525,9 @@
the conditions listed below applies:</p>
<ul><!-- when editing this list, search for the two other occurrences
- of 'critical-no-alt' --><!--FORK--><!--TITLE--><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
+ of 'critical-no-alt' --><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>
-<!--FORK--><!--TITLE-->
<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 satisfies <a href=#figcaption-as-alt-condition>the
@@ -25532,11 +25536,9 @@
<!-- the following are additional entries not included in the
aforementioned list, as they apply only to conformance checkers -->
-<!--FORK-->
<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>
-<!--FORK-->
<li>The document has a <code><a href=#the-meta-element>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
@@ -60453,7 +60455,6 @@
<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>
-<!--FORK--><!--TITLE-->
<hr><p>For short inline annotations, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute should be used.</p>
<div class=example>
@@ -60469,15 +60470,10 @@
closing for lunch</span>.</pre>
</div>
-<!--FORK--><!--TITLE-->
- <hr><p>For
-<!--FORK--><!--TITLE-->
- longer
-<!--FORK--><!--TITLE-->
- annotations, the <code><a href=#the-a-element>a</a></code> element should be used, pointing to
- an element later in the document. The convention is that the
- contents of the link be a number in square brackets.</p>
+ <hr><p>For longer annotations, the <code><a href=#the-a-element>a</a></code> element should be
+ used, pointing to an element later in the document. The convention
+ is that the contents of the link be a number in square brackets.</p>
<div class=example>
Modified: source
===================================================================
--- source 2012-07-19 23:03:09 UTC (rev 7182)
+++ source 2012-07-19 23:14:07 UTC (rev 7183)
@@ -207,7 +207,7 @@
nonetheless include textual alternatives to those images, because
of <a
href="http://lists.w3.org/Archives/Public/public-html/2011Apr/0451.html">a
- working group decision from April 2011</a>.</li>
+ working group decision from April 2011</a>.</li><!--FORK-->
<li>The W3C HTML specification does not state that the
<code>img</code> element's <code title="attr-img-alt">alt</code>
@@ -252,7 +252,7 @@
<a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0555.html">first</a>,
<a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0731.html">second</a>,
<a href="http://lists.w3.org/Archives/Public/public-html/2012Mar/0785.html">third</a>.
- </li><!--FORK--><!--TITLE-->
+ </li><!--FORK-->
<li>The W3C HTML specification omits some advice about how to
remove focus outlines in an accessible manner (instead only urging
@@ -15924,6 +15924,14 @@
</div>
+ <p class="note">This metadata name causes conformance checkers to
+ <a href="#guidance-for-conformance-checkers">silently ignore</a>
+ certain conformance errors that are inevitable when using
+ state-of-the-art editing software, to discourage such editors from
+ replacing those errors with even more incorrect markup that
+ state-of-the-art automated conformance checkers cannot distinguish
+ from valid markup.</p>
+
</dd>
<dt><dfn title="meta-keywords"><code>keywords</code></dfn></dt>
@@ -21988,7 +21996,6 @@
</div>
-<!--END w3c-html--><!--FORK--><!--TITLE-->
<div class="example">
<p>The previous example could also be more succintly written as
@@ -22007,7 +22014,6 @@
</figure></pre>
</div>
-<!--START w3c-html--><!--FORK--><!--TITLE-->
<h4>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -26204,7 +26210,6 @@
<!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' -->
-<!--TITLE--><!-- this is not omitted for some reason; see http://www.w3.org/html/wg/wiki/ChangeProposals/notitlev2#Details -->
<li><p>If the image has a <code title="attr-title">title</code>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
@@ -27235,10 +27240,8 @@
<!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' -->
-<!--END w3c-html--><!--FORK--><!--TITLE-->
<li>The <code title="attr-title">title</code> attribute is
present and has a non-empty value.</li>
-<!--START w3c-html--><!--FORK--><!--TITLE-->
<li id="figcaption-as-alt-condition">The <code>img</code> element
is in a <code>figure</code> element that contains a
@@ -27441,7 +27444,7 @@
<div class="impl">
- <h6>Guidance for conformance checkers</h6>
+ <h6 id="guidance-for-conformance-checkers">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 one of
@@ -27452,11 +27455,9 @@
<!-- when editing this list, search for the two other occurrences
of 'critical-no-alt' -->
-<!--END w3c-html--><!--FORK--><!--TITLE-->
<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>
-<!--START w3c-html--><!--FORK--><!--TITLE-->
<li>The <code>img</code> element is in a <code>figure</code>
element that satisfies <a href="#figcaption-as-alt-condition">the
@@ -27465,11 +27466,9 @@
<!-- the following are additional entries not included in the
aforementioned list, as they apply only to conformance checkers -->
-<!--END w3c-html--><!--FORK-->
<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>
-<!--START w3c-html--><!--FORK-->
<li>The document has a <code>meta</code> element with a <code
title="attr-meta-name">name</code> attribute whose value is an
@@ -70615,7 +70614,6 @@
<p>HTML does not have a dedicated mechanism for marking up
footnotes. Here are the recommended alternatives.</p>
-<!--END w3c-html--><!--FORK--><!--TITLE-->
<hr>
<p>For short inline annotations, the <code
@@ -70635,17 +70633,12 @@
closing for lunch</span>.</pre>
</div>
-<!--START w3c-html--><!--FORK--><!--TITLE-->
<hr>
- <p>For
-<!--END w3c-html--><!--FORK--><!--TITLE-->
- longer
-<!--START w3c-html--><!--FORK--><!--TITLE-->
- annotations, the <code>a</code> element should be used, pointing to
- an element later in the document. The convention is that the
- contents of the link be a number in square brackets.</p>
+ <p>For longer annotations, the <code>a</code> element should be
+ used, pointing to an element later in the document. The convention
+ is that the contents of the link be a number in square brackets.</p>
<div class="example">
More information about the Commit-Watchers
mailing list