[Bug 17032] IndexedDB: Editorial - use of phrase "explicit key" is confusing

https://www.w3.org/Bugs/Public/show_bug.cgi?id=17032

Jonas Sicking <jonas@sicking.cc> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |jonas@sicking.cc

--- Comment #1 from Jonas Sicking <jonas@sicking.cc> 2012-07-15 22:23:14 UTC ---
It's hard to come up with language which is both precise and readable.
Suggestions welcome. I ended up removing the note and just going with the
following text (which is plenty sprinkled with links):


When a record is stored and an key value is specified in the call to store the
record, if the specified key value is a float greater than or equal to the key
generator's current number, then the key generator's current number is set to
the smallest integer number greater than the explicit key. A key can be
specified both for object stores which use in-line keys, by setting the
property on the stored value which the object store's key path points to, and
for object stores which use out-of-line keys, by passing a key argument to the
call to store the record.

Only specified keys values which are float values affect the current number of
the key generator. Dates and Arrays which contain floats do not affect the
current number of the key generator. Nor do DOMString values which could be
parsed as floats. Likewise, negative float numbers do not affect the current
number since they are always lower than the current number.

-- 
Configure bugmail: https://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Sunday, 15 July 2012 22:23:16 UTC