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

Rename <header> to <hgroup> and restrict it just to supporting subheadings. (whatwg r3039)

From: poot <cvsmail@w3.org>
Date: Fri, 1 May 2009 02:39:15 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090430173915.C302F2BBF4@toro.w3.mag.keio.ac.jp>
Rename <header> to <hgroup> and restrict it just to supporting
subheadings. (whatwg r3039)

media element attributes
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#media-element-attributes
4.4.3 The nav element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#the-nav-element
3.3 Elements
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#elements
4.4.7 The hgroup element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#the-hgroup-element
media data
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#media-data
4.4.2 The section element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#the-section-element
rank
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#rank
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.2199.html#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos
4.4.8 The footer element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#the-footer-element
Special
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#special
4.4.10 Headings and sections
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#headings-and-sections
8.2.5.10 The "in body" insertion mode
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#parsing-main-inbody
8.1.2.4 Optional tags
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#optional-tags
4.4.9 The address element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2199.html#the-address-element

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2198&r2=1.2199&f=h
http://html5.org/tools/web-apps-tracker?from=3038&to=3039

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2198
retrieving revision 1.2199
diff -u -d -r1.2198 -r1.2199
--- Overview.html	30 Apr 2009 07:02:46 -0000	1.2198
+++ Overview.html	30 Apr 2009 17:37:35 -0000	1.2199
@@ -444,7 +444,7 @@
   <code>h3</code>, <code>h4</code>,
   <code>h5</code>, and <code>h6</code>
   elements</a></li>
-     <li><a href="#the-header-element"><span class="secno">4.4.7 </span>The <code>header</code> element</a></li>
+     <li><a href="#the-hgroup-element"><span class="secno">4.4.7 </span>The <code>hgroup</code> element</a></li>
      <li><a href="#the-footer-element"><span class="secno">4.4.8 </span>The <code>footer</code> element</a></li>
      <li><a href="#the-address-element"><span class="secno">4.4.9 </span>The <code>address</code> element</a></li>
      <li><a href="#headings-and-sections"><span class="secno">4.4.10 </span>Headings and sections</a>
@@ -7025,14 +7025,14 @@
  &lt;h2&gt;Leading the way in widget design since 1432&lt;/h2&gt;
  ...</pre>
 
-   <p>The <code><a href="#the-header-element">header</a></code> element should be used in these kinds of
+   <p>The <code><a href="#the-hgroup-element">hgroup</a></code> element should be used in these kinds of
    situations:</p>
 
    <pre>&lt;body&gt;
- &lt;header&gt;
+ &lt;hgroup&gt;
   &lt;h1&gt;ABC Company&lt;/h1&gt;
   &lt;h2&gt;Leading the way in widget design since 1432&lt;/h2&gt;
- &lt;/header&gt;
+ &lt;/hgroup&gt;
  ...</pre>
 
   </div><p>Through scripting and using other mechanisms, the values of
@@ -10751,10 +10751,10 @@
    Web page) about apples, containing two short sections.</p>
 
    <pre>&lt;article&gt;
- &lt;header&gt;
+ &lt;hgroup&gt;
   &lt;h1&gt;Apples&lt;/h1&gt;
-  &lt;p&gt;Tasty, delicious fruit!&lt;/p&gt;
- &lt;/header&gt;
+  &lt;h2&gt;Tasty, delicious fruit!&lt;/h2&gt;
+ &lt;/hgroup&gt;
  &lt;p&gt;The apple is the pomaceous fruit of the apple tree.&lt;/p&gt;
  &lt;section&gt;
   &lt;h1&gt;Red Delicious&lt;/h1&gt;
@@ -10798,12 +10798,12 @@
    navigation section.</p>
 
    <pre>&lt;body&gt;
- &lt;header&gt;
+ <!--&lt;header>-->
   &lt;h1&gt;Wake up sheeple!&lt;/h1&gt;
   &lt;p&gt;&lt;a href="news.html"&gt;News&lt;/a&gt; -
      &lt;a href="blog.html"&gt;Blog&lt;/a&gt; -
      &lt;a href="forums.html"&gt;Forums&lt;/a&gt;&lt;/p&gt;
- &lt;/header&gt;
+ <!--&lt;/header>-->
  &lt;nav&gt;
   &lt;h1&gt;Navigation&lt;/h1&gt;
   &lt;ul&gt;
@@ -10926,39 +10926,31 @@
   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
   rank, the <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> element has the lowest rank, and two
-  elements with the same name have equal rank.<h4 id="the-header-element"><span class="secno">4.4.7 </span>The <dfn><code>header</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+  elements with the same name have equal rank.<h4 id="the-hgroup-element"><span class="secno">4.4.7 </span>The <dfn><code>hgroup</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#heading-content-0">Heading content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
-   <dd><a href="#flow-content-0">Flow content</a>, including at least one descendant
-   that is <a href="#heading-content-0">heading content</a>, but no <a href="#sectioning-content-0">sectioning
-   content</a> descendants, no <code><a href="#the-header-element">header</a></code> element
-   descendants, and no <code><a href="#the-footer-element">footer</a></code> element descendants.</dd>
+   <dd>One or more <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">h2</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h3</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h4</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h5</a></code>, and/or <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements.</dd>
    <dt>Content attributes:</dt>
    <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>The <code><a href="#the-header-element">header</a></code> element <a href="#represents">represents</a> the
-  header of a section. The element is typically used to group a set of
+  </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 to mark up a page's
-  title with its subtitle or tagline. However, <code><a href="#the-header-element">header</a></code>
-  elements may contain more than just the section's headings and
-  subheadings &mdash; for example it would be reasonable for the
-  header to include version history information.
-
-  <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code><a href="#the-header-element">header</a></code> elements is defined to be the text
+  title with its subtitle or tagline.<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
   of the highest <a href="#rank" title="rank">ranked</a>
   <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 descendant of the
-  <code><a href="#the-header-element">header</a></code> element, if there are any such elements, and the
+  <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-header-element">header</a></code> element is the empty string.<p>Other heading elements in the <code><a href="#the-header-element">header</a></code> element
-  indicate subheadings or subtitles.<p>The <a href="#rank">rank</a> of a <code><a href="#the-header-element">header</a></code> element is the
+  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 a <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-header-element">header</a></code> elements are assigned to individual
+  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
@@ -10966,15 +10958,20 @@
    header in an application extracting header data and ignoring
    subheadings.</p>
 
-   <pre>&lt;header&gt;
+   <pre>&lt;hgroup&gt;
  &lt;h1&gt;<strong>The reality dysfunction</strong>&lt;/h1&gt;
  &lt;h2&gt;Space is not the only void&lt;/h2&gt;
-&lt;/header&gt;</pre>
+&lt;/hgroup&gt;</pre>
 
-   <pre>&lt;header&gt;
+   <pre>&lt;hgroup&gt;
  &lt;h1&gt;<strong>Dr. Strangelove</strong>&lt;/h1&gt;
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
-&lt;/header&gt;</pre>
+&lt;/hgroup&gt;</pre>
+
+<!--
+  The <code>header</code> element may contain more than just the
+  section's headings and subheadings &mdash; for example it would be
+  reasonable for the header to include version history information.
 
    <pre>&lt;header&gt;
  &lt;p&gt;Welcome to...&lt;/p&gt;
@@ -10982,8 +10979,10 @@
 &lt;/header&gt;</pre>
 
    <pre>&lt;header&gt;
- &lt;h1&gt;<strong>Scalable Vector Graphics (SVG) 1.2</strong>&lt;/h1&gt;
- &lt;h2&gt;W3C Working Draft 27 October 2004&lt;/h2&gt;
+ &lt;hgroup&gt;
+  &lt;h1&gt;<strong>Scalable Vector Graphics (SVG) 1.2</strong>&lt;/h1&gt;
+  &lt;h2&gt;W3C Working Draft 27 October 2004&lt;/h2&gt;
+ &lt;/hgroup&gt;
  &lt;dl&gt;
   &lt;dt&gt;This version:&lt;/dt&gt;
   &lt;dd&gt;&lt;a href="http://www.w3.org/TR/2004/WD-SVG12-20041027/"&gt;http://www.w3.org/TR/2004/WD-SVG12-20041027/&lt;/a&gt;&lt;/dd&gt;
@@ -11000,6 +10999,7 @@
  &lt;/dl&gt;
  &lt;p class="copyright"&gt;&lt;a href="http://www.w3.org/Consortium/Legal/ipr-notic <em>...</em>
 &lt;/header&gt;</pre>
+-->
   </div><h4 id="the-footer-element"><span class="secno">4.4.8 </span>The <dfn><code>footer</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
@@ -11026,10 +11026,10 @@
 
    <pre>&lt;body&gt;
  &lt;footer&gt;&lt;a href="../"&gt;Back to index...&lt;/a&gt;&lt;/footer&gt;
- &lt;header&gt;
+ &lt;hgroup&gt;
   &lt;h1&gt;Lorem ipsum&lt;/h1&gt;
   &lt;h2&gt;The ipsum of all lorems&lt;/h2&gt;
- &lt;/header&gt;
+ &lt;/hgroup&gt;
  &lt;p&gt;A dolor sit amet, consectetur adipisicing elit, sed do eiusmod
  tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
  veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
@@ -11088,7 +11088,7 @@
   content</a> element, e.g.  an <code><a href="#the-aside-element">aside</a></code> element, does
   not apply to its ancestor elements, e.g. the page's
   <code><a href="#the-body-element">body</a></code>.<h4 id="headings-and-sections"><span class="secno">4.4.10 </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-header-element">header</a></code> element are headings.<p>The first element of <a href="#heading-content-0">heading content</a> in an element
+  <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
@@ -15201,33 +15201,35 @@
 
   </div><p>In other cases, the icon has no text next to it describing what
   it means; the icon is supposed to be self-explanatory. In those
-  cases, an equivalent textual label must be given in the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute.<div class="example">
+  cases, an equivalent textual label must be given in the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute.</p><!--
+  <div class="example">
 
    <p>Here, posts on a news site are labeled with an icon
    indicating their topic.</p>
 
-   <pre>&lt;body&gt;
- &lt;article&gt;
-  &lt;header&gt;
-   &lt;h1&gt;Ratatouille wins &lt;i&gt;Best Movie of the Year&lt;/i&gt; award&lt;/h1&gt;
-   &lt;p&gt;<strong>&lt;img src="movies.png" alt="Movies"&gt;</strong>&lt;/p&gt;
-  &lt;/header&gt;
-  &lt;p&gt;Pixar has won yet another &lt;i&gt;Best Movie of the Year&lt;/i&gt; award,
-  making this its 8th win in the last 12 years.&lt;/p&gt;
- &lt;/article&gt;
- &lt;article&gt;
-  &lt;header&gt;
-   &lt;h1&gt;Latest TWiT episode is online&lt;/h1&gt;
-   &lt;p&gt;<strong>&lt;img src="podcasts.png" alt="Podcasts"&gt;</strong>&lt;/p&gt;
-  &lt;/header&gt;
-  &lt;p&gt;The latest TWiT episode has been posted, in which we hear
+   <pre>&lt;body>
+ &lt;article>
+  &lt;header>
+   &lt;h1>Ratatouille wins &lt;i>Best Movie of the Year&lt;/i> award&lt;/h1>
+   &lt;p><strong>&lt;img src="movies.png" alt="Movies"></strong>&lt;/p>
+  &lt;/header>
+  &lt;p>Pixar has won yet another &lt;i>Best Movie of the Year&lt;/i> award,
+  making this its 8th win in the last 12 years.&lt;/p>
+ &lt;/article>
+ &lt;article>
+  &lt;header>
+   &lt;h1>Latest TWiT episode is online&lt;/h1>
+   &lt;p><strong>&lt;img src="podcasts.png" alt="Podcasts"></strong>&lt;/p>
+  &lt;/header>
+  &lt;p>The latest TWiT episode has been posted, in which we hear
   several tech news stories as well as learning much more about the
   iPhone. This week, the panelists compare how reflective their
-  iPhones' Apple logos are.&lt;/p&gt;
- &lt;/article&gt;
-&lt;/body&gt;</pre>
+  iPhones' Apple logos are.&lt;/p>
+ &lt;/article>
+&lt;/body></pre>
 
-  </div><p>Many pages include logos, insignia, flags, or emblems, which
+  </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
@@ -17324,6 +17326,8 @@
        - an event that reports playback difficulties?
        - an arbitrary quality metric?
     * bufferingRate/bufferingThrottled (see v3BUF)
+    * events for when the user agent's controls get shown or hidden
+      so that the author's controls can get away of the UA's
   --><p><a href="#media-element" title="media element">Media elements</a> are used to
   present audio data, or video and audio data, to the user. This is
   referred to as <dfn id="media-data">media data</dfn> in this section, since this
@@ -46955,7 +46959,7 @@
   <code><a href="#the-div-element">div</a></code>, <code><a href="#the-dl-element">dl</a></code>, <code><a href="#the-fieldset-element">fieldset</a></code>,
   <code><a href="#the-footer-element">footer</a></code>, <code><a href="#the-form-element">form</a></code>, <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">h2</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h3</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h4</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h5</a></code>,
-  <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code>, <code><a href="#the-header-element">header</a></code>, <code><a href="#the-hr-element">hr</a></code>,
+  <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code>, <code><a href="#the-hgroup-element">hgroup</a></code>, <code><a href="#the-hr-element">hr</a></code>,
   <code><a href="#menus">menu</a></code>, <code><a href="#the-nav-element">nav</a></code>, <code><a href="#the-ol-element">ol</a></code>,
   <code><a href="#the-p-element">p</a></code>, <code><a href="#the-pre-element">pre</a></code>, <code><a href="#the-section-element">section</a></code>,
   <code><a href="#the-table-element">table</a></code>, or <code><a href="#the-ul-element">ul</a></code>, element, or if there is no
@@ -47950,7 +47954,7 @@
    <code><a href="#the-footer-element">footer</a></code>, <code><a href="#the-form-element">form</a></code>, <code>frame</code>,
    <code>frameset</code>, <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">h2</a></code>,
    <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h3</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h4</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h5</a></code>, <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code>,
-   <code><a href="#the-head-element">head</a></code>, <code><a href="#the-header-element">header</a></code>, <code><a href="#the-hr-element">hr</a></code>,
+   <code><a href="#the-head-element">head</a></code>, <code><a href="#the-hgroup-element">hgroup</a></code>, <code><a href="#the-hr-element">hr</a></code>,
    <code><a href="#the-iframe-element">iframe</a></code>, <!-- <code>image</code>, (commented out
    because this isn't an element that can end up on the stack, so it
    doesn't matter) --> <code><a href="#the-img-element">img</a></code>, <code><a href="#the-input-element">input</a></code>,
@@ -50574,7 +50578,7 @@
    <!-- the normal ones -->
    <dt>A start tag whose tag name is one of: "address", "article",
    "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "dir", "div", "dl", "fieldset", "figure", "footer", "hgroup",
    "menu", "nav", "ol", "p", "section", "ul"</dt>
    <dd>
 
@@ -50777,7 +50781,7 @@
    <!-- the normal ones -->
    <dt>An end tag whose tag name is one of: "address", "article",
    "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "dir", "div", "dl", "fieldset", "figure", "footer", "hgroup",
    "listing", "menu", "nav", "ol", "pre", "section", "ul"</dt>
    <dd>
Received on Thursday, 30 April 2009 17:39:52 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:04 GMT