Add note to clarify "collapsed block prop"
authorAryeh Gregor <AryehGregor+gitcommit@gmail.com>
Thu, 28 Jul 2011 13:40:05 -0600
changeset 464 653eb3ce2461
parent 463 5b6f2e76a4c0
child 465 2f2e210fbf77
Add note to clarify "collapsed block prop"

Reported-By: Michael A. Puls II
Report-URL: http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-July/032666.html
editing.html
source.html
--- a/editing.html	Thu Jul 28 13:31:42 2011 -0600
+++ b/editing.html	Thu Jul 28 13:40:05 2011 -0600
@@ -821,6 +821,11 @@
 block props</a> and that has at least one <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>child</a> that is a
 <a href=#collapsed-block-prop>collapsed block prop</a>.
 
+<p class=note>A collapsed block prop is something like the <code title="">&lt;br&gt;</code> in <code title="">&lt;p&gt;&lt;br&gt;&lt;/p&gt;</code>, or the <code title="">&lt;br&gt;</code> and <code title="">&lt;span&gt;</code> in <code title="">&lt;p&gt;&lt;span&gt;&lt;br&gt;&lt;/span&gt;&lt;/p&gt;</code>.  These are necessary to
+stop the block from having zero height when it has no other contents, but serve
+no purpose and should be removed once the block has other contents that stop it
+from collapsing.
+
 <p>The <dfn id=active-range>active range</dfn> is the first <a class=external data-anolis-spec=domrange href=http://html5.org/specs/dom-range.html#concept-range title=concept-range>range</a> in the <code class=external data-anolis-spec=domrange><a href=http://html5.org/specs/dom-range.html#selection>Selection</a></code>
 given by calling <code class=external data-anolis-spec=domrange title=dom-Document-getSelection><a href=http://html5.org/specs/dom-range.html#dom-document-getselection>getSelection()</a></code> on the <a class=external data-anolis-spec=domrange href=http://html5.org/specs/dom-range.html#context-object>context object</a>, or null if there is
 no such <a class=external data-anolis-spec=domrange href=http://html5.org/specs/dom-range.html#concept-range title=concept-range>range</a>.
--- a/source.html	Thu Jul 28 13:31:42 2011 -0600
+++ b/source.html	Thu Jul 28 13:40:05 2011 -0600
@@ -770,6 +770,14 @@
 block props</span> and that has at least one [[child]] that is a
 <span>collapsed block prop</span>.
 
+<p class=note>A collapsed block prop is something like the <code
+title>&lt;br></code> in <code title>&lt;p>&lt;br>&lt;/p></code>, or the <code
+title>&lt;br></code> and <code title>&lt;span></code> in <code
+title>&lt;p>&lt;span>&lt;br>&lt;/span>&lt;/p></code>.  These are necessary to
+stop the block from having zero height when it has no other contents, but serve
+no purpose and should be removed once the block has other contents that stop it
+from collapsing.
+
 <p>The <dfn>active range</dfn> is the first [[range]] in the [[selection]]
 given by calling [[getselection]] on the [[contextobject]], or null if there is
 no such [[range]].