[html5] r6923 - [e] (0) Slight tweaks to the anti-document.write() warning. Fixing https://www.w [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2012-01-26 14:29:18 -0800 (Thu, 26 Jan 2012)
New Revision: 6923

Modified:
   complete.html
   index
   source
Log:
[e] (0) Slight tweaks to the anti-document.write() warning.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=14275
Affected topics: HTML Syntax and Parsing

Modified: complete.html
===================================================================
--- complete.html	2012-01-26 21:55:38 UTC (rev 6922)
+++ complete.html	2012-01-26 22:29:18 UTC (rev 6923)
@@ -13769,14 +13769,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=""><plaintext></code>" or "<code title=""><!--</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>

Modified: index
===================================================================
--- index	2012-01-26 21:55:38 UTC (rev 6922)
+++ index	2012-01-26 22:29:18 UTC (rev 6923)
@@ -13769,14 +13769,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=""><plaintext></code>" or "<code title=""><!--</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>

Modified: source
===================================================================
--- source	2012-01-26 21:55:38 UTC (rev 6922)
+++ source	2012-01-26 22:29:18 UTC (rev 6923)
@@ -14528,15 +14528,15 @@
     <p class="warning">This method has very idiosyncratic behavior. In
     some cases, this method can affect the state of the <span>HTML
     parser</span> 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
+    does not correspond to the source of the document (e.g. if the
+    string written is the string "<code
+    title=""><plaintext></code>" or "<code
+    title=""><!--</code>"). In other cases, the call can clear the
+    current page first, as if <code
     title="dom-document-open">document.open()</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>InvalidStateError</code> exception
     when invoked on <span>XML documents</span>.</p>