Changes between Version 125 and Version 126 of WebKitIDL


Ignore:
Timestamp:
Jun 12, 2013 5:49:37 AM (8 years ago)
Author:
Christophe Dumez
Comment:

Rename [CallWith] to [ConstructorCallWith] for interfaces

Legend:

Unmodified
Added
Removed
Modified
  • WebKitIDL

    v125 v126  
    1313 - [#Clamp Clamp(a,p)][[br]]
    1414 - [#Custom Custom(m,a), CustomGetter(a), CustomSetter(a)][[br]]
    15  - [#CallWith CallWith(i,m,a)][[br]]
     15 - [#CallWith CallWith(m,a)][[br]]
    1616 - [#StrictTypeChecking StrictTypeChecking(m,a,p)][[br]]
    1717 - [#ReturnNewObject ReturnNewObject(m,a)][[br]]
     
    2222 - [#CachedAttribute CachedAttribute(a)][[br]]
    2323 - [#JSWindowEventListener JSWindowEventListener(a)][[br]]
    24  - [#Constructor Constructor(i), CallWith(i,m,a), ConstructorRaisesException(i)][[br]]
     24 - [#Constructor Constructor(i), ConstructorCallWith(i), ConstructorRaisesException(i)][[br]]
    2525 - [#ConstructorTemplate ConstructorTemplate(i), InitializedByEventConstructor(a)][[br]]
    2626 - [#NamedConstructor NamedConstructor(i)][[br]]
     
    404404Note: ObjC, GObject and CPP bindings do not support custom bindings.
    405405
    406 == `[CallWith]`(i,m,a) == #CallWith
     406== `[CallWith]`(m,a) == #CallWith
    407407
    408408Summary: `[CallWith]` indicates that the bindings code calls a WebCore method with additional information.
     
    421421}}}
    422422
    423 Note: `[CallWith]` can be also specified on interfaces but it has a different meaning.
    424 Refer to [#Constructor the `[Constructor]` section] for `[CallWith]` on interfaces.
     423Note: See `[ConstructorCallWith]` in the [#Constructor [Constructor] section] for similar functionality on constructors.
    425424
    426425In case of func1(...), HTMLFoo::func1(ScriptExecutionContext* context, int a, int b) is called in WebCore.
     
    648647ADD EXPLANATIONS
    649648
    650 == `[Constructor]`(i), `[CallWith]`(i,m,a), `[ConstructorRaisesException](i)` == #Constructor
     649== `[Constructor]`(i), `[ConstructorCallWith]`(i), `[ConstructorRaisesException](i)` == #Constructor
    651650
    652651 * [http://dev.w3.org/2006/webapi/WebIDL/#Constructor The spec of Constructor]
    653652
    654653Summary: `[Constructor]` indicates that the interface should have constructor, i.e. "new XXX()".
    655 `[CallWith]` and `[ConstructorRaisesException]` add information when the constructor callback is called in WebCore.
    656 
    657 Usage: `[Constructor]`, `[CallWith]` and `[ConstructorRaisesException]` can be specified on interfaces:
     654`[ConstructorCallWith]` and `[ConstructorRaisesException]` add information when the constructor callback is called in WebCore.
     655
     656Usage: `[Constructor]`, `[ConstructorCallWith]` and `[ConstructorRaisesException]` can be specified on interfaces:
    658657{{{
    659658    [
    660659        Constructor(float x, float y, DOMString str),
    661660        ConstructorRaisesException,
    662         CallWith=ScriptExecutionContext
     661        ConstructorCallWith=ScriptExecutionContext
    663662    ] interface XXX {
    664663    };
     
    696695
    697696If `XXX::create(...)` needs additional information like ScriptExecutionContext,
    698 you can specify `[CallWith=ScriptExecutionContext]`.
     697you can specify `[ConstructorCallWith=ScriptExecutionContext]`.
    699698Then `XXX::create(...)` can have the following signature:
    700699{{{
     
    705704}}}
    706705You can retrieve document or frame from ScriptExecutionContext.
    707 Please see [#CallWith another [CallWith] section] for more details.
    708 
    709 Note that `[CallWith=...]` arguments are added at the head of `XXX::create(...)`'s arguments,
     706
     707Note that `[ConstructorCallWith=...]` arguments are added at the head of `XXX::create(...)`'s arguments,
    710708and the ExceptionCode argument is added at the tail of `XXX::create(...)`'s arguments.
    711709