[html5] r7056 - [e] (0) Apply some WG chair decisions. Affected topics: HTML
whatwg at whatwg.org
whatwg at whatwg.org
Tue Apr 17 23:57:53 PDT 2012
Author: ianh
Date: 2012-04-17 23:57:51 -0700 (Tue, 17 Apr 2012)
New Revision: 7056
Modified:
complete.html
index
source
Log:
[e] (0) Apply some WG chair decisions.
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2012-04-17 21:32:22 UTC (rev 7055)
+++ complete.html 2012-04-18 06:57:51 UTC (rev 7056)
@@ -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 — Last Updated 17 April 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — 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 @@
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,9 +20445,37 @@
<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><figure>
+ <figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.</figcaption>
+ <figure>
+ <figcaption>Etching. Anonymous, ca. 1423.</figcaption>
+ <img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it.">
+ </figure>
+ <figure>
+ <figcaption>Oil-based paint on canvas. Maria Towle, 1858.</figcaption>
+ <img src="castle1858.jpeg" alt="The castle now has two towers and two walls.">
+ </figure>
+ <figure>
+ <figcaption>Film photograph. Peter Jankle, 1999.</figcaption>
+ <img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece.">
+ </figure>
+</figure></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><figure>
<img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
alt="The castle has one tower, and a tall wall around it.">
<img src="castle1858.jpeg" title="Oil-based paint on canvas. Maria Towle, 1858."
@@ -20447,6 +20486,7 @@
</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>
@@ -23794,7 +23834,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' --><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 @@
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 @@
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 @@
<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 @@
closing for lunch</span>.</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>
Modified: index
===================================================================
--- index 2012-04-17 21:32:22 UTC (rev 7055)
+++ index 2012-04-18 06:57:51 UTC (rev 7056)
@@ -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 — Last Updated 17 April 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — 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 @@
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,9 +20445,37 @@
<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><figure>
+ <figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.</figcaption>
+ <figure>
+ <figcaption>Etching. Anonymous, ca. 1423.</figcaption>
+ <img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it.">
+ </figure>
+ <figure>
+ <figcaption>Oil-based paint on canvas. Maria Towle, 1858.</figcaption>
+ <img src="castle1858.jpeg" alt="The castle now has two towers and two walls.">
+ </figure>
+ <figure>
+ <figcaption>Film photograph. Peter Jankle, 1999.</figcaption>
+ <img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece.">
+ </figure>
+</figure></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><figure>
<img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
alt="The castle has one tower, and a tall wall around it.">
<img src="castle1858.jpeg" title="Oil-based paint on canvas. Maria Towle, 1858."
@@ -20447,6 +20486,7 @@
</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>
@@ -23794,7 +23834,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' --><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 @@
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 @@
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 @@
<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 @@
closing for lunch</span>.</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>
Modified: source
===================================================================
--- source 2012-04-17 21:32:22 UTC (rev 7055)
+++ source 2012-04-18 06:57:51 UTC (rev 7056)
@@ -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 @@
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,9 +21904,37 @@
<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><figure>
+ <figcaption>The castle through the ages: 1423, 1858, and 1999 respectively.</figcaption>
+ <figure>
+ <figcaption>Etching. Anonymous, ca. 1423.</figcaption>
+ <img src="castle1423.jpeg" alt="The castle has one tower, and a tall wall around it.">
+ </figure>
+ <figure>
+ <figcaption>Oil-based paint on canvas. Maria Towle, 1858.</figcaption>
+ <img src="castle1858.jpeg" alt="The castle now has two towers and two walls.">
+ </figure>
+ <figure>
+ <figcaption>Film photograph. Peter Jankle, 1999.</figcaption>
+ <img src="castle1999.jpeg" alt="The castle lies in ruins, the original tower all that remains in one piece.">
+ </figure>
+</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><figure>
<img src="castle1423.jpeg" title="Etching. Anonymous, ca. 1423."
alt="The castle has one tower, and a tall wall around it.">
<img src="castle1858.jpeg" title="Oil-based paint on canvas. Maria Towle, 1858."
@@ -21905,6 +21945,7 @@
</figure></pre>
</div>
+<!--START w3c-html--><!--FORK--><!--TITLE-->
<h4>The <dfn><code>figcaption</code></dfn> element</h4>
@@ -25546,6 +25587,7 @@
<!-- 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 @@
<!-- 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 @@
<!-- 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 @@
<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 @@
closing for lunch</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">
More information about the Commit-Watchers
mailing list