[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