hixie: Try to clarify the element summary. I fear this may just make things worse though. (whatwg r6114)

hixie: Try to clarify the element summary. I fear this may just make
things worse though. (whatwg r6114)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4915&r2=1.4916&f=h
http://html5.org/tools/web-apps-tracker?from=6113&to=6114

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4915
retrieving revision 1.4916
diff -u -d -r1.4915 -r1.4916
--- Overview.html 6 May 2011 22:37:11 -0000 1.4915
+++ Overview.html 6 May 2011 22:49:15 -0000 1.4916
@@ -67888,7 +67888,7 @@
    <thead><tr><th> Element
      <th> Description
      <th> Categories
-     <th> Parents
+     <th> Parents&dagger;
      <th> Children
      <th> Attributes
      <th> Interface
@@ -68718,8 +68718,8 @@
          <a href="#phrasing-content" title="Phrasing content">phrasing</a></td>
      <td><a href="#phrasing-content" title="Phrasing content">phrasing</a></td>
      <td><a href="#phrasing-content" title="Phrasing content">phrasing</a>;
-         <code><a href="#the-rt-element">rt</a></code> element;
-         <code><a href="#the-rp-element">rp</a></code> element*</td>
+         <code><a href="#the-rt-element">rt</a></code>;
+         <code><a href="#the-rp-element">rp</a></code>*</td>
      <td><a href="#global-attributes" title="global attributes">globals</a></td>
      <td><code><a href="#htmlelement">HTMLElement</a></code></td>
     <tr><th><code><a href="#the-s-element">s</a></code></th>
@@ -69026,7 +69026,15 @@
      <td>empty</td>
      <td><a href="#global-attributes" title="global attributes">globals</a></td>
      <td><code><a href="#htmlelement">HTMLElement</a></code></td>
-    </table><p>An asterisk (*) in a cell indicates that the actual rules are more complicated than indicated in the table above.<h3 class="no-num" id="element-content-categories">Element content categories</h3><p><i>This section is non-normative.</i></p><table><caption>List of element content categories</caption>
+    </table><p>An asterisk (*) in a cell indicates that the actual rules are more complicated than indicated in the table above.<p>&dagger; Categories in the "Parents" column refer to parents that
+  list the given categories in their content model, not to elements
+  that themselves are in those categories. For example, the
+  <code><a href="#the-a-element">a</a></code> element's "Parents" column says "phrasing", so any
+  element whose content model contains the "phrasing" category could
+  be a parent of an <code><a href="#the-a-element">a</a></code> element. Since the "flow" category
+  includes all the "phrasing" elements, that means the
+  <code><a href="#the-address-element">address</a></code> element could be a parent to an <code><a href="#the-a-element">a</a></code>
+  element.<h3 class="no-num" id="element-content-categories">Element content categories</h3><p><i>This section is non-normative.</i></p><table><caption>List of element content categories</caption>
    <thead><tr><th> Category
      <th> Elements
      <th> Elements with exceptions

Received on Friday, 6 May 2011 22:53:20 UTC