[html5] r3888 - [e] (0) Tidy up some XXX markers.

whatwg at whatwg.org whatwg at whatwg.org
Thu Sep 17 22:12:44 PDT 2009


Author: ianh
Date: 2009-09-17 22:12:43 -0700 (Thu, 17 Sep 2009)
New Revision: 3888

Modified:
   index
   source
Log:
[e] (0) Tidy up some XXX markers.

Modified: index
===================================================================
--- index	2009-09-18 05:06:16 UTC (rev 3887)
+++ index	2009-09-18 05:12:43 UTC (rev 3888)
@@ -57059,7 +57059,7 @@
   as defined for the <code>Range</code> interface; this can therefore
   result in the members of the <code><a href=#selection-0>Selection</a></code> interface
   raising exceptions as well, in addition to any explicitly called out
-  below.</p> <!-- XXX example -->
+  below.</p>
 
   <dl class=domintro><dt><var title="">selection</var> . <code title=dom-selection-anchorNode><a href=#dom-selection-anchornode>anchorNode</a></code></dt>
 
@@ -57273,8 +57273,7 @@
   range). Duplicates are not prevented; a range may be added more than
   once in which case it appears in the list more than once, which (for
   example) will cause <a href=#dom-selection-tostring title=dom-selection-toString>stringification</a> to return the
-  range's text twice.</p> <!-- XXX how does this interact with
-  deleteFromDocument() which acts on all ranges? -->
+  range's text twice.</p>
 
   <p>The <dfn id=dom-selection-removerange title=dom-selection-removeRange><code>removeRange(<var title="">range</var>)</code></dfn>
   method must remove the first occurrence of <var title="">range</var> in the
@@ -57321,7 +57320,7 @@
            attribute unsigned long <a href=#dom-textarea/input-selectionstart title=dom-textarea/input-selectionStart>selectionStart</a>;
            attribute unsigned long <a href=#dom-textarea/input-selectionend title=dom-textarea/input-selectionEnd>selectionEnd</a>;
   void <a href=#dom-textarea/input-setselectionrange title=dom-textarea/input-setSelectionRange>setSelectionRange</a>(in unsigned long start, in unsigned long end);</pre>
-  <!-- XXX also add textLength? it seems to be widely used -->
+  <!-- v2: also add textLength? it seems to be widely used -->
 
   <p>These methods and attributes expose and control the selection of
   <code><a href=#the-input-element>input</a></code> and <code><a href=#the-textarea-element>textarea</a></code> text fields.</p>
@@ -57525,12 +57524,12 @@
   <p>When an editing host has focus, it must have a <dfn id=caret-position>caret
   position</dfn> that specifies where the current editing position
   is. It may also have a <a href=#the-selection title="the
-  selection">selection</a>.</p> <!-- XXX xref to later section -->
+  selection">selection</a>.</p>
 
   <p class=note>How the caret and selection are represented depends
   entirely on the UA.</p>
 
-  <!-- XXX would be useful to have a way to mark an element as
+  <!-- v2: would be useful to have a way to mark an element as
   unremovable. -->
 
   </div>
@@ -57708,14 +57707,17 @@
    attribute. (Updating the <code title="">default*</code> IDL
    attributes causes content attributes to be updated as well.)</dd>
 
-   <!-- XXX something about not supporting resizing? -->
-
-  </dl><!-- XXX each action performed should be added to the undo history --><p>User agents may perform several commands per user request; for
+  </dl><p>User agents may perform several commands per user request; for
   example if the user selects a block of text and hits
   <kbd><kbd>Enter</kbd></kbd>, the UA might interpret that as a
   request to delete the content of <a href=#the-selection>the selection</a> followed
   by a request to break the paragraph at that position.</p>
 
+  <p>User agents may add <a href=#dom-changes>DOM changes</a> entries to the
+  <a href=#undo-transaction-history>undo transaction history</a> of the <a href=#editing-host>editing
+  host</a>'s <code>Document</code> object each time an action is
+  triggered.</p>
+
   <p>All of the actions defined above, whether triggered by the user
   or programmatically (e.g. by <code title=dom-document-execCommand><a href=#execCommand>execCommand()</a></code> commands),
   must fire mutation events as appropriate.</p>

Modified: source
===================================================================
--- source	2009-09-18 05:06:16 UTC (rev 3887)
+++ source	2009-09-18 05:12:43 UTC (rev 3888)
@@ -66488,7 +66488,7 @@
   as defined for the <code>Range</code> interface; this can therefore
   result in the members of the <code>Selection</code> interface
   raising exceptions as well, in addition to any explicitly called out
-  below.</p> <!-- XXX example -->
+  below.</p>
 
   <dl class="domintro">
 
@@ -66733,8 +66733,7 @@
   once in which case it appears in the list more than once, which (for
   example) will cause <span
   title="dom-selection-toString">stringification</span> to return the
-  range's text twice.</p> <!-- XXX how does this interact with
-  deleteFromDocument() which acts on all ranges? -->
+  range's text twice.</p>
 
   <p>The <dfn
   title="dom-selection-removeRange"><code>removeRange(<var title="">range</var>)</code></dfn>
@@ -66786,7 +66785,7 @@
            attribute unsigned long <span title="dom-textarea/input-selectionStart">selectionStart</span>;
            attribute unsigned long <span title="dom-textarea/input-selectionEnd">selectionEnd</span>;
   void <span title="dom-textarea/input-setSelectionRange">setSelectionRange</span>(in unsigned long start, in unsigned long end);</pre>
-  <!-- XXX also add textLength? it seems to be widely used -->
+  <!-- v2: also add textLength? it seems to be widely used -->
 
   <p>These methods and attributes expose and control the selection of
   <code>input</code> and <code>textarea</code> text fields.</p>
@@ -67031,12 +67030,12 @@
   <p>When an editing host has focus, it must have a <dfn>caret
   position</dfn> that specifies where the current editing position
   is. It may also have a <span title="the
-  selection">selection</span>.</p> <!-- XXX xref to later section -->
+  selection">selection</span>.</p>
 
   <p class="note">How the caret and selection are represented depends
   entirely on the UA.</p>
 
-  <!-- XXX would be useful to have a way to mark an element as
+  <!-- v2: would be useful to have a way to mark an element as
   unremovable. -->
 
   </div>
@@ -67227,18 +67226,19 @@
    attribute. (Updating the <code title="">default*</code> IDL
    attributes causes content attributes to be updated as well.)</p></dd>
 
-   <!-- XXX something about not supporting resizing? -->
-
   </dl>
 
-  <!-- XXX each action performed should be added to the undo history -->
-
   <p>User agents may perform several commands per user request; for
   example if the user selects a block of text and hits
   <kbd><kbd>Enter</kbd></kbd>, the UA might interpret that as a
   request to delete the content of <span>the selection</span> followed
   by a request to break the paragraph at that position.</p>
 
+  <p>User agents may add <span>DOM changes</span> entries to the
+  <span>undo transaction history</span> of the <span>editing
+  host</span>'s <code>Document</code> object each time an action is
+  triggered.</p>
+
   <p>All of the actions defined above, whether triggered by the user
   or programmatically (e.g. by <code
   title="dom-document-execCommand">execCommand()</code> commands),




More information about the Commit-Watchers mailing list