[IndexedDB] Type of IDBCursor.source

2013-01-21 Thread Ms2ger 

Hi,

IDBCursor.source is described as returning "object". It would be better 
to return the union (IDBObjectStore or IDBIndex), to make it clear that 
that is what's intended.


HTH
Ms2ger

[IndexedDB] Type of IDBRequest.readyState

2013-01-21 Thread Ms2ger 

Hi,

The specification has the following IDL:

interface IDBRequest : EventTarget {
// …
readonly attribute enum   readyState;
// …
};

However, "enum" is not a type. The correct syntax would be something like

enum IDBReadyState { "pending", "done" };

interface IDBRequest : EventTarget {
// …
readonly attribute IDBReadyState  readyState;
// …
};

HTH
Ms2ger

[IndexedDB] Type of IDBRequest.source

2013-01-21 Thread Ms2ger 

Hi,

IDBRequest.source has type "object" in the IDL snippet, but the 
definition claims the attribute can return null. If this is the case, 
the type should be "object?", as for all nullable types.


HTH
Ms2ger

[IndexedDB] Event handlers

2013-01-21 Thread Ms2ger 

Hi,

The IDB specification still uses IDL like

  [TreatNonCallableAsNull] attribute Function? onsuccess;

for its event handlers. Current practice is to use

  attribute EventHandler onsuccess;

Please update the specification.

Thanks,
Ms2ger

[IndexedDB] IDBKeyRange should have static functions

2013-01-21 Thread Ms2ger 

Hi all,

From the examples in the IDB specification (in [1], for example) and 
from existing implementations, it appears that the functions on the 
IDBKeyRange interface (only, lowerBound, upperBound and bound) should be 
static. However, there is no actual normative requirement to that 
effect; instead, the IDL snippet requires those functions to only be 
callable on IDBKeyRange instances. [2]


If this is caused by a bug in ReSpec, I suggest that either ReSpec is 
fixed or the spec moves away from ReSpec to a tool that doesn't limit 
what can be specified. In any case, an insufficient tool can not be used 
as an excuse for an incorrect specification, and I doubt we could 
publish a Rec without this shortcoming being addressed.


HTH
Ms2ger

[1] 
https://dvcs.w3.org/hg/IndexedDB/raw-file/tip/Overview.html#key-generator-concept
[2] 
https://dvcs.w3.org/hg/IndexedDB/raw-file/tip/Overview.html#idl-def-IDBKeyRange