- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 12 Aug 2010 08:33:42 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2442
Modified Files:
Overview.html
Log Message:
Remove document.async and restrict document.load to createDocument() documents. (whatwg r5285)
Index: Overview.html
===================================================================
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:33:43 UTC