Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[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
Hixie committed Apr 18, 2012
1 parent 2b1d471 commit 4c98a1d
Show file tree
Hide file tree
Showing 3 changed files with 174 additions and 26 deletions.
68 changes: 58 additions & 10 deletions complete.html
Expand Up @@ -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>
Expand Down Expand Up @@ -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>

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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."
Expand All @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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>
Expand All @@ -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>

Expand Down
68 changes: 58 additions & 10 deletions index
Expand Up @@ -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>
Expand Down Expand Up @@ -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>

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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."
Expand All @@ -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>
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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>
Expand All @@ -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>

Expand Down

0 comments on commit 4c98a1d

Please sign in to comment.