W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2009

html5/spec Overview.html,1.2202,1.2203

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 30 Apr 2009 19:04:11 +0000
To: public-html-commits@w3.org
Message-Id: <E1LzbYJ-0000du-M0@lionel-hutz.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>&lt;aside&gt;
@@ -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>  &lt;title&gt;Introduction to The Mating Rituals of Bees&lt;/title&gt;
     ...
@@ -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>  &lt;title&gt;Dances used during bee mating rituals&lt;/title&gt;
@@ -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>&ndash;<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>&ndash;<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>&lt;hgroup&gt;
@@ -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>&ndash;<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 @@
 &lt;/header&gt;</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>&lt;header&gt;
  &lt;hgroup&gt;
@@ -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>&ndash;<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>&lt;body&gt;
@@ -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.&lt;/p&gt;
 <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>&lt;h1&gt;<strong>&lt;img src="earthdayheader.png" alt="Earth Day"&gt;</strong>&lt;/h1&gt;</pre>
+   <pre>&lt;h1&gt;<strong>&lt;img src="earthdayheading.png" alt="Earth Day"&gt;</strong>&lt;/h1&gt;</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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 30 April 2009 19:04:22 GMT