[html5] r8365 - [giow] (1) Define the source browsing context for location.reload(), though it's [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Dec 18 10:36:34 PST 2013


Author: ianh
Date: 2013-12-18 10:36:32 -0800 (Wed, 18 Dec 2013)
New Revision: 8365

Modified:
   complete.html
   index
   source
Log:
[giow] (1) Define the source browsing context for location.reload(), though it's mostly academic.
Affected topics: DOM APIs, HTML

Modified: complete.html
===================================================================
--- complete.html	2013-12-17 22:14:14 UTC (rev 8364)
+++ complete.html	2013-12-18 18:36:32 UTC (rev 8365)
@@ -298,7 +298,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 17 December 2013</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 18 December 2013</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -8413,7 +8413,8 @@
   set, the <code><a href=#document>Document</a></code> also has a <dfn id=reload-override-buffer>reload override buffer</dfn> which is a Unicode
   string that is used as the source of the document when it is reloaded.</p>
 
-  <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, it must act as follows:</p>
+  <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, given a <a href=#source-browsing-context>source
+  browsing context</a>, it must act as follows:</p>
 
   <ol><li><p>Let <var title="">source</var> be the value of the <a href=#browsing-context>browsing context</a>'s
    <a href=#active-document>active document</a>'s <a href=#reload-override-buffer>reload override buffer</a>.</li>
@@ -8421,8 +8422,11 @@
    <li><p>Let <var title="">address</var> be the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
    document</a>'s <a href="#the-document's-address" title="the document's address">address</a>.</li>
 
+<!--CLEANUP-->
    <li><p><a href=#navigate>Navigate</a><!--DONAV reload after d.open()--> the <a href=#browsing-context>browsing context</a>
    to a resource whose source is <var title="">source</var>, with <a href=#replacement-enabled>replacement enabled</a>.
+   The <a href=#source-browsing-context>source browsing context</a> is that given to the <a href=#an-overridden-reload title="an overridden
+   reload">overridden reload</a> algorithm.
    When the <a href=#navigate>navigate</a> algorithm creates a <code><a href=#document>Document</a></code> object for this purpose,
    set that <code><a href=#document>Document</a></code>'s <a href=#reload-override-flag>reload override flag</a> and set its <a href=#reload-override-buffer>reload
    override buffer</a> to <var title="">source</var>.</p>
@@ -66631,7 +66635,9 @@
    <dt>If the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active document</a> has its <a href=#reload-override-flag>reload
    override flag</a> set</dt>
 
-   <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>.</dd>
+   <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>, with the <a href=#responsible-browsing-context>responsible browsing
+   context</a> specified by the <a href=#incumbent-settings-object>incumbent settings object</a> as the <a href=#source-browsing-context>source
+   browsing context</a>.</dd>
 
    <dt>Otherwise</dt>
 
@@ -66653,7 +66659,8 @@
   agents may allow the user to explicitly override any caches when reloading. If <a href=#browsing-context>browsing
   context</a>'s <a href=#active-document>active document</a>'s <a href=#reload-override-flag>reload override flag</a> is set, then the
   user agent may instead perform <a href=#an-overridden-reload>an overridden reload</a> rather than the navigation
-  described in this paragraph.</p>
+  described in this paragraph (with the <a href=#browsing-context>browsing context</a> being reloaded as the
+  <a href=#source-browsing-context>source browsing context</a>).</p>
 
   <hr></div>
 
@@ -66805,20 +66812,20 @@
   <h4 id=navigating-across-documents><span class=secno>6.6.1 </span>Navigating across documents</h4>
 
   <p>Certain actions cause the <a href=#browsing-context>browsing context</a> to <i><a href=#navigate>navigate</a></i> to a new resource.
-  Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
-  was responsible for starting the navigation.</p>
+  A user agent may provide various ways for the user to explicitly cause a browsing context to
+  navigate, in addition to those defined in this specification.</p>
 
   <p class=example>For example, <a href=#following-hyperlinks title="following hyperlinks">following a hyperlink</a>,
   <a href=#concept-form-submit title=concept-form-submit>form submission</a>, and the <code title=dom-open><a href=#dom-open>window.open()</a></code> and <code title=dom-location-assign><a href=#dom-location-assign>location.assign()</a></code> methods can all cause a browsing context to
   navigate.</p>
 
-  <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
-  navigate, in addition to those defined in this specification.</p>
-
   <p class=note>A <i>resource</i> has a URL, but that might not be the only information necessary
   to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
   and payload. Similarly, <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a> needs to know the data it is to use.</p>
 
+  <p>Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
+  was responsible for starting the navigation.</p>
+
   <!-- NAVIGATE <dfn>navigate</dfn> -->
   <!-- For places that _call_ this, as opposed to just referring to
   it, search for "DONAV" -->

Modified: index
===================================================================
--- index	2013-12-17 22:14:14 UTC (rev 8364)
+++ index	2013-12-18 18:36:32 UTC (rev 8365)
@@ -298,7 +298,7 @@
 
   <header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 17 December 2013</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 18 December 2013</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -8413,7 +8413,8 @@
   set, the <code><a href=#document>Document</a></code> also has a <dfn id=reload-override-buffer>reload override buffer</dfn> which is a Unicode
   string that is used as the source of the document when it is reloaded.</p>
 
-  <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, it must act as follows:</p>
+  <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, given a <a href=#source-browsing-context>source
+  browsing context</a>, it must act as follows:</p>
 
   <ol><li><p>Let <var title="">source</var> be the value of the <a href=#browsing-context>browsing context</a>'s
    <a href=#active-document>active document</a>'s <a href=#reload-override-buffer>reload override buffer</a>.</li>
@@ -8421,8 +8422,11 @@
    <li><p>Let <var title="">address</var> be the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
    document</a>'s <a href="#the-document's-address" title="the document's address">address</a>.</li>
 
+<!--CLEANUP-->
    <li><p><a href=#navigate>Navigate</a><!--DONAV reload after d.open()--> the <a href=#browsing-context>browsing context</a>
    to a resource whose source is <var title="">source</var>, with <a href=#replacement-enabled>replacement enabled</a>.
+   The <a href=#source-browsing-context>source browsing context</a> is that given to the <a href=#an-overridden-reload title="an overridden
+   reload">overridden reload</a> algorithm.
    When the <a href=#navigate>navigate</a> algorithm creates a <code><a href=#document>Document</a></code> object for this purpose,
    set that <code><a href=#document>Document</a></code>'s <a href=#reload-override-flag>reload override flag</a> and set its <a href=#reload-override-buffer>reload
    override buffer</a> to <var title="">source</var>.</p>
@@ -66631,7 +66635,9 @@
    <dt>If the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active document</a> has its <a href=#reload-override-flag>reload
    override flag</a> set</dt>
 
-   <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>.</dd>
+   <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>, with the <a href=#responsible-browsing-context>responsible browsing
+   context</a> specified by the <a href=#incumbent-settings-object>incumbent settings object</a> as the <a href=#source-browsing-context>source
+   browsing context</a>.</dd>
 
    <dt>Otherwise</dt>
 
@@ -66653,7 +66659,8 @@
   agents may allow the user to explicitly override any caches when reloading. If <a href=#browsing-context>browsing
   context</a>'s <a href=#active-document>active document</a>'s <a href=#reload-override-flag>reload override flag</a> is set, then the
   user agent may instead perform <a href=#an-overridden-reload>an overridden reload</a> rather than the navigation
-  described in this paragraph.</p>
+  described in this paragraph (with the <a href=#browsing-context>browsing context</a> being reloaded as the
+  <a href=#source-browsing-context>source browsing context</a>).</p>
 
   <hr></div>
 
@@ -66805,20 +66812,20 @@
   <h4 id=navigating-across-documents><span class=secno>6.6.1 </span>Navigating across documents</h4>
 
   <p>Certain actions cause the <a href=#browsing-context>browsing context</a> to <i><a href=#navigate>navigate</a></i> to a new resource.
-  Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
-  was responsible for starting the navigation.</p>
+  A user agent may provide various ways for the user to explicitly cause a browsing context to
+  navigate, in addition to those defined in this specification.</p>
 
   <p class=example>For example, <a href=#following-hyperlinks title="following hyperlinks">following a hyperlink</a>,
   <a href=#concept-form-submit title=concept-form-submit>form submission</a>, and the <code title=dom-open><a href=#dom-open>window.open()</a></code> and <code title=dom-location-assign><a href=#dom-location-assign>location.assign()</a></code> methods can all cause a browsing context to
   navigate.</p>
 
-  <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
-  navigate, in addition to those defined in this specification.</p>
-
   <p class=note>A <i>resource</i> has a URL, but that might not be the only information necessary
   to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
   and payload. Similarly, <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a> needs to know the data it is to use.</p>
 
+  <p>Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
+  was responsible for starting the navigation.</p>
+
   <!-- NAVIGATE <dfn>navigate</dfn> -->
   <!-- For places that _call_ this, as opposed to just referring to
   it, search for "DONAV" -->

Modified: source
===================================================================
--- source	2013-12-17 22:14:14 UTC (rev 8364)
+++ source	2013-12-18 18:36:32 UTC (rev 8365)
@@ -8048,7 +8048,8 @@
   set, the <code>Document</code> also has a <dfn>reload override buffer</dfn> which is a Unicode
   string that is used as the source of the document when it is reloaded.</p>
 
-  <p>When the user agent is to perform <dfn>an overridden reload</dfn>, it must act as follows:</p>
+  <p>When the user agent is to perform <dfn>an overridden reload</dfn>, given a <span>source
+  browsing context</span>, it must act as follows:</p>
 
   <ol>
 
@@ -8058,8 +8059,11 @@
    <li><p>Let <var data-x="">address</var> be the <span>browsing context</span>'s <span>active
    document</span>'s <span data-x="the document's address">address</span>.</p></li>
 
+<!--CLEANUP-->
    <li><p><span>Navigate</span><!--DONAV reload after d.open()--> the <span>browsing context</span>
    to a resource whose source is <var data-x="">source</var>, with <span>replacement enabled</span>.
+   The <span>source browsing context</span> is that given to the <span data-x="an overridden
+   reload">overridden reload</span> algorithm.
    When the <span>navigate</span> algorithm creates a <code>Document</code> object for this purpose,
    set that <code>Document</code>'s <span>reload override flag</span> and set its <span>reload
    override buffer</span> to <var data-x="">source</var>.</p>
@@ -74227,7 +74231,9 @@
    <dt>If the <span>browsing context</span>'s <span>active document</span> has its <span>reload
    override flag</span> set</dt>
 
-   <dd><p>Perform <span>an overridden reload</span>.</p></dd>
+   <dd><p>Perform <span>an overridden reload</span>, with the <span>responsible browsing
+   context</span> specified by the <span>incumbent settings object</span> as the <span>source
+   browsing context</span>.</p></dd>
 
    <dt>Otherwise</dt>
 
@@ -74251,7 +74257,8 @@
   agents may allow the user to explicitly override any caches when reloading. If <span>browsing
   context</span>'s <span>active document</span>'s <span>reload override flag</span> is set, then the
   user agent may instead perform <span>an overridden reload</span> rather than the navigation
-  described in this paragraph.</p>
+  described in this paragraph (with the <span>browsing context</span> being reloaded as the
+  <span>source browsing context</span>).</p>
 
   <hr>
 
@@ -74427,8 +74434,8 @@
   <h4>Navigating across documents</h4>
 
   <p>Certain actions cause the <span>browsing context</span> to <i>navigate</i> to a new resource.
-  Navigation always involves <dfn>source browsing context</dfn>, which is the browsing context which
-  was responsible for starting the navigation.</p>
+  A user agent may provide various ways for the user to explicitly cause a browsing context to
+  navigate, in addition to those defined in this specification.</p>
 
   <p class="example">For example, <span data-x="following hyperlinks">following a hyperlink</span>,
   <span data-x="concept-form-submit">form submission</span>, and the <code
@@ -74436,14 +74443,14 @@
   data-x="dom-location-assign">location.assign()</code> methods can all cause a browsing context to
   navigate.</p>
 
-  <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
-  navigate, in addition to those defined in this specification.</p>
-
   <p class="note">A <i>resource</i> has a URL, but that might not be the only information necessary
   to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
   and payload. Similarly, <span>an <code>iframe</code> <code
   data-x="attr-iframe-srcdoc">srcdoc</code> document</span> needs to know the data it is to use.</p>
 
+  <p>Navigation always involves <dfn>source browsing context</dfn>, which is the browsing context which
+  was responsible for starting the navigation.</p>
+
   <!-- NAVIGATE <dfn>navigate</dfn> -->
   <!-- For places that _call_ this, as opposed to just referring to
   it, search for "DONAV" -->




More information about the Commit-Watchers mailing list