- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 30 Apr 2009 17:37:38 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv22162
Modified Files:
Overview.html
Log Message:
Rename <header> to <hgroup> and restrict it just to supporting subheadings. (whatwg r3039)
Index: Overview.html
===================================================================
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 @@
<h2>Leading the way in widget design since 1432</h2>
...</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><body>
- <header>
+ <hgroup>
<h1>ABC Company</h1>
<h2>Leading the way in widget design since 1432</h2>
- </header>
+ </hgroup>
...</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><article>
- <header>
+ <hgroup>
<h1>Apples</h1>
- <p>Tasty, delicious fruit!</p>
- </header>
+ <h2>Tasty, delicious fruit!</h2>
+ </hgroup>
<p>The apple is the pomaceous fruit of the apple tree.</p>
<section>
<h1>Red Delicious</h1>
@@ -10798,12 +10798,12 @@
navigation section.</p>
<pre><body>
- <header>
+ <!--<header>-->
<h1>Wake up sheeple!</h1>
<p><a href="news.html">News</a> -
<a href="blog.html">Blog</a> -
<a href="forums.html">Forums</a></p>
- </header>
+ <!--</header>-->
<nav>
<h1>Navigation</h1>
<ul>
@@ -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>–<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 — 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>–<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><header>
+ <pre><hgroup>
<h1><strong>The reality dysfunction</strong></h1>
<h2>Space is not the only void</h2>
-</header></pre>
+</hgroup></pre>
- <pre><header>
+ <pre><hgroup>
<h1><strong>Dr. Strangelove</strong></h1>
<h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
-</header></pre>
+</hgroup></pre>
+
+<!--
+ The <code>header</code> element may contain more than just the
+ section's headings and subheadings — for example it would be
+ reasonable for the header to include version history information.
<pre><header>
<p>Welcome to...</p>
@@ -10982,8 +10979,10 @@
</header></pre>
<pre><header>
- <h1><strong>Scalable Vector Graphics (SVG) 1.2</strong></h1>
- <h2>W3C Working Draft 27 October 2004</h2>
+ <hgroup>
+ <h1><strong>Scalable Vector Graphics (SVG) 1.2</strong></h1>
+ <h2>W3C Working Draft 27 October 2004</h2>
+ </hgroup>
<dl>
<dt>This version:</dt>
<dd><a href="http://www.w3.org/TR/2004/WD-SVG12-20041027/">http://www.w3.org/TR/2004/WD-SVG12-20041027/</a></dd>
@@ -11000,6 +10999,7 @@
</dl>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notic <em>...</em>
</header></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><body>
<footer><a href="../">Back to index...</a></footer>
- <header>
+ <hgroup>
<h1>Lorem ipsum</h1>
<h2>The ipsum of all lorems</h2>
- </header>
+ </hgroup>
<p>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>–<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><body>
- <article>
- <header>
- <h1>Ratatouille wins <i>Best Movie of the Year</i> award</h1>
- <p><strong><img src="movies.png" alt="Movies"></strong></p>
- </header>
- <p>Pixar has won yet another <i>Best Movie of the Year</i> award,
- making this its 8th win in the last 12 years.</p>
- </article>
- <article>
- <header>
- <h1>Latest TWiT episode is online</h1>
- <p><strong><img src="podcasts.png" alt="Podcasts"></strong></p>
- </header>
- <p>The latest TWiT episode has been posted, in which we hear
+ <pre><body>
+ <article>
+ <header>
+ <h1>Ratatouille wins <i>Best Movie of the Year</i> award</h1>
+ <p><strong><img src="movies.png" alt="Movies"></strong></p>
+ </header>
+ <p>Pixar has won yet another <i>Best Movie of the Year</i> award,
+ making this its 8th win in the last 12 years.</p>
+ </article>
+ <article>
+ <header>
+ <h1>Latest TWiT episode is online</h1>
+ <p><strong><img src="podcasts.png" alt="Podcasts"></strong></p>
+ </header>
+ <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.</p>
- </article>
-</body></pre>
+ iPhones' Apple logos are.</p>
+ </article>
+</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:37:49 UTC