[a] (0) Clarify that sectioning roots also set the context for sectio…

…ning content. git-svn-id: http://svn.whatwg.org/webapps@4847 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Mar 16, 2010 · fc1b24a · fc1b24a
1 parent 05c4fe5
commit fc1b24a
Show file tree

Hide file tree

Showing 3 changed files with 36 additions and 22 deletions.
diff --git a/complete.html b/complete.html
@@ -157,7 +157,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Draft Standard &mdash; 13 March 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard &mdash; 16 March 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -14602,11 +14602,6 @@ <h4 id=headings-and-sections><span class=secno>4.4.11 </span><dfn>Headings and s
   previous one. In both cases, the element <a href=#represents>represents</a> the
   heading of the implied section.</p>
 
-  <p><a href=#sectioning-content>Sectioning content</a> elements are always considered
-  subsections of their nearest ancestor element of <a href=#sectioning-content>sectioning
-  content</a>, regardless of what implied sections other headings
-  may have created.</p>
-
   <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
@@ -14621,7 +14616,16 @@ <h4 id=headings-and-sections><span class=secno>4.4.11 </span><dfn>Headings and s
    <li><code><a href=#the-fieldset-element>fieldset</a></code></li>
    <li><code><a href=#the-figure-element>figure</a></code></li>
    <li><code><a href=#the-td-element>td</a></code></li>
-  </ul><div class=example>
+  </ul><!-- a root element isn't a sectioning root. This means, for
+  instance, that you don't get an outline if you just have a random
+  XML file with <html:h1> elements in it. Other vocabs need to define
+  what their sectioning root is. --><p><a href=#sectioning-content>Sectioning content</a> elements are always considered
+  subsections of their nearest ancestor <a href=#sectioning-root>sectioning root</a>
+  or their nearest ancestor element of <a href=#sectioning-content>sectioning
+  content</a>, whichever is nearest, regardless of what implied
+  sections other headings may have created.</p>
+
+  <div class=example>
    <p>For the following fragment:</p>
    <pre>&lt;body&gt;
  &lt;h1&gt;Foo&lt;/h1&gt;
@@ -14643,7 +14647,7 @@ <h4 id=headings-and-sections><span class=secno>4.4.11 </span><dfn>Headings and s
        Bar (heading starting implied section, containing a block quote and the "Baz" paragraph)
       </li>
       <li>
-       Quux (heading starting implied section)
+       Quux (heading starting implied section with no content other than the heading itself)
       </li>
       <li>
        Thud (heading of explicit <code><a href=#the-section-element>section</a></code> section)

diff --git a/index b/index
@@ -161,7 +161,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>HTML5 (including next generation additions still in development)</h1>
-    <h2 class="no-num no-toc">Draft Standard &mdash; 13 March 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard &mdash; 16 March 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -14501,11 +14501,6 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
   previous one. In both cases, the element <a href=#represents>represents</a> the
   heading of the implied section.</p>
 
-  <p><a href=#sectioning-content>Sectioning content</a> elements are always considered
-  subsections of their nearest ancestor element of <a href=#sectioning-content>sectioning
-  content</a>, regardless of what implied sections other headings
-  may have created.</p>
-
   <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
@@ -14520,7 +14515,16 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
    <li><code><a href=#the-fieldset-element>fieldset</a></code></li>
    <li><code><a href=#the-figure-element>figure</a></code></li>
    <li><code><a href=#the-td-element>td</a></code></li>
-  </ul><div class=example>
+  </ul><!-- a root element isn't a sectioning root. This means, for
+  instance, that you don't get an outline if you just have a random
+  XML file with <html:h1> elements in it. Other vocabs need to define
+  what their sectioning root is. --><p><a href=#sectioning-content>Sectioning content</a> elements are always considered
+  subsections of their nearest ancestor <a href=#sectioning-root>sectioning root</a>
+  or their nearest ancestor element of <a href=#sectioning-content>sectioning
+  content</a>, whichever is nearest, regardless of what implied
+  sections other headings may have created.</p>
+
+  <div class=example>
    <p>For the following fragment:</p>
    <pre>&lt;body&gt;
  &lt;h1&gt;Foo&lt;/h1&gt;
@@ -14542,7 +14546,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
        Bar (heading starting implied section, containing a block quote and the "Baz" paragraph)
       </li>
       <li>
-       Quux (heading starting implied section)
+       Quux (heading starting implied section with no content other than the heading itself)
       </li>
       <li>
        Thud (heading of explicit <code><a href=#the-section-element>section</a></code> section)

diff --git a/source b/source
@@ -15372,11 +15372,6 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   previous one. In both cases, the element <span>represents</span> the
   heading of the implied section.</p>
 
-  <p><span>Sectioning content</span> elements are always considered
-  subsections of their nearest ancestor element of <span>sectioning
-  content</span>, regardless of what implied sections other headings
-  may have created.</p>
-
   <p>Certain elements are said to be <dfn title="sectioning
   root">sectioning roots</dfn>, including <code>blockquote</code> and
   <code>td</code> elements. These elements can have their own
@@ -15394,6 +15389,17 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
    <li><code>td</code></li>
   </ul>
 
+  <!-- a root element isn't a sectioning root. This means, for
+  instance, that you don't get an outline if you just have a random
+  XML file with <html:h1> elements in it. Other vocabs need to define
+  what their sectioning root is. -->
+
+  <p><span>Sectioning content</span> elements are always considered
+  subsections of their nearest ancestor <span>sectioning root</span>
+  or their nearest ancestor element of <span>sectioning
+  content</span>, whichever is nearest, regardless of what implied
+  sections other headings may have created.</p>
+
   <div class="example">
    <p>For the following fragment:</p>
    <pre>&lt;body&gt;
@@ -15418,7 +15424,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
        Bar (heading starting implied section, containing a block quote and the "Baz" paragraph)
       </li>
       <li>
-       Quux (heading starting implied section)
+       Quux (heading starting implied section with no content other than the heading itself)
       </li>
       <li>
        Thud (heading of explicit <code>section</code> section)