Clarify what we won't do to non-editable things
authorAryeh Gregor <AryehGregor+gitcommit@gmail.com>
Mon, 30 May 2011 13:19:18 -0600
changeset 197 06dedd89ddfb
parent 196 1b080ed11898
child 198 da52305049bb
Clarify what we won't do to non-editable things
editcommands.html
source.html
--- a/editcommands.html	Mon May 30 13:11:54 2011 -0600
+++ b/editcommands.html	Mon May 30 13:19:18 2011 -0600
@@ -354,11 +354,6 @@
 <code class=external data-anolis-spec=domcore><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#documentfragment>DocumentFragment</a></code>, its <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-tree-parent title=concept-tree-parent>parent</a> cannot be null, and it must descend from
 either an <code class=external data-anolis-spec=domcore><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#element>Element</a></code> or a <code class=external data-anolis-spec=domcore><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document>Document</a></code>.
 
-<p class=note>The algorithms here will generally not remove or alter the
-attributes of any node that is not editable.  Note that an editing host is not
-editable, so authors are assured that editing commands will only modify the
-editing host's contents and not the editing host itself.
-
 <p>The <dfn id=editing-host-of>editing host of</dfn> <var title="">node</var> is null if <var title="">node</var> is
 neither <a href=#editable>editable</a> nor an <a href=#editing-host>editing host</a>; <var title="">node</var>
 itself, if <var title="">node</var> is an <a href=#editing-host>editing host</a>; or the nearest
@@ -369,6 +364,14 @@
 host of</a> the first is non-null and the same as the <a href=#editing-host-of>editing host
 of</a> the second.
 
+<p class=note>Barring bugs, the algorithms here will not alter the attributes
+of a non-editable element; will not remove a non-editable node from its parent
+(except to immediately give it a new parent in the same editing host); and will
+not add, remove, or reorder children of a node unless it is either editable or
+an editing host.  An editing host is never editable, so authors are assured
+that editing commands will only modify the editing host's contents and not the
+editing host itself.
+
 <p>The <dfn id=prohibited-paragraph-children>prohibited paragraph children</dfn> are "address", "article",
 "aside", "blockquote", "center", "details", "dd", "dir", "div", "dl", "dt",
 "fieldset", "figcaption", "figure", "footer", "form", "h1", "h2", "h3", "h4",
--- a/source.html	Mon May 30 13:11:54 2011 -0600
+++ b/source.html	Mon May 30 13:19:18 2011 -0600
@@ -311,11 +311,6 @@
 [[documentfragment]], its [[parent]] cannot be null, and it must descend from
 either an [[element]] or a [[document]].
 
-<p class=note>The algorithms here will generally not remove or alter the
-attributes of any node that is not editable.  Note that an editing host is not
-editable, so authors are assured that editing commands will only modify the
-editing host's contents and not the editing host itself.
-
 <p>The <dfn>editing host of</dfn> <var>node</var> is null if <var>node</var> is
 neither <span>editable</span> nor an <span>editing host</span>; <var>node</var>
 itself, if <var>node</var> is an <span>editing host</span>; or the nearest
@@ -326,6 +321,14 @@
 host of</span> the first is non-null and the same as the <span>editing host
 of</span> the second.
 
+<p class=note>Barring bugs, the algorithms here will not alter the attributes
+of a non-editable element; will not remove a non-editable node from its parent
+(except to immediately give it a new parent in the same editing host); and will
+not add, remove, or reorder children of a node unless it is either editable or
+an editing host.  An editing host is never editable, so authors are assured
+that editing commands will only modify the editing host's contents and not the
+editing host itself.
+
 <p>The <dfn>prohibited paragraph children</dfn> are "address", "article",
 "aside", "blockquote", "center", "details", "dd", "dir", "div", "dl", "dt",
 "fieldset", "figcaption", "figure", "footer", "form", "h1", "h2", "h3", "h4",