[html5] r6114 - [e] (0) Try to clarify the element summary. I fear this may just make things wor [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2011-05-06 15:49:10 -0700 (Fri, 06 May 2011)
New Revision: 6114

Modified:
   complete.html
   index
   source
Log:
[e] (0) Try to clarify the element summary. I fear this may just make things worse though.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12350

Modified: complete.html
===================================================================
--- complete.html	2011-05-06 22:37:06 UTC (rev 6113)
+++ complete.html	2011-05-06 22:49:10 UTC (rev 6114)
@@ -94949,7 +94949,7 @@
    <thead><tr><th> Element
      <th> Description
      <th> Categories
-     <th> Parents
+     <th> Parents†
      <th> Children
      <th> Attributes
      <th> Interface
@@ -95785,8 +95785,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>
@@ -96095,6 +96095,15 @@
      <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.</p>
 
+  <p>† 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.</p>
 
 
 

Modified: index
===================================================================
--- index	2011-05-06 22:37:06 UTC (rev 6113)
+++ index	2011-05-06 22:49:10 UTC (rev 6114)
@@ -90930,7 +90930,7 @@
    <thead><tr><th> Element
      <th> Description
      <th> Categories
-     <th> Parents
+     <th> Parents†
      <th> Children
      <th> Attributes
      <th> Interface
@@ -91766,8 +91766,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>
@@ -92076,6 +92076,15 @@
      <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.</p>
 
+  <p>† 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.</p>
 
 
 

Modified: source
===================================================================
--- source	2011-05-06 22:37:06 UTC (rev 6113)
+++ source	2011-05-06 22:49:10 UTC (rev 6114)
@@ -107877,7 +107877,7 @@
      <th> Element
      <th> Description
      <th> Categories
-     <th> Parents
+     <th> Parents†
      <th> Children
      <th> Attributes
      <th> Interface
@@ -108935,8 +108935,8 @@
          <span title="Phrasing content">phrasing</span></td>
      <td><span title="Phrasing content">phrasing</span></td>
      <td><span title="Phrasing content">phrasing</span>;
-         <code>rt</code> element;
-         <code>rp</code> element*</td>
+         <code>rt</code>;
+         <code>rp</code>*</td>
      <td><span title="global attributes">globals</span></td>
      <td><code>HTMLElement</code></td>
     </tr>
@@ -109335,6 +109335,15 @@
   </table>
   <p>An asterisk (*) in a cell indicates that the actual rules are more complicated than indicated in the table above.</p>
 
+  <p>† 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</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</code> element. Since the "flow" category
+  includes all the "phrasing" elements, that means the
+  <code>address</code> element could be a parent to an <code>a</code>
+  element.</p>