- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 08 Sep 2010 05:51:24 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv26917
Modified Files:
Overview.html
Log Message:
Move this section up to introduce the section better. (whatwg r5440)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4338
retrieving revision 1.4339
diff -u -d -r1.4338 -r1.4339
--- Overview.html 8 Sep 2010 05:16:09 -0000 1.4338
+++ Overview.html 8 Sep 2010 05:51:20 -0000 1.4339
@@ -675,18 +675,18 @@
<ol>
<li><a href="#alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</a>
<ol>
- <li><a href="#a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.1 </span>A link or button containing nothing but the image</a></li>
- <li><a href="#a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.2 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</a></li>
- <li><a href="#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.3 </span>A short phrase or label with an alternative graphical representation: icons, logos</a></li>
- <li><a href="#text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.4 </span>Text that has been rendered to a graphic for typographical effect</a></li>
- <li><a href="#a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.5 </span>A graphical representation of some of the surrounding text</a></li>
- <li><a href="#a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.6 </span>A purely decorative image that doesn't add any information</a></li>
- <li><a href="#a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.7 </span>A group of images that form a single larger picture with no links</a></li>
- <li><a href="#a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with links</a></li>
- <li><a href="#a-key-part-of-the-content"><span class="secno">4.8.1.1.9 </span>A key part of the content</a></li>
- <li><a href="#an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.10 </span>An image not intended for the user</a></li>
- <li><a href="#an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.11 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</a></li>
- <li><a href="#general-guidelines"><span class="secno">4.8.1.1.12 </span>General guidelines</a></li>
+ <li><a href="#general-guidelines"><span class="secno">4.8.1.1.1 </span>General guidelines</a></li>
+ <li><a href="#a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.2 </span>A link or button containing nothing but the image</a></li>
+ <li><a href="#a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.3 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</a></li>
+ <li><a href="#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.4 </span>A short phrase or label with an alternative graphical representation: icons, logos</a></li>
+ <li><a href="#text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.5 </span>Text that has been rendered to a graphic for typographical effect</a></li>
+ <li><a href="#a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.6 </span>A graphical representation of some of the surrounding text</a></li>
+ <li><a href="#a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.7 </span>A purely decorative image that doesn't add any information</a></li>
+ <li><a href="#a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with no links</a></li>
+ <li><a href="#a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.9 </span>A group of images that form a single larger picture with links</a></li>
+ <li><a href="#a-key-part-of-the-content"><span class="secno">4.8.1.1.10 </span>A key part of the content</a></li>
+ <li><a href="#an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.11 </span>An image not intended for the user</a></li>
+ <li><a href="#an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.12 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</a></li>
<li><a href="#guidance-for-markup-generators"><span class="secno">4.8.1.1.13 </span>Guidance for markup generators</a></li>
<li><a href="#guidance-for-conformance-checkers"><span class="secno">4.8.1.1.14 </span>Guidance for conformance checkers</a></ol></ol></li>
<li><a href="#the-iframe-element"><span class="secno">4.8.2 </span>The <code>iframe</code> element</a></li>
@@ -17824,11 +17824,25 @@
<p>He would play in the morning, he would play in the evening.</p>
</article></pre>
- </div><h5 id="alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</h5><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Except where otherwise specified, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be specified and its
+ </div><h5 id="alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</h5><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><h6 id="general-guidelines"><span class="secno">4.8.1.1.1 </span>General guidelines</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Except where otherwise specified, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be specified and its
value must not be empty; the value must be an appropriate
replacement for the image. The specific requirements for the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute depend on what the image
is intended to represent, as described in the following
- sections.<h6 id="a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.1 </span>A link or button containing nothing but the image</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When an <a href="#the-a-element">a</a> element that creates a
+ sections.<p>The most general rule to consider when writing alternative text
+ is the following: <strong>the intent is that replacing every image
+ with the text of its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute
+ not change the meaning of the page</strong>.<p>So, in general, alternative text can be written by considering
+ what one would have written had one not been able to include the
+ image.<p>A corollary to this is that the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute's value should never
+ contain text that could be considered the image's <em>caption</em>,
+ <em>title</em>, or <em>legend</em>. It is supposed to contain
+ replacement text that could be used by users <em>instead</em> of the
+ image; it is not meant to supplement the image. The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute can be used for
+ supplemental information.<p class="note">One way to think of alternative text is to think
+ about how you would read the page containing the image to someone
+ over the phone, without mentioning that there is an image
+ present. Whatever you say instead of the image is typically a good
+ start for writing the alternative text.<h6 id="a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.2 </span>A link or button containing nothing but the image</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When an <a href="#the-a-element">a</a> element that creates a
<a href="#hyperlink">hyperlink</a>, or a <code><a href="#the-button-element">button</a></code> element, has no
textual content but contains one or more images, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attributes must contain text that
together convey the purpose of the link or button.<div class="example">
@@ -17867,7 +17881,7 @@
<pre><button name="rgb"><strong><img src="red" alt="sRGB profile"><img src="green" alt=""><img src="blue" alt=""></strong></button>
<button name="cmyk"><strong><img src="cyan" alt="CMYK profile"><img src="magenta" alt=""><img src="yellow" alt=""><img src="black" alt=""></strong></button></pre>
- </div><h6 id="a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.2 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes something can be more clearly stated in graphical
+ </div><h6 id="a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.3 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes something can be more clearly stated in graphical
form, for example as a flowchart, a diagram, a graph, or a simple
map showing directions. In such cases, an image can be given using
the <code><a href="#the-img-element">img</a></code> element, but the lesser textual version must
@@ -17929,7 +17943,7 @@
<code><a href="#the-figcaption-element">figcaption</a></code> element of a <code><a href="#the-figure-element">figure</a></code> with this
image).</p>
- </div><h6 id="a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.3 </span>A short phrase or label with an alternative graphical representation: icons, logos</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>A document can contain information in iconic form. The icon is
+ </div><h6 id="a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.4 </span>A short phrase or label with an alternative graphical representation: icons, logos</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>A document can contain information in iconic form. The icon is
intended to help users of visual browsers to recognize features at
a glance.<p>In some cases, the icon is supplemental to a text label
conveying the same meaning. In those cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be present but must
@@ -18035,7 +18049,7 @@
the text flows seamlessly into the surrounding text, as if the
image had never been there in the first place.</p>
- </div><h6 id="text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.4 </span>Text that has been rendered to a graphic for typographical effect</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes, an image just consists of text, and the purpose of the
+ </div><h6 id="text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.5 </span>Text that has been rendered to a graphic for typographical effect</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes, an image just consists of text, and the purpose of the
image is not to highlight the actual typographic effects used to
render the text, but just to convey the text itself.<p>In such cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code>
attribute must be present but must consist of the same text as
@@ -18049,7 +18063,7 @@
<pre><h1><strong><img src="earthdayheading.png" alt="Earth Day"></strong></h1></pre>
- </div><h6 id="a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.5 </span>A graphical representation of some of the surrounding text</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In many cases, the image is actually just supplementary, and
+ </div><h6 id="a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.6 </span>A graphical representation of some of the surrounding text</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In many cases, the image is actually just supplementary, and
its presence merely reinforces the surrounding text. In these
cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be
present but its value must be the empty string.<p>In general, an image falls into this category if removing the
@@ -18119,7 +18133,7 @@
Standards mode, and about 9% triggered the Standards mode.</p>
<strong><p><img src="rendering-mode-pie-chart.png" alt=""></p></strong></pre>
- </div><h6 id="a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.6 </span>A purely decorative image that doesn't add any information</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In general, if an image is decorative but isn't especially
+ </div><h6 id="a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.7 </span>A purely decorative image that doesn't add any information</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In general, if an image is decorative but isn't especially
page-specific, for example an image that forms part of a site-wide
design scheme, the image should be specified in the site's CSS,
not in the markup of the document.<p>However, a decorative image that isn't discussed by the
@@ -18147,7 +18161,7 @@
Round an island there below,<br>
The island of Shalott.</p></pre>
- </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.7 </span>A group of images that form a single larger picture with no links</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When a picture has been sliced into smaller image files that are
+ </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with no links</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When a picture has been sliced into smaller image files that are
then displayed together to form the complete picture again, one of
the images must have its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code>
attribute set as per the relevant rules that would be appropriate
@@ -18176,7 +18190,7 @@
><img src="1" alt=""><img src="1" alt=""><img src="0" alt=""
><img src="0" alt=""></strong></meter></p></pre>
- </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with links</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally, <a href="#image-map" title="image map">image maps</a> should be
+ </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.9 </span>A group of images that form a single larger picture with links</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally, <a href="#image-map" title="image map">image maps</a> should be
used instead of slicing an image for links.<p>However, if an image is indeed sliced and any of the components
of the sliced picture are the sole contents of links, then one image
per link must have alternative text in its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute representing the purpose
@@ -18194,7 +18208,7 @@
><img src="fsm-middle.png" alt=""
><a href="?go=right"><img src="fsm-right.png" alt="Right side."></a></p></strong></pre>
- </div><h6 id="a-key-part-of-the-content"><span class="secno">4.8.1.1.9 </span>A key part of the content</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In some cases, the image is a critical part of the
+ </div><h6 id="a-key-part-of-the-content"><span class="secno">4.8.1.1.10 </span>A key part of the content</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In some cases, the image is a critical part of the
content. This could be the case, for instance, on a page that is
part of a photo gallery. The image is the whole <em>point</em> of
the page containing it.<p>How to provide alternative text for an image that is a key part
@@ -18450,13 +18464,13 @@
</dd>
- </dl><h6 id="an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.10 </span>An image not intended for the user</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally authors should avoid using <code><a href="#the-img-element">img</a></code> elements
+ </dl><h6 id="an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.11 </span>An image not intended for the user</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally authors should avoid using <code><a href="#the-img-element">img</a></code> elements
for purposes other than showing images.<p>If an <code><a href="#the-img-element">img</a></code> element is being used for purposes other
than showing an image, e.g. as part of a service to count page
views, then the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must
be the empty string.<p>In such cases, the <code title="attr-dim-width"><a href="#attr-dim-width">width</a></code> and
<code title="attr-dim-height"><a href="#attr-dim-height">height</a></code> attributes should both
- be set to zero.<h6 id="an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.11 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p><i>This section does not apply to documents that are publicly
+ be set to zero.<h6 id="an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.12 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p><i>This section does not apply to documents that are publicly
accessible, or whose target audience is not necessarily personally
known to the author, such as documents on a Web site, e-mails sent
to public mailing lists, or software documentation.</i><p>When an image is included in a private communication (such as an
@@ -18468,21 +18482,7 @@
the e-mail is still usable should the user use a mail client that
does not support images, or should the document be forwarded on to
other users whose abilities might not include easily seeing
- images.<h6 id="general-guidelines"><span class="secno">4.8.1.1.12 </span>General guidelines</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>The most general rule to consider when writing alternative text
- is the following: <strong>the intent is that replacing every image
- with the text of its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute
- not change the meaning of the page</strong>.<p>So, in general, alternative text can be written by considering
- what one would have written had one not been able to include the
- image.<p>A corollary to this is that the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute's value should never
- contain text that could be considered the image's <em>caption</em>,
- <em>title</em>, or <em>legend</em>. It is supposed to contain
- replacement text that could be used by users <em>instead</em> of the
- image; it is not meant to supplement the image. The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute can be used for
- supplemental information.<p class="note">One way to think of alternative text is to think
- about how you would read the page containing the image to someone
- over the phone, without mentioning that there is an image
- present. Whatever you say instead of the image is typically a good
- start for writing the alternative text.<div class="impl">
+ images.<div class="impl">
<h6 id="guidance-for-markup-generators"><span class="secno">4.8.1.1.13 </span>Guidance for markup generators</h6>
Received on Wednesday, 8 September 2010 05:51:26 UTC