[a] (0) Try to clarify <footer>.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7502 git-svn-id: http://svn.whatwg.org/webapps@3954 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Sep 22, 2009 · ec57dfd07b178fdc05ab10fa848a30d973e8567c · ec57dfd
1 parent baa59bd
commit ec57dfd07b178fdc05ab10fa848a30d973e8567c
Show file tree

Hide file tree

Showing 2 changed files with 102 additions and 8 deletions.
diff --git a/index b/index
@@ -13602,15 +13602,16 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
    <dt>DOM interface:</dt>
    <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
   </dl><p>The <code><a href=#the-footer-element>footer</a></code> element <a href=#represents>represents</a> a footer
-  for its nearest ancestor <a href=#sectioning-content>sectioning content</a>. A footer
-  typically contains information about its section such as who wrote
-  it, links to related documents, copyright data, and the like.</p>
+  for its nearest ancestor <a href=#sectioning-content>sectioning content</a> or
+  <a href=#sectioning-root>sectioning root</a> element. A footer typically contains
+  information about its section such as who wrote it, links to related
+  documents, copyright data, and the like.</p>
 
   <p class=note>Contact information belongs in an
   <code><a href=#the-address-element>address</a></code> element, possibly itself inside a
   <code><a href=#the-footer-element>footer</a></code>.</p>
 
-  <p>Footers don't necessarily have to appear at the end of a section,
+  <p>Footers don't necessarily have to appear at the <em>end</em> of a section,
   though they usually do.</p>
 
   <p>When the <code><a href=#the-footer-element>footer</a></code> element contains entire sections,
@@ -13622,6 +13623,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
   <a href=#sectioning-content>sectioning content</a>; it doesn't introduce a new
   section.</p>
 
+  <p>When the nearest ancestor <a href=#sectioning-content>sectioning content</a> or
+  <a href=#sectioning-root>sectioning root</a> element is <a href=#the-body-element>the body
+  element</a>, then it applies to the whole page.</p>
+
   <div class=example>
 
    <p>Here is a page with two footers, one at the top and one at the
@@ -13645,6 +13650,48 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
 
   </div>
 
+  <div class=example>
+
+   <p>Here is an example which shows the <code><a href=#the-footer-element>footer</a></code> element
+   being used both for a site-wide footer and for a section
+   footer.</p>
+
+   <pre>&lt;!DOCTYPE HTML&gt;
+&lt;HTML&gt;&lt;HEAD&gt;
+&lt;TITLE&gt;The Ramblings of a Scientist&lt;/TITLE&gt;
+&lt;BODY&gt;
+&lt;H1&gt;The Ramblings of a Scientist&lt;/H1&gt;
+&lt;ARTICLE&gt;
+ &lt;H1&gt;Episode 15&lt;/H1&gt;
+ &lt;VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER&gt;
+  &lt;P&gt;&lt;A HREF="/fm/015.ogv"&gt;Download video&lt;/A&gt;.&lt;/P&gt;
+ &lt;/VIDEO&gt;
+ &lt;FOOTER&gt; &lt;!-- footer for article --&gt;
+  &lt;P&gt;Published &lt;TIME PUBDATE DATETIME="2009-10-21T18:26-07:00"&gt;&lt;/TIME&gt;&lt;/P&gt;
+ &lt;/FOOTER&gt;
+&lt;/ARTICLE&gt;
+&lt;ARTICLE&gt;
+ &lt;H1&gt;My Favorite Trains&lt;/H1&gt;
+ &lt;P&gt;I love my trains. My favorite train of all time is a K&ouml;f.&lt;/P&gt;
+ &lt;P&gt;It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.&lt;/P&gt;
+ &lt;FOOTER&gt; &lt;!-- footer for article --&gt;
+  &lt;P&gt;Published &lt;TIME PUBDATE DATETIME="2009-09-15T14:54-07:00"&gt;&lt;/TIME&gt;&lt;/P&gt;
+ &lt;/FOOTER&gt;
+&lt;/ARTICLE&gt;
+&lt;FOOTER&gt; &lt;!-- site wide footer --&gt;
+ &lt;NAV&gt;
+  &lt;P&gt;&lt;A HREF="/credits.html"&gt;Credits&lt;/A&gt; &mdash;
+     &lt;A HREF="/tos.html"&gt;Terms of Service&lt;/A&gt; &mdash;
+     &lt;A HREF="/index.html"&gt;Blog Index&lt;/A&gt;&lt;/P&gt;
+ &lt;/NAV&gt;
+ &lt;P&gt;Copyright &copy; 2009 Gordon Freeman&lt;/P&gt;
+&lt;/FOOTER&gt;
+&lt;/BODY&gt;
+&lt;/HTML&gt;</pre>
+
+  </div>
+
 
   <h4 id=the-address-element><span class=secno>4.4.10 </span>The <dfn><code>address</code></dfn> element</h4>
 

diff --git a/source b/source
@@ -14438,15 +14438,16 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   </dl>
 
   <p>The <code>footer</code> element <span>represents</span> a footer
-  for its nearest ancestor <span>sectioning content</span>. A footer
-  typically contains information about its section such as who wrote
-  it, links to related documents, copyright data, and the like.</p>
+  for its nearest ancestor <span>sectioning content</span> or
+  <span>sectioning root</span> element. A footer typically contains
+  information about its section such as who wrote it, links to related
+  documents, copyright data, and the like.</p>
 
   <p class="note">Contact information belongs in an
   <code>address</code> element, possibly itself inside a
   <code>footer</code>.</p>
 
-  <p>Footers don't necessarily have to appear at the end of a section,
+  <p>Footers don't necessarily have to appear at the <em>end</em> of a section,
   though they usually do.</p>
 
   <p>When the <code>footer</code> element contains entire sections,
@@ -14458,6 +14459,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   <span>sectioning content</span>; it doesn't introduce a new
   section.</p>
 
+  <p>When the nearest ancestor <span>sectioning content</span> or
+  <span>sectioning root</span> element is <span>the body
+  element</span>, then it applies to the whole page.</p>
+
   <div class="example">
 
    <p>Here is a page with two footers, one at the top and one at the
@@ -14481,6 +14486,48 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
 
   </div>
 
+  <div class="example">
+
+   <p>Here is an example which shows the <code>footer</code> element
+   being used both for a site-wide footer and for a section
+   footer.</p>
+
+   <pre>&lt;!DOCTYPE HTML>
+&lt;HTML>&lt;HEAD>
+&lt;TITLE>The Ramblings of a Scientist&lt;/TITLE>
+&lt;BODY>
+&lt;H1>The Ramblings of a Scientist&lt;/H1>
+&lt;ARTICLE>
+ &lt;H1>Episode 15&lt;/H1>
+ &lt;VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER>
+  &lt;P>&lt;A HREF="/fm/015.ogv">Download video&lt;/A>.&lt;/P>
+ &lt;/VIDEO>
+ &lt;FOOTER> &lt;!-- footer for article -->
+  &lt;P>Published &lt;TIME PUBDATE DATETIME="2009-10-21T18:26-07:00">&lt;/TIME>&lt;/P>
+ &lt;/FOOTER>
+&lt;/ARTICLE>
+&lt;ARTICLE>
+ &lt;H1>My Favorite Trains&lt;/H1>
+ &lt;P>I love my trains. My favorite train of all time is a K&ouml;f.&lt;/P>
+ &lt;P>It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.&lt;/P>
+ &lt;FOOTER> &lt;!-- footer for article -->
+  &lt;P>Published &lt;TIME PUBDATE DATETIME="2009-09-15T14:54-07:00">&lt;/TIME>&lt;/P>
+ &lt;/FOOTER>
+&lt;/ARTICLE>
+&lt;FOOTER> &lt;!-- site wide footer -->
+ &lt;NAV>
+  &lt;P>&lt;A HREF="/credits.html">Credits&lt;/A> &mdash;
+     &lt;A HREF="/tos.html">Terms of Service&lt;/A> &mdash;
+     &lt;A HREF="/index.html">Blog Index&lt;/A>&lt;/P>
+ &lt;/NAV>
+ &lt;P>Copyright &copy; 2009 Gordon Freeman&lt;/P>
+&lt;/FOOTER>
+&lt;/BODY>
+&lt;/HTML></pre>
+
+  </div>
+
 
   <h4>The <dfn><code>address</code></dfn> element</h4>