[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