- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 30 Apr 2009 19:04:11 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2456
Modified Files:
Overview.html
Log Message:
Attempt to resolve the terminology confusion of heading vs header. (whatwg r3043)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2202
retrieving revision 1.2203
diff -u -d -r1.2202 -r1.2203
--- Overview.html 30 Apr 2009 18:43:29 -0000 1.2202
+++ Overview.html 30 Apr 2009 19:04:08 -0000 1.2203
@@ -7708,7 +7708,7 @@
when it is used as a placeholder which will later be filled in by a
script, or when the element is part of a template and would on most
pages be filled in but on some pages is not relevant.<h5 id="sectioning-content"><span class="secno">3.4.1.3 </span>Sectioning content</h5><p><dfn id="sectioning-content-0">Sectioning content</dfn> is content that defines the scope
- of <a href="#heading-content-0" title="heading content">headers</a>, <a href="#the-footer-element" title="footer">footers</a>, and <a href="#the-address-element" title="address">contact
+ of <a href="#heading-content-0" title="heading content">headings</a>, <a href="#the-footer-element" title="footer">footers</a>, and <a href="#the-address-element" title="address">contact
information</a>.<p>Each <a href="#sectioning-content-0">sectioning content</a> element potentially has a
heading and an <a href="#outline">outline</a>. See the section on
<a href="#headings-and-sections">headings and sections</a> for further details.<p class="note">There are also certain elements that are <a href="#sectioning-root" title="sectioning root">sectioning roots</a>. These are distinct
@@ -7880,7 +7880,7 @@
other.<div class="example">
<p>In the following example, there are two paragraphs in a
- section. There is also a header, which contains phrasing content
+ section. There is also a heading, which contains phrasing content
that is not a paragraph. Note how the comments and
<a href="#inter-element-whitespace">inter-element whitespace</a> do not form paragraphs.</p>
@@ -7908,7 +7908,7 @@
</div><div class="example">
<p>In the following example, the link spans half of the first
- paragraph, all of the header separating the two paragraphs, and
+ paragraph, all of the heading separating the two paragraphs, and
half of the second paragraph.</p>
<pre><aside>
@@ -8796,14 +8796,14 @@
document's title or name. Authors should use titles that identify
their documents even when they are used out of context, for example
in a user's history or bookmarks, or in search results. The
- document's title is often different from its first header, since the
- first header does not have to stand alone when taken out of
+ document's title is often different from its first heading, since the
+ first heading does not have to stand alone when taken out of
context.<p>There must be no more than one <code><a href="#the-title-element">title</a></code> element per
document.<p>The <code><a href="#the-title-element">title</a></code> element must not contain any
elements.<div class="example">
<p>Here are some examples of appropriate titles, contrasted with
- the top-level headers that might be used on those same pages.</p>
+ the top-level headings that might be used on those same pages.</p>
<pre> <title>Introduction to The Mating Rituals of Bees</title>
...
@@ -8814,7 +8814,7 @@
<p>The next page might be a part of the same site. Note how the
title describes the subject matter unambiguously, while the first
- header assumes the reader knows what the context is and therefore
+ heading assumes the reader knows what the context is and therefore
won't wonder if the dances are Salsa or Waltz:</p>
<pre> <title>Dances used during bee mating rituals</title>
@@ -10742,7 +10742,7 @@
<dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
</dl><p>The <code><a href="#the-section-element">section</a></code> element <a href="#represents">represents</a> a
generic document or application section. A section, in this context,
- is a thematic grouping of content, typically with a header, possibly
+ is a thematic grouping of content, typically with a heading, possibly
with a footer.<p class="example">Examples of sections would be chapters, the
various tabbed pages in a tabbed dialog box, or the numbered
sections of a thesis. A Web site's home page could be split into
@@ -10924,7 +10924,7 @@
<dd><a href="#global-attributes">Global attributes</a></dd>
<dt>DOM interface:</dt>
<dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
- </dl><p>These elements <a href="#represents" title="represents">represent</a> headers
+ </dl><p>These elements <a href="#represents" title="represents">represent</a> headings
for their sections.<p>The semantics and meaning of these elements are defined in the
section on <a href="#headings-and-sections">headings and sections</a>.<p>These elements have a <dfn id="rank">rank</dfn> given by the number in
their name. The <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> element is said to have the highest
@@ -10941,8 +10941,8 @@
<dt>DOM interface:</dt>
<dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
</dl><p>The <code><a href="#the-hgroup-element">hgroup</a></code> element <a href="#represents">represents</a> the
- header of a section. The element is used to group a set of
- <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>–<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements when the header has
+ heading of a section. The element is used to group a set of
+ <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>–<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements when the heading has
multiple levels, such as subheadings, alternative titles, or
taglines.<p>For the purposes of document summaries, outlines, and the like,
the text of <code><a href="#the-hgroup-element">hgroup</a></code> elements is defined to be the text
@@ -10951,15 +10951,15 @@
<code><a href="#the-hgroup-element">hgroup</a></code> element, if there are any such elements, and the
first such element if there are multiple elements with that
<a href="#rank">rank</a>. If there are no such elements, then the text of
- the <code><a href="#the-hgroup-element">hgroup</a></code> element is the empty string.<p>Other heading elements in the <code><a href="#the-hgroup-element">hgroup</a></code> element
- indicate subheadings or subtitles.<p>The <a href="#rank">rank</a> of an <code><a href="#the-hgroup-element">hgroup</a></code> element is the
+ the <code><a href="#the-hgroup-element">hgroup</a></code> element is the empty string.<p>Other elements of <a href="#heading-content-0">heading content</a> in the
+ <code><a href="#the-hgroup-element">hgroup</a></code> element indicate subheadings or subtitles.<p>The <a href="#rank">rank</a> of an <code><a href="#the-hgroup-element">hgroup</a></code> element is the
same as for an <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> element (the highest rank).<p>The section on <a href="#headings-and-sections">headings and sections</a>
defines how <code><a href="#the-hgroup-element">hgroup</a></code> elements are assigned to individual
sections.<div class="example">
- <p>Here are some examples of valid headers. In each case, the
+ <p>Here are some examples of valid headings. In each case, the
emphasized text represents the text that would be used as the
- header in an application extracting header data and ignoring
+ heading in an application extracting heading data and ignoring
subheadings.</p>
<pre><hgroup>
@@ -10984,14 +10984,12 @@
<dt>DOM interface:</dt>
<dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
</dl><p>The <code><a href="#the-header-element">header</a></code> element <a href="#represents">represents</a> a group
- of introductory or navigational aids for the section it <a href="#applyToSection">applies</a> to. A <code><a href="#the-header-element">header</a></code> element
- typically contains the section's header (an
+ of introductory or navigational aids. A <code><a href="#the-header-element">header</a></code> element
+ typically contains the section's heading (an
<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>–<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> element or an
<code><a href="#the-hgroup-element">hgroup</a></code> element), but can also contain other content,
such as a table of contents, a search form, or any relevant
- logos.<p>Contact information for the section to which the
- <code><a href="#the-header-element">header</a></code> element <a href="#applyToSection">applies</a>
- should be marked up using the <code><a href="#the-address-element">address</a></code> element.<div class="example">
+ logos.<div class="example">
<p>Here are some sample headers. This first one is for a game:</p>
@@ -11001,7 +10999,7 @@
</header></pre>
<p>The following snippet shows how the element can be used to mark
- up a specification's heading:</p>
+ up a specification's header:</p>
<pre><header>
<hgroup>
@@ -11078,7 +11076,7 @@
though they usually do.<p>The <code><a href="#the-footer-element">footer</a></code> element is inappropriate for containing
entire sections. For appendices, indexes, long colophons, verbose
license agreements, and other such content which needs sectioning
- with headers and so forth, regular <code><a href="#the-section-element">section</a></code> elements
+ with headings and so forth, regular <code><a href="#the-section-element">section</a></code> elements
should be used, not a <code><a href="#the-footer-element">footer</a></code>.<div class="example">
<p>Here is a page with two footers, one at the top and one at the
@@ -11150,17 +11148,17 @@
<code><a href="#the-body-element">body</a></code>.<h4 id="headings-and-sections"><span class="secno">4.4.11 </span><dfn>Headings and sections</dfn></h4><p>The <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>–<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements and the
<code><a href="#the-hgroup-element">hgroup</a></code> element are headings.<p>The first element of <a href="#heading-content-0">heading content</a> in an element
of <a href="#sectioning-content-0">sectioning content</a> <a href="#represents">represents</a> the
- header for that section. Subsequent headers of equal or higher
- <a href="#rank">rank</a> start new (implied) sections, headers of lower
+ heading for that section. Subsequent headings of equal or higher
+ <a href="#rank">rank</a> start new (implied) sections, headings of lower
<a href="#rank">rank</a> start implied subsections that are part of the
previous one. In both cases, the element <a href="#represents">represents</a> the
- header of the implied section.<p><a href="#sectioning-content-0">Sectioning content</a> elements are always considered
+ heading of the implied section.<p><a href="#sectioning-content-0">Sectioning content</a> elements are always considered
subsections of their nearest ancestor element of <a href="#sectioning-content-0">sectioning
content</a>, regardless of what implied sections other headings
may have created.<p>Certain elements are said to be <dfn id="sectioning-root" title="sectioning
root">sectioning roots</dfn>, including <code><a href="#the-blockquote-element">blockquote</a></code> and
<code><a href="#the-td-element">td</a></code> elements. These elements can have their own
- outlines, but the sections and headers inside these elements do not
+ outlines, but the sections and headings inside these elements do not
contribute to the outlines of their ancestors.<div class="example">
<p>For the following fragment:</p>
<pre><body>
@@ -11192,7 +11190,7 @@
</ol><p>Notice how the <code><a href="#the-section-element">section</a></code> ends the earlier implicit
section so that a later paragraph ("Grunt") is back at the top
level.</p>
- </div><p>Sections may contain headers of any <a href="#rank">rank</a>, but
+ </div><p>Sections may contain headings of any <a href="#rank">rank</a>, but
authors are strongly encouraged to either use only <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>
elements, or to use elements of the appropriate <a href="#rank">rank</a>
for the section's nesting level.<p>Authors are also encouraged to explicitly wrap sections in
@@ -11503,7 +11501,7 @@
<p class="note">Selecting the first <a href="#concept-section" title="concept-section">section</a> of the document therefore
always takes the user to the top of the document, regardless of
- where the first header in the <code><a href="#the-body-element">body</a></code> is to be found.</p>
+ where the first heading in the <code><a href="#the-body-element">body</a></code> is to be found.</p>
<!-- XXX assuming there is a body, anyway -->
<div class="note">
@@ -14107,7 +14105,7 @@
kittens to her Aberdeen home.</p>
<i>[...]</i></pre>
</div><p>The <code><a href="#the-b-element">b</a></code> element should be used as a last resort when
- no other element is more appropriate. In particular, headers should
+ no other element is more appropriate. In particular, headings should
use the <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> to <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements, stress emphasis
should use the <code><a href="#the-em-element">em</a></code> element, importance should be denoted
with the <code><a href="#the-strong-element">strong</a></code> element, and text marked or highlighted
@@ -15290,7 +15288,7 @@
</div><p>Many pages include logos, insignia, flags, or emblems, which
stand for a particular entity such as a company, organization,
project, band, software package, country, or some such.<p>If the logo is being used to represent the entity, e.g. as a page
- header, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must
+ heading, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must
contain the name of the entity being represented by the logo. The
<code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must <em>not</em>
contain text like the word "logo", as it is not the fact that it is
@@ -15357,11 +15355,11 @@
<p>Consider a graphic containing the text "Earth Day", but with the
letters all decorated with flowers and plants. If the text is
- merely being used as a header, to spice up the page for graphical
+ merely being used as a heading, to spice up the page for graphical
users, then the correct alternative text is just the same text
"Earth Day", and no mention need be made of the decorations:</p>
- <pre><h1><strong><img src="earthdayheader.png" alt="Earth Day"></strong></h1></pre>
+ <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.2.1.5 </span>A graphical representation of some of the surrounding text</h6><p>In many cases, the image is actually just supplementary, and
its presence merely reinforces the surrounding text. In these
@@ -56074,9 +56072,9 @@
}
address, article, aside, blockquote, body, center, dd, dialog, dir,
-div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header, hr,
-html, legend, listing, menu, nav, ol, p, plaintext, pre, rp, section,
-ul, xmp { display: block; }
+div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header,
+hgroup, hr, html, legend, listing, menu, nav, ol, p, plaintext, pre,
+rp, section, ul, xmp { display: block; }
table { display: table; }
caption { display: table-caption; }
Received on Thursday, 30 April 2009 19:04:22 UTC