[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