--- a/editing.html Thu Aug 11 14:06:49 2011 -0600
+++ b/editing.html Thu Aug 11 14:14:01 2011 -0600
@@ -34,6 +34,8 @@
li p + * > li:first-child { margin-top: -1em }
li li > p + * > li:first-child { margin-top: 0 }
table { margin: 1em 0 }
+.toc, .toc li { list-style-type: disc }
+.toc li li { list-style-type: circle }
/* Overwrite the underline so it's orange instead of blue, thus looks less
* silly */
a code { text-decoration: underline }
@@ -109,85 +111,85 @@
<ol class=toc>
<li><a class=no-num href=#status-of-this-document>Status of this Document</a></li>
<li><a class=no-num href=#table-of-contents>Table of contents</a></li>
- <li><a href=#introduction><span class=secno>1 </span>Introduction</a></li>
- <li><a href=#tests><span class=secno>2 </span>Tests</a></li>
- <li><a href=#issues><span class=secno>3 </span>Issues</a></li>
- <li><a href=#commands><span class=secno>4 </span>Commands</a>
- <ol>
- <li><a href=#properties-of-commands><span class=secno>4.1 </span>Properties of commands</a></li>
- <li><a href=#supported-commands><span class=secno>4.2 </span>Supported commands</a></li>
- <li><a href=#enabled-commands><span class=secno>4.3 </span>Enabled commands</a></ol></li>
- <li><a href=#methods-of-the-htmldocument-interface><span class=secno>5 </span>Methods of the <code class=external data-anolis-spec=html>HTMLDocument</code> interface</a></li>
- <li><a href=#common-definitions><span class=secno>6 </span>Common definitions</a></li>
- <li><a href=#common-algorithms><span class=secno>7 </span>Common algorithms</a>
- <ol>
- <li><a href=#assorted-common-algorithms><span class=secno>7.1 </span>Assorted common algorithms</a></li>
- <li><a href=#wrapping-a-list-of-nodes><span class=secno>7.2 </span>Wrapping a list of nodes</a></li>
- <li><a href=#allowed-children><span class=secno>7.3 </span>Allowed children</a></ol></li>
- <li><a href=#inline-formatting-commands><span class=secno>8 </span>Inline formatting commands</a>
+ <li><a href=#introduction>Introduction</a></li>
+ <li><a href=#tests>Tests</a></li>
+ <li><a href=#issues>Issues</a></li>
+ <li><a href=#commands>Commands</a>
<ol>
- <li><a href=#inline-formatting-command-definitions><span class=secno>8.1 </span>Inline formatting command definitions</a></li>
- <li><a href=#assorted-inline-formatting-command-algorithms><span class=secno>8.2 </span>Assorted inline formatting command algorithms</a></li>
- <li><a href="#clearing-an-element's-value"><span class=secno>8.3 </span>Clearing an element's value</a></li>
- <li><a href=#pushing-down-values><span class=secno>8.4 </span>Pushing down values</a></li>
- <li><a href=#forcing-the-value-of-a-node><span class=secno>8.5 </span>Forcing the value of a node</a></li>
- <li><a href="#setting-the-selection's-value"><span class=secno>8.6 </span>Setting the selection's value</a></li>
- <li><a href=#the-backcolor-command><span class=secno>8.7 </span>The <code title="">backColor</code> command</a></li>
- <li><a href=#the-bold-command><span class=secno>8.8 </span>The <code title="">bold</code> command</a></li>
- <li><a href=#the-createlink-command><span class=secno>8.9 </span>The <code title="">createLink</code> command</a></li>
- <li><a href=#the-fontname-command><span class=secno>8.10 </span>The <code title="">fontName</code> command</a></li>
- <li><a href=#the-fontsize-command><span class=secno>8.11 </span>The <code title="">fontSize</code> command</a></li>
- <li><a href=#the-forecolor-command><span class=secno>8.12 </span>The <code title="">foreColor</code> command</a></li>
- <li><a href=#the-hilitecolor-command><span class=secno>8.13 </span>The <code title="">hiliteColor</code> command</a></li>
- <li><a href=#the-italic-command><span class=secno>8.14 </span>The <code title="">italic</code> command</a></li>
- <li><a href=#the-removeformat-command><span class=secno>8.15 </span>The <code title="">removeFormat</code> command</a></li>
- <li><a href=#the-strikethrough-command><span class=secno>8.16 </span>The <code title="">strikethrough</code> command</a></li>
- <li><a href=#the-subscript-command><span class=secno>8.17 </span>The <code title="">subscript</code> command</a></li>
- <li><a href=#the-superscript-command><span class=secno>8.18 </span>The <code title="">superscript</code> command</a></li>
- <li><a href=#the-underline-command><span class=secno>8.19 </span>The <code title="">underline</code> command</a></li>
- <li><a href=#the-unlink-command><span class=secno>8.20 </span>The <code title="">unlink</code> command</a></ol></li>
- <li><a href=#block-formatting-commands><span class=secno>9 </span>Block formatting commands</a>
+ <li><a href=#properties-of-commands>Properties of commands</a></li>
+ <li><a href=#supported-commands>Supported commands</a></li>
+ <li><a href=#enabled-commands>Enabled commands</a></ol></li>
+ <li><a href=#methods-of-the-htmldocument-interface>Methods of the <code class=external data-anolis-spec=html>HTMLDocument</code> interface</a></li>
+ <li><a href=#common-definitions>Common definitions</a></li>
+ <li><a href=#common-algorithms>Common algorithms</a>
<ol>
- <li><a href=#block-formatting-command-definitions><span class=secno>9.1 </span>Block formatting command definitions</a></li>
- <li><a href=#assorted-block-formatting-command-algorithms><span class=secno>9.2 </span>Assorted block formatting command algorithms</a></li>
- <li><a href=#block-extending-a-range><span class=secno>9.3 </span>Block-extending a range</a></li>
- <li><a href=#recording-and-restoring-overrides><span class=secno>9.4 </span>Recording and restoring overrides</a></li>
- <li><a href=#deleting-the-contents-of-a-range><span class=secno>9.5 </span>Deleting the contents of a range</a></li>
- <li><a href="#splitting-a-node-list's-parent"><span class=secno>9.6 </span>Splitting a node list's parent</a></li>
- <li><a href=#canonical-space-sequences><span class=secno>9.7 </span>Canonical space sequences</a></li>
- <li><a href=#indenting-and-outdenting><span class=secno>9.8 </span>Indenting and outdenting</a></li>
- <li><a href=#toggling-lists><span class=secno>9.9 </span>Toggling lists</a></li>
- <li><a href=#justifying-the-selection><span class=secno>9.10 </span>Justifying the selection</a></li>
- <li><a href=#the-delete-command><span class=secno>9.11 </span>The <code title="">delete</code> command</a></li>
- <li><a href=#the-formatblock-command><span class=secno>9.12 </span>The <code title="">formatBlock</code> command</a></li>
- <li><a href=#the-forwarddelete-command><span class=secno>9.13 </span>The <code title="">forwardDelete</code> command</a></li>
- <li><a href=#the-indent-command><span class=secno>9.14 </span>The <code title="">indent</code> command</a></li>
- <li><a href=#the-inserthorizontalrule-command><span class=secno>9.15 </span>The <code title="">insertHorizontalRule</code> command</a></li>
- <li><a href=#the-inserthtml-command><span class=secno>9.16 </span>The <code title="">insertHTML</code> command</a></li>
- <li><a href=#the-insertimage-command><span class=secno>9.17 </span>The <code title="">insertImage</code> command</a></li>
- <li><a href=#the-insertlinebreak-command><span class=secno>9.18 </span>The <code title="">insertLineBreak</code> command</a></li>
- <li><a href=#the-insertorderedlist-command><span class=secno>9.19 </span>The <code title="">insertOrderedList</code> command</a></li>
- <li><a href=#the-insertparagraph-command><span class=secno>9.20 </span>The <code title="">insertParagraph</code> command</a></li>
- <li><a href=#the-inserttext-command><span class=secno>9.21 </span>The <code title="">insertText</code> command</a></li>
- <li><a href=#the-insertunorderedlist-command><span class=secno>9.22 </span>The <code title="">insertUnorderedList</code> command</a></li>
- <li><a href=#the-justifycenter-command><span class=secno>9.23 </span>The <code title="">justifyCenter</code> command</a></li>
- <li><a href=#the-justifyfull-command><span class=secno>9.24 </span>The <code title="">justifyFull</code> command</a></li>
- <li><a href=#the-justifyleft-command><span class=secno>9.25 </span>The <code title="">justifyLeft</code> command</a></li>
- <li><a href=#the-justifyright-command><span class=secno>9.26 </span>The <code title="">justifyRight</code> command</a></li>
- <li><a href=#the-outdent-command><span class=secno>9.27 </span>The <code title="">outdent</code> command</a></ol></li>
- <li><a href=#miscellaneous-commands><span class=secno>10 </span>Miscellaneous commands</a>
+ <li><a href=#assorted-common-algorithms>Assorted common algorithms</a></li>
+ <li><a href=#wrapping-a-list-of-nodes>Wrapping a list of nodes</a></li>
+ <li><a href=#allowed-children>Allowed children</a></ol></li>
+ <li><a href=#inline-formatting-commands>Inline formatting commands</a>
<ol>
- <li><a href=#the-copy-command><span class=secno>10.1 </span>The <code title="">copy</code> command</a></li>
- <li><a href=#the-cut-command><span class=secno>10.2 </span>The <code title="">cut</code> command</a></li>
- <li><a href=#the-paste-command><span class=secno>10.3 </span>The <code title="">paste</code> command</a></li>
- <li><a href=#the-selectall-command><span class=secno>10.4 </span>The <code title="">selectAll</code> command</a></li>
- <li><a href=#the-stylewithcss-command><span class=secno>10.5 </span>The <code title="">styleWithCSS</code> command</a></li>
- <li><a href=#the-usecss-command><span class=secno>10.6 </span>The <code title="">useCSS</code> command</a></ol></li>
- <li><a href=#additional-requirements><span class=secno>11 </span>Additional requirements</a></li>
+ <li><a href=#inline-formatting-command-definitions>Inline formatting command definitions</a></li>
+ <li><a href=#assorted-inline-formatting-command-algorithms>Assorted inline formatting command algorithms</a></li>
+ <li><a href="#clearing-an-element's-value">Clearing an element's value</a></li>
+ <li><a href=#pushing-down-values>Pushing down values</a></li>
+ <li><a href=#forcing-the-value-of-a-node>Forcing the value of a node</a></li>
+ <li><a href="#setting-the-selection's-value">Setting the selection's value</a></li>
+ <li><a href=#the-backcolor-command>The <code title="">backColor</code> command</a></li>
+ <li><a href=#the-bold-command>The <code title="">bold</code> command</a></li>
+ <li><a href=#the-createlink-command>The <code title="">createLink</code> command</a></li>
+ <li><a href=#the-fontname-command>The <code title="">fontName</code> command</a></li>
+ <li><a href=#the-fontsize-command>The <code title="">fontSize</code> command</a></li>
+ <li><a href=#the-forecolor-command>The <code title="">foreColor</code> command</a></li>
+ <li><a href=#the-hilitecolor-command>The <code title="">hiliteColor</code> command</a></li>
+ <li><a href=#the-italic-command>The <code title="">italic</code> command</a></li>
+ <li><a href=#the-removeformat-command>The <code title="">removeFormat</code> command</a></li>
+ <li><a href=#the-strikethrough-command>The <code title="">strikethrough</code> command</a></li>
+ <li><a href=#the-subscript-command>The <code title="">subscript</code> command</a></li>
+ <li><a href=#the-superscript-command>The <code title="">superscript</code> command</a></li>
+ <li><a href=#the-underline-command>The <code title="">underline</code> command</a></li>
+ <li><a href=#the-unlink-command>The <code title="">unlink</code> command</a></ol></li>
+ <li><a href=#block-formatting-commands>Block formatting commands</a>
+ <ol>
+ <li><a href=#block-formatting-command-definitions>Block formatting command definitions</a></li>
+ <li><a href=#assorted-block-formatting-command-algorithms>Assorted block formatting command algorithms</a></li>
+ <li><a href=#block-extending-a-range>Block-extending a range</a></li>
+ <li><a href=#recording-and-restoring-overrides>Recording and restoring overrides</a></li>
+ <li><a href=#deleting-the-contents-of-a-range>Deleting the contents of a range</a></li>
+ <li><a href="#splitting-a-node-list's-parent">Splitting a node list's parent</a></li>
+ <li><a href=#canonical-space-sequences>Canonical space sequences</a></li>
+ <li><a href=#indenting-and-outdenting>Indenting and outdenting</a></li>
+ <li><a href=#toggling-lists>Toggling lists</a></li>
+ <li><a href=#justifying-the-selection>Justifying the selection</a></li>
+ <li><a href=#the-delete-command>The <code title="">delete</code> command</a></li>
+ <li><a href=#the-formatblock-command>The <code title="">formatBlock</code> command</a></li>
+ <li><a href=#the-forwarddelete-command>The <code title="">forwardDelete</code> command</a></li>
+ <li><a href=#the-indent-command>The <code title="">indent</code> command</a></li>
+ <li><a href=#the-inserthorizontalrule-command>The <code title="">insertHorizontalRule</code> command</a></li>
+ <li><a href=#the-inserthtml-command>The <code title="">insertHTML</code> command</a></li>
+ <li><a href=#the-insertimage-command>The <code title="">insertImage</code> command</a></li>
+ <li><a href=#the-insertlinebreak-command>The <code title="">insertLineBreak</code> command</a></li>
+ <li><a href=#the-insertorderedlist-command>The <code title="">insertOrderedList</code> command</a></li>
+ <li><a href=#the-insertparagraph-command>The <code title="">insertParagraph</code> command</a></li>
+ <li><a href=#the-inserttext-command>The <code title="">insertText</code> command</a></li>
+ <li><a href=#the-insertunorderedlist-command>The <code title="">insertUnorderedList</code> command</a></li>
+ <li><a href=#the-justifycenter-command>The <code title="">justifyCenter</code> command</a></li>
+ <li><a href=#the-justifyfull-command>The <code title="">justifyFull</code> command</a></li>
+ <li><a href=#the-justifyleft-command>The <code title="">justifyLeft</code> command</a></li>
+ <li><a href=#the-justifyright-command>The <code title="">justifyRight</code> command</a></li>
+ <li><a href=#the-outdent-command>The <code title="">outdent</code> command</a></ol></li>
+ <li><a href=#miscellaneous-commands>Miscellaneous commands</a>
+ <ol>
+ <li><a href=#the-copy-command>The <code title="">copy</code> command</a></li>
+ <li><a href=#the-cut-command>The <code title="">cut</code> command</a></li>
+ <li><a href=#the-paste-command>The <code title="">paste</code> command</a></li>
+ <li><a href=#the-selectall-command>The <code title="">selectAll</code> command</a></li>
+ <li><a href=#the-stylewithcss-command>The <code title="">styleWithCSS</code> command</a></li>
+ <li><a href=#the-usecss-command>The <code title="">useCSS</code> command</a></ol></li>
+ <li><a href=#additional-requirements>Additional requirements</a></li>
<li><a class=no-num href=#acknowledgements>Acknowledgements</a></ol>
<!--end-toc-->
-<h2 id=introduction><span class=secno>1 </span>Introduction</h2>
+<h2 id=introduction>Introduction</h2>
<p>This specification defines commands to edit HTML documents programmatically.
The APIs specified here were originally introduced in Microsoft's Internet
@@ -259,7 +261,7 @@
</ul>
-<h2 id=tests><span class=secno>2 </span>Tests</h2>
+<h2 id=tests>Tests</h2>
<p>This specification is developed in tandem with a more or less complete <a href=implementation.js>JavaScript implementation</a>, which is used for a suite
@@ -402,7 +404,7 @@
-<h2 id=issues><span class=secno>3 </span>Issues</h2>
+<h2 id=issues>Issues</h2>
<p>This specification is mostly feature-complete. It's more or less fully
implemented in JavaScript, and has been tested on a fairly significant amount
@@ -562,9 +564,9 @@
-<h2 id=commands><span class=secno>4 </span>Commands</h2>
-
-<h3 id=properties-of-commands><span class=secno>4.1 </span>Properties of commands</h3>
+<h2 id=commands>Commands</h2>
+
+<h3 id=properties-of-commands>Properties of commands</h3>
<p>This specification defines a number of <dfn id=command title=command>commands</dfn>,
identified by <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive>ASCII case-insensitive</a>
@@ -629,7 +631,7 @@
</ul>
-<h3 id=supported-commands><span class=secno>4.2 </span>Supported commands</h3>
+<h3 id=supported-commands>Supported commands</h3>
<p class=comments>If you try doing anything with an unrecognized command, IE9
throws an "Invalid argument" exception, and Firefox 6.0a2 throws
@@ -670,7 +672,7 @@
using <code><a href=#querycommandsupported()>queryCommandSupported()</a></code>.
-<h3 id=enabled-commands><span class=secno>4.3 </span>Enabled commands</h3>
+<h3 id=enabled-commands>Enabled commands</h3>
<p>At any given time, a <a href=#supported>supported</a> command can be either
<dfn id=enabled>enabled</dfn> or not. Authors can tell whether a <a href=#command>command</a> is
@@ -714,7 +716,7 @@
-<h2 id=methods-of-the-htmldocument-interface><span class=secno>5 </span>Methods of the <code class=external data-anolis-spec=html><a href=http://www.whatwg.org/html/#htmldocument>HTMLDocument</a></code> interface</h2>
+<h2 id=methods-of-the-htmldocument-interface>Methods of the <code class=external data-anolis-spec=html><a href=http://www.whatwg.org/html/#htmldocument>HTMLDocument</a></code> interface</h2>
<p class=comments>TODO: Define behavior for <var title="">show UI</var>.
@@ -909,7 +911,7 @@
</div>
-<h2 id=common-definitions><span class=secno>6 </span>Common definitions</h2>
+<h2 id=common-definitions>Common definitions</h2>
<p>An <dfn id=html-element>HTML element</dfn> is 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> whose <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-element-namespace title=concept-element-namespace>namespace</a> is the
<a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#html-namespace>HTML namespace</a>.
@@ -1078,9 +1080,9 @@
sequentially in the list's order.
-<h2 id=common-algorithms><span class=secno>7 </span>Common algorithms</h2>
-
-<h3 id=assorted-common-algorithms><span class=secno>7.1 </span>Assorted common algorithms</h3>
+<h2 id=common-algorithms>Common algorithms</h2>
+
+<h3 id=assorted-common-algorithms>Assorted common algorithms</h3>
<p>To move a <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a> to a new location, <dfn id=preserving-ranges>preserving ranges</dfn>, remove
the <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a> from its original <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> (if any), then insert it in the new
@@ -1205,7 +1207,7 @@
extraneous line breaks at the end of</a> it.
-<h3 id=wrapping-a-list-of-nodes><span class=secno>7.2 </span>Wrapping a list of nodes</h3>
+<h3 id=wrapping-a-list-of-nodes>Wrapping a list of nodes</h3>
<p>To <dfn id=wrap>wrap</dfn> a list <var title="">node list</var> of consecutive <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-tree-sibling title=concept-tree-sibling>sibling</a>
<a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>nodes</a>, run the following algorithm. In addition to <var title="">node list</var>,
@@ -1397,7 +1399,7 @@
</ol>
-<h3 id=allowed-children><span class=secno>7.3 </span>Allowed children</h3>
+<h3 id=allowed-children>Allowed children</h3>
<div class=comments>
<p>List is mostly based on current HTML5, together with obsolete
@@ -1569,9 +1571,9 @@
</ol>
-<h2 id=inline-formatting-commands><span class=secno>8 </span>Inline formatting commands</h2>
-
-<h3 id=inline-formatting-command-definitions><span class=secno>8.1 </span>Inline formatting command definitions</h3>
+<h2 id=inline-formatting-commands>Inline formatting commands</h2>
+
+<h3 id=inline-formatting-command-definitions>Inline formatting command definitions</h3>
<p class=comments>The difference between "contained" and "effectively
contained" is basically that 1) in <b>[foo]</b>, the text node and the
@@ -1748,7 +1750,7 @@
boilerplate half a dozen times.
-<h3 id=assorted-inline-formatting-command-algorithms><span class=secno>8.2 </span>Assorted inline formatting command algorithms</h3>
+<h3 id=assorted-inline-formatting-command-algorithms>Assorted inline formatting command algorithms</h3>
<p>The <dfn id=effective-command-value>effective command value</dfn> of a <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a> <var title="">node</var> for a
given <var title="">command</var> is returned by the following algorithm, which will
@@ -2005,7 +2007,7 @@
-<h3 id="clearing-an-element's-value"><span class=secno>8.3 </span>Clearing an element's value</h3>
+<h3 id="clearing-an-element's-value">Clearing an element's value</h3>
<p>To <dfn id=clear-the-value>clear the value</dfn> of 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> <var title="">element</var>:
@@ -2083,7 +2085,7 @@
</ol>
-<h3 id=pushing-down-values><span class=secno>8.4 </span>Pushing down values</h3>
+<h3 id=pushing-down-values>Pushing down values</h3>
<div class=comments>
<p>This algorithm goes up to just below the nearest ancestor with the right
@@ -2244,7 +2246,7 @@
</ol>
-<h3 id=forcing-the-value-of-a-node><span class=secno>8.5 </span>Forcing the value of a node</h3>
+<h3 id=forcing-the-value-of-a-node>Forcing the value of a node</h3>
<p>To <dfn id=force-the-value>force the value</dfn> of a <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a> <var title="">node</var> to <var title="">new
value</var>:
@@ -2564,7 +2566,7 @@
</ol>
-<h3 id="setting-the-selection's-value"><span class=secno>8.6 </span>Setting the selection's value</h3>
+<h3 id="setting-the-selection's-value">Setting the selection's value</h3>
<p>To <dfn id="set-the-selection's-value">set the selection's value</dfn> to <var title="">new value</var>:
@@ -2758,7 +2760,7 @@
</ol>
-<h3 id=the-backcolor-command><span class=secno>8.7 </span><dfn>The <code title="">backColor</code> command</dfn></h3>
+<h3 id=the-backcolor-command><dfn>The <code title="">backColor</code> command</dfn></h3>
<p class=note>For historical reasons, backColor and hiliteColor behave
identically.
@@ -2820,7 +2822,7 @@
valid CSS color.
-<h3 id=the-bold-command><span class=secno>8.8 </span><dfn>The <code title="">bold</code> command</dfn></h3>
+<h3 id=the-bold-command><dfn>The <code title="">bold</code> command</dfn></h3>
<p class=comments>If the selection is collapsed (but not if it contains nothing
but is not collapsed), IE9 wraps the whole line in a <strong>. This seems
@@ -2859,7 +2861,7 @@
"bold" and the other is "700", or one is "normal" and the other is "400".
-<h3 id=the-createlink-command><span class=secno>8.9 </span><dfn>The <code title="">createLink</code> command</dfn></h3>
+<h3 id=the-createlink-command><dfn>The <code title="">createLink</code> command</dfn></h3>
<p class=comments> If the selection doesn't contain anything (meaning, e.g.,
deleteContents() doesn't change anything), then Chrome 12 dev inserts a link at
@@ -2920,7 +2922,7 @@
<p><a href=#standard-inline-value-command>Standard inline value command</a>
-<h3 id=the-fontname-command><span class=secno>8.10 </span><dfn>The <code title="">fontName</code> command</dfn></h3>
+<h3 id=the-fontname-command><dfn>The <code title="">fontName</code> command</dfn></h3>
<div class=comments>
<p>UAs differ a bit in the details here:
@@ -2990,7 +2992,7 @@
<p><a href=#relevant-css-property>Relevant CSS property</a>: "font-family"
-<h3 id=the-fontsize-command><span class=secno>8.11 </span><dfn>The <code title="">fontSize</code> command</dfn></h3>
+<h3 id=the-fontsize-command><dfn>The <code title="">fontSize</code> command</dfn></h3>
<div class=comments>
<dl>
@@ -3193,7 +3195,7 @@
<li>Return "7".
</ol>
-<h3 id=the-forecolor-command><span class=secno>8.12 </span><dfn>The <code title="">foreColor</code> command</dfn></h3>
+<h3 id=the-forecolor-command><dfn>The <code title="">foreColor</code> command</dfn></h3>
<div class=comments>
<p>Color interpretations:
@@ -3312,7 +3314,7 @@
valid CSS color.
-<h3 id=the-hilitecolor-command><span class=secno>8.13 </span><dfn>The <code title="">hiliteColor</code> command</dfn></h3>
+<h3 id=the-hilitecolor-command><dfn>The <code title="">hiliteColor</code> command</dfn></h3>
<p class=note>For historical reasons, backColor and hiliteColor behave
identically.
@@ -3366,7 +3368,7 @@
valid CSS color.
-<h3 id=the-italic-command><span class=secno>8.14 </span><dfn>The <code title="">italic</code> command</dfn></h3>
+<h3 id=the-italic-command><dfn>The <code title="">italic</code> command</dfn></h3>
<p><a href=#action>Action</a>: If <code title=queryCommandState()><a href=#querycommandstate()>queryCommandState("italic")</a></code> returns true,
<a href="#set-the-selection's-value">set the selection's value</a> to "normal". Otherwise <a href="#set-the-selection's-value">set the
@@ -3377,7 +3379,7 @@
<p><a href=#relevant-css-property>Relevant CSS property</a>: "font-style"
-<h3 id=the-removeformat-command><span class=secno>8.15 </span><dfn>The <code title="">removeFormat</code> command</dfn></h3>
+<h3 id=the-removeformat-command><dfn>The <code title="">removeFormat</code> command</dfn></h3>
<div class=comments>
<p>Tested in IE 9, Firefox 4.0, Chrome 12 dev, Opera 11.00.
@@ -3512,7 +3514,7 @@
</ol>
-<h3 id=the-strikethrough-command><span class=secno>8.16 </span><dfn>The <code title="">strikethrough</code> command</dfn></h3>
+<h3 id=the-strikethrough-command><dfn>The <code title="">strikethrough</code> command</dfn></h3>
<p class=comments>TODO: See underline TODO.
@@ -3523,7 +3525,7 @@
<p><a href=#inline-command-activated-values>Inline command activated values</a>: "line-through"
-<h3 id=the-subscript-command><span class=secno>8.17 </span><dfn>The <code title="">subscript</code> command</dfn></h3>
+<h3 id=the-subscript-command><dfn>The <code title="">subscript</code> command</dfn></h3>
<p><a href=#action>Action</a>:
@@ -3559,7 +3561,7 @@
<p><a href=#inline-command-activated-values>Inline command activated values</a>: "subscript"
-<h3 id=the-superscript-command><span class=secno>8.18 </span><dfn>The <code title="">superscript</code> command</dfn></h3>
+<h3 id=the-superscript-command><dfn>The <code title="">superscript</code> command</dfn></h3>
<p><a href=#action>Action</a>:
@@ -3584,7 +3586,7 @@
<p><a href=#inline-command-activated-values>Inline command activated values</a>: "superscript"
-<h3 id=the-underline-command><span class=secno>8.19 </span><dfn>The <code title="">underline</code> command</dfn></h3>
+<h3 id=the-underline-command><dfn>The <code title="">underline</code> command</dfn></h3>
<div class=comments>
<p>TODO: There are a lot of problems with underline color and thickness,
@@ -3640,7 +3642,7 @@
<p><a href=#inline-command-activated-values>Inline command activated values</a>: "underline"
-<h3 id=the-unlink-command><span class=secno>8.20 </span><dfn>The <code title="">unlink</code> command</dfn></h3>
+<h3 id=the-unlink-command><dfn>The <code title="">unlink</code> command</dfn></h3>
<p class=comments>IE 9 RC unlinks the whole link you're pointing at, while
others only unlink the current text. The latter behavior seems less expected,
@@ -3667,9 +3669,9 @@
-<h2 id=block-formatting-commands><span class=secno>9 </span>Block formatting commands</h2>
-
-<h3 id=block-formatting-command-definitions><span class=secno>9.1 </span>Block formatting command definitions</h3>
+<h2 id=block-formatting-commands>Block formatting commands</h2>
+
+<h3 id=block-formatting-command-definitions>Block formatting command definitions</h3>
<p>An <dfn id=indentation-element>indentation element</dfn> is either a <code class=external data-anolis-spec=html title="the blockquote element"><a href=http://www.whatwg.org/html/#the-blockquote-element>blockquote</a></code>, or a <code class=external data-anolis-spec=html title="the div element"><a href=http://www.whatwg.org/html/#the-div-element>div</a></code>
that has a <code class=external data-anolis-spec=html title="the style attribute"><a href=http://www.whatwg.org/html/#the-style-attribute>style</a></code> attribute that sets "margin" or some subproperty of it.
@@ -3715,7 +3717,7 @@
<p>The <dfn id=default-single-line-container-name>default single-line container name</dfn> is "p".
-<h3 id=assorted-block-formatting-command-algorithms><span class=secno>9.2 </span>Assorted block formatting command algorithms</h3>
+<h3 id=assorted-block-formatting-command-algorithms>Assorted block formatting command algorithms</h3>
<p class=comments>TODO: When breaking a non-inline element out of an inline
element, like p in b or whatever, it would make sense to re-wrap the contents
@@ -3988,7 +3990,7 @@
</ol>
-<h3 id=block-extending-a-range><span class=secno>9.3 </span>Block-extending a range</h3>
+<h3 id=block-extending-a-range>Block-extending a range</h3>
<p>When a user agent is to <dfn id=block-extend>block-extend</dfn> a <a class=external data-anolis-spec=domrange href=http://html5.org/specs/dom-range.html#concept-range title=concept-range>range</a>
<var title="">range</var>, it must run the following steps:
@@ -4138,7 +4140,7 @@
</ol>
-<h3 id=recording-and-restoring-overrides><span class=secno>9.4 </span>Recording and restoring overrides</h3>
+<h3 id=recording-and-restoring-overrides>Recording and restoring overrides</h3>
<!--@{-->
<p>To <dfn id=record-current-overrides>record current overrides</dfn>:
@@ -4280,7 +4282,7 @@
</ol>
<!--@}-->
-<h3 id=deleting-the-contents-of-a-range><span class=secno>9.5 </span>Deleting the contents of a range</h3>
+<h3 id=deleting-the-contents-of-a-range>Deleting the contents of a range</h3>
<p class=comments>TODO: Consider what should happen for block merging in corner
cases like display: inline-table.
@@ -4800,7 +4802,7 @@
</ol>
-<h3 id="splitting-a-node-list's-parent"><span class=secno>9.6 </span>Splitting a node list's parent</h3>
+<h3 id="splitting-a-node-list's-parent">Splitting a node list's parent</h3>
<p>To <dfn id=split-the-parent>split the parent</dfn> of a list <var title="">node list</var> of consecutive
<a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-tree-sibling title=concept-tree-sibling>sibling</a> <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>nodes</a>:
@@ -4955,7 +4957,7 @@
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>.
-<h3 id=canonical-space-sequences><span class=secno>9.7 </span>Canonical space sequences</h3>
+<h3 id=canonical-space-sequences>Canonical space sequences</h3>
<div class=note>
<p>Whitespace in HTML normally collapses. However, if the user hits the space
@@ -5194,7 +5196,7 @@
</ol>
-<h3 id=indenting-and-outdenting><span class=secno>9.8 </span>Indenting and outdenting</h3>
+<h3 id=indenting-and-outdenting>Indenting and outdenting</h3>
<div class=note>
<p>There are two basically different types of indent/outdent: lists, and
@@ -5554,7 +5556,7 @@
</ol>
-<h3 id=toggling-lists><span class=secno>9.9 </span>Toggling lists</h3>
+<h3 id=toggling-lists>Toggling lists</h3>
<div class=note>
<p>This is the action for <a href=#the-insertorderedlist-command>the <code title="">insertOrderedList</code>
@@ -6298,7 +6300,7 @@
</ol>
-<h3 id=justifying-the-selection><span class=secno>9.10 </span>Justifying the selection</h3>
+<h3 id=justifying-the-selection>Justifying the selection</h3>
<p class=note>This is the <a href=#action>action</a> for the four <code title="">justify*</code> commands. It's pretty straightforward, with no notable
gotchas or special cases. It works more or less like a stripped-down version
@@ -6424,7 +6426,7 @@
</ol>
-<h3 id=the-delete-command><span class=secno>9.11 </span><dfn>The <code title="">delete</code> command</dfn></h3>
+<h3 id=the-delete-command><dfn>The <code title="">delete</code> command</dfn></h3>
<div class=note>
<p>This is the same as hitting backspace (see <a href=#additional-requirements>Additional requirements</a>). The easy part is
@@ -6812,7 +6814,7 @@
</ol>
-<h3 id=the-formatblock-command><span class=secno>9.12 </span><dfn>The <code title="">formatBlock</code> command</dfn></h3>
+<h3 id=the-formatblock-command><dfn>The <code title="">formatBlock</code> command</dfn></h3>
<p class=note>This command lets you change what block element particular lines
are wrapped in. It will convert an existing wrapper if one exists, and
@@ -7144,7 +7146,7 @@
</ol>
-<h3 id=the-forwarddelete-command><span class=secno>9.13 </span><dfn>The <code title="">forwardDelete</code> command</dfn></h3>
+<h3 id=the-forwarddelete-command><dfn>The <code title="">forwardDelete</code> command</dfn></h3>
<p class=note>This is the same as hitting the delete key (see <a href=#additional-requirements>Additional requirements</a>). It behaves much
the same as <a href=#the-delete-command>the <code title="">delete</code> command</a>, except of
@@ -7339,7 +7341,7 @@
</ol>
-<h3 id=the-indent-command><span class=secno>9.14 </span><dfn>The <code title="">indent</code> command</dfn></h3>
+<h3 id=the-indent-command><dfn>The <code title="">indent</code> command</dfn></h3>
<div class=comments>
<dl>
@@ -7447,7 +7449,7 @@
</ol>
-<h3 id=the-inserthorizontalrule-command><span class=secno>9.15 </span><dfn>The <code title="">insertHorizontalRule</code> command</dfn></h3>
+<h3 id=the-inserthorizontalrule-command><dfn>The <code title="">insertHorizontalRule</code> command</dfn></h3>
<p class=comments>You'd think interop here would be simple, right? Nope: we
have three different behaviors across four browsers. Opera 11.00 is the only
@@ -7516,7 +7518,7 @@
</ol>
-<h3 id=the-inserthtml-command><span class=secno>9.16 </span><dfn>The <code title="">insertHTML</code> command</dfn></h3>
+<h3 id=the-inserthtml-command><dfn>The <code title="">insertHTML</code> command</dfn></h3>
<div class=comments>
<p>Not supported by IE9. Handling of disallowed children is interesting:
@@ -7654,7 +7656,7 @@
</ol>
-<h3 id=the-insertimage-command><span class=secno>9.17 </span><dfn>The <code title="">insertImage</code> command</dfn></h3>
+<h3 id=the-insertimage-command><dfn>The <code title="">insertImage</code> command</dfn></h3>
<p><a href=#action>Action</a>:
@@ -7720,7 +7722,7 @@
</ol>
-<h3 id=the-insertlinebreak-command><span class=secno>9.18 </span><dfn>The <code title="">insertLineBreak</code> command</dfn></h3>
+<h3 id=the-insertlinebreak-command><dfn>The <code title="">insertLineBreak</code> command</dfn></h3>
<p class=note>This is the same as hitting Shift-Enter or such (see <a href=#additional-requirements>Additional requirements</a>). It deletes the
selection, and replaces it with a <code title=""><br></code>. No real
@@ -7798,7 +7800,7 @@
</ol>
-<h3 id=the-insertorderedlist-command><span class=secno>9.19 </span><dfn>The <code title="">insertOrderedList</code> command</dfn></h3>
+<h3 id=the-insertorderedlist-command><dfn>The <code title="">insertOrderedList</code> command</dfn></h3>
<p><a href=#action>Action</a>: <a href=#toggle-lists>Toggle lists</a> with <var title="">tag name</var>
"ol".
@@ -7822,7 +7824,7 @@
false otherwise.
-<h3 id=the-insertparagraph-command><span class=secno>9.20 </span><dfn>The <code title="">insertParagraph</code> command</dfn></h3>
+<h3 id=the-insertparagraph-command><dfn>The <code title="">insertParagraph</code> command</dfn></h3>
<div class=note>
<p>This is the same as hitting enter (see <a href=#additional-requirements>Additional requirements</a>). The general rule
@@ -8147,7 +8149,7 @@
</ol>
-<h3 id=the-inserttext-command><span class=secno>9.21 </span><dfn>The <code title="">insertText</code> command</dfn></h3>
+<h3 id=the-inserttext-command><dfn>The <code title="">insertText</code> command</dfn></h3>
<div class=note>
<p>This is the same as typing text (see <a href=#additional-requirements>Additional requirements</a>). If the input
@@ -8390,7 +8392,7 @@
</ol>
-<h3 id=the-insertunorderedlist-command><span class=secno>9.22 </span><dfn>The <code title="">insertUnorderedList</code> command</dfn></h3>
+<h3 id=the-insertunorderedlist-command><dfn>The <code title="">insertUnorderedList</code> command</dfn></h3>
<p class=comments>See comments for <a href=#the-insertorderedlist-command>insertOrderedList</a>.
@@ -8404,7 +8406,7 @@
false otherwise.
-<h3 id=the-justifycenter-command><span class=secno>9.23 </span><dfn>The <code title="">justifyCenter</code> command</dfn></h3>
+<h3 id=the-justifycenter-command><dfn>The <code title="">justifyCenter</code> command</dfn></h3>
<p><a href=#action>Action</a>: <a href=#justify-the-selection>Justify the selection</a> with
<var title="">alignment</var> "center".
@@ -8471,7 +8473,7 @@
<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>children</a>. If there is no such <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a>, return "left".
-<h3 id=the-justifyfull-command><span class=secno>9.24 </span><dfn>The <code title="">justifyFull</code> command</dfn></h3>
+<h3 id=the-justifyfull-command><dfn>The <code title="">justifyFull</code> command</dfn></h3>
<p><a href=#action>Action</a>: <a href=#justify-the-selection>Justify the selection</a> with
<var title="">alignment</var> "justify".
@@ -8494,7 +8496,7 @@
<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>children</a>. If there is no such <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a>, return "left".
-<h3 id=the-justifyleft-command><span class=secno>9.25 </span><dfn>The <code title="">justifyLeft</code> command</dfn></h3>
+<h3 id=the-justifyleft-command><dfn>The <code title="">justifyLeft</code> command</dfn></h3>
<p><a href=#action>Action</a>: <a href=#justify-the-selection>Justify the selection</a> with
<var title="">alignment</var> "left".
@@ -8517,7 +8519,7 @@
<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>children</a>. If there is no such <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a>, return "left".
-<h3 id=the-justifyright-command><span class=secno>9.26 </span><dfn>The <code title="">justifyRight</code> command</dfn></h3>
+<h3 id=the-justifyright-command><dfn>The <code title="">justifyRight</code> command</dfn></h3>
<p><a href=#action>Action</a>: <a href=#justify-the-selection>Justify the selection</a> with
<var title="">alignment</var> "right".
@@ -8540,7 +8542,7 @@
<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>children</a>. If there is no such <a class=external data-anolis-spec=domcore href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-node title=concept-node>node</a>, return "left".
-<h3 id=the-outdent-command><span class=secno>9.27 </span><dfn>The <code title="">outdent</code> command</dfn></h3>
+<h3 id=the-outdent-command><dfn>The <code title="">outdent</code> command</dfn></h3>
<p><a href=#action>Action</a>:
@@ -8623,9 +8625,9 @@
</ol>
-<h2 id=miscellaneous-commands><span class=secno>10 </span>Miscellaneous commands</h2>
-
-<h3 id=the-copy-command><span class=secno>10.1 </span><dfn>The <code title="">copy</code> command</dfn></h3>
+<h2 id=miscellaneous-commands>Miscellaneous commands</h2>
+
+<h3 id=the-copy-command><dfn>The <code title="">copy</code> command</dfn></h3>
<p class=comments>IE9 supports copy/cut/paste with a security warning. Firefox
reportedly only supports it if you set a pref. I didn't find info on other
@@ -8657,7 +8659,7 @@
those sites.
-<h3 id=the-cut-command><span class=secno>10.2 </span><dfn>The <code title="">cut</code> command</dfn></h3>
+<h3 id=the-cut-command><dfn>The <code title="">cut</code> command</dfn></h3>
<p class=comments>See comment for <a href=#the-copy-command>copy</a>.
@@ -8679,7 +8681,7 @@
those sites.
-<h3 id=the-paste-command><span class=secno>10.3 </span><dfn>The <code title="">paste</code> command</dfn></h3>
+<h3 id=the-paste-command><dfn>The <code title="">paste</code> command</dfn></h3>
<p class=comments>See comment for <a href=#the-copy-command>copy</a>.
@@ -8701,7 +8703,7 @@
those sites.
-<h3 id=the-selectall-command><span class=secno>10.4 </span><dfn>The <code title="">selectAll</code> command</dfn></h3>
+<h3 id=the-selectall-command><dfn>The <code title="">selectAll</code> command</dfn></h3>
<div class=comments>
<p>Tested using roughly <a href=http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1018>this</a>.
@@ -8757,7 +8759,7 @@
</ol>
-<h3 id=the-stylewithcss-command><span class=secno>10.5 </span><dfn>The <code title="">styleWithCSS</code> command</dfn></h3>
+<h3 id=the-stylewithcss-command><dfn>The <code title="">styleWithCSS</code> command</dfn></h3>
<div class=comments>
<p>IE9 and Opera 11.00 don't support this command. By and large, they act the
@@ -8788,7 +8790,7 @@
otherwise false.
-<h3 id=the-usecss-command><span class=secno>10.6 </span><dfn>The <code title="">useCSS</code> command</dfn></h3>
+<h3 id=the-usecss-command><dfn>The <code title="">useCSS</code> command</dfn></h3>
<p class=comments>Supported by Firefox 4.0, but not IE9 or Opera 11.00 (which
don't support styleWithCSS either), nor by Chrome 12 dev (which does support
@@ -8812,7 +8814,7 @@
get rid of it.
-<h2 id=additional-requirements><span class=secno>11 </span>Additional requirements</h2>
+<h2 id=additional-requirements>Additional requirements</h2>
<p class=XXX>It has been <a href=http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2009-December/024628.html>suggested</a>
that some things here need to be platform-dependent, not fully standardized.