[html5] r7441 - [e] (0) Try to clarify the foster parenting logic... Fixing https://www.w3.org/B [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2012-10-08 14:29:45 -0700 (Mon, 08 Oct 2012)
New Revision: 7441

Modified:
   complete.html
   index
   source
Log:
[e] (0) Try to clarify the foster parenting logic...
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=18473
Affected topics: HTML Syntax and Parsing

Modified: complete.html
===================================================================
--- complete.html	2012-10-08 19:04:03 UTC (rev 7440)
+++ complete.html	2012-10-08 21:29:45 UTC (rev 7441)
@@ -92100,7 +92100,9 @@
   <a href=#concept-fe-value title=concept-fe-value>value</a> and <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> based on the element's
   attributes.)</p>
 
-  <hr><p>When the steps below require the UA to <dfn id=insert-an-html-element>insert an HTML
+  <hr><!-- The names of these algorithms are kinda confusing; e.g. see the confusion in
+         https://www.w3.org/Bugs/Public/show_bug.cgi?id=18367
+       Not sure what we could call them instead, though... --><p>When the steps below require the UA to <dfn id=insert-an-html-element>insert an HTML
   element</dfn> for a token, the UA must first <a href=#create-an-element-for-the-token>create an element
   for the token</a> in the <a href=#html-namespace-0>HTML namespace</a>, and then
   append this node to the <a href=#current-node>current node</a>, and push it onto
@@ -92277,6 +92279,10 @@
   parent">foster parented</dfn>, the node <var title="">node</var>
   must be inserted into the <i><a href=#foster-parent-element>foster parent element</a></i>.</p>
 
+  <p class=note>This typically happens as part of the <a href=#insert-an-html-element>insert an HTML element</a>
+  algorithm above: when that algorithm would normally insert the newly created node into the
+  <a href=#current-node>current node</a>, it gets inserted into the <i><a href=#foster-parent-element>foster parent element</a></i> instead.</p>
+
   <p>The <dfn id=foster-parent-element>foster parent element</dfn> is the parent element of the
   last <code><a href=#the-table-element>table</a></code> element in the <a href=#stack-of-open-elements>stack of open
   elements</a>, if there is a <code><a href=#the-table-element>table</a></code> element and it has

Modified: index
===================================================================
--- index	2012-10-08 19:04:03 UTC (rev 7440)
+++ index	2012-10-08 21:29:45 UTC (rev 7441)
@@ -92100,7 +92100,9 @@
   <a href=#concept-fe-value title=concept-fe-value>value</a> and <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> based on the element's
   attributes.)</p>
 
-  <hr><p>When the steps below require the UA to <dfn id=insert-an-html-element>insert an HTML
+  <hr><!-- The names of these algorithms are kinda confusing; e.g. see the confusion in
+         https://www.w3.org/Bugs/Public/show_bug.cgi?id=18367
+       Not sure what we could call them instead, though... --><p>When the steps below require the UA to <dfn id=insert-an-html-element>insert an HTML
   element</dfn> for a token, the UA must first <a href=#create-an-element-for-the-token>create an element
   for the token</a> in the <a href=#html-namespace-0>HTML namespace</a>, and then
   append this node to the <a href=#current-node>current node</a>, and push it onto
@@ -92277,6 +92279,10 @@
   parent">foster parented</dfn>, the node <var title="">node</var>
   must be inserted into the <i><a href=#foster-parent-element>foster parent element</a></i>.</p>
 
+  <p class=note>This typically happens as part of the <a href=#insert-an-html-element>insert an HTML element</a>
+  algorithm above: when that algorithm would normally insert the newly created node into the
+  <a href=#current-node>current node</a>, it gets inserted into the <i><a href=#foster-parent-element>foster parent element</a></i> instead.</p>
+
   <p>The <dfn id=foster-parent-element>foster parent element</dfn> is the parent element of the
   last <code><a href=#the-table-element>table</a></code> element in the <a href=#stack-of-open-elements>stack of open
   elements</a>, if there is a <code><a href=#the-table-element>table</a></code> element and it has

Modified: source
===================================================================
--- source	2012-10-08 19:04:03 UTC (rev 7440)
+++ source	2012-10-08 21:29:45 UTC (rev 7441)
@@ -106920,6 +106920,10 @@
 
   <hr>
 
+  <!-- The names of these algorithms are kinda confusing; e.g. see the confusion in
+         https://www.w3.org/Bugs/Public/show_bug.cgi?id=18367
+       Not sure what we could call them instead, though... -->
+
   <p>When the steps below require the UA to <dfn>insert an HTML
   element</dfn> for a token, the UA must first <span>create an element
   for the token</span> in the <span>HTML namespace</span>, and then
@@ -107121,6 +107125,10 @@
   parent">foster parented</dfn>, the node <var title="">node</var>
   must be inserted into the <i>foster parent element</i>.</p>
 
+  <p class="note">This typically happens as part of the <span>insert an HTML element</span>
+  algorithm above: when that algorithm would normally insert the newly created node into the
+  <span>current node</span>, it gets inserted into the <i>foster parent element</i> instead.</p>
+
   <p>The <dfn>foster parent element</dfn> is the parent element of the
   last <code>table</code> element in the <span>stack of open
   elements</span>, if there is a <code>table</code> element and it has