- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 29 Aug 2009 23:46:15 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv12930
Modified Files:
Overview.html
Log Message:
Split document.open() and document.close(). (whatwg r3701)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2879
retrieving revision 1.2880
diff -u -d -r1.2879 -r1.2880
--- Overview.html 29 Aug 2009 23:30:58 -0000 1.2879
+++ Overview.html 29 Aug 2009 23:46:11 -0000 1.2880
@@ -421,12 +421,13 @@
<li><a href="#interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</a></li>
<li><a href="#dynamic-markup-insertion"><span class="secno">3.5 </span>Dynamic markup insertion</a>
<ol>
- <li><a href="#controlling-the-input-stream"><span class="secno">3.5.1 </span>Controlling the input stream</a></li>
- <li><a href="#document.write"><span class="secno">3.5.2 </span><code title="dom-document-write">document.write()</code></a></li>
- <li><a href="#document.writeln"><span class="secno">3.5.3 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
- <li><a href="#innerhtml"><span class="secno">3.5.4 </span><code title="dom-innerHTML">innerHTML</code></a></li>
- <li><a href="#outerhtml"><span class="secno">3.5.5 </span><code title="dom-outerHTML">outerHTML</code></a></li>
- <li><a href="#insertadjacenthtml"><span class="secno">3.5.6 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
+ <li><a href="#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li>
+ <li><a href="#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li>
+ <li><a href="#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li>
+ <li><a href="#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
+ <li><a href="#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
+ <li><a href="#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
+ <li><a href="#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
<li><a href="#semantics"><span class="secno">4 </span>The elements of HTML</a>
<ol>
<li><a href="#the-root-element"><span class="secno">4.1 </span>The root element</a>
@@ -7914,7 +7915,7 @@
<p>To avoid this confusion, explicit <code><a href="#the-p-element">p</a></code> elements can be
used.</p>
- </div><h4 id="annotations-for-assistive-technology-products"><span class="secno">3.2.6 </span><dfn>Annotations for assistive technology products</dfn></h4><p class="XXX annotation"><b>Status: </b><i>First draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/14">ISSUE-14</a> (aria-role) and <a href="http://www.w3.org/html/wg/tracker/issues/35">ISSUE-35</a> (aria-processing) block progress to Last Call</span><p>Authors may use the ARIA <code title="attr-aria-role">role</code>
+ </div><h4 id="annotations-for-assistive-technology-products"><span class="secno">3.2.6 </span><dfn>Annotations for assistive technology products</dfn></h4><p class="XXX annotation"><b>Status: </b><i>First draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/35">ISSUE-35</a> (aria-processing) and <a href="http://www.w3.org/html/wg/tracker/issues/14">ISSUE-14</a> (aria-role) block progress to Last Call</span><p>Authors may use the ARIA <code title="attr-aria-role">role</code>
and <code title="attr-aria-*">aria-*</code> attributes on <a href="#html-elements">HTML
elements</a>, in accordance with the requirements described in
the ARIA specifications, except where these conflict with the
@@ -8330,7 +8331,7 @@
document interact with the parser, and thus their behavior, varies
depending on whether they are used with <a href="#html-documents">HTML documents</a>
(and the <a href="#html-parser">HTML parser</a>) or XHTML in <a href="#xml-documents">XML
- documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="controlling-the-input-stream"><span class="secno">3.5.1 </span>Controlling the input stream</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
+ documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
method comes in several variants with different numbers of
arguments.<dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( [ <var title="">type</var> [, <var title="">replace</var> ] ] )</dt>
@@ -8366,14 +8367,6 @@
</dd>
- <dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
-
- <dd>
-
- <p>Closes the input stream that was opened by the <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> method.</p>
-
- </dd>
-
</dl><div class="impl">
<p>When called with two or fewer arguments, the method must act as
@@ -8522,6 +8515,16 @@
<code><a href="#window">Window</a></code> object, then the method must raise an
<code><a href="#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception.</p>
+ </div><h4 id="closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
+
+ <dd>
+
+ <p>Closes the input stream that was opened by the <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> method.</p>
+
+ </dd>
+
+ </dl><div class="impl">
+
<p>The <dfn id="dom-document-close" title="dom-document-close"><code>close()</code></dfn>
method must do nothing if there is no <a href="#script-created-parser">script-created
parser</a> associated with the document. If there is such a
@@ -8529,7 +8532,7 @@
an <a href="#explicit-eof-character">explicit "EOF" character</a> at the end of the parser's
<a href="#the-input-stream">input stream</a>.</p>
- </div><h4 id="document.write"><span class="secno">3.5.2 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
+ </div><h4 id="document.write"><span class="secno">3.5.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -8610,7 +8613,7 @@
</li>
- </ol></div><h4 id="document.writeln"><span class="secno">3.5.3 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
+ </ol></div><h4 id="document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -8631,7 +8634,7 @@
invoked with the same argument(s), plus an extra argument consisting
of a string containing a single line feed character (U+000A).</p>
- </div><h4 id="innerhtml"><span class="secno">3.5.4 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> DOM
+ </div><h4 id="innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> DOM
attribute represents the markup of the node's contents.<dl class="domintro"><dt><var title="">document</var> . <code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -8741,7 +8744,7 @@
</li>
- </ol></div><h4 id="outerhtml"><span class="secno">3.5.5 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> DOM
+ </ol></div><h4 id="outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> DOM
attribute represents the markup of the element and its contents.<dl class="domintro"><dt><var title="">element</var> . <code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -8842,7 +8845,7 @@
</li>
- </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.5.6 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
+ </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
<dd>
@@ -15339,7 +15342,7 @@
<legend>The castle through the ages: 1423, 1858, and 1999 respectively.</legend>
</figure></pre>
- </div><h4 id="the-img-element"><span class="secno">4.8.2 </span>The <dfn><code>img</code></dfn> element</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/30">ISSUE-30</a> (longdesc) and <a href="http://www.w3.org/html/wg/tracker/issues/66">ISSUE-66</a> (image-analysis) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
+ </div><h4 id="the-img-element"><span class="secno">4.8.2 </span>The <dfn><code>img</code></dfn> element</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/66">ISSUE-66</a> (image-analysis) and <a href="http://www.w3.org/html/wg/tracker/issues/30">ISSUE-30</a> (longdesc) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#embedded-content">Embedded content</a>.</dd>
@@ -17593,7 +17596,7 @@
<a href="#reflect">reflect</a> the respective content attributes of the same
name.</p>
- </div><h4 id="video"><span class="secno">4.8.7 </span>The <dfn><code>video</code></dfn> element</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/9">ISSUE-9</a> (video-synchronization), <a href="http://www.w3.org/html/wg/tracker/issues/10">ISSUE-10</a> (video-smil) and <a href="http://www.w3.org/html/wg/tracker/issues/7">ISSUE-7</a> (video-codecs) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
+ </div><h4 id="video"><span class="secno">4.8.7 </span>The <dfn><code>video</code></dfn> element</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/7">ISSUE-7</a> (video-codecs), <a href="http://www.w3.org/html/wg/tracker/issues/9">ISSUE-9</a> (video-synchronization) and <a href="http://www.w3.org/html/wg/tracker/issues/10">ISSUE-10</a> (video-smil) block progress to Last Call</span><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content">Flow content</a>.</dd>
<dd><a href="#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="#embedded-content">Embedded content</a>.</dd>
@@ -48391,7 +48394,7 @@
<a href="#source-browsing-context">source browsing context</a>.</p>
- <h5 id="hyperlink-auditing"><span class="secno">6.12.2.1 </span><dfn>Hyperlink auditing</dfn></h5><p class="XXX annotation"><b>Status: </b><i>Controversial Working Draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/2">ISSUE-2</a> (PINGUI), <a href="http://www.w3.org/html/wg/tracker/issues/63">ISSUE-63</a> (origin-req-scope) and <a href="http://www.w3.org/html/wg/tracker/issues/1">ISSUE-1</a> (PINGPOST) block progress to Last Call</span></p>
+ <h5 id="hyperlink-auditing"><span class="secno">6.12.2.1 </span><dfn>Hyperlink auditing</dfn></h5><p class="XXX annotation"><b>Status: </b><i>Controversial Working Draft. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/1">ISSUE-1</a> (PINGPOST), <a href="http://www.w3.org/html/wg/tracker/issues/2">ISSUE-2</a> (PINGUI) and <a href="http://www.w3.org/html/wg/tracker/issues/63">ISSUE-63</a> (origin-req-scope) block progress to Last Call</span></p>
<p>If an <code><a href="#the-a-element">a</a></code> or <code><a href="#the-area-element">area</a></code> hyperlink element has a
<code title="attr-hyperlink-ping"><a href="#ping">ping</a></code> attribute, and the
Received on Saturday, 29 August 2009 23:46:24 UTC