[html5] r4382 - [e] (0) Clarify when SQLResultSetRowList should be prefilled.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-11-30 17:16:23 -0800 (Mon, 30 Nov 2009)
New Revision: 4382

Modified:
   source
Log:
[e] (0) Clarify when SQLResultSetRowList should be prefilled.

Modified: source
===================================================================
--- source	2009-11-26 01:37:44 UTC (rev 4381)
+++ source	2009-12-01 01:16:23 UTC (rev 4382)
@@ -66766,9 +66766,13 @@
   getter <span>any</span> <span title="dom-SQLResultSetRowList-item">item</span>(in unsigned long index);
 };</pre>
 
-  <p class="note">Implementors are encouraged to implement
-  <code>SQLResultSetRowList</code> objects lazily, or at least
-  asynchronously, for better performance.</p>
+  <p class="note">For the asynchronous API, implementors are
+  encouraged to prefetch all the data for
+  <code>SQLResultSetRowList</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>
 
   <p><code>SQLResultSetRowList</code> objects have a <dfn
   title="dom-SQLResultSetRowList-length"><code>length</code></dfn>