[html5] r4375 - [agiow] (0) Nuke history.clearState() since it was confusingly specced and its u [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Nov 12 17:45:04 PST 2009


Author: ianh
Date: 2009-11-12 17:45:00 -0800 (Thu, 12 Nov 2009)
New Revision: 4375

Modified:
   complete.html
   index
   source
Log:
[agiow] (0) Nuke history.clearState() since it was confusingly specced and its use cases were unclear.

Modified: complete.html
===================================================================
--- complete.html	2009-11-03 23:00:59 UTC (rev 4374)
+++ complete.html	2009-11-13 01:45:00 UTC (rev 4375)
@@ -110,7 +110,7 @@
 
   <header class=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Draft Standard — 3 November 2009</h2>
+    <h2 class="no-num no-toc">Draft Standard — 13 November 2009</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>-->
@@ -54893,7 +54893,6 @@
   void <a href=#dom-history-forward title=dom-history-forward>forward</a>();
   void <a href=#dom-history-pushstate title=dom-history-pushState>pushState</a>(in any data, in DOMString title, in optional DOMString url);
   void <a href=#dom-history-replacestate title=dom-history-replaceState>replaceState</a>(in any data, in DOMString title, in optional DOMString url);
-  void <a href=#dom-history-clearstate title=dom-history-clearState>clearState</a>();
 };</pre>
 
   <dl class=domintro><dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-length><a href=#dom-history-length>length</a></code></dt>
@@ -54952,14 +54951,6 @@
 
    </dd>
 
-   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-clearState><a href=#dom-history-clearstate>clearState</a></code>()</dt>
-
-   <dd>
-
-    <p>Removes all state objects for the current page from the session history.</p>
-
-   </dd>
-
   </dl><p>The <dfn id=joint-session-history>joint session history</dfn> of a <code><a href=#history-0>History</a></code>
   object is the union of all the <a href=#session-history title="session history">session
   histories</a> of all <a href=#browsing-context title="browsing context">browsing
@@ -55131,20 +55122,6 @@
   having added the new entry. (Thus the state history acts as a FIFO
   buffer for eviction, but as a LIFO buffer for navigation.)</p>
 
-  <p>The <dfn id=dom-history-clearstate title=dom-history-clearState><code>clearState()</code></dfn>
-  method removes all the state objects for the <code>Document</code>
-  object from the session history.</p>
-
-  <p>When this method is invoked, the user agent must remove from the
-  session history all the entries from the first state object entry
-  for that <code>Document</code> object up to the last entry that
-  references that same <code>Document</code> object, if any.</p>
-
-  <p>Then, if the <a href=#current-entry>current entry</a> was removed in the
-  previous step, the <a href=#current-entry>current entry</a> must be set to the
-  last entry for that <code>Document</code> object in the session
-  history.</p>
-
   </div>
 
   <div class=example>

Modified: index
===================================================================
--- index	2009-11-03 23:00:59 UTC (rev 4374)
+++ index	2009-11-13 01:45:00 UTC (rev 4375)
@@ -111,7 +111,7 @@
 
   <header class=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>HTML5</h1>
-    <h2 class="no-num no-toc">Draft Standard — 3 November 2009</h2>
+    <h2 class="no-num no-toc">Draft Standard — 13 November 2009</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>-->
@@ -52059,7 +52059,6 @@
   void <a href=#dom-history-forward title=dom-history-forward>forward</a>();
   void <a href=#dom-history-pushstate title=dom-history-pushState>pushState</a>(in any data, in DOMString title, in optional DOMString url);
   void <a href=#dom-history-replacestate title=dom-history-replaceState>replaceState</a>(in any data, in DOMString title, in optional DOMString url);
-  void <a href=#dom-history-clearstate title=dom-history-clearState>clearState</a>();
 };</pre>
 
   <dl class=domintro><dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-length><a href=#dom-history-length>length</a></code></dt>
@@ -52118,14 +52117,6 @@
 
    </dd>
 
-   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-clearState><a href=#dom-history-clearstate>clearState</a></code>()</dt>
-
-   <dd>
-
-    <p>Removes all state objects for the current page from the session history.</p>
-
-   </dd>
-
   </dl><p>The <dfn id=joint-session-history>joint session history</dfn> of a <code><a href=#history-0>History</a></code>
   object is the union of all the <a href=#session-history title="session history">session
   histories</a> of all <a href=#browsing-context title="browsing context">browsing
@@ -52297,20 +52288,6 @@
   having added the new entry. (Thus the state history acts as a FIFO
   buffer for eviction, but as a LIFO buffer for navigation.)</p>
 
-  <p>The <dfn id=dom-history-clearstate title=dom-history-clearState><code>clearState()</code></dfn>
-  method removes all the state objects for the <code>Document</code>
-  object from the session history.</p>
-
-  <p>When this method is invoked, the user agent must remove from the
-  session history all the entries from the first state object entry
-  for that <code>Document</code> object up to the last entry that
-  references that same <code>Document</code> object, if any.</p>
-
-  <p>Then, if the <a href=#current-entry>current entry</a> was removed in the
-  previous step, the <a href=#current-entry>current entry</a> must be set to the
-  last entry for that <code>Document</code> object in the session
-  history.</p>
-
   </div>
 
   <div class=example>
@@ -61856,7 +61833,7 @@
    <dd>Switch to the <a href=#rcdata-less-than-sign-state>RCDATA less-than sign state</a>.</dd>
 
    <dt>EOF</dt>
-   <dd><a href=#parse-error>Parse error</a>. Emit an end-of-file token.</dd>
+   <dd>Emit an end-of-file token.</dd>
 
    <dt>Anything else</dt>
    <dd>Emit the <a href=#current-input-character>current input character</a> as a character
@@ -61883,7 +61860,7 @@
    <dd>Switch to the <a href=#rawtext-less-than-sign-state>RAWTEXT less-than sign state</a>.</dd>
 
    <dt>EOF</dt>
-   <dd><a href=#parse-error>Parse error</a>. Emit an end-of-file token.</dd>
+   <dd>Emit an end-of-file token.</dd>
 
    <dt>Anything else</dt>
    <dd>Emit the <a href=#current-input-character>current input character</a> as a character
@@ -61897,7 +61874,7 @@
    <dd>Switch to the <a href=#script-data-less-than-sign-state>script data less-than sign state</a>.</dd>
 
    <dt>EOF</dt>
-   <dd><a href=#parse-error>Parse error</a>. Emit an end-of-file token.</dd>
+   <dd>Emit an end-of-file token.</dd>
 
    <dt>Anything else</dt>
    <dd>Emit the <a href=#current-input-character>current input character</a> as a character

Modified: source
===================================================================
--- source	2009-11-03 23:00:59 UTC (rev 4374)
+++ source	2009-11-13 01:45:00 UTC (rev 4375)
@@ -61930,7 +61930,6 @@
   void <span title="dom-history-forward">forward</span>();
   void <span title="dom-history-pushState">pushState</span>(in any data, in DOMString title, in optional DOMString url);
   void <span title="dom-history-replaceState">replaceState</span>(in any data, in DOMString title, in optional DOMString url);
-  void <span title="dom-history-clearState">clearState</span>();
 };</pre>
 
   <dl class="domintro">
@@ -61991,14 +61990,6 @@
 
    </dd>
 
-   <dt><var title="">window</var> . <code title="dom-history">history</code> . <code title="dom-history-clearState">clearState</code>()</dt>
-
-   <dd>
-
-    <p>Removes all state objects for the current page from the session history.</p>
-
-   </dd>
-
   </dl>
 
   <p>The <dfn>joint session history</dfn> of a <code>History</code>
@@ -62225,21 +62216,6 @@
   having added the new entry. (Thus the state history acts as a FIFO
   buffer for eviction, but as a LIFO buffer for navigation.)</p>
 
-  <p>The <dfn
-  title="dom-history-clearState"><code>clearState()</code></dfn>
-  method removes all the state objects for the <code>Document</code>
-  object from the session history.</p>
-
-  <p>When this method is invoked, the user agent must remove from the
-  session history all the entries from the first state object entry
-  for that <code>Document</code> object up to the last entry that
-  references that same <code>Document</code> object, if any.</p>
-
-  <p>Then, if the <span>current entry</span> was removed in the
-  previous step, the <span>current entry</span> must be set to the
-  last entry for that <code>Document</code> object in the session
-  history.</p>
-
   </div>
 
   <div class="example">




More information about the Commit-Watchers mailing list