[html5] r5683 - [e] (0) Add DONAV markers wherever navigation happens, to make updating those ca [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Nov 29 14:56:41 PST 2010
Author: ianh
Date: 2010-11-29 14:56:34 -0800 (Mon, 29 Nov 2010)
New Revision: 5683
Modified:
complete.html
index
source
Log:
[e] (0) Add DONAV markers wherever navigation happens, to make updating those cases easier.
Modified: complete.html
===================================================================
--- complete.html 2010-11-15 23:25:55 UTC (rev 5682)
+++ complete.html 2010-11-29 22:56:34 UTC (rev 5683)
@@ -214,7 +214,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1>Web Applications 1.0</h1>
- <h2 class="no-num no-toc">Draft Standard — 15 November 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 29 November 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -13685,17 +13685,15 @@
<code><a href=#meta>meta</a></code> element's <code><a href=#document>Document</a></code>'s
<a href=#browsing-context>browsing context</a> did not have the <a href=#sandboxed-automatic-features-browsing-context-flag>sandboxed
automatic features browsing context flag</a> set when the
- <code><a href=#document>Document</a></code> was created, the user agent <a href=#navigate title=navigate>navigates</a> the <code><a href=#document>Document</a></code>'s
- <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with
- <a href=#replacement-enabled>replacement enabled</a>, and with the
- <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> as the
- <a href=#source-browsing-context>source browsing context</a>.</li>
+ <code><a href=#document>Document</a></code> was created, the user agent <a href=#navigate title=navigate>navigates</a><!--DONAV meta refresh--> the
+ <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with <a href=#replacement-enabled>replacement enabled</a>, and
+ with the <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a>
+ as the <a href=#source-browsing-context>source browsing context</a>.</li>
<li><p>Provide the user with an interface that, when selected,
- <a href=#navigate title=navigate>navigates</a> a <a href=#browsing-context>browsing
- context</a> to <var title="">url</var>, with the document's
- browsing context as the <a href=#source-browsing-context>source browsing
- context</a>.</li>
+ <a href=#navigate title=navigate>navigates</a><!--DONAV meta
+ refresh--> a <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with the document's browsing context as the
+ <a href=#source-browsing-context>source browsing context</a>.</li>
<li><p>Do nothing.</li>
@@ -22295,12 +22293,14 @@
<dl class=switch><dt>If the <code title=attr-iframe-srcdoc><a href=#attr-iframe-srcdoc>srcdoc</a></code> attribute
is specified</dt>
- <dd><p><a href=#navigate>Navigate</a> the element's <a href=#browsing-context>browsing
- context</a> to a resource whose <a href=#content-type>Content-Type</a> is
- <code><a href=#text/html>text/html</a></code>, whose <a href=#url>URL</a> is
- <code><a href=#about:srcdoc>about:srcdoc</a></code>, and whose data consists of the value of
- the attribute. The resulting <code><a href=#document>Document</a></code> must be
- considered <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a>.</dd>
+ <dd><p><a href=#navigate>Navigate</a><!--DONAV iframe--> the element's
+ <a href=#browsing-context>browsing context</a> to a resource whose
+ <a href=#content-type>Content-Type</a> is <code><a href=#text/html>text/html</a></code>, whose
+ <a href=#url>URL</a> is <code><a href=#about:srcdoc>about:srcdoc</a></code>, and whose data
+ consists of the value of the attribute. The resulting
+ <code><a href=#document>Document</a></code> must be considered <a href=#an-iframe-srcdoc-document>an
+ <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code>
+ document</a>.</dd>
<dt>If the <code title=attr-iframe-src><a href=#attr-iframe-src>src</a></code>
attribute is specified but the <code title=attr-iframe-srcdoc><a href=#attr-iframe-srcdoc>srcdoc</a></code> attribute is not</dt>
@@ -22324,8 +22324,8 @@
first time, <code><a href=#about:blank>about:blank</a></code> is loaded
normally.)</li>
- <li><p><a href=#navigate>Navigate</a> the element's <a href=#browsing-context>browsing
- context</a> to the resulting <a href=#absolute-url>absolute
+ <li><p><a href=#navigate>Navigate</a><!--DONAV iframe--> the element's
+ <a href=#browsing-context>browsing context</a> to the resulting <a href=#absolute-url>absolute
URL</a>.</li>
</ol><p><i>Empty</i>: When the steps above require the user agent to
@@ -23771,12 +23771,12 @@
<p>If the <a href=#url>URL</a> of the given resource is not
<code><a href=#about:blank>about:blank</a></code>, the element's <a href=#nested-browsing-context>nested browsing
- context</a> must then be <a href=#navigate title=navigate>navigated</a> to that resource, with
- <a href=#replacement-enabled>replacement enabled</a>, and with the
+ context</a> must then be <a href=#navigate title=navigate>navigated</a><!--DONAV object--> to that
+ resource, with <a href=#replacement-enabled>replacement enabled</a>, and with the
<code><a href=#the-object-element>object</a></code> element's document's <a href=#browsing-context>browsing
- context</a> as the <a href=#source-browsing-context>source browsing
- context</a>. (The <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute of the
- <code><a href=#the-object-element>object</a></code> element doesn't get updated if the
+ context</a> as the <a href=#source-browsing-context>source browsing context</a>.
+ (The <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute of
+ the <code><a href=#the-object-element>object</a></code> element doesn't get updated if the
browsing context gets further navigated to other
locations.)</p>
@@ -31313,9 +31313,9 @@
the translation distance in the horizontal direction and the <var title="">y</var> argument represents the translation distance in the
vertical direction. The arguments are in coordinate space units.</p>
- <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
- <var title="">f</var>)</code></dfn> method must multiply the
- current transformation matrix with the matrix described by:</p>
+ <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</code></dfn> method must replace the current
+ transformation matrix with the result of multiplying the current
+ transformation matrix with the matrix described by:</p>
</div>
@@ -47538,10 +47538,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -47570,19 +47571,18 @@
<dd>Let <var title="">MIME type</var> be "<code title="">text/plain</code>".</dd>
- </dl><p>If <var title="">method</var> is anything but <!--GET or-->
- POST, and the <a href=#origin>origin</a> of <var title="">action</var>
- is not the <a href=#same-origin>same origin</a> as that of the
- <code><a href=#the-form-element>form</a></code> element's <code><a href=#document>Document</a></code>, then abort
- these steps.</p> <!-- CORS, one day -->
+ </dl><!--<p>If <var title="">method</var> is anything but (GET or)
+ POST, and the <span>origin</span> of <var title="">action</var>
+ is not the <span>same origin</span> as that of the
+ <code>form</code> element's <code>Document</code>, then abort
+ these steps.</p> [or do CORS] (this is commented out since only
+ POST can trigger this now, and that's historically
+ unrestricted)--><p>Otherwise, <a href=#navigate>navigate</a><!--DONAV form--> <var title="">target browsing context</var> to <var title="">action</var> using the HTTP method given by <var title="">method</var> and with <var title="">entity body</var>
+ as the entity body, of type <var title="">MIME type</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
- <p>Otherwise, <a href=#navigate>navigate</a> <var title="">target
- browsing context</var> to <var title="">action</var> using the
- HTTP method given by <var title="">method</var> and with <var title="">entity body</var> as the entity body, of type <var title="">MIME type</var>. If <var title="">target browsing
- context</var> was newly created for this purpose by the steps
- above, then it must be navigated with <a href=#replacement-enabled>replacement
- enabled</a>.</p>
-
</dd>
<dt><dfn id=submit-get-action title=submit-get-action>Get action</dfn>
@@ -47591,8 +47591,8 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">action</var>. If <var title="">target browsing context</var> was newly created for
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">action</var>. If <var title="">target browsing context</var> was newly created for
this purpose by the steps above, then it must be navigated with
<a href=#replacement-enabled>replacement enabled</a>.</p>
@@ -47624,8 +47624,8 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to the potentially modified <var title="">action</var>. If <var title="">target browsing
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to the potentially modified <var title="">action</var>. If <var title="">target browsing
context</var> was newly created for this purpose by the steps
above, then it must be navigated with <a href=#replacement-enabled>replacement
enabled</a>.</p>
@@ -47654,10 +47654,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -47687,10 +47688,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -49731,16 +49733,17 @@
the user agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the
<a href=#url>URL</a> given by the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute of that element,
relative to that element, and if that is successful, must
- <a href=#navigate>navigate</a> a <a href=#browsing-context>browsing context</a> to the
- resulting <a href=#absolute-url>absolute URL</a>. In the case of server-side
- image maps, that <a href=#absolute-url>absolute URL</a> must have its
- <var><a href=#hyperlink-suffix>hyperlink suffix</a></var> appended to it before the navigation is
- started.</p>
+ <a href=#navigate>navigate</a><!--DONAV hyperlink--> a <a href=#browsing-context>browsing
+ context</a> to the resulting <a href=#absolute-url>absolute URL</a>. In the
+ case of server-side image maps, that <a href=#absolute-url>absolute URL</a> must
+ have its <var><a href=#hyperlink-suffix>hyperlink suffix</a></var> appended to it before the
+ navigation is started.</p>
<p>If <a href=#resolve-a-url title="resolve a url">resolving</a> the
<a href=#url>URL</a> fails, the user agent may report the error to the
- user in a user-agent-specific manner, may navigate to an error page
- to report the error, or may ignore the error and do nothing.</p>
+ user in a user-agent-specific manner, may
+ <a href=#navigate>navigate</a><!--DONAV hyperlink--> to an error page to
+ report the error, or may ignore the error and do nothing.</p>
<p>If the user indicated a specific <a href=#browsing-context>browsing context</a>
when following the hyperlink, or if the user agent is configured to
@@ -57024,9 +57027,8 @@
no name). The chosen browsing context must be this new browsing
context.</p>
- <p>If it is immediately <a href=#navigate title=navigate>navigated</a>,
- then the navigation will be done with <a href=#replacement-enabled>replacement
- enabled</a>.</dd>
+ <p class=note>If it is immediately <a href=#navigate title=navigate>navigated</a>, then the navigation will be
+ done with <a href=#replacement-enabled>replacement enabled</a>.</dd>
<dt>If the user agent has been configured such that in this
@@ -57379,15 +57381,14 @@
agent could override the selection of the target browsing context to
instead target a new tab.</p>
- <p>Then, the user agent must <a href=#navigate>navigate</a> the selected
- <a href=#browsing-context>browsing context</a> to the <a href=#absolute-url>absolute URL</a> (or
- error) obtained from <a href=#resolve-a-url title="resolve a url">resolving</a>
- <var title="">url</var> earlier. If the <var title="">replace</var>
- is true, then <a href=#replacement-enabled title="replacement enabled">replacement must be
- enabled</a>; otherwise, it must not be enabled unless the
- <a href=#browsing-context>browsing context</a> was just created as part of
- <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing
- context name</a>. The navigation must be done with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
+ <p>Then, the user agent must <a href=#navigate>navigate</a><!--DONAV
+ window.open()--> the selected <a href=#browsing-context>browsing context</a> to the
+ <a href=#absolute-url>absolute URL</a> (or error) obtained from <a href=#resolve-a-url title="resolve a url">resolving</a> <var title="">url</var>
+ earlier. If the <var title="">replace</var> is true or if the
+ <a href=#browsing-context>browsing context</a> was just created as part of <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the
+ rules for choosing a browsing context given a browsing context
+ name</a>, then <a href=#replacement-enabled title="replacement enabled">replacement must
+ be enabled</a>. The navigation must be done with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
<a href=#entry-script>entry script</a> as the <a href=#source-browsing-context>source browsing
context</a>.</p>
@@ -58927,22 +58928,23 @@
<p>When the <dfn id=dom-location-assign title=dom-location-assign><code>assign(<var title="">url</var>)</code></dfn> method is invoked, the UA must
<a href=#resolve-a-url title="resolve a url">resolve</a> the argument, relative to
the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base
- URL</a>, and if that is successful, must <a href=#navigate>navigate</a>
- the <a href=#browsing-context>browsing context</a> to the specified <var title="">url</var>. If the <a href=#browsing-context>browsing context</a>'s
+ URL</a>, and if that is successful, must
+ <a href=#navigate>navigate</a><!--DONAV location.href/assign--> the
+ <a href=#browsing-context>browsing context</a> to the specified <var title="">url</var>. If the <a href=#browsing-context>browsing context</a>'s
<a href=#session-history>session history</a> contains only one
<code><a href=#document>Document</a></code>, and that was the <code><a href=#about:blank>about:blank</a></code>
<code><a href=#document>Document</a></code> created when the <a href=#browsing-context>browsing context</a>
- was created, then the navigation must be done with
- <a href=#replacement-enabled>replacement enabled</a>.</p> <!-- READ ME WHEN EDITING
- THIS: IE and Firefox only seem to treat it that way if the DOM is
- still a virgin DOM; Safari doesn't check that. Thus this might need
- changing if testing shows the IE/Firefox behaviour is required
- here. -->
+ was created, then the navigation must be done with <a href=#replacement-enabled>replacement
+ enabled</a>.</p> <!-- READ ME WHEN EDITING THIS: IE and Firefox
+ only seem to treat it that way if the DOM is still a virgin DOM;
+ Safari doesn't check that. Thus this might need changing if testing
+ shows the IE/Firefox behaviour is required here. -->
<p>When the <dfn id=dom-location-replace title=dom-location-replace><code>replace(<var title="">url</var>)</code></dfn> method is invoked, the UA must
<a href=#resolve-a-url title="resolve a url">resolve</a> the argument, relative to
the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base
- URL</a>, and if that is successful, <a href=#navigate>navigate</a> the
+ URL</a>, and if that is successful,
+ <a href=#navigate>navigate</a><!--DONAV location.replace--> the
<a href=#browsing-context>browsing context</a> to the specified <var title="">url</var> with <a href=#replacement-enabled>replacement enabled</a>.</p>
<p>Navigation for the <code title=dom-location-assign><a href=#dom-location-assign>assign()</a></code> and <code title=dom-location-replace><a href=#dom-location-replace>replace()</a></code> methods must be done
@@ -58975,24 +58977,25 @@
<dt>Otherwise</dt>
- <dd><p><a href=#navigate>Navigate</a> the <a href=#browsing-context>browsing context</a> to
- <a href="#the-document's-current-address">the document's current address</a> with
- <a href=#replacement-enabled>replacement enabled</a>. The <a href=#source-browsing-context>source browsing
- context</a> must be the <a href=#browsing-context>browsing context</a> being
- navigated.</dd> <!-- it appears that document.reload() always
- uses GET and does not, e.g., re-POST. -->
+ <dd><p><a href=#navigate>Navigate</a><!--DONAV location.reload()--> the
+ <a href=#browsing-context>browsing context</a> to <a href="#the-document's-current-address">the document's current
+ address</a> with <a href=#replacement-enabled>replacement enabled</a>. The
+ <a href=#source-browsing-context>source browsing context</a> must be the <a href=#browsing-context>browsing
+ context</a> being navigated.</dd> <!-- it appears that
+ document.reload() always uses GET and does not, e.g., re-POST. -->
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/141 -->
</dl><p>When a user requests that the current page be reloaded through a
- user interface element, the user agent should <a href=#navigate>navigate</a>
- the <a href=#browsing-context>browsing context</a> to the same resource as
- <code><a href=#document>Document</a></code>, with <a href=#replacement-enabled>replacement enabled</a>. In the
- case of non-idempotent methods (e.g. HTTP POST), the user agent
- should prompt the user to confirm the operation first, since
- otherwise transactions (e.g. purchases or database modifications)
- could be repeated. User agents may allow the user to explicitly
- override any caches when reloading.</p>
+ user interface element, the user agent should
+ <a href=#navigate>navigate</a><!--DONAV user reload--> the <a href=#browsing-context>browsing
+ context</a> to the same resource as <code><a href=#document>Document</a></code>, with
+ <a href=#replacement-enabled>replacement enabled</a>. In the case of non-idempotent
+ methods (e.g. HTTP POST), the user agent should prompt the user to
+ confirm the operation first, since otherwise transactions (e.g.
+ purchases or database modifications) could be repeated. User agents
+ may allow the user to explicitly override any caches when
+ reloading.</p>
</div>
@@ -59104,6 +59107,8 @@
in this specification.</p>
<!-- NAVIGATE <dfn>navigate</dfn> -->
+ <!-- For places that _call_ this, as opposed to just referring to
+ it, search for "DONAV" -->
<p>When a browsing context is <dfn id=navigate title=navigate>navigated</dfn>
to a new resource, the user agent must run the following steps:</p>
@@ -59136,9 +59141,10 @@
the new resource in a new <a href=#top-level-browsing-context>top-level browsing context</a>
or in the <a href=#top-level-browsing-context>top-level browsing context</a> of the
<a href=#source-browsing-context>source browsing context</a>, at the user's option, in
- which case the user agent must <a href=#navigate>navigate</a> that
- designated <a href=#top-level-browsing-context>top-level browsing context</a> to the new
- resource as if the user had requested it independently.</p>
+ which case the user agent must <a href=#navigate>navigate</a><!--DONAV
+ sandbox manual load--> that designated <a href=#top-level-browsing-context>top-level browsing
+ context</a> to the new resource as if the user had requested it
+ independently.</p>
</li>
@@ -59946,8 +59952,9 @@
page</a>.</p>
<ol><li><p>If there is no longer a <code><a href=#document>Document</a></code> object for the
- entry in question, the user agent must <a href=#navigate>navigate</a> the
- browsing context to the location for that entry to perform an
+ entry in question, the user agent must
+ <a href=#navigate>navigate</a><!--DONAV history traversal after eviction-->
+ the browsing context to the location for that entry to perform an
<a href=#entry-update>entry update</a> of that entry, and abort these steps. The
"<a href=#navigate>navigate</a>" algorithm reinvokes this "traverse"
algorithm to complete the traversal, at which point there
@@ -64347,11 +64354,13 @@
<li>
- <p><a href=#navigate>Navigate</a> the new <a href=#browsing-context>browsing context</a> to
- the <a href=#absolute-url>absolute URL</a> that resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> <var title="">url</var>
- earlier, with <a href=#replacement-enabled>replacement enabled</a>, and with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
- <a href=#concept-script title=concept-script>script</a> that invoked the method
- as the <a href=#source-browsing-context>source browsing context</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV showModalDialog--> the new
+ <a href=#browsing-context>browsing context</a> to the <a href=#absolute-url>absolute URL</a>
+ that resulted from <a href=#resolve-a-url title="resolve a url">resolving</a>
+ <var title="">url</var> earlier, with <a href=#replacement-enabled>replacement
+ enabled</a>, and with the <a href="#script's-browsing-context" title="script's browsing
+ context">browsing context</a> of the <a href=#concept-script title=concept-script>script</a> that invoked the method as
+ the <a href=#source-browsing-context>source browsing context</a>.</p>
</li>
@@ -64702,10 +64711,10 @@
a url">resolve</a> the resulting URL, relative to the <a href="#script's-base-url" title="script's base URL">base URL</a> of the <a href=#entry-script>entry
script</a> at the time the <code title=dom-navigator-registerContentHandler><a href=#dom-navigator-registercontenthandler>registerContentHandler()</a></code>
or <code title=dom-navigator-registerProtocolHandler><a href=#dom-navigator-registerprotocolhandler>registerProtocolHandler()</a></code>
- methods were invoked, and then <a href=#navigate>navigate</a> an
- appropriate <a href=#browsing-context>browsing context</a> to the resulting URL
- using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or
- equivalent</a> for non-HTTP URLs).</p>
+ methods were invoked, and then <a href=#navigate>navigate</a><!--DONAV
+ user--> an appropriate <a href=#browsing-context>browsing context</a> to the
+ resulting URL using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or equivalent</a> for
+ non-HTTP URLs).</p>
<p>To get the escaped version of the <a href=#absolute-url>absolute URL</a> of
the content in question, the user agent must replace every
@@ -76034,11 +76043,11 @@
convert the input stream to the new encoding, set the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
<i>certain</i>, and abort these steps.</li>
- <li>Otherwise, <a href=#navigate>navigate</a> to the document again, with
- <a href=#replacement-enabled>replacement enabled</a>, and using the same <a href=#source-browsing-context>source
- browsing context</a>, but this time skip the <a href=#encoding-sniffing-algorithm>encoding
- sniffing algorithm</a> and instead just set the encoding to the
- new encoding and the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
+ <li>Otherwise, <a href=#navigate>navigate</a><!--DONAV reparse--> to the
+ document again, with <a href=#replacement-enabled>replacement enabled</a>, and using
+ the same <a href=#source-browsing-context>source browsing context</a>, but this time skip
+ the <a href=#encoding-sniffing-algorithm>encoding sniffing algorithm</a> and instead just set
+ the encoding to the new encoding and the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
<i>certain</i>. Whenever possible, this should be done without
actually contacting the network layer (the bytes should be
re-parsed from memory), even if, e.g., the document is marked as
@@ -86816,9 +86825,9 @@
part of such auditing.</p>
<!--PING-->
- <p>User agents are expected to allow users to <a href=#navigate>navigate</a>
- <a href=#browsing-context title="browsing context">browsing contexts</a> to the
- resources <a href=#resolve-a-url title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href=#the-q-element>q</a></code>,
+ <p>User agents are expected to allow users to
+ <a href=#navigate>navigate</a><!--DONAV cite=""--> <a href=#browsing-context title="browsing
+ context">browsing contexts</a> to the resources <a href=#resolve-a-url title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href=#the-q-element>q</a></code>,
<code><a href=#the-blockquote-element>blockquote</a></code>, <code><a href=#the-section-element>section</a></code>, <code><a href=#the-article-element>article</a></code>,
<code><a href=#the-ins-element>ins</a></code>, and <code><a href=#the-del-element>del</a></code> elements.</p>
@@ -87674,21 +87683,20 @@
<p>When the browsing context is created, if a <code title=attr-frame-src>src</code> attribute is present, the user
agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of
that attribute, relative to the element, and if that is successful,
- must then <a href=#navigate>navigate</a> the element's browsing context to
- the resulting <a href=#absolute-url>absolute URL</a>, with <a href=#replacement-enabled>replacement
- enabled</a>, and with the <code><a href=#frame>frame</a></code> element's
+ must then <a href=#navigate>navigate</a><!--DONAV frame--> the element's
+ browsing context to the resulting <a href=#absolute-url>absolute URL</a>, with
+ <a href=#replacement-enabled>replacement enabled</a>, and with the <code><a href=#frame>frame</a></code>
+ element's document's <a href=#browsing-context>browsing context</a> as the
+ <a href=#source-browsing-context>source browsing context</a>.</p>
+
+ <p>Whenever the <code title=attr-frame-src>src</code> attribute is
+ set, the user agent must <a href=#resolve-a-url title="resolve a url">resolve</a>
+ the value of that attribute, relative to the element, and if that is
+ successful, the nested <a href=#browsing-context>browsing context</a> must be <a href=#navigate title=navigate>navigated</a><!--DONAV frame--> to the resulting
+ <a href=#absolute-url>absolute URL</a>, with the <code><a href=#frame>frame</a></code> element's
document's <a href=#browsing-context>browsing context</a> as the <a href=#source-browsing-context>source
browsing context</a>.</p>
- <p>Whenever the <code title=attr-frame-src>src</code> attribute
- is set, the user agent must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the value of that attribute, relative to the
- element, and if that is successful, the nested <a href=#browsing-context>browsing
- context</a> must be <a href=#navigate title=navigate>navigated</a> to
- the resulting <a href=#absolute-url>absolute URL</a>, with the
- <code><a href=#frame>frame</a></code> element's document's <a href=#browsing-context>browsing
- context</a> as the <a href=#source-browsing-context>source browsing context</a>.</p>
-
<p>When the browsing context is created, if a <code title=attr-frame-name>name</code> attribute is present, the
<a href=#browsing-context-name>browsing context name</a> must be set to the value of this
attribute; otherwise, the <a href=#browsing-context-name>browsing context name</a> must be
Modified: index
===================================================================
--- index 2010-11-15 23:25:55 UTC (rev 5682)
+++ index 2010-11-29 22:56:34 UTC (rev 5683)
@@ -218,7 +218,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1>HTML5 (including next generation additions still in development)</h1>
- <h2 class="no-num no-toc">Draft Standard — 15 November 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 29 November 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -13662,17 +13662,15 @@
<code><a href=#meta>meta</a></code> element's <code><a href=#document>Document</a></code>'s
<a href=#browsing-context>browsing context</a> did not have the <a href=#sandboxed-automatic-features-browsing-context-flag>sandboxed
automatic features browsing context flag</a> set when the
- <code><a href=#document>Document</a></code> was created, the user agent <a href=#navigate title=navigate>navigates</a> the <code><a href=#document>Document</a></code>'s
- <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with
- <a href=#replacement-enabled>replacement enabled</a>, and with the
- <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> as the
- <a href=#source-browsing-context>source browsing context</a>.</li>
+ <code><a href=#document>Document</a></code> was created, the user agent <a href=#navigate title=navigate>navigates</a><!--DONAV meta refresh--> the
+ <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with <a href=#replacement-enabled>replacement enabled</a>, and
+ with the <code><a href=#document>Document</a></code>'s <a href=#browsing-context>browsing context</a>
+ as the <a href=#source-browsing-context>source browsing context</a>.</li>
<li><p>Provide the user with an interface that, when selected,
- <a href=#navigate title=navigate>navigates</a> a <a href=#browsing-context>browsing
- context</a> to <var title="">url</var>, with the document's
- browsing context as the <a href=#source-browsing-context>source browsing
- context</a>.</li>
+ <a href=#navigate title=navigate>navigates</a><!--DONAV meta
+ refresh--> a <a href=#browsing-context>browsing context</a> to <var title="">url</var>, with the document's browsing context as the
+ <a href=#source-browsing-context>source browsing context</a>.</li>
<li><p>Do nothing.</li>
@@ -22272,12 +22270,14 @@
<dl class=switch><dt>If the <code title=attr-iframe-srcdoc><a href=#attr-iframe-srcdoc>srcdoc</a></code> attribute
is specified</dt>
- <dd><p><a href=#navigate>Navigate</a> the element's <a href=#browsing-context>browsing
- context</a> to a resource whose <a href=#content-type>Content-Type</a> is
- <code><a href=#text/html>text/html</a></code>, whose <a href=#url>URL</a> is
- <code><a href=#about:srcdoc>about:srcdoc</a></code>, and whose data consists of the value of
- the attribute. The resulting <code><a href=#document>Document</a></code> must be
- considered <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a>.</dd>
+ <dd><p><a href=#navigate>Navigate</a><!--DONAV iframe--> the element's
+ <a href=#browsing-context>browsing context</a> to a resource whose
+ <a href=#content-type>Content-Type</a> is <code><a href=#text/html>text/html</a></code>, whose
+ <a href=#url>URL</a> is <code><a href=#about:srcdoc>about:srcdoc</a></code>, and whose data
+ consists of the value of the attribute. The resulting
+ <code><a href=#document>Document</a></code> must be considered <a href=#an-iframe-srcdoc-document>an
+ <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code>
+ document</a>.</dd>
<dt>If the <code title=attr-iframe-src><a href=#attr-iframe-src>src</a></code>
attribute is specified but the <code title=attr-iframe-srcdoc><a href=#attr-iframe-srcdoc>srcdoc</a></code> attribute is not</dt>
@@ -22301,8 +22301,8 @@
first time, <code><a href=#about:blank>about:blank</a></code> is loaded
normally.)</li>
- <li><p><a href=#navigate>Navigate</a> the element's <a href=#browsing-context>browsing
- context</a> to the resulting <a href=#absolute-url>absolute
+ <li><p><a href=#navigate>Navigate</a><!--DONAV iframe--> the element's
+ <a href=#browsing-context>browsing context</a> to the resulting <a href=#absolute-url>absolute
URL</a>.</li>
</ol><p><i>Empty</i>: When the steps above require the user agent to
@@ -23751,12 +23751,12 @@
<p>If the <a href=#url>URL</a> of the given resource is not
<code><a href=#about:blank>about:blank</a></code>, the element's <a href=#nested-browsing-context>nested browsing
- context</a> must then be <a href=#navigate title=navigate>navigated</a> to that resource, with
- <a href=#replacement-enabled>replacement enabled</a>, and with the
+ context</a> must then be <a href=#navigate title=navigate>navigated</a><!--DONAV object--> to that
+ resource, with <a href=#replacement-enabled>replacement enabled</a>, and with the
<code><a href=#the-object-element>object</a></code> element's document's <a href=#browsing-context>browsing
- context</a> as the <a href=#source-browsing-context>source browsing
- context</a>. (The <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute of the
- <code><a href=#the-object-element>object</a></code> element doesn't get updated if the
+ context</a> as the <a href=#source-browsing-context>source browsing context</a>.
+ (The <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute of
+ the <code><a href=#the-object-element>object</a></code> element doesn't get updated if the
browsing context gets further navigated to other
locations.)</p>
@@ -31293,9 +31293,9 @@
the translation distance in the horizontal direction and the <var title="">y</var> argument represents the translation distance in the
vertical direction. The arguments are in coordinate space units.</p>
- <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
- <var title="">f</var>)</code></dfn> method must multiply the
- current transformation matrix with the matrix described by:</p>
+ <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</code></dfn> method must replace the current
+ transformation matrix with the result of multiplying the current
+ transformation matrix with the matrix described by:</p>
</div>
@@ -47518,10 +47518,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -47550,19 +47551,18 @@
<dd>Let <var title="">MIME type</var> be "<code title="">text/plain</code>".</dd>
- </dl><p>If <var title="">method</var> is anything but <!--GET or-->
- POST, and the <a href=#origin>origin</a> of <var title="">action</var>
- is not the <a href=#same-origin>same origin</a> as that of the
- <code><a href=#the-form-element>form</a></code> element's <code><a href=#document>Document</a></code>, then abort
- these steps.</p> <!-- CORS, one day -->
+ </dl><!--<p>If <var title="">method</var> is anything but (GET or)
+ POST, and the <span>origin</span> of <var title="">action</var>
+ is not the <span>same origin</span> as that of the
+ <code>form</code> element's <code>Document</code>, then abort
+ these steps.</p> [or do CORS] (this is commented out since only
+ POST can trigger this now, and that's historically
+ unrestricted)--><p>Otherwise, <a href=#navigate>navigate</a><!--DONAV form--> <var title="">target browsing context</var> to <var title="">action</var> using the HTTP method given by <var title="">method</var> and with <var title="">entity body</var>
+ as the entity body, of type <var title="">MIME type</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
- <p>Otherwise, <a href=#navigate>navigate</a> <var title="">target
- browsing context</var> to <var title="">action</var> using the
- HTTP method given by <var title="">method</var> and with <var title="">entity body</var> as the entity body, of type <var title="">MIME type</var>. If <var title="">target browsing
- context</var> was newly created for this purpose by the steps
- above, then it must be navigated with <a href=#replacement-enabled>replacement
- enabled</a>.</p>
-
</dd>
<dt><dfn id=submit-get-action title=submit-get-action>Get action</dfn>
@@ -47571,8 +47571,8 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">action</var>. If <var title="">target browsing context</var> was newly created for
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">action</var>. If <var title="">target browsing context</var> was newly created for
this purpose by the steps above, then it must be navigated with
<a href=#replacement-enabled>replacement enabled</a>.</p>
@@ -47604,8 +47604,8 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to the potentially modified <var title="">action</var>. If <var title="">target browsing
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to the potentially modified <var title="">action</var>. If <var title="">target browsing
context</var> was newly created for this purpose by the steps
above, then it must be navigated with <a href=#replacement-enabled>replacement
enabled</a>.</p>
@@ -47634,10 +47634,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -47667,10 +47668,11 @@
<p>Let <var title="">target browsing context</var> be <a href=#the-form-submission-target-browsing-context>the
form submission target browsing context</a>.</p>
- <p><a href=#navigate>Navigate</a> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <a href=#replacement-enabled>replacement enabled</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <a href=#replacement-enabled>replacement enabled</a>.</p>
</dd>
@@ -49711,16 +49713,17 @@
the user agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the
<a href=#url>URL</a> given by the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute of that element,
relative to that element, and if that is successful, must
- <a href=#navigate>navigate</a> a <a href=#browsing-context>browsing context</a> to the
- resulting <a href=#absolute-url>absolute URL</a>. In the case of server-side
- image maps, that <a href=#absolute-url>absolute URL</a> must have its
- <var><a href=#hyperlink-suffix>hyperlink suffix</a></var> appended to it before the navigation is
- started.</p>
+ <a href=#navigate>navigate</a><!--DONAV hyperlink--> a <a href=#browsing-context>browsing
+ context</a> to the resulting <a href=#absolute-url>absolute URL</a>. In the
+ case of server-side image maps, that <a href=#absolute-url>absolute URL</a> must
+ have its <var><a href=#hyperlink-suffix>hyperlink suffix</a></var> appended to it before the
+ navigation is started.</p>
<p>If <a href=#resolve-a-url title="resolve a url">resolving</a> the
<a href=#url>URL</a> fails, the user agent may report the error to the
- user in a user-agent-specific manner, may navigate to an error page
- to report the error, or may ignore the error and do nothing.</p>
+ user in a user-agent-specific manner, may
+ <a href=#navigate>navigate</a><!--DONAV hyperlink--> to an error page to
+ report the error, or may ignore the error and do nothing.</p>
<p>If the user indicated a specific <a href=#browsing-context>browsing context</a>
when following the hyperlink, or if the user agent is configured to
@@ -57004,9 +57007,8 @@
no name). The chosen browsing context must be this new browsing
context.</p>
- <p>If it is immediately <a href=#navigate title=navigate>navigated</a>,
- then the navigation will be done with <a href=#replacement-enabled>replacement
- enabled</a>.</dd>
+ <p class=note>If it is immediately <a href=#navigate title=navigate>navigated</a>, then the navigation will be
+ done with <a href=#replacement-enabled>replacement enabled</a>.</dd>
<dt>If the user agent has been configured such that in this
@@ -57359,15 +57361,14 @@
agent could override the selection of the target browsing context to
instead target a new tab.</p>
- <p>Then, the user agent must <a href=#navigate>navigate</a> the selected
- <a href=#browsing-context>browsing context</a> to the <a href=#absolute-url>absolute URL</a> (or
- error) obtained from <a href=#resolve-a-url title="resolve a url">resolving</a>
- <var title="">url</var> earlier. If the <var title="">replace</var>
- is true, then <a href=#replacement-enabled title="replacement enabled">replacement must be
- enabled</a>; otherwise, it must not be enabled unless the
- <a href=#browsing-context>browsing context</a> was just created as part of
- <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing
- context name</a>. The navigation must be done with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
+ <p>Then, the user agent must <a href=#navigate>navigate</a><!--DONAV
+ window.open()--> the selected <a href=#browsing-context>browsing context</a> to the
+ <a href=#absolute-url>absolute URL</a> (or error) obtained from <a href=#resolve-a-url title="resolve a url">resolving</a> <var title="">url</var>
+ earlier. If the <var title="">replace</var> is true or if the
+ <a href=#browsing-context>browsing context</a> was just created as part of <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the
+ rules for choosing a browsing context given a browsing context
+ name</a>, then <a href=#replacement-enabled title="replacement enabled">replacement must
+ be enabled</a>. The navigation must be done with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
<a href=#entry-script>entry script</a> as the <a href=#source-browsing-context>source browsing
context</a>.</p>
@@ -58907,22 +58908,23 @@
<p>When the <dfn id=dom-location-assign title=dom-location-assign><code>assign(<var title="">url</var>)</code></dfn> method is invoked, the UA must
<a href=#resolve-a-url title="resolve a url">resolve</a> the argument, relative to
the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base
- URL</a>, and if that is successful, must <a href=#navigate>navigate</a>
- the <a href=#browsing-context>browsing context</a> to the specified <var title="">url</var>. If the <a href=#browsing-context>browsing context</a>'s
+ URL</a>, and if that is successful, must
+ <a href=#navigate>navigate</a><!--DONAV location.href/assign--> the
+ <a href=#browsing-context>browsing context</a> to the specified <var title="">url</var>. If the <a href=#browsing-context>browsing context</a>'s
<a href=#session-history>session history</a> contains only one
<code><a href=#document>Document</a></code>, and that was the <code><a href=#about:blank>about:blank</a></code>
<code><a href=#document>Document</a></code> created when the <a href=#browsing-context>browsing context</a>
- was created, then the navigation must be done with
- <a href=#replacement-enabled>replacement enabled</a>.</p> <!-- READ ME WHEN EDITING
- THIS: IE and Firefox only seem to treat it that way if the DOM is
- still a virgin DOM; Safari doesn't check that. Thus this might need
- changing if testing shows the IE/Firefox behaviour is required
- here. -->
+ was created, then the navigation must be done with <a href=#replacement-enabled>replacement
+ enabled</a>.</p> <!-- READ ME WHEN EDITING THIS: IE and Firefox
+ only seem to treat it that way if the DOM is still a virgin DOM;
+ Safari doesn't check that. Thus this might need changing if testing
+ shows the IE/Firefox behaviour is required here. -->
<p>When the <dfn id=dom-location-replace title=dom-location-replace><code>replace(<var title="">url</var>)</code></dfn> method is invoked, the UA must
<a href=#resolve-a-url title="resolve a url">resolve</a> the argument, relative to
the <a href=#entry-script>entry script</a>'s <a href="#script's-base-url" title="script's base URL">base
- URL</a>, and if that is successful, <a href=#navigate>navigate</a> the
+ URL</a>, and if that is successful,
+ <a href=#navigate>navigate</a><!--DONAV location.replace--> the
<a href=#browsing-context>browsing context</a> to the specified <var title="">url</var> with <a href=#replacement-enabled>replacement enabled</a>.</p>
<p>Navigation for the <code title=dom-location-assign><a href=#dom-location-assign>assign()</a></code> and <code title=dom-location-replace><a href=#dom-location-replace>replace()</a></code> methods must be done
@@ -58955,24 +58957,25 @@
<dt>Otherwise</dt>
- <dd><p><a href=#navigate>Navigate</a> the <a href=#browsing-context>browsing context</a> to
- <a href="#the-document's-current-address">the document's current address</a> with
- <a href=#replacement-enabled>replacement enabled</a>. The <a href=#source-browsing-context>source browsing
- context</a> must be the <a href=#browsing-context>browsing context</a> being
- navigated.</dd> <!-- it appears that document.reload() always
- uses GET and does not, e.g., re-POST. -->
+ <dd><p><a href=#navigate>Navigate</a><!--DONAV location.reload()--> the
+ <a href=#browsing-context>browsing context</a> to <a href="#the-document's-current-address">the document's current
+ address</a> with <a href=#replacement-enabled>replacement enabled</a>. The
+ <a href=#source-browsing-context>source browsing context</a> must be the <a href=#browsing-context>browsing
+ context</a> being navigated.</dd> <!-- it appears that
+ document.reload() always uses GET and does not, e.g., re-POST. -->
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/141 -->
</dl><p>When a user requests that the current page be reloaded through a
- user interface element, the user agent should <a href=#navigate>navigate</a>
- the <a href=#browsing-context>browsing context</a> to the same resource as
- <code><a href=#document>Document</a></code>, with <a href=#replacement-enabled>replacement enabled</a>. In the
- case of non-idempotent methods (e.g. HTTP POST), the user agent
- should prompt the user to confirm the operation first, since
- otherwise transactions (e.g. purchases or database modifications)
- could be repeated. User agents may allow the user to explicitly
- override any caches when reloading.</p>
+ user interface element, the user agent should
+ <a href=#navigate>navigate</a><!--DONAV user reload--> the <a href=#browsing-context>browsing
+ context</a> to the same resource as <code><a href=#document>Document</a></code>, with
+ <a href=#replacement-enabled>replacement enabled</a>. In the case of non-idempotent
+ methods (e.g. HTTP POST), the user agent should prompt the user to
+ confirm the operation first, since otherwise transactions (e.g.
+ purchases or database modifications) could be repeated. User agents
+ may allow the user to explicitly override any caches when
+ reloading.</p>
</div>
@@ -59084,6 +59087,8 @@
in this specification.</p>
<!-- NAVIGATE <dfn>navigate</dfn> -->
+ <!-- For places that _call_ this, as opposed to just referring to
+ it, search for "DONAV" -->
<p>When a browsing context is <dfn id=navigate title=navigate>navigated</dfn>
to a new resource, the user agent must run the following steps:</p>
@@ -59116,9 +59121,10 @@
the new resource in a new <a href=#top-level-browsing-context>top-level browsing context</a>
or in the <a href=#top-level-browsing-context>top-level browsing context</a> of the
<a href=#source-browsing-context>source browsing context</a>, at the user's option, in
- which case the user agent must <a href=#navigate>navigate</a> that
- designated <a href=#top-level-browsing-context>top-level browsing context</a> to the new
- resource as if the user had requested it independently.</p>
+ which case the user agent must <a href=#navigate>navigate</a><!--DONAV
+ sandbox manual load--> that designated <a href=#top-level-browsing-context>top-level browsing
+ context</a> to the new resource as if the user had requested it
+ independently.</p>
</li>
@@ -59926,8 +59932,9 @@
page</a>.</p>
<ol><li><p>If there is no longer a <code><a href=#document>Document</a></code> object for the
- entry in question, the user agent must <a href=#navigate>navigate</a> the
- browsing context to the location for that entry to perform an
+ entry in question, the user agent must
+ <a href=#navigate>navigate</a><!--DONAV history traversal after eviction-->
+ the browsing context to the location for that entry to perform an
<a href=#entry-update>entry update</a> of that entry, and abort these steps. The
"<a href=#navigate>navigate</a>" algorithm reinvokes this "traverse"
algorithm to complete the traversal, at which point there
@@ -64347,11 +64354,13 @@
<li>
- <p><a href=#navigate>Navigate</a> the new <a href=#browsing-context>browsing context</a> to
- the <a href=#absolute-url>absolute URL</a> that resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> <var title="">url</var>
- earlier, with <a href=#replacement-enabled>replacement enabled</a>, and with the <a href="#script's-browsing-context" title="script's browsing context">browsing context</a> of the
- <a href=#concept-script title=concept-script>script</a> that invoked the method
- as the <a href=#source-browsing-context>source browsing context</a>.</p>
+ <p><a href=#navigate>Navigate</a><!--DONAV showModalDialog--> the new
+ <a href=#browsing-context>browsing context</a> to the <a href=#absolute-url>absolute URL</a>
+ that resulted from <a href=#resolve-a-url title="resolve a url">resolving</a>
+ <var title="">url</var> earlier, with <a href=#replacement-enabled>replacement
+ enabled</a>, and with the <a href="#script's-browsing-context" title="script's browsing
+ context">browsing context</a> of the <a href=#concept-script title=concept-script>script</a> that invoked the method as
+ the <a href=#source-browsing-context>source browsing context</a>.</p>
</li>
@@ -64702,10 +64711,10 @@
a url">resolve</a> the resulting URL, relative to the <a href="#script's-base-url" title="script's base URL">base URL</a> of the <a href=#entry-script>entry
script</a> at the time the <code title=dom-navigator-registerContentHandler><a href=#dom-navigator-registercontenthandler>registerContentHandler()</a></code>
or <code title=dom-navigator-registerProtocolHandler><a href=#dom-navigator-registerprotocolhandler>registerProtocolHandler()</a></code>
- methods were invoked, and then <a href=#navigate>navigate</a> an
- appropriate <a href=#browsing-context>browsing context</a> to the resulting URL
- using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or
- equivalent</a> for non-HTTP URLs).</p>
+ methods were invoked, and then <a href=#navigate>navigate</a><!--DONAV
+ user--> an appropriate <a href=#browsing-context>browsing context</a> to the
+ resulting URL using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or equivalent</a> for
+ non-HTTP URLs).</p>
<p>To get the escaped version of the <a href=#absolute-url>absolute URL</a> of
the content in question, the user agent must replace every
@@ -71948,11 +71957,11 @@
convert the input stream to the new encoding, set the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
<i>certain</i>, and abort these steps.</li>
- <li>Otherwise, <a href=#navigate>navigate</a> to the document again, with
- <a href=#replacement-enabled>replacement enabled</a>, and using the same <a href=#source-browsing-context>source
- browsing context</a>, but this time skip the <a href=#encoding-sniffing-algorithm>encoding
- sniffing algorithm</a> and instead just set the encoding to the
- new encoding and the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
+ <li>Otherwise, <a href=#navigate>navigate</a><!--DONAV reparse--> to the
+ document again, with <a href=#replacement-enabled>replacement enabled</a>, and using
+ the same <a href=#source-browsing-context>source browsing context</a>, but this time skip
+ the <a href=#encoding-sniffing-algorithm>encoding sniffing algorithm</a> and instead just set
+ the encoding to the new encoding and the <a href=#concept-encoding-confidence title=concept-encoding-confidence>confidence</a> to
<i>certain</i>. Whenever possible, this should be done without
actually contacting the network layer (the bytes should be
re-parsed from memory), even if, e.g., the document is marked as
@@ -82730,9 +82739,9 @@
part of such auditing.</p>
<!--PING-->
- <p>User agents are expected to allow users to <a href=#navigate>navigate</a>
- <a href=#browsing-context title="browsing context">browsing contexts</a> to the
- resources <a href=#resolve-a-url title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href=#the-q-element>q</a></code>,
+ <p>User agents are expected to allow users to
+ <a href=#navigate>navigate</a><!--DONAV cite=""--> <a href=#browsing-context title="browsing
+ context">browsing contexts</a> to the resources <a href=#resolve-a-url title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href=#the-q-element>q</a></code>,
<code><a href=#the-blockquote-element>blockquote</a></code>, <code><a href=#the-section-element>section</a></code>, <code><a href=#the-article-element>article</a></code>,
<code><a href=#the-ins-element>ins</a></code>, and <code><a href=#the-del-element>del</a></code> elements.</p>
@@ -83588,21 +83597,20 @@
<p>When the browsing context is created, if a <code title=attr-frame-src>src</code> attribute is present, the user
agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of
that attribute, relative to the element, and if that is successful,
- must then <a href=#navigate>navigate</a> the element's browsing context to
- the resulting <a href=#absolute-url>absolute URL</a>, with <a href=#replacement-enabled>replacement
- enabled</a>, and with the <code><a href=#frame>frame</a></code> element's
+ must then <a href=#navigate>navigate</a><!--DONAV frame--> the element's
+ browsing context to the resulting <a href=#absolute-url>absolute URL</a>, with
+ <a href=#replacement-enabled>replacement enabled</a>, and with the <code><a href=#frame>frame</a></code>
+ element's document's <a href=#browsing-context>browsing context</a> as the
+ <a href=#source-browsing-context>source browsing context</a>.</p>
+
+ <p>Whenever the <code title=attr-frame-src>src</code> attribute is
+ set, the user agent must <a href=#resolve-a-url title="resolve a url">resolve</a>
+ the value of that attribute, relative to the element, and if that is
+ successful, the nested <a href=#browsing-context>browsing context</a> must be <a href=#navigate title=navigate>navigated</a><!--DONAV frame--> to the resulting
+ <a href=#absolute-url>absolute URL</a>, with the <code><a href=#frame>frame</a></code> element's
document's <a href=#browsing-context>browsing context</a> as the <a href=#source-browsing-context>source
browsing context</a>.</p>
- <p>Whenever the <code title=attr-frame-src>src</code> attribute
- is set, the user agent must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the value of that attribute, relative to the
- element, and if that is successful, the nested <a href=#browsing-context>browsing
- context</a> must be <a href=#navigate title=navigate>navigated</a> to
- the resulting <a href=#absolute-url>absolute URL</a>, with the
- <code><a href=#frame>frame</a></code> element's document's <a href=#browsing-context>browsing
- context</a> as the <a href=#source-browsing-context>source browsing context</a>.</p>
-
<p>When the browsing context is created, if a <code title=attr-frame-name>name</code> attribute is present, the
<a href=#browsing-context-name>browsing context name</a> must be set to the value of this
attribute; otherwise, the <a href=#browsing-context-name>browsing context name</a> must be
Modified: source
===================================================================
--- source 2010-11-15 23:25:55 UTC (rev 5682)
+++ source 2010-11-29 22:56:34 UTC (rev 5683)
@@ -14437,17 +14437,17 @@
<span>browsing context</span> did not have the <span>sandboxed
automatic features browsing context flag</span> set when the
<code>Document</code> was created, the user agent <span
- title="navigate">navigates</span> the <code>Document</code>'s
- <span>browsing context</span> to <var title="">url</var>, with
- <span>replacement enabled</span>, and with the
- <code>Document</code>'s <span>browsing context</span> as the
- <span>source browsing context</span>.</p></li>
+ title="navigate">navigates</span><!--DONAV meta refresh--> the
+ <code>Document</code>'s <span>browsing context</span> to <var
+ title="">url</var>, with <span>replacement enabled</span>, and
+ with the <code>Document</code>'s <span>browsing context</span>
+ as the <span>source browsing context</span>.</p></li>
<li><p>Provide the user with an interface that, when selected,
- <span title="navigate">navigates</span> a <span>browsing
- context</span> to <var title="">url</var>, with the document's
- browsing context as the <span>source browsing
- context</span>.</p></li>
+ <span title="navigate">navigates</span><!--DONAV meta
+ refresh--> a <span>browsing context</span> to <var
+ title="">url</var>, with the document's browsing context as the
+ <span>source browsing context</span>.</p></li>
<li><p>Do nothing.</p></li>
@@ -23839,13 +23839,14 @@
<dt>If the <code title="attr-iframe-srcdoc">srcdoc</code> attribute
is specified</dt>
- <dd><p><span>Navigate</span> the element's <span>browsing
- context</span> to a resource whose <span>Content-Type</span> is
- <code>text/html</code>, whose <span>URL</span> is
- <code>about:srcdoc</code>, and whose data consists of the value of
- the attribute. The resulting <code>Document</code> must be
- considered <span>an <code>iframe</code> <code
- title="attr-iframe-srcdoc">srcdoc</code> document</span>.</p></dd>
+ <dd><p><span>Navigate</span><!--DONAV iframe--> the element's
+ <span>browsing context</span> to a resource whose
+ <span>Content-Type</span> is <code>text/html</code>, whose
+ <span>URL</span> is <code>about:srcdoc</code>, and whose data
+ consists of the value of the attribute. The resulting
+ <code>Document</code> must be considered <span>an
+ <code>iframe</code> <code title="attr-iframe-srcdoc">srcdoc</code>
+ document</span>.</p></dd>
<dt>If the <code title="attr-iframe-src">src</code>
attribute is specified but the <code
@@ -23874,8 +23875,8 @@
first time, <code>about:blank</code> is loaded
normally.)</p></li>
- <li><p><span>Navigate</span> the element's <span>browsing
- context</span> to the resulting <span>absolute
+ <li><p><span>Navigate</span><!--DONAV iframe--> the element's
+ <span>browsing context</span> to the resulting <span>absolute
URL</span>.</p></li>
</ol>
@@ -25512,13 +25513,12 @@
<p>If the <span>URL</span> of the given resource is not
<code>about:blank</code>, the element's <span>nested browsing
context</span> must then be <span
- title="navigate">navigated</span> to that resource, with
- <span>replacement enabled</span>, and with the
+ title="navigate">navigated</span><!--DONAV object--> to that
+ resource, with <span>replacement enabled</span>, and with the
<code>object</code> element's document's <span>browsing
- context</span> as the <span>source browsing
- context</span>. (The <code
- title="attr-object-data">data</code> attribute of the
- <code>object</code> element doesn't get updated if the
+ context</span> as the <span>source browsing context</span>.
+ (The <code title="attr-object-data">data</code> attribute of
+ the <code>object</code> element doesn't get updated if the
browsing context gets further navigated to other
locations.)</p>
@@ -34374,10 +34374,11 @@
vertical direction. The arguments are in coordinate space units.</p>
<p>The <dfn title="dom-context-2d-transform"><code>transform(<var
- title="">a</var>, <var title="">b</var>, <var
- title="">c</var>, <var title="">d</var>, <var title="">e</var>,
- <var title="">f</var>)</code></dfn> method must multiply the
- current transformation matrix with the matrix described by:</p>
+ title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var
+ title="">d</var>, <var title="">e</var>, <var
+ title="">f</var>)</code></dfn> method must replace the current
+ transformation matrix with the result of multiplying the current
+ transformation matrix with the matrix described by:</p>
</div>
@@ -53431,11 +53432,11 @@
<p>Let <var title="">target browsing context</var> be <span>the
form submission target browsing context</span>.</p>
- <p><span>Navigate</span> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var
- title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <span>replacement enabled</span>.</p>
+ <p><span>Navigate</span><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <span>replacement enabled</span>.</p>
</dd>
@@ -53470,20 +53471,22 @@
</dl>
- <p>If <var title="">method</var> is anything but <!--GET or-->
+ <!--<p>If <var title="">method</var> is anything but (GET or)
POST, and the <span>origin</span> of <var title="">action</var>
is not the <span>same origin</span> as that of the
<code>form</code> element's <code>Document</code>, then abort
- these steps.</p> <!-- CORS, one day -->
+ these steps.</p> [or do CORS] (this is commented out since only
+ POST can trigger this now, and that's historically
+ unrestricted)-->
- <p>Otherwise, <span>navigate</span> <var title="">target
- browsing context</var> to <var title="">action</var> using the
- HTTP method given by <var title="">method</var> and with <var
- title="">entity body</var> as the entity body, of type <var
- title="">MIME type</var>. If <var title="">target browsing
- context</var> was newly created for this purpose by the steps
- above, then it must be navigated with <span>replacement
- enabled</span>.</p>
+ <p>Otherwise, <span>navigate</span><!--DONAV form--> <var
+ title="">target browsing context</var> to <var
+ title="">action</var> using the HTTP method given by <var
+ title="">method</var> and with <var title="">entity body</var>
+ as the entity body, of type <var title="">MIME type</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <span>replacement enabled</span>.</p>
</dd>
@@ -53493,8 +53496,8 @@
<p>Let <var title="">target browsing context</var> be <span>the
form submission target browsing context</span>.</p>
- <p><span>Navigate</span> <var title="">target browsing
- context</var> to <var title="">action</var>. If <var
+ <p><span>Navigate</span><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">action</var>. If <var
title="">target browsing context</var> was newly created for
this purpose by the steps above, then it must be navigated with
<span>replacement enabled</span>.</p>
@@ -53534,8 +53537,8 @@
<p>Let <var title="">target browsing context</var> be <span>the
form submission target browsing context</span>.</p>
- <p><span>Navigate</span> <var title="">target browsing
- context</var> to the potentially modified <var
+ <p><span>Navigate</span><!--DONAV form--> <var title="">target
+ browsing context</var> to the potentially modified <var
title="">action</var>. If <var title="">target browsing
context</var> was newly created for this purpose by the steps
above, then it must be navigated with <span>replacement
@@ -53570,11 +53573,11 @@
<p>Let <var title="">target browsing context</var> be <span>the
form submission target browsing context</span>.</p>
- <p><span>Navigate</span> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var
- title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <span>replacement enabled</span>.</p>
+ <p><span>Navigate</span><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <span>replacement enabled</span>.</p>
</dd>
@@ -53606,11 +53609,11 @@
<p>Let <var title="">target browsing context</var> be <span>the
form submission target browsing context</span>.</p>
- <p><span>Navigate</span> <var title="">target browsing
- context</var> to <var title="">destination</var>. If <var
- title="">target browsing context</var> was newly created for
- this purpose by the steps above, then it must be navigated with
- <span>replacement enabled</span>.</p>
+ <p><span>Navigate</span><!--DONAV form--> <var title="">target
+ browsing context</var> to <var title="">destination</var>. If
+ <var title="">target browsing context</var> was newly created
+ for this purpose by the steps above, then it must be navigated
+ with <span>replacement enabled</span>.</p>
</dd>
@@ -55988,16 +55991,17 @@
<span>URL</span> given by the <code
title="attr-hyperlink-href">href</code> attribute of that element,
relative to that element, and if that is successful, must
- <span>navigate</span> a <span>browsing context</span> to the
- resulting <span>absolute URL</span>. In the case of server-side
- image maps, that <span>absolute URL</span> must have its
- <var>hyperlink suffix</var> appended to it before the navigation is
- started.</p>
+ <span>navigate</span><!--DONAV hyperlink--> a <span>browsing
+ context</span> to the resulting <span>absolute URL</span>. In the
+ case of server-side image maps, that <span>absolute URL</span> must
+ have its <var>hyperlink suffix</var> appended to it before the
+ navigation is started.</p>
<p>If <span title="resolve a url">resolving</span> the
<span>URL</span> fails, the user agent may report the error to the
- user in a user-agent-specific manner, may navigate to an error page
- to report the error, or may ignore the error and do nothing.</p>
+ user in a user-agent-specific manner, may
+ <span>navigate</span><!--DONAV hyperlink--> to an error page to
+ report the error, or may ignore the error and do nothing.</p>
<p>If the user indicated a specific <span>browsing context</span>
when following the hyperlink, or if the user agent is configured to
@@ -64788,9 +64792,9 @@
no name). The chosen browsing context must be this new browsing
context.</p>
- <p>If it is immediately <span title="navigate">navigated</span>,
- then the navigation will be done with <span>replacement
- enabled</span>.</p></dd>
+ <p class="note">If it is immediately <span
+ title="navigate">navigated</span>, then the navigation will be
+ done with <span>replacement enabled</span>.</p></dd>
<dt>If the user agent has been configured such that in this
@@ -65169,15 +65173,15 @@
agent could override the selection of the target browsing context to
instead target a new tab.</p>
- <p>Then, the user agent must <span>navigate</span> the selected
- <span>browsing context</span> to the <span>absolute URL</span> (or
- error) obtained from <span title="resolve a url">resolving</span>
- <var title="">url</var> earlier. If the <var title="">replace</var>
- is true, then <span title="replacement enabled">replacement must be
- enabled</span>; otherwise, it must not be enabled unless the
- <span>browsing context</span> was just created as part of
- <span>the rules for choosing a browsing context given a browsing
- context name</span>. The navigation must be done with the <span
+ <p>Then, the user agent must <span>navigate</span><!--DONAV
+ window.open()--> the selected <span>browsing context</span> to the
+ <span>absolute URL</span> (or error) obtained from <span
+ title="resolve a url">resolving</span> <var title="">url</var>
+ earlier. If the <var title="">replace</var> is true or if the
+ <span>browsing context</span> was just created as part of <span>the
+ rules for choosing a browsing context given a browsing context
+ name</span>, then <span title="replacement enabled">replacement must
+ be enabled</span>. The navigation must be done with the <span
title="script's browsing context">browsing context</span> of the
<span>entry script</span> as the <span>source browsing
context</span>.</p>
@@ -66939,24 +66943,25 @@
title="">url</var>)</code></dfn> method is invoked, the UA must
<span title="resolve a url">resolve</span> the argument, relative to
the <span>entry script</span>'s <span title="script's base URL">base
- URL</span>, and if that is successful, must <span>navigate</span>
- the <span>browsing context</span> to the specified <var
+ URL</span>, and if that is successful, must
+ <span>navigate</span><!--DONAV location.href/assign--> the
+ <span>browsing context</span> to the specified <var
title="">url</var>. If the <span>browsing context</span>'s
<span>session history</span> contains only one
<code>Document</code>, and that was the <code>about:blank</code>
<code>Document</code> created when the <span>browsing context</span>
- was created, then the navigation must be done with
- <span>replacement enabled</span>.</p> <!-- READ ME WHEN EDITING
- THIS: IE and Firefox only seem to treat it that way if the DOM is
- still a virgin DOM; Safari doesn't check that. Thus this might need
- changing if testing shows the IE/Firefox behaviour is required
- here. -->
+ was created, then the navigation must be done with <span>replacement
+ enabled</span>.</p> <!-- READ ME WHEN EDITING THIS: IE and Firefox
+ only seem to treat it that way if the DOM is still a virgin DOM;
+ Safari doesn't check that. Thus this might need changing if testing
+ shows the IE/Firefox behaviour is required here. -->
<p>When the <dfn title="dom-location-replace"><code>replace(<var
title="">url</var>)</code></dfn> method is invoked, the UA must
<span title="resolve a url">resolve</span> the argument, relative to
the <span>entry script</span>'s <span title="script's base URL">base
- URL</span>, and if that is successful, <span>navigate</span> the
+ URL</span>, and if that is successful,
+ <span>navigate</span><!--DONAV location.replace--> the
<span>browsing context</span> to the specified <var
title="">url</var> with <span>replacement enabled</span>.</p>
@@ -66999,26 +67004,27 @@
<dt>Otherwise</dt>
- <dd><p><span>Navigate</span> the <span>browsing context</span> to
- <span>the document's current address</span> with
- <span>replacement enabled</span>. The <span>source browsing
- context</span> must be the <span>browsing context</span> being
- navigated.</p></dd> <!-- it appears that document.reload() always
- uses GET and does not, e.g., re-POST. -->
+ <dd><p><span>Navigate</span><!--DONAV location.reload()--> the
+ <span>browsing context</span> to <span>the document's current
+ address</span> with <span>replacement enabled</span>. The
+ <span>source browsing context</span> must be the <span>browsing
+ context</span> being navigated.</p></dd> <!-- it appears that
+ document.reload() always uses GET and does not, e.g., re-POST. -->
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/141 -->
</dl>
<p>When a user requests that the current page be reloaded through a
- user interface element, the user agent should <span>navigate</span>
- the <span>browsing context</span> to the same resource as
- <code>Document</code>, with <span>replacement enabled</span>. In the
- case of non-idempotent methods (e.g. HTTP POST), the user agent
- should prompt the user to confirm the operation first, since
- otherwise transactions (e.g. purchases or database modifications)
- could be repeated. User agents may allow the user to explicitly
- override any caches when reloading.</p>
+ user interface element, the user agent should
+ <span>navigate</span><!--DONAV user reload--> the <span>browsing
+ context</span> to the same resource as <code>Document</code>, with
+ <span>replacement enabled</span>. In the case of non-idempotent
+ methods (e.g. HTTP POST), the user agent should prompt the user to
+ confirm the operation first, since otherwise transactions (e.g.
+ purchases or database modifications) could be repeated. User agents
+ may allow the user to explicitly override any caches when
+ reloading.</p>
</div>
@@ -67152,6 +67158,8 @@
in this specification.</p>
<!-- NAVIGATE <dfn>navigate</dfn> -->
+ <!-- For places that _call_ this, as opposed to just referring to
+ it, search for "DONAV" -->
<p>When a browsing context is <dfn title="navigate">navigated</dfn>
to a new resource, the user agent must run the following steps:</p>
@@ -67187,9 +67195,10 @@
the new resource in a new <span>top-level browsing context</span>
or in the <span>top-level browsing context</span> of the
<span>source browsing context</span>, at the user's option, in
- which case the user agent must <span>navigate</span> that
- designated <span>top-level browsing context</span> to the new
- resource as if the user had requested it independently.</p>
+ which case the user agent must <span>navigate</span><!--DONAV
+ sandbox manual load--> that designated <span>top-level browsing
+ context</span> to the new resource as if the user had requested it
+ independently.</p>
</li>
@@ -68094,8 +68103,9 @@
<ol>
<li><p>If there is no longer a <code>Document</code> object for the
- entry in question, the user agent must <span>navigate</span> the
- browsing context to the location for that entry to perform an
+ entry in question, the user agent must
+ <span>navigate</span><!--DONAV history traversal after eviction-->
+ the browsing context to the location for that entry to perform an
<span>entry update</span> of that entry, and abort these steps. The
"<span>navigate</span>" algorithm reinvokes this "traverse"
algorithm to complete the traversal, at which point there
@@ -73292,13 +73302,14 @@
<li>
- <p><span>Navigate</span> the new <span>browsing context</span> to
- the <span>absolute URL</span> that resulted from <span
- title="resolve a url">resolving</span> <var title="">url</var>
- earlier, with <span>replacement enabled</span>, and with the <span
- title="script's browsing context">browsing context</span> of the
- <span title="concept-script">script</span> that invoked the method
- as the <span>source browsing context</span>.</p>
+ <p><span>Navigate</span><!--DONAV showModalDialog--> the new
+ <span>browsing context</span> to the <span>absolute URL</span>
+ that resulted from <span title="resolve a url">resolving</span>
+ <var title="">url</var> earlier, with <span>replacement
+ enabled</span>, and with the <span title="script's browsing
+ context">browsing context</span> of the <span
+ title="concept-script">script</span> that invoked the method as
+ the <span>source browsing context</span>.</p>
</li>
@@ -73687,10 +73698,11 @@
title="dom-navigator-registerContentHandler">registerContentHandler()</code>
or <code
title="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code>
- methods were invoked, and then <span>navigate</span> an
- appropriate <span>browsing context</span> to the resulting URL
- using the GET method (<span title="concept-http-equivalent-get">or
- equivalent</span> for non-HTTP URLs).</p>
+ methods were invoked, and then <span>navigate</span><!--DONAV
+ user--> an appropriate <span>browsing context</span> to the
+ resulting URL using the GET method (<span
+ title="concept-http-equivalent-get">or equivalent</span> for
+ non-HTTP URLs).</p>
<p>To get the escaped version of the <span>absolute URL</span> of
the content in question, the user agent must replace every
@@ -87256,11 +87268,11 @@
title="concept-encoding-confidence">confidence</span> to
<i>certain</i>, and abort these steps.</li>
- <li>Otherwise, <span>navigate</span> to the document again, with
- <span>replacement enabled</span>, and using the same <span>source
- browsing context</span>, but this time skip the <span>encoding
- sniffing algorithm</span> and instead just set the encoding to the
- new encoding and the <span
+ <li>Otherwise, <span>navigate</span><!--DONAV reparse--> to the
+ document again, with <span>replacement enabled</span>, and using
+ the same <span>source browsing context</span>, but this time skip
+ the <span>encoding sniffing algorithm</span> and instead just set
+ the encoding to the new encoding and the <span
title="concept-encoding-confidence">confidence</span> to
<i>certain</i>. Whenever possible, this should be done without
actually contacting the network layer (the bytes should be
@@ -99507,9 +99519,10 @@
part of such auditing.</p>
<!--START w3c-html--><!--PING-->
- <p>User agents are expected to allow users to <span>navigate</span>
- <span title="browsing context">browsing contexts</span> to the
- resources <span title="resolve a url">indicated</span> by the <code
+ <p>User agents are expected to allow users to
+ <span>navigate</span><!--DONAV cite=""--> <span title="browsing
+ context">browsing contexts</span> to the resources <span
+ title="resolve a url">indicated</span> by the <code
title="">cite</code> attributes on <code>q</code>,
<code>blockquote</code>, <code>section</code>, <code>article</code>,
<code>ins</code>, and <code>del</code> elements.</p>
@@ -100518,21 +100531,21 @@
title="attr-frame-src">src</code> attribute is present, the user
agent must <span title="resolve a url">resolve</span> the value of
that attribute, relative to the element, and if that is successful,
- must then <span>navigate</span> the element's browsing context to
- the resulting <span>absolute URL</span>, with <span>replacement
- enabled</span>, and with the <code>frame</code> element's
+ must then <span>navigate</span><!--DONAV frame--> the element's
+ browsing context to the resulting <span>absolute URL</span>, with
+ <span>replacement enabled</span>, and with the <code>frame</code>
+ element's document's <span>browsing context</span> as the
+ <span>source browsing context</span>.</p>
+
+ <p>Whenever the <code title="attr-frame-src">src</code> attribute is
+ set, the user agent must <span title="resolve a url">resolve</span>
+ the value of that attribute, relative to the element, and if that is
+ successful, the nested <span>browsing context</span> must be <span
+ title="navigate">navigated</span><!--DONAV frame--> to the resulting
+ <span>absolute URL</span>, with the <code>frame</code> element's
document's <span>browsing context</span> as the <span>source
browsing context</span>.</p>
- <p>Whenever the <code title="attr-frame-src">src</code> attribute
- is set, the user agent must <span title="resolve a
- url">resolve</span> the value of that attribute, relative to the
- element, and if that is successful, the nested <span>browsing
- context</span> must be <span title="navigate">navigated</span> to
- the resulting <span>absolute URL</span>, with the
- <code>frame</code> element's document's <span>browsing
- context</span> as the <span>source browsing context</span>.</p>
-
<p>When the browsing context is created, if a <code
title="attr-frame-name">name</code> attribute is present, the
<span>browsing context name</span> must be set to the value of this
More information about the Commit-Watchers
mailing list