--- a/editcommands.html	Sun Jun 19 09:59:35 2011 -0600
+++ b/editcommands.html	Sun Jun 19 10:04:04 2011 -0600
@@ -2646,6 +2646,16 @@
 <p>To <dfn id=fix-prohibited-paragraph-descendants>fix prohibited paragraph descendants</dfn> of a <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a>
 <var title="">node</var>:
 
+<p class=note>This will fix any case where a descendant of node is a prohibited
+paragraph child.  The function returns a list consisting of <var title="">node</var> and
+any new siblings this algorithm might give it, if some of its children are
+split out of it.
+
+<p class=XXX>Possibly can be converted to just fix disallowed ancestors of all
+descendant nodes.  The only reason this is nontrivial is because the caller
+needs the list of returned nodes.  (It's only used by formatBlock, but it
+currently has to be a separate function because it's recursive.)
+
 <ol>
   <li>If <var title="">node</var> has no <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-tree-child title=concept-tree-child>children</a>, return the one-<a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a> list
   consisting of <var title="">node</var>.

--- a/source.html	Sun Jun 19 09:59:35 2011 -0600
+++ b/source.html	Sun Jun 19 10:04:04 2011 -0600
@@ -2627,6 +2627,16 @@
 <p>To <dfn>fix prohibited paragraph descendants</dfn> of a [[node]]
 <var>node</var>:
 
+<p class=note>This will fix any case where a descendant of node is a prohibited
+paragraph child.  The function returns a list consisting of <var>node</var> and
+any new siblings this algorithm might give it, if some of its children are
+split out of it.
+
+<p class=XXX>Possibly can be converted to just fix disallowed ancestors of all
+descendant nodes.  The only reason this is nontrivial is because the caller
+needs the list of returned nodes.  (It's only used by formatBlock, but it
+currently has to be a separate function because it's recursive.)
+
 <ol>
   <li>If <var>node</var> has no [[children]], return the one-[[node]] list
   consisting of <var>node</var>.