html5/spec Overview.html,1.5521,1.5522

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

Modified Files:
	Overview.html 
Log Message:
More tweaks to the text (including a comment that describes one of the situations in question). (whatwg r6924)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5521
retrieving revision 1.5522
diff -u -d -r1.5521 -r1.5522
--- Overview.html	26 Jan 2012 22:29:23 -0000	1.5521
+++ Overview.html	27 Jan 2012 00:30:46 -0000	1.5522
@@ -320,7 +320,7 @@
 
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id="editor-s-draft-26-january-2012">Editor's Draft 26 January 2012</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-27-january-2012">Editor's Draft 27 January 2012</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -467,7 +467,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 26 January 2012 Editor's Draft.
+  This specification is the 27 January 2012 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
   actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
   group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -11469,8 +11469,10 @@
     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. <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, 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>

Received on Friday, 27 January 2012 00:30:56 UTC