W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2010

html5/spec-author-view Overview.html,1.848,1.849 history.html,1.583,1.584 spec.html,1.856,1.857

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 09 Apr 2010 01:57:42 +0000
To: public-html-commits@w3.org
Message-Id: <E1O03Ta-0008Tf-Pk@lionel-hutz.w3.org>
Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv32556

Modified Files:
	Overview.html history.html spec.html 
Log Message:
Add some exposition about state objects. (whatwg r4989)

[updated by splitter]


Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/Overview.html,v
retrieving revision 1.848
retrieving revision 1.849
diff -u -d -r1.848 -r1.849
--- Overview.html	8 Apr 2010 23:57:35 -0000	1.848
+++ Overview.html	9 Apr 2010 01:57:39 -0000	1.849
@@ -287,7 +287,7 @@
    <h1>HTML5 (Author Edition)</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
 
-   <h2 class="no-num no-toc" id="editor-s-draft-8-april-2010">Editor's Draft 8 April 2010</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-9-april-2010">Editor's Draft 9 April 2010</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -305,7 +305,7 @@
    </dl><p>This specification is available in the following formats: 
     <a href="spec.html">single page HTML</a>,
     <a href="Overview.html">multipage HTML</a>.
-This is revision 1.4006.
+This is revision 1.4007.
    </p> 
    <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2010 <a href="http://www.w3.org/"><abbr title="World Wide
@@ -394,7 +394,7 @@
   specification's progress along the W3C Recommendation
   track.
 
-  This specification is the 8 April 2010 Editor's Draft.
+  This specification is the 9 April 2010 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>The contents of this specification are also part of <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/">a
   specification</a> published by the <a href="http://www.whatwg.org/">WHATWG</a>, which is available under a
   license that permits reuse of the specification text.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5

Index: history.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/history.html,v
retrieving revision 1.583
retrieving revision 1.584
diff -u -d -r1.583 -r1.584
--- history.html	4 Apr 2010 22:47:27 -0000	1.583
+++ history.html	9 Apr 2010 01:57:39 -0000	1.584
@@ -320,7 +320,28 @@
   interface state.</p><p>Pages can <a href="#dom-history-pushstate" title="dom-history-pushState">add</a> <a href="#state-object" title="state object">state objects</a> between their entry in the
   session history and the next ("forward") entry. These are then <a href="#event-popstate" title="event-popstate">returned to the script</a> when the user
   (or script) goes back in the history, thus enabling authors to use
-  the "navigation" metaphor even in one-page applications.</p><p>At any point, one of the entries in the session history is the
+  the "navigation" metaphor even in one-page applications.</p><div class="note">
+
+   <p><a href="#state-object" title="state object">State objects</a> are intended to
+   be used for two main purposes: first, storing a preparsed
+   description of the state in the <a href="urls.html#url">URL</a> so that in the
+   simple case an author doesn't have to do the parsing (though one
+   would still need the parsing for handling <a href="urls.html#url" title="URL">URLs</a> passed around by users, so it's only a minor
+   optimization), and second, so that the author can store state that
+   one wouldn't store in the URL because it only applies to the current
+   <code><a href="#document">Document</a></code> instance and it would have to be reconstructed
+   if a new <code><a href="#document">Document</a></code> were opened.</p>
+
+   <p>An example of the latter would be something like keeping track of
+   the precise coordinate from which a popup <code><a href="grouping-content.html#the-div-element">div</a></code> was made
+   to animate, so that if the user goes back, it can be made to animate
+   to the same location. Or alternatively, it could be used to keep a
+   pointer into a cache of data that would be fetched from the server
+   based on the information in the <a href="urls.html#url">URL</a>, so that when going
+   back and forward, the information doesn't have to be fetched
+   again.</p>
+
+  </div><hr><p>At any point, one of the entries in the session history is the
   <dfn id="current-entry">current entry</dfn>. This is the entry representing the
   <a href="browsers.html#active-document">active document</a> of the <a href="browsers.html#browsing-context">browsing
   context</a>. The <a href="#current-entry">current entry</a> is usually an entry

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.856
retrieving revision 1.857
diff -u -d -r1.856 -r1.857
--- spec.html	8 Apr 2010 23:57:36 -0000	1.856
+++ spec.html	9 Apr 2010 01:57:39 -0000	1.857
@@ -285,7 +285,7 @@
    <h1>HTML5 (Author Edition)</h1>
    <h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
 
-   <h2 class="no-num no-toc" id=editor-s-draft-8-april-2010>Editor's Draft 8 April 2010</h2>
+   <h2 class="no-num no-toc" id=editor-s-draft-9-april-2010>Editor's Draft 9 April 2010</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href=http://www.w3.org/TR/html5/>http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -303,7 +303,7 @@
    </dl><p>This specification is available in the following formats: 
     <a href=spec.html>single page HTML</a>,
     <a href=Overview.html>multipage HTML</a>.
-This is revision 1.4006.
+This is revision 1.4007.
    </p> 
    <p class=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a>
    © 2010 <a href=http://www.w3.org/><abbr title="World Wide
@@ -392,7 +392,7 @@
   specification's progress along the W3C Recommendation
   track.
 
-  This specification is the 8 April 2010 Editor's Draft.
+  This specification is the 9 April 2010 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>The contents of this specification are also part of <a href=http://www.whatwg.org/specs/web-apps/current-work/multipage/>a
   specification</a> published by the <a href=http://www.whatwg.org/>WHATWG</a>, which is available under a
   license that permits reuse of the specification text.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/>5
@@ -22898,7 +22898,28 @@
   interface state.</p><p>Pages can <a href=#dom-history-pushstate title=dom-history-pushState>add</a> <a href=#state-object title="state object">state objects</a> between their entry in the
   session history and the next ("forward") entry. These are then <a href=#event-popstate title=event-popstate>returned to the script</a> when the user
   (or script) goes back in the history, thus enabling authors to use
-  the "navigation" metaphor even in one-page applications.</p><p>At any point, one of the entries in the session history is the
+  the "navigation" metaphor even in one-page applications.</p><div class=note>
+
+   <p><a href=#state-object title="state object">State objects</a> are intended to
+   be used for two main purposes: first, storing a preparsed
+   description of the state in the <a href=#url>URL</a> so that in the
+   simple case an author doesn't have to do the parsing (though one
+   would still need the parsing for handling <a href=#url title=URL>URLs</a> passed around by users, so it's only a minor
+   optimization), and second, so that the author can store state that
+   one wouldn't store in the URL because it only applies to the current
+   <code><a href=#document>Document</a></code> instance and it would have to be reconstructed
+   if a new <code><a href=#document>Document</a></code> were opened.</p>
+
+   <p>An example of the latter would be something like keeping track of
+   the precise coordinate from which a popup <code><a href=#the-div-element>div</a></code> was made
+   to animate, so that if the user goes back, it can be made to animate
+   to the same location. Or alternatively, it could be used to keep a
+   pointer into a cache of data that would be fetched from the server
+   based on the information in the <a href=#url>URL</a>, so that when going
+   back and forward, the information doesn't have to be fetched
+   again.</p>
+
+  </div><hr><p>At any point, one of the entries in the session history is the
   <dfn id=current-entry>current entry</dfn>. This is the entry representing the
   <a href=#active-document>active document</a> of the <a href=#browsing-context>browsing
   context</a>. The <a href=#current-entry>current entry</a> is usually an entry
Received on Friday, 9 April 2010 01:57:44 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 9 April 2010 01:57:44 GMT