Skip to content

Commit

Permalink
[e] (0) Fix terminology around the concept of an 'active parser'.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@3259 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jun 15, 2009
1 parent 707305a commit b234c33
Show file tree
Hide file tree
Showing 2 changed files with 52 additions and 42 deletions.
47 changes: 26 additions & 21 deletions index
View file
Expand Up @@ -6589,6 +6589,11 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
simple event</a> called <code title=event-readystatechange>readystatechange</code> at the
<code>Document</code> object.</p>

<p>A <code>Document</code> is said to have an <dfn id=active-parser>active
parser</dfn> if it is associated with an <a href=#html-parser>HTML parser</a> or
an <a href=#xml-parser>XML parser</a> that has not yet been <a href=#stop-parsing title="stop
parsing">stopped</a> or aborted.</p>

<p>The <dfn id=dom-document-readystate title=dom-document-readyState><code>readyState</code></dfn> DOM
attribute must, on getting, return the <a href=#current-document-readiness>current document
readiness</a>.</p>
Expand Down Expand Up @@ -8527,13 +8532,13 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0

<li>

<p>If the document has an <span>active parser</span><!-- XXX xref
--> that isn't a <a href=#script-created-parser>script-created parser</a>, and the
<a href=#insertion-point>insertion point</a> associated with that parser's
<a href=#the-input-stream>input stream</a> is not undefined (that is, it
<em>does</em> point to somewhere in the input stream), then the
method does nothing. Abort these steps and return the
<code>Document</code> object on which the method was invoked.</p>
<p>If the document has an <a href=#active-parser>active parser</a> that isn't a
<a href=#script-created-parser>script-created parser</a>, and the <a href=#insertion-point>insertion
point</a> associated with that parser's <a href=#the-input-stream>input
stream</a> is not undefined (that is, it <em>does</em> point to
somewhere in the input stream), then the method does
nothing. Abort these steps and return the <code>Document</code>
object on which the method was invoked.</p>

<p class=note>This basically causes <code title=dom-document-open><a href=#dom-document-open>document.open()</a></code> to be ignored
when it's called in an inline script found during the parsing of
Expand Down Expand Up @@ -8563,12 +8568,12 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0

-->

<li><p>If the document has an <span>active parser</span><!--XXX
xref-->, then stop that parser, and throw away any pending content
in the input stream. <span class=XXX>what about if it
doesn't, because it's either like a text/plain, or Atom, or PDF, or
XHTML, or image document, or something?</span></li><!-- XXX see
also innerHTML in HTML -->
<li><p>If the document has an <a href=#active-parser>active parser</a>, then
abort that parser, and throw away any pending content in the input
stream. <span class=XXX>what about if it doesn't, because it's
either like a text/plain, or Atom, or PDF, or XHTML, or image
document, or something?</span></li><!-- XXX see also innerHTML
in HTML -->

<li><p>Unregister all event listeners registered on the
<code>Document</code> node and its descendants.</p>
Expand Down Expand Up @@ -8870,8 +8875,8 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0
<li>

<p>If the attribute is being set on a <code>Document</code> node,
and that document has an active <a href=#html-parser>HTML parser</a> or
<a href=#xml-parser>XML parser</a>, then stop that parser.</p>
and that document has an <a href=#active-parser>active parser</a>, then abort
that parser.</p>

<p class=XXX>what about if it doesn't, because it's either
like a text/plain, or Atom, or PDF, or XHTML, or image document,
Expand Down Expand Up @@ -17865,12 +17870,12 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
then the user agent must <a href=#fire-a-simple-event>fire a simple event</a> called
<code title=event-error><a href=#event-error>error</a></code> at the element instead.</p>

<p>When there is an active parser in the <code><a href=#the-iframe-element>iframe</a></code>, and
when anything in the <code><a href=#the-iframe-element>iframe</a></code> is <a href=#delay-the-load-event title="delay the
load event">delaying the load event</a> of the
<code><a href=#the-iframe-element>iframe</a></code>'s <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
document</a>, the <code><a href=#the-iframe-element>iframe</a></code> must <a href=#delay-the-load-event>delay the load
event</a> of its document.</p>
<p>When there is an <a href=#active-parser>active parser</a> in the
<code><a href=#the-iframe-element>iframe</a></code>, and when anything in the <code><a href=#the-iframe-element>iframe</a></code> is
<a href=#delay-the-load-event title="delay the load event">delaying the load event</a> of
the <code><a href=#the-iframe-element>iframe</a></code>'s <a href=#browsing-context>browsing context</a>'s
<a href=#active-document>active document</a>, the <code><a href=#the-iframe-element>iframe</a></code> must
<a href=#delay-the-load-event>delay the load event</a> of its document.</p>

<p class=note>If, during the handling of the <code title=event-load><a href=#event-load>load</a></code> event, the <a href=#browsing-context>browsing
context</a> in the <code><a href=#the-iframe-element>iframe</a></code> is again <a href=#navigate title=navigate>navigated</a>, that will further <a href=#delay-the-load-event>delay the
Expand Down
47 changes: 26 additions & 21 deletions source
View file
Expand Up @@ -6514,6 +6514,11 @@ interface <dfn>HTMLDocument</dfn> {
title="event-readystatechange">readystatechange</code> at the
<code>Document</code> object.</p>

<p>A <code>Document</code> is said to have an <dfn>active
parser</dfn> if it is associated with an <span>HTML parser</span> or
an <span>XML parser</span> that has not yet been <span title="stop
parsing">stopped</span> or aborted.</p>

<p>The <dfn
title="dom-document-readyState"><code>readyState</code></dfn> DOM
attribute must, on getting, return the <span>current document
Expand Down Expand Up @@ -8674,13 +8679,13 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0

<li>

<p>If the document has an <span>active parser</span><!-- XXX xref
--> that isn't a <span>script-created parser</span>, and the
<span>insertion point</span> associated with that parser's
<span>input stream</span> is not undefined (that is, it
<em>does</em> point to somewhere in the input stream), then the
method does nothing. Abort these steps and return the
<code>Document</code> object on which the method was invoked.</p>
<p>If the document has an <span>active parser</span> that isn't a
<span>script-created parser</span>, and the <span>insertion
point</span> associated with that parser's <span>input
stream</span> is not undefined (that is, it <em>does</em> point to
somewhere in the input stream), then the method does
nothing. Abort these steps and return the <code>Document</code>
object on which the method was invoked.</p>

<p class="note">This basically causes <code
title="dom-document-open">document.open()</code> to be ignored
Expand Down Expand Up @@ -8711,12 +8716,12 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0

-->

<li><p>If the document has an <span>active parser</span><!--XXX
xref-->, then stop that parser, and throw away any pending content
in the input stream. <span class="XXX">what about if it
doesn't, because it's either like a text/plain, or Atom, or PDF, or
XHTML, or image document, or something?</span></p></li><!-- XXX see
also innerHTML in HTML -->
<li><p>If the document has an <span>active parser</span>, then
abort that parser, and throw away any pending content in the input
stream. <span class="XXX">what about if it doesn't, because it's
either like a text/plain, or Atom, or PDF, or XHTML, or image
document, or something?</span></p></li><!-- XXX see also innerHTML
in HTML -->

<li><p>Unregister all event listeners registered on the
<code>Document</code> node and its descendants.</p>
Expand Down Expand Up @@ -9060,8 +9065,8 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%0
<li>

<p>If the attribute is being set on a <code>Document</code> node,
and that document has an active <span>HTML parser</span> or
<span>XML parser</span>, then stop that parser.</p>
and that document has an <span>active parser</span>, then abort
that parser.</p>

<p class="XXX">what about if it doesn't, because it's either
like a text/plain, or Atom, or PDF, or XHTML, or image document,
Expand Down Expand Up @@ -18997,12 +19002,12 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
then the user agent must <span>fire a simple event</span> called
<code title="event-error">error</code> at the element instead.</p>

<p>When there is an active parser in the <code>iframe</code>, and
when anything in the <code>iframe</code> is <span title="delay the
load event">delaying the load event</span> of the
<code>iframe</code>'s <span>browsing context</span>'s <span>active
document</span>, the <code>iframe</code> must <span>delay the load
event</span> of its document.</p>
<p>When there is an <span>active parser</span> in the
<code>iframe</code>, and when anything in the <code>iframe</code> is
<span title="delay the load event">delaying the load event</span> of
the <code>iframe</code>'s <span>browsing context</span>'s
<span>active document</span>, the <code>iframe</code> must
<span>delay the load event</span> of its document.</p>

<p class="note">If, during the handling of the <code
title="event-load">load</code> event, the <span>browsing
Expand Down

0 comments on commit b234c33

Please sign in to comment.