hixie: Slight tweaks to the anti-document.write() warning. (whatwg r6923)

hixie: Slight tweaks to the anti-document.write() warning. (whatwg
r6923)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5520&r2=1.5521&f=h
http://html5.org/tools/web-apps-tracker?from=6922&to=6923

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5520
retrieving revision 1.5521
diff -u -d -r1.5520 -r1.5521
--- Overview.html 26 Jan 2012 21:55:45 -0000 1.5520
+++ Overview.html 26 Jan 2012 22:29:23 -0000 1.5521
@@ -11465,14 +11465,12 @@
     <p class="warning">This method has very idiosyncratic behavior. In
     some cases, this method can affect the state of the <a href="#html-parser">HTML
     parser</a> while the parser is running, resulting in a DOM that
-    does not correspond to the source of the document. In other cases,
-    the call can clear the current page first, as if <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> had been called.
+    does not correspond to the source of the document (e.g. if the
+    string written is the string "<code title="">&lt;plaintext&gt;</code>" or "<code title="">&lt;!--</code>"). In other cases, the call can clear the
+    current page first, as if <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> had been called.
     In yet more cases, the method is simply ignored, or throws an
-    exception. To make matters worse, the exact behavior of this
-    method can in some cases be dependent on network latency, which
-    can lead to failures that are very hard to debug. <strong>For all
-    these reasons, use of this method is strongly
-    discouraged.</strong></p>
+    exception. <strong>For all these reasons, use of this method is
+    strongly discouraged.</strong></p>
 
     <p>This method throws an <code><a href="#invalidstateerror">InvalidStateError</a></code> exception
     when invoked on <a href="#xml-documents">XML documents</a>.</p>

Received on Thursday, 26 January 2012 22:29:51 UTC