Browse files

[e] (0) Apply some WG chair decisions.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7056 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent 2b1d471 commit 4c98a1d49d557b464c1056d688e46d4c09163167 @Hixie Hixie committed Apr 18, 2012
Showing with 174 additions and 26 deletions.
  1. +58 −10 complete.html
  2. +58 −10 index
  3. +58 −6 source
View
68 complete.html
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 17 April 2012</h2>
+ <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 18 April 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -1509,6 +1509,16 @@ <h6 class=no-toc id=how-do-the-whatwg-and-w3c-specifications-differ?><span class
instead, because of a <a href=http://lists.w3.org/Archives/Public/public-html/2012Jan/0131.html>working
group chair decision from November 2011</a>.</li>
+ <li>The W3C HTML specification omits a number of suggestions
+ regarding using the <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ attribute, and makes using the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute for captions
+ non-conforming in certain specific cases, because of a number of
+ working group chair decisions from March 2012:
+ <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-->
+
</ul><p>The following sections are only published in the WHATWG
specifications and are not currently available anywhere else:</p>
@@ -11206,8 +11216,9 @@ <h5 id=the-title-attribute><span class=secno>3.2.3.2 </span>The <dfn title=attr-
title or a description of the target resource; on an image, it could
be the image credit or a description of the image; on a paragraph,
it could be a footnote or commentary on the text; on a citation, it
- could be further information about the source; and so forth. The
- value is text.</p>
+ could be further information about the source; on <a href=#interactive-content>interactive
+ content</a>, it could be a label for, or instructions for, use of
+ the element; and so forth. The value is text.</p>
<p>If this attribute is omitted from an element, then it implies
that the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute of the
@@ -20434,7 +20445,35 @@ <h4 id=the-figure-element><span class=secno>4.5.11 </span>The <dfn><code>figure<
<div class=example>
<p>In this example, which could be part of a much larger work
- discussing a castle, the figure has three images in it.</p>
+ discussing a castle, nested <code><a href=#the-figure-element>figure</a></code> elements are used
+ to provide both a group caption and individual captions for each
+ figure in the group:</p>
+
+ <pre>&lt;figure&gt;
+ &lt;figcaption&gt;The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Etching. Anonymous, ca. 1423.&lt;/figcaption&gt;
+ &lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it."&gt;
+ &lt;/figure&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption&gt;
+ &lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls."&gt;
+ &lt;/figure&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Film photograph. Peter Jankle, 1999.&lt;/figcaption&gt;
+ &lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece."&gt;
+ &lt;/figure&gt;
+&lt;/figure&gt;</pre>
+
+ </div>
+
+<!--FORK--><!--TITLE-->
+ <div class=example>
+
+ <p>The previous example could also be more succintly written as
+ follows (using <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes in
+ place of the nested <code><a href=#the-figure-element>figure</a></code>/<code><a href=#the-figcaption-element>figcaption</a></code>
+ pairs):</p>
<pre>&lt;figure&gt;
&lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
@@ -20447,6 +20486,7 @@ <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>
@@ -23794,7 +23834,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' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ 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>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
@@ -24754,8 +24794,9 @@ <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' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
+ of 'critical-no-alt' --><!--FORK--><!--TITLE--><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
@@ -24954,9 +24995,10 @@ <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' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
+ of 'critical-no-alt' --><!--FORK--><!--TITLE--><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
@@ -58792,6 +58834,7 @@ <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>
@@ -58807,10 +58850,15 @@ <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 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>
+ <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>
<div class=example>
View
68 index
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 17 April 2012</h2>
+ <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 18 April 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -1509,6 +1509,16 @@
instead, because of a <a href=http://lists.w3.org/Archives/Public/public-html/2012Jan/0131.html>working
group chair decision from November 2011</a>.</li>
+ <li>The W3C HTML specification omits a number of suggestions
+ regarding using the <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ attribute, and makes using the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute for captions
+ non-conforming in certain specific cases, because of a number of
+ working group chair decisions from March 2012:
+ <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-->
+
</ul><p>The following sections are only published in the WHATWG
specifications and are not currently available anywhere else:</p>
@@ -11206,8 +11216,9 @@ interface <dfn id=htmlunknownelement>HTMLUnknownElement</dfn> : <a href=#htmlele
title or a description of the target resource; on an image, it could
be the image credit or a description of the image; on a paragraph,
it could be a footnote or commentary on the text; on a citation, it
- could be further information about the source; and so forth. The
- value is text.</p>
+ could be further information about the source; on <a href=#interactive-content>interactive
+ content</a>, it could be a label for, or instructions for, use of
+ the element; and so forth. The value is text.</p>
<p>If this attribute is omitted from an element, then it implies
that the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute of the
@@ -20434,7 +20445,35 @@ included with Exhibit B.
<div class=example>
<p>In this example, which could be part of a much larger work
- discussing a castle, the figure has three images in it.</p>
+ discussing a castle, nested <code><a href=#the-figure-element>figure</a></code> elements are used
+ to provide both a group caption and individual captions for each
+ figure in the group:</p>
+
+ <pre>&lt;figure&gt;
+ &lt;figcaption&gt;The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Etching. Anonymous, ca. 1423.&lt;/figcaption&gt;
+ &lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it."&gt;
+ &lt;/figure&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption&gt;
+ &lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls."&gt;
+ &lt;/figure&gt;
+ &lt;figure&gt;
+ &lt;figcaption&gt;Film photograph. Peter Jankle, 1999.&lt;/figcaption&gt;
+ &lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece."&gt;
+ &lt;/figure&gt;
+&lt;/figure&gt;</pre>
+
+ </div>
+
+<!--FORK--><!--TITLE-->
+ <div class=example>
+
+ <p>The previous example could also be more succintly written as
+ follows (using <code title=attr-title><a href=#the-title-attribute>title</a></code> attributes in
+ place of the nested <code><a href=#the-figure-element>figure</a></code>/<code><a href=#the-figcaption-element>figcaption</a></code>
+ pairs):</p>
<pre>&lt;figure&gt;
&lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
@@ -20447,6 +20486,7 @@ 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>
@@ -23794,7 +23834,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' --><li><p>If the image has a <code title=attr-title><a href=#the-title-attribute>title</a></code>
+ 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>
attribute whose value is not the empty string, then the value of
that attribute is the caption information; abort these
steps.</li>
@@ -24754,8 +24794,9 @@ 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' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is
+ of 'critical-no-alt' --><!--FORK--><!--TITLE--><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
@@ -24954,9 +24995,10 @@ 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' --><li>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is present
+ of 'critical-no-alt' --><!--FORK--><!--TITLE--><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
@@ -58792,6 +58834,7 @@ 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>
@@ -58807,10 +58850,15 @@ fur
closing for lunch&lt;/span&gt;.</pre>
</div>
+<!--FORK--><!--TITLE-->
- <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>
+ <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>
<div class=example>
View
64 source
@@ -234,6 +234,17 @@
href="http://lists.w3.org/Archives/Public/public-html/2012Jan/0131.html">working
group chair decision from November 2011</a>.</li>
+ <li>The W3C HTML specification omits a number of suggestions
+ regarding using the <code title="attr-title">title</code>
+ attribute, and makes using the <code
+ title="attr-title">title</code> attribute for captions
+ non-conforming in certain specific cases, because of a number of
+ working group chair decisions from March 2012:
+ <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-->
+
</ul>
<p>The following sections are only published in the WHATWG
@@ -11598,8 +11609,9 @@ interface <dfn>HTMLUnknownElement</dfn> : <span>HTMLElement</span> { };</pre>
title or a description of the target resource; on an image, it could
be the image credit or a description of the image; on a paragraph,
it could be a footnote or commentary on the text; on a citation, it
- could be further information about the source; and so forth. The
- value is text.</p>
+ could be further information about the source; on <span>interactive
+ content</span>, it could be a label for, or instructions for, use of
+ the element; and so forth. The value is text.</p>
<p>If this attribute is omitted from an element, then it implies
that the <code title="attr-title">title</code> attribute of the
@@ -21892,7 +21904,35 @@ included with Exhibit B.
<div class="example">
<p>In this example, which could be part of a much larger work
- discussing a castle, the figure has three images in it.</p>
+ discussing a castle, nested <code>figure</code> elements are used
+ to provide both a group caption and individual captions for each
+ figure in the group:</p>
+
+ <pre>&lt;figure>
+ &lt;figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.&lt;/figcaption>
+ &lt;figure>
+ &lt;figcaption>Etching. Anonymous, ca. 1423.&lt;/figcaption>
+ &lt;img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it.">
+ &lt;/figure>
+ &lt;figure>
+ &lt;figcaption>Oil-based paint on canvas. Maria Towle, 1858.&lt;/figcaption>
+ &lt;img src="castle1858.jpeg" alt="The castle now has two towers and two walls.">
+ &lt;/figure>
+ &lt;figure>
+ &lt;figcaption>Film photograph. Peter Jankle, 1999.&lt;/figcaption>
+ &lt;img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece.">
+ &lt;/figure>
+&lt;/figure></pre>
+
+ </div>
+
+<!--END w3c-html--><!--FORK--><!--TITLE-->
+ <div class="example">
+
+ <p>The previous example could also be more succintly written as
+ follows (using <code title="attr-title">title</code> attributes in
+ place of the nested <code>figure</code>/<code>figcaption</code>
+ pairs):</p>
<pre>&lt;figure>
&lt;img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
@@ -21905,6 +21945,7 @@ included with Exhibit B.
&lt;/figure></pre>
</div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
<h4>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -25546,6 +25587,7 @@ 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
@@ -26573,8 +26615,10 @@ 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
@@ -26788,9 +26832,11 @@ 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
@@ -68578,6 +68624,7 @@ 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
@@ -68597,12 +68644,17 @@ fur
closing for lunch&lt;/span>.</pre>
</div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
<hr>
- <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>
+ <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>
<div class="example">

0 comments on commit 4c98a1d

Please sign in to comment.