[html5] r1262 - /

whatwg at whatwg.org whatwg at whatwg.org
Wed Feb 27 11:35:51 PST 2008


Author: ianh
Date: 2008-02-27 11:35:50 -0800 (Wed, 27 Feb 2008)
New Revision: 1262

Modified:
   index
   source
Log:
[e] (0) Clarify <header>; fix some places that still considered <blockquote> to be a sectioning element.

Modified: index
===================================================================
--- index	2008-02-27 10:21:30 UTC (rev 1261)
+++ index	2008-02-27 19:35:50 UTC (rev 1262)
@@ -8529,8 +8529,7 @@
 
    <dd><a href="#flow-content0">Flow content</a>, including at least one
     descendant that is <a href="#heading0">heading content</a>, but no <a
-    href="#sectioning0">sectioning content</a> descendants other than
-    <code><a href="#blockquote">blockquote</a></code> elements, no <code><a
+    href="#sectioning0">sectioning content</a> descendants, no <code><a
     href="#header">header</a></code> element descendants, and no <code><a
     href="#footer">footer</a></code> element descendants.
 
@@ -8545,9 +8544,12 @@
   </dl>
 
   <p>The <code><a href="#header">header</a></code> element represents the
-   header of a section. Headers may contain more than just the section's
-   heading — for example it would be reasonable for the header to
-   include version history information.
+   header of a section. The element is typically used to group a set of
+   <code><a href="#h1">h1</a></code>-<code><a href="#h6">h6</a></code>
+   elements to mark up a page's title with its subtitle or tagline. However,
+   <code><a href="#header">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, <code><a
    href="#header">header</a></code> elements are equivalent to the highest <a
@@ -8560,6 +8562,14 @@
   <p>Other heading elements in the <code><a href="#header">header</a></code>
    element indicate subheadings or subtitles.
 
+  <p>The <a href="#rank">rank</a> of a <code><a
+   href="#header">header</a></code> element is the same as for an <code><a
+   href="#h1">h1</a></code> element (the highest rank).
+
+  <p>The section on <a href="#headings0">headings and sections</a> defines
+   how <code><a href="#header">header</a></code> elements are assigned to
+   individual sections.
+
   <div class=example>
    <p>Here are some examples of valid headers. In each case, the emphasised
     text represents the text that would be used as the header in an
@@ -8571,6 +8581,11 @@
 </header></pre>
 
    <pre><header>
+ <h1><strong>Dr. Strangelove</strong></h1>
+ <h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
+</header></pre>
+
+   <pre><header>
  <p>Welcome to...</p>
  <h1><strong>Voidwars!</strong></h1>
 </header></pre>
@@ -8596,14 +8611,6 @@
 </header></pre>
   </div>
 
-  <p>The section on <a href="#headings0">headings and sections</a> defines
-   how <code><a href="#header">header</a></code> elements are assigned to
-   individual sections.
-
-  <p>The <a href="#rank">rank</a> of a <code><a
-   href="#header">header</a></code> element is the same as for an <code><a
-   href="#h1">h1</a></code> element (the highest rank).
-
   <h4 id=the-footer><span class=secno>3.8.8 </span>The <dfn
    id=footer><code>footer</code></dfn> element</h4>
 
@@ -8620,9 +8627,8 @@
 
    <dd><a href="#flow-content0">Flow content</a>, but with no <a
     href="#heading0">heading content</a> descendants, no <a
-    href="#sectioning0">sectioning content</a> descendants other than
-    <code><a href="#blockquote">blockquote</a></code> elements, and no
-    <code><a href="#footer">footer</a></code> element descendants.
+    href="#sectioning0">sectioning content</a> descendants, and no <code><a
+    href="#footer">footer</a></code> element descendants.
 
    <dt>Element-specific attributes:
 

Modified: source
===================================================================
--- source	2008-02-27 10:21:30 UTC (rev 1261)
+++ source	2008-02-27 19:35:50 UTC (rev 1262)
@@ -6894,9 +6894,8 @@
    <dt>Content model:</dt>
    <dd><span>Flow content</span>, including at least one descendant
    that is <span>heading content</span>, but no <span>sectioning
-   content</span> descendants other than <code>blockquote</code>
-   elements, no <code>header</code> element descendants, and no
-   <code>footer</code> element descendants.</dd>
+   content</span> descendants, no <code>header</code> element
+   descendants, and no <code>footer</code> element descendants.</dd>
    <dt>Element-specific attributes:</dt>
    <dd>None.</dd>
    <dt>DOM interface:</dt>
@@ -6904,9 +6903,12 @@
   </dl>
 
   <p>The <code>header</code> element represents the header of a
-  section. Headers may contain more than just the section's heading
+  section. The element is typically used to group a set of
+  <code>h1</code>-<code>h6</code> elements to mark up a page's title
+  with its subtitle or tagline. However, <code>header</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>
+  version history information.
 
   <p>For the purposes of document summaries, outlines, and the like,
   <code>header</code> elements are equivalent to the highest <span
@@ -6918,6 +6920,13 @@
   <p>Other heading elements in the <code>header</code> element
   indicate subheadings or subtitles.</p>
 
+  <p>The <span>rank</span> of a <code>header</code> element is the
+  same as for an <code>h1</code> element (the highest rank).</p>
+
+  <p>The section on <span>headings and sections</span>
+  defines how <code>header</code> elements are assigned to individual
+  sections.</p>
+
   <div class="example">
 
    <p>Here are some examples of valid headers. In each case, the
@@ -6931,6 +6940,11 @@
 </header></pre>
 
    <pre><header>
+ <h1><strong>Dr. Strangelove</strong></h1>
+ <h2>Or: How I Learned to Stop Worrying and Love the Bomb</h2>
+</header></pre>
+
+   <pre><header>
  <p>Welcome to...</p>
  <h1><strong>Voidwars!</strong></h1>
 </header></pre>
@@ -6956,14 +6970,7 @@
 </header></pre>
   </div>
 
-  <p>The section on <span>headings and sections</span>
-  defines how <code>header</code> elements are assigned to individual
-  sections.</p>
 
-  <p>The <span>rank</span> of a <code>header</code> element is the
-  same as for an <code>h1</code> element (the highest rank).</p>
-
-
   <h4>The <dfn><code>footer</code></dfn> element</h4>
 
   <dl class="element">
@@ -6974,8 +6981,7 @@
    <dt>Content model:</dt>
    <dd><span>Flow content</span>, but with no <span>heading
    content</span> descendants, no <span>sectioning content</span>
-   descendants other than <code>blockquote</code> elements, and no
-   <code>footer</code> element descendants.</dd>
+   descendants, and no <code>footer</code> element descendants.</dd>
    <dt>Element-specific attributes:</dt>
    <dd>None.</dd>
    <dt>DOM interface:</dt>




More information about the Commit-Watchers mailing list