Skip to content

Commit

Permalink
[e] (0) Mention the validator silencing in the definition of the keyw…
Browse files Browse the repository at this point in the history 
…ord 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

git-svn-id: http://svn.whatwg.org/webapps@7183 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jul 19, 2012
1 parent 2dfb534 commit 37efef5
Show file tree
Hide file tree
Showing 3 changed files with 46 additions and 61 deletions.
36 changes: 16 additions & 20 deletions complete.html
View file
Expand Up @@ -1486,7 +1486,7 @@ <h6 class=no-toc id=how-do-the-whatwg-and-w3c-specifications-differ?><span class
(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>
Expand Down Expand Up @@ -1524,7 +1524,7 @@ <h6 class=no-toc id=how-do-the-whatwg-and-w3c-specifications-differ?><span class
<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
Expand Down Expand Up @@ -14979,6 +14979,14 @@ <h5 id=standard-metadata-names><span class=secno>4.2.5.1 </span>Standard metadat

</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>
Expand Down Expand Up @@ -20508,7 +20516,6 @@ <h4 id=the-figure-element><span class=secno>4.5.11 </span>The <dfn><code>figure<

</div>

<!--FORK--><!--TITLE-->
<div class=example>

<p>The previous example could also be more succintly written as
Expand All @@ -20527,7 +20534,6 @@ <h4 id=the-figure-element><span class=secno>4.5.11 </span>The <dfn><code>figure<
&lt;/figure&gt;</pre>

</div>
<!--FORK--><!--TITLE-->


<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
Expand Down Expand Up @@ -24356,7 +24362,7 @@ <h4 id=the-img-element><span class=secno>4.8.1 </span>The <dfn><code>img</code><
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>
Expand Down Expand Up @@ -25319,9 +25325,8 @@ <h6 id=a-key-part-of-the-content><span class=secno>4.8.1.1.10 </span>A key part
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
Expand Down Expand Up @@ -25520,10 +25525,9 @@ <h6 id=guidance-for-conformance-checkers><span class=secno>4.8.1.1.14 </span>Gui
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
Expand All @@ -25532,11 +25536,9 @@ <h6 id=guidance-for-conformance-checkers><span class=secno>4.8.1.1.14 </span>Gui
<!-- 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
Expand Down Expand Up @@ -60453,7 +60455,6 @@ <h4 id=footnotes><span class=secno>4.13.5 </span>Footnotes</h4>
<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>
Expand All @@ -60469,15 +60470,10 @@ <h4 id=footnotes><span class=secno>4.13.5 </span>Footnotes</h4>
closing for lunch&lt;/span&gt;.</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>

Expand Down
36 changes: 16 additions & 20 deletions index
View file
Expand Up @@ -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>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -14979,6 +14979,14 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p&gt;

</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>
Expand Down Expand Up @@ -20508,7 +20516,6 @@ included with Exhibit B.

</div>

<!--FORK--><!--TITLE-->
<div class=example>

<p>The previous example could also be more succintly written as
Expand All @@ -20527,7 +20534,6 @@ included with Exhibit B.
&lt;/figure&gt;</pre>

</div>
<!--FORK--><!--TITLE-->


<h4 id=the-figcaption-element><span class=secno>4.5.12 </span>The <dfn><code>figcaption</code></dfn> element</h4>
Expand Down Expand Up @@ -24356,7 +24362,7 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href=#htmlelement
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>
Expand Down Expand Up @@ -25319,9 +25325,8 @@ of various sizes."&gt;</strong></pre>
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
Expand Down Expand Up @@ -25520,10 +25525,9 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
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
Expand All @@ -25532,11 +25536,9 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
<!-- 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
Expand Down Expand Up @@ -60453,7 +60455,6 @@ fur
<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>
Expand All @@ -60469,15 +60470,10 @@ fur
closing for lunch&lt;/span&gt;.</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>

Expand Down
35 changes: 14 additions & 21 deletions source
View file
Expand Up @@ -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>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -15924,6 +15924,14 @@ gave me some of the songs they wrote. I love sharing my music.&lt;/p>

</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>
Expand Down Expand Up @@ -21988,7 +21996,6 @@ included with Exhibit B.

</div>

<!--END w3c-html--><!--FORK--><!--TITLE-->
<div class="example">

<p>The previous example could also be more succintly written as
Expand All @@ -22007,7 +22014,6 @@ included with Exhibit B.
&lt;/figure></pre>

</div>
<!--START w3c-html--><!--FORK--><!--TITLE-->


<h4>The <dfn><code>figcaption</code></dfn> element</h4>
Expand Down Expand Up @@ -26204,7 +26210,6 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
<!-- 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
Expand Down Expand Up @@ -27235,10 +27240,8 @@ of various sizes."></strong></pre>
<!-- 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
Expand Down Expand Up @@ -27441,7 +27444,7 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>

<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
Expand All @@ -27452,11 +27455,9 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
<!-- 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
Expand All @@ -27465,11 +27466,9 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
<!-- 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
Expand Down Expand Up @@ -70615,7 +70614,6 @@ fur
<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
Expand All @@ -70635,17 +70633,12 @@ fur
closing for lunch&lt;/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">

Expand Down

0 comments on commit 37efef5

Please sign in to comment.