[html5] r1092 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2007-10-24 03:45:55 -0700 (Wed, 24 Oct 2007)
New Revision: 1092

Modified:
   index
   source
Log:
[e] (0) add note about db versions

Modified: index
===================================================================
--- index	2007-10-24 10:36:41 UTC (rev 1091)
+++ index	2007-10-24 10:45:55 UTC (rev 1092)
@@ -30408,6 +30408,12 @@
    databases. Each database has a name and a current version. There is no way
    to enumerate or delete the databases available for a domain from this API.
 
+  <p class=note>Each database has one version at a time, a database can't
+   exist in multiple versions at once. Versions are intended to allow authors
+   to manage schema changes incrementally and non-destructively, and without
+   running the risk of old code (e.g. in another browser window) trying to
+   write to a database with incorrect assumptions.
+
   <p>The <dfn id=opendatabase
    title=dom-opendatabase><code>openDatabase()</code></dfn> method returns a
    <code><a href="#database0">Database</a></code> object. The method takes

Modified: source
===================================================================
--- source	2007-10-24 10:36:41 UTC (rev 1091)
+++ source	2007-10-24 10:45:55 UTC (rev 1092)
@@ -27996,6 +27996,13 @@
   enumerate or delete the databases available for a domain from this
   API.</p>
 
+  <p class="note">Each database has one version at a time, a database
+  can't exist in multiple versions at once. Versions are intended to
+  allow authors to manage schema changes incrementally and
+  non-destructively, and without running the risk of old code (e.g. in
+  another browser window) trying to write to a database with incorrect
+  assumptions.</p>
+
   <p>The <dfn
   title="dom-opendatabase"><code>openDatabase()</code></dfn> method
   returns a <code>Database</code> object. The method takes two