- From: poot <cvsmail@w3.org>
- Date: Fri, 1 May 2009 04:05:39 +0900 (JST)
- To: public-html-diffs@w3.org
Attempt to resolve the terminology confusion of heading vs header. (whatwg r3043) flow content http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#flow-content-0 4.6.20 The b element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-b-element sectioning roots http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#sectioning-root 4.4.7 The hgroup element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-hgroup-element 3.4.1.3 Sectioning content http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#sectioning-content 4.4.2 The section element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-section-element 4.4.6 The h1, h2, h3, h4, h5, and h6 elements http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-h1-h2-h3-h4-h5-and-h6-elements 4.8.2.1.3 A short phrase or label with an alternative graphical representation: icons, logos http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos 4.8.2.1.5 A graphical representation of some of the surrounding text http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#a-graphical-representation-of-some-of-the-surrounding-text 4.4.9 The footer element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-footer-element 4.8.2.1.4 Text that has been rendered to a graphic for typographical effect http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#text-that-has-been-rendered-to-a-graphic-for-typographical-effect rank http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#rank In addition, whenever you exit a node, after doing the steps above, if current section is not null, associate the node with the section current section. http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#associatedSection 3.5 Paragraphs http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#paragraphs 4.4.11 Headings and sections http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#headings-and-sections 4.4.8 The header element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-header-element 4.2.2 The title element http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#the-title-element 10.2.2 Display types http://people.w3.org/mike/diffs/html5/spec/Overview.1.2203.html#display-types http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2202&r2=1.2203&f=h http://html5.org/tools/web-apps-tracker?from=3042&to=3043 =================================================================== 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:06:18 UTC