[html5] r6924 - [e] (0) More tweaks to the text (including a comment that describes one of the s [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2012-01-26 16:30:42 -0800 (Thu, 26 Jan 2012)
New Revision: 6924

Modified:
   complete.html
   index
   source
Log:
[e] (0) More tweaks to the text (including a comment that describes one of the situations in question).
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 22:29:18 UTC (rev 6923)
+++ complete.html	2012-01-27 00:30:42 UTC (rev 6924)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 26 January 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 27 January 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -13773,9 +13773,20 @@
     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. <strong>For all these reasons, use of this method is
-    strongly discouraged.</strong></p>
+    exception. To make matters worse, the exact behavior of this
+    method can in some cases be dependent on network latency<!--
 
+     Namely, in the following case:
+
+        <script>
+         document.write('<link rel=stylesheet href=foo.css><script></script>x');
+         // at this point, whether the DOM contains an "x" or not depends on how quickly the foo.css file could be processed
+        </script>
+
+    -->, 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>
+
     <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 22:29:18 UTC (rev 6923)
+++ index	2012-01-27 00:30:42 UTC (rev 6924)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 26 January 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 27 January 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -13773,9 +13773,20 @@
     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. <strong>For all these reasons, use of this method is
-    strongly discouraged.</strong></p>
+    exception. To make matters worse, the exact behavior of this
+    method can in some cases be dependent on network latency<!--
 
+     Namely, in the following case:
+
+        <script>
+         document.write('<link rel=stylesheet href=foo.css><script></script>x');
+         // at this point, whether the DOM contains an "x" or not depends on how quickly the foo.css file could be processed
+        </script>
+
+    -->, 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>
+
     <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 22:29:18 UTC (rev 6923)
+++ source	2012-01-27 00:30:42 UTC (rev 6924)
@@ -14535,9 +14535,20 @@
     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. <strong>For all these reasons, use of this method is
-    strongly discouraged.</strong></p>
+    exception. To make matters worse, the exact behavior of this
+    method can in some cases be dependent on network latency<!--
 
+     Namely, in the following case:
+
+        <script>
+         document.write('<link rel=stylesheet href=foo.css><script></script>x');
+         // at this point, whether the DOM contains an "x" or not depends on how quickly the foo.css file could be processed
+        </script>
+
+    -->, 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>
+
     <p>This method throws an <code>InvalidStateError</code> exception
     when invoked on <span>XML documents</span>.</p>