Changes between Version 70 and Version 71 of WebKitIDL

Timestamp:

Jun 29, 2012 3:45:40 PM (12 years ago)

Author:

arv@chromium.org

Comment:

--

WebKitIDL

@@ -49 +49 @@
  - [#CustomCall CustomCall(i)][[br]]
  - [#JSCustomToNativeObject JSCustomToNativeObject(i), JSCustomFinalize(i), JSCustomIsReachable(i), JSCustomMarkFunction(i), JSCustomNamedGetterOnPrototype(i), JSCustomPushEventHandlerScope(i), JSCustomDefineOwnProperty(i), JSCustomDefineOwnPropertyOnPrototype(i), JSCustomGetOwnPropertySlotAndDescriptor(i)][[br]]
- - [#JSGenerateToJSObject JSGenerateToJSObject(i), JSGenerateIsReachable(i), JSGenerateToNativeObject(i)][[br]]
+ - [#JSGenerateToJSObject JSGenerateToJSObject(i), JSGenerateToNativeObject(i)][[br]]
+ - [#JSGenerateIsReachable JSGenerateIsReachable(i)]
+ - [#V8GenerateIsReachable V8GenerateIsReachable(i)]
+ - [#GenerateIsReachable GenerateIsReachable(i)]
  - [#JSCustomHeader JSCustomHeader(i)][[br]]
  - [#JSLegacyParent JSLegacyParent(i)][[br]]
@@ -1602 +1605 @@
 }}}
 
-== [JSGenerateToJSObject](i), [JSGenerateIsReachable](i), [JSGenerateToNativeObject](i) == #JSGenerateToJSObject
+== [JSGenerateToJSObject](i), [JSGenerateToNativeObject](i) == #JSGenerateToJSObject
 
 Summary: They force JavaScriptCore bindings to generate JavaScriptCore-specific methods, even if a given interface has a parent interface.
@@ -1610 +1613 @@
     interface [
         JSGenerateToJSObject,
-        JSGenerateIsReachable,
         JSGenerateToNativeObject
     ] XXX {
@@ -1618 +1620 @@
 toJS(...), isReachableFromOpaqueRoots(...) or toXXX() is not generated if XXX has a parent interface.
 If you want to generate it even if XXX does not have a parent interface, you can specify
-[JSGenerateToJSObject], [JSGenerateIsReachable] or [JSGenerateToNativeObject], respectively.
+[JSGenerateToJSObject] or [JSGenerateToNativeObject], respectively.
+
+== [JSGenerateIsReachable](i) == #JSGenerateIsReachable
+
+Summary: This generates code that determines if a wrapper is reachable.
+
+Usage: The JSGenerateIsReachable can be specified on the interface. This attribute is ignored if CustomIsReachable is present.
+
+{{{
+    interface [
+        JSGenerateIsReachable=ImplBaseRoot
+    ] XXX {
+    };
+}}}
+
+The code generates a function called XXX::isReachableFromOpaqueRoots which returns a boolean if the wrapper is reachable.
+
+The currently valid values are:
+
+ - (no value)
+ - Impl
+ - ImplContext
+ - ImplFrame
+ - ImplDocument
+ - ImplElementRoot
+ - ImplBaseRoot
+
+The value of these represents the functions to call to get the object that determines whether the object is reachable or not. See CodeGeneratorJS.pm for more details. The values that end with Root calls WebCore::root to get the root. If the value is left out then WebCore::root is called on impl().
+
+== [V8GenerateIsReachable](i) == #V8GenerateIsReachable
+
+Summary: This generates code that determines if a wrapper is reachable.
+
+Usage: The V8GenerateIsReachable can be specified on the interface. This attribute is ignored if CustomIsReachable is present.
+
+{{{
+    interface [
+        V8GenerateIsReachable=ImplBaseRoot
+    ] XXX {
+    };
+}}}
+
+The code generates a function called XXX::visitDOMWrapper which is called by V8GCController before GC. The function adds implicit references to the wrapper which keeps it alive.
+
+The currently valid values are:
+
+|ImplElementRoot|ImplOwnerRoot|ImplOwnerNodeRoot|ImplBaseRoot
+
+ - ImplOwnerRoot
+ - ImplOwnerNodeRoot
+ - ImplElementRoot
+ - ImplBaseRoot
+
+The value of these represents the functions to call to get the object that determines whether the object is reachable or not. See CodeGeneratorV8.pm for more details.
+
+== [GenerateIsReachable](i) == #GenerateIsReachable
+
+Summary: This is the shared version of [JSGenerateIsReachable] and V8GenerateIsReachable. The accepted values are the intersection of those two.
+
+ - ImplElementRoot
+ - ImplBaseRoot
 
 == [JSCustomHeader](i) == #JSCustomHeader