W3C home > Mailing lists > Public > public-html-commits@w3.org > December 2009

html5/webdatabase Overview.html,1.46,1.47

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 01 Dec 2009 01:16:29 +0000
To: public-html-commits@w3.org
Message-Id: <E1NFHLx-0008Ve-VR@lionel-hutz.w3.org>
Update of /sources/public/html5/webdatabase
In directory hutz:/tmp/cvs-serv32696

Modified Files:
	Overview.html 
Log Message:
Clarify when SQLResultSetRowList should be prefilled. (whatwg r4382)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/webdatabase/Overview.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- Overview.html	13 Nov 2009 01:53:51 -0000	1.46
+++ Overview.html	1 Dec 2009 01:16:27 -0000	1.47
@@ -169,7 +169,7 @@
    <p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p>
    <h1>Web Database</h1>
 
-   <h2 class="no-num no-toc" id="editor-s-draft-13-november-2009">Editor's Draft 13 November 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-1-december-2009">Editor's Draft 1 December 2009</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/webdatabase/">http://www.w3.org/TR/webdatabase/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -232,7 +232,7 @@
   Working Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation track.
 
-  This specification is the 13 November 2009 Editor's Draft.
+  This specification is the 1 December 2009 Editor's Draft.
   </p><!-- 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
   February 2004 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/42538/status" rel="disclosure">public list of
   any patent disclosures</a> made in connection with the deliverables
@@ -958,9 +958,13 @@
   be zero).<pre class="idl">interface <dfn id="sqlresultsetrowlist">SQLResultSetRowList</dfn> {
   readonly attribute unsigned long <a href="#dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length">length</a>;
   getter <span>any</span> <a href="#dom-sqlresultsetrowlist-item" title="dom-SQLResultSetRowList-item">item</a>(in unsigned long index);
-};</pre><p class="note">Implementors are encouraged to implement
-  <code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects lazily, or at least
-  asynchronously, for better performance.<p><code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects have a <dfn id="dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length"><code>length</code></dfn>
+};</pre><p class="note">For the asynchronous API, implementors are
+  encouraged to prefetch all the data for
+  <code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects when the object is
+  constructed (before the result set callback is invoked), rather than
+  on-demand, for better responsiveness. For the synchronous API, an
+  on-demand lazy evaluation implementation strategy is encouraged
+  instead, for better performance.<p><code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects have a <dfn id="dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length"><code>length</code></dfn>
   attribute that must return the number of rows it represents (the
   number of rows returned by the database). This is the <var title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></var>.<p class="note">Fetching the <code title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></code> might be
   expensive, and authors are thus encouraged to avoid using it (or
Received on Tuesday, 1 December 2009 01:16:42 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 1 December 2009 01:16:43 GMT