hixie: Remove document.async and restrict document.load to createDocument() documents. (whatwg r5285)

hixie: Remove document.async and restrict document.load to
createDocument() documents. (whatwg r5285)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4210&r2=1.4211&f=h
http://html5.org/tools/web-apps-tracker?from=5284&to=5285

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4210
retrieving revision 1.4211
diff -u -d -r1.4210 -r1.4211
--- Overview.html 12 Aug 2010 05:23:03 -0000 1.4210
+++ Overview.html 12 Aug 2010 08:33:38 -0000 1.4211
@@ -7572,53 +7572,56 @@
   <h4 id="loading-xml-documents"><span class="secno">3.1.6 </span>Loading XML documents</h4>
 
   <p>A <code><a href="#document">Document</a></code> object that is an <a href="#xml-documents" title="XML
-  documents">XML document</a> must also implement the
+  documents">XML document</a> that was created by the <code title="dom-DOMImplementation-createDocument"><a href="#dom-domimplementation-createdocument">DOMImplementation.createDocument()</a></code>
+  factory method must also implement the
   <code><a href="#xmldocumentloader">XMLDocumentLoader</a></code> interface:</p>
 
   <pre class="idl">[Supplemental, NoInterfaceObject]
 interface <dfn id="xmldocumentloader">XMLDocumentLoader</dfn> {
-           attribute boolean <a href="#dom-xmldocumentloader-async" title="dom-XMLDocumentLoader-async">async</a>;
-  boolean <a href="#dom-xmldocumentloader-load" title="dom-XMLDocumentLoader-load">load</a>(in DOMString url);
+<!--SYNCLOAD           attribute boolean <span title="dom-XMLDocumentLoader-async">async</span>;
+-->  boolean <a href="#dom-xmldocumentloader-load" title="dom-XMLDocumentLoader-load">load</a>(in DOMString url);
 };</pre>
 
   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/576 -->
   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/577 -->
   <!-- http://www.hixie.ch/tests/adhoc/dom/level0/document/load/001.html -->
 
-  <p>The <dfn id="dom-xmldocumentloader-async" title="dom-XMLDocumentLoader-async"><code>async</code></dfn>
+<!--SYNCLOAD
+  <p>The <dfn
+  title="dom-XMLDocumentLoader-async"><code>async</code></dfn>
   attribute must initially be true. On getting, it must return its
   current value. On setting, its current value must be changed to the
   new value.</p>
-
+-->
   <p>The <dfn id="dom-xmldocumentloader-load" title="dom-XMLDocumentLoader-load"><code>load(<var title="">url</var>)</code></dfn> method must run the following
   steps:</p>
 
-  <ol><li><p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code> is
+  <ol><!--SYNCLOAD
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code> is
    set to false and the <var title="">document</var> is
-   <a href="#load-blocked">load-blocked</a>, return false and abort these
-   steps.</li>
-
-   <li><p>Let <var title="">document</var> be the <code><a href="#document">Document</a></code>
+   <span>load-blocked</span>, return false and abort these
+   steps.</p></li>
+--><li><p>Let <var title="">document</var> be the <code><a href="#document">Document</a></code>
    object on which the method was invoked.</li>
 
    <li><p>If the <a href="#origin">origin</a> of <var title="">url</var> is not
    the same as the <a href="#origin">origin</a> of <var title="">document</var>, throw a <code><a href="#security_err">SECURITY_ERR</a></code>
    exception.</li>
-
-   <li><p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code> is
+<!--SYNCLOAD
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code> is
    set to false, let <var title="">document</var> be
-   <dfn id="load-blocked">load-blocked</dfn>.</li>
-
+   <dfn>load-blocked</dfn>.</p></li>
+-->
    <li><p>Remove all child nodes of <var title="">document</var>,
    without firing any mutation events.</li> <!-- as of 2010-07-26,
    only Opera fired mutation events here. -->
 
    <li><p>Set the <a href="#current-document-readiness">current document readiness</a> of <var title="">document</var> to "loading".</li>
 
-   <li><p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code> is
-   set to true, then run the remainder of these steps asynchronously,
-   and return true from the method. Otherwise, continue running these
-   steps without yet returning.</li>
+   <li><p><!--SYNCLOAD If <code title="dom-XMLDocumentLoader-async">async</code> is
+   set to true, then run--> Run the remainder of these steps asynchronously,
+   and return true from the method.<!--SYNCLOAD Otherwise, continue running these
+   steps without yet returning.--></li>
 
    <li><p>Let <var title="">result</var> be an <code><a href="#document">Document</a></code>
    object.</li>
@@ -7649,9 +7652,9 @@
 
    <li>
 
-    <p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code> is
-    set to true, then <a href="#queue-a-task">queue a task</a> to run the following
-    steps. Otherwise, run them synchronously.</p>
+    <p><!--SYNCLOAD If <code title="dom-XMLDocumentLoader-async">async</code> is
+    set to true, then <span>queue--> <a href="#queue-a-task">Queue a task</a> to run the following
+    steps. <!--SYNCLOAD Otherwise, run them synchronously.--></p>
 
     <ol><li><p>Set the <a href="#current-document-readiness">current document readiness</a> of <var title="">document</var> to "complete".</li>
 
@@ -7670,14 +7673,16 @@
      <li><p><a href="#fire-a-simple-event">Fire a simple event</a> named <code title="event-load">load</code> at <var title="">document</var>.</li>
 
     </ol></li>
+<!--SYNCLOAD
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code>
+   was set to false when this algorithm started, let <var
+   title="">document</var> be no longer
+   <span>load-blocked</span>.</p></li>
 
-   <li><p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code>
-   was set to false when this algorithm started, let <var title="">document</var> be no longer
-   <a href="#load-blocked">load-blocked</a>.</li>
-
-   <li><p>If <code title="dom-XMLDocumentLoader-async"><a href="#dom-xmldocumentloader-async">async</a></code>
-   was set to false when this algorithm started, return <var title="">success</var>.</li>
-
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code>
+   was set to false when this algorithm started, return <var
+   title="">success</var>.</p></li>
+-->
   </ol></div><h3 id="elements"><span class="secno">3.2 </span>Elements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h4 id="semantics-0"><span class="secno">3.2.1 </span>Semantics</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/41">ISSUE-41</a> (Decentralized-extensibility) blocks progress to Last Call</span><p>Elements, attributes, and attribute values in HTML are defined
   (by this specification) to have certain meanings (semantics). For
   example, the <code><a href="#the-ol-element">ol</a></code> element represents an ordered list, and

Received on Thursday, 12 August 2010 08:34:26 UTC