Defer a couple XXX's to V2
authorAryeh Gregor <AryehGregor+gitcommit@gmail.com>
Sun, 10 Jul 2011 13:30:47 -0600
changeset 391 de617d14a219
parent 390 0d4099838e70
child 392 d9c1f90d71d8
Defer a couple XXX's to V2
editcommands.html
source.html
--- a/editcommands.html	Sun Jul 10 13:26:27 2011 -0600
+++ b/editcommands.html	Sun Jul 10 13:30:47 2011 -0600
@@ -3807,26 +3807,18 @@
 
   <li>If the first <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> of <var title="">original parent</var> is not in <var title="">node
   list</var>, but its last <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> is:
-
-  <div class=XXX>
-  <p>We insert things after the parent.  This is bad, because it will cause
-  them to become part of any ranges that immediately follow.  For instance, if
-  we're hitting "bar" in
-
-  </p><xmp><div><p>foo<p>bar</div>{<p>baz}</xmp>
-
-  <p>it becomes
-
-  </p><xmp><div><p>foo</div>{<p>bar<p>baz}</xmp>
-
-  <p>instead of
-
-  </p><xmp><div><p>foo</div><p>bar{<p>baz}</xmp>
-
-  <p>because of how range mutation rules work.  This doesn't happen if we
-  insert before.  Probably this isn't important enough to try working around,
-  though.
-  </div>
+  <!--
+  TODO V2: We insert things after the parent.  This is bad, because it will
+  cause them to become part of any ranges that immediately follow.  For
+  instance, if we're hitting "bar" in
+    <div><p>foo<p>bar</div>{<p>baz}
+  it becomes
+    <div><p>foo</div>{<p>bar<p>baz}
+  instead of
+    <div><p>foo</div><p>bar{<p>baz}
+  because of how range mutation rules work.  This doesn't happen if we insert
+  before.  This may or may not be important enough to bother working around.
+  -->
 
   <ol>
     <li>For each <var title="">node</var> in <var title="">node list</var>, <em>in reverse
@@ -5933,11 +5925,12 @@
 
   <li>Let <var title="">frag</var> be the result of calling <code class=external data-anolis-spec=domps title=dom-Range-createContextualFragment><a href=http://html5.org/specs/dom-parsing.html#dom-range-createcontextualfragment>createContextualFragment(<var title="">value</var>)</a></code>
   on the <a href=#active-range>active range</a>.
-
-  <p class=XXX>This has some interesting consequences.  For instance, table
-  cells and similar will just vanish if they're not in an appropriate place;
-  and inside a script or style or xmp or such, the argument will effectively be
+  <!--
+  TODO V2: This has some interesting consequences.  For instance, table cells
+  and similar will just vanish if they're not in an appropriate place; and
+  inside a script or style or xmp or such, the argument will effectively be
   HTML-escaped before use.  Some of these consequences might be undesirable.
+  -->
 
   <li>Let <var title="">last child</var> be the <code class=external data-anolis-spec=domcore title=dom-Node-lastChild><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-node-lastchild>lastChild</a></code> of <var title="">frag</var>.
 
--- a/source.html	Sun Jul 10 13:26:27 2011 -0600
+++ b/source.html	Sun Jul 10 13:30:47 2011 -0600
@@ -3786,26 +3786,18 @@
 
   <li>If the first [[child]] of <var>original parent</var> is not in <var>node
   list</var>, but its last [[child]] is:
-
-  <div class=XXX>
-  <p>We insert things after the parent.  This is bad, because it will cause
-  them to become part of any ranges that immediately follow.  For instance, if
-  we're hitting "bar" in
-
-  <xmp><div><p>foo<p>bar</div>{<p>baz}</xmp>
-
-  <p>it becomes
-
-  <xmp><div><p>foo</div>{<p>bar<p>baz}</xmp>
-
-  <p>instead of
-
-  <xmp><div><p>foo</div><p>bar{<p>baz}</xmp>
-
-  <p>because of how range mutation rules work.  This doesn't happen if we
-  insert before.  Probably this isn't important enough to try working around,
-  though.
-  </div>
+  <!--
+  TODO V2: We insert things after the parent.  This is bad, because it will
+  cause them to become part of any ranges that immediately follow.  For
+  instance, if we're hitting "bar" in
+    <div><p>foo<p>bar</div>{<p>baz}
+  it becomes
+    <div><p>foo</div>{<p>bar<p>baz}
+  instead of
+    <div><p>foo</div><p>bar{<p>baz}
+  because of how range mutation rules work.  This doesn't happen if we insert
+  before.  This may or may not be important enough to bother working around.
+  -->
 
   <ol>
     <li>For each <var>node</var> in <var>node list</var>, <em>in reverse
@@ -5942,11 +5934,12 @@
   <li>Let <var>frag</var> be the result of calling <code data-anolis-spec=domps
   title=dom-Range-createContextualFragment>createContextualFragment(<var>value</var>)</code>
   on the <span>active range</span>.
-
-  <p class=XXX>This has some interesting consequences.  For instance, table
-  cells and similar will just vanish if they're not in an appropriate place;
-  and inside a script or style or xmp or such, the argument will effectively be
+  <!--
+  TODO V2: This has some interesting consequences.  For instance, table cells
+  and similar will just vanish if they're not in an appropriate place; and
+  inside a script or style or xmp or such, the argument will effectively be
   HTML-escaped before use.  Some of these consequences might be undesirable.
+  -->
 
   <li>Let <var>last child</var> be the [[lastchild]] of <var>frag</var>.