html5/spec Overview.html,1.5520,1.5521

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv18710

Modified Files:
	Overview.html 
Log Message:
Slight tweaks to the anti-document.write() warning. (whatwg r6923)

Index: Overview.html
===================================================================
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:32 UTC