Clarify that useCSS has no state
authorAryeh Gregor <AryehGregor+gitcommit@gmail.com>
Mon, 12 Sep 2011 14:38:37 -0600
changeset 575 8ebb342e7e3a
parent 574 534809fa1dc9
child 576 40496360e561
Clarify that useCSS has no state

Also update some related material. Background:
https://bugs.webkit.org/show_bug.cgi?id=36683
editing.html
source.html
--- a/editing.html	Mon Sep 12 14:30:03 2011 -0600
+++ b/editing.html	Mon Sep 12 14:38:37 2011 -0600
@@ -9101,12 +9101,17 @@
 
 <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
-styleWithCSS).  useCSS was the original feature in Mozilla 1.3, but the meaning
-is backward, so Gecko added styleWithCSS as a replacement.  No state is
-defined, since only Gecko supports useCss at all, and as of Firefox 6.0a2, it
-doesn't support queryCommandState() for it.
+<div class=comments>
+<p>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 styleWithCSS).
+useCSS was the original feature in Mozilla 1.3, but the meaning is backward, so
+Gecko added styleWithCSS as a replacement.  No state is defined, since only
+Gecko supports useCSS at all, and as of Firefox 6.0a2, it doesn't support
+queryCommandState() for it.
+
+<p>As of September 2011, WebKit is <a href="https://bugs.webkit.org/show_bug.cgi?id=36683">adding support</a> for this
+command, so it can no longer be considered deprecated.
+</div>
 
 <p><a href=#action>Action</a>: If <var title="">value</var> is an <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> match for the string
 "false", set the <a href=#css-styling-flag>CSS styling flag</a> to true.  Otherwise, set the
@@ -9118,9 +9123,10 @@
 command"><a href=#the-usecss-command>useCSS</a></code> is used, such as by logging a warning to an error
 console.
 
-<p class=XXX>The meaning of this command is backwards, and only Gecko supports
-it.  It would be great if Gecko would agree to drop support, so that we could
-get rid of it.
+<p class=note>No <a href=#state>state</a> is defined for this command, so <code title=queryCommandState()><a href=#querycommandstate()>queryCommandState("useCSS")</a></code> must raise an
+<code class=external data-anolis-spec=domcore title=dom-DOMException-INVALID_ACCESS_ERR><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.  To query the <a href=#css-styling-flag>CSS styling flag</a>'s
+current value, authors have to use <a href=#the-stylewithcss-command>the <code title="">styleWithCSS</code>
+command</a>.
 
 
 <h2 id=additional-requirements>Additional requirements</h2>
--- a/source.html	Mon Sep 12 14:30:03 2011 -0600
+++ b/source.html	Mon Sep 12 14:38:37 2011 -0600
@@ -9175,12 +9175,18 @@
 <!-- @} -->
 <h3><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
-styleWithCSS).  useCSS was the original feature in Mozilla 1.3, but the meaning
-is backward, so Gecko added styleWithCSS as a replacement.  No state is
-defined, since only Gecko supports useCss at all, and as of Firefox 6.0a2, it
-doesn't support queryCommandState() for it.
+<div class=comments>
+<p>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 styleWithCSS).
+useCSS was the original feature in Mozilla 1.3, but the meaning is backward, so
+Gecko added styleWithCSS as a replacement.  No state is defined, since only
+Gecko supports useCSS at all, and as of Firefox 6.0a2, it doesn't support
+queryCommandState() for it.
+
+<p>As of September 2011, WebKit is <a
+href=https://bugs.webkit.org/show_bug.cgi?id=36683>adding support</a> for this
+command, so it can no longer be considered deprecated.
+</div>
 
 <p><span>Action</span>: If <var>value</var> is an <span
 data-anolis-spec=domcore>ASCII case-insensitive</span> match for the string
@@ -9193,9 +9199,11 @@
 command">useCSS</code> is used, such as by logging a warning to an error
 console.
 
-<p class=XXX>The meaning of this command is backwards, and only Gecko supports
-it.  It would be great if Gecko would agree to drop support, so that we could
-get rid of it.
+<p class=note>No <span>state</span> is defined for this command, so <code
+title=queryCommandState()>queryCommandState("useCSS")</code> must raise an
+[[INVALID_ACCESS_ERR]] exception.  To query the <span>CSS styling flag</span>'s
+current value, authors have to use <span>the <code title>styleWithCSS</code>
+command</span>.
 <!-- @} -->
 
 <h2>Additional requirements</h2>