W3C home > Mailing lists > Public > public-html-diffs@w3.org > March 2010

hixie: Clarify that sectioning roots also set the context for sectioning content. (whatwg r4847)

From: poot <cvsmail@w3.org>
Date: Tue, 16 Mar 2010 10:39:35 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100316013936.356072BC37@toro.w3.mag.keio.ac.jp>
hixie: Clarify that sectioning roots also set the context for sectioning
content. (whatwg r4847)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3882&r2=1.3883&f=h
http://html5.org/tools/web-apps-tracker?from=4846&to=4847

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3882
retrieving revision 1.3883
diff -u -d -r1.3882 -r1.3883
--- Overview.html	13 Mar 2010 00:37:11 -0000	1.3882
+++ Overview.html	16 Mar 2010 01:39:16 -0000	1.3883
@@ -12559,10 +12559,7 @@
   <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
-  heading of the implied section.<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>Certain elements are said to be <dfn id="sectioning-root" title="sectioning
+  heading of the implied section.<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 headings inside these elements do not
@@ -12573,7 +12570,14 @@
    <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.<div class="example">
    <p>For the following fragment:</p>
    <pre>&lt;body&gt;
  &lt;h1&gt;Foo&lt;/h1&gt;
@@ -12595,7 +12599,7 @@
        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)
Received on Tuesday, 16 March 2010 01:40:05 GMT

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