Changes between Version 74 and Version 75 of WebKitIDL

Timestamp:

Jul 30, 2012, 12:29:06 AM (13 years ago)

Author:

haraken@chromium.org

Comment:

--

WebKitIDL

@@ -11 +11 @@
  - [#TreatReturnedNullStringAs TreatReturnedNullStringAs(m,a)][[br]]
  - [#Optional Optional(p)][[br]]
+ - [#Clamp Clamp(a,p)][[br]]
  - [#Callback Callback(i,p)][[br]]
  - [#Custom Custom(m,a), JSCustom(m,a), V8Custom(m,a), CustomGetter(a), JSCustomGetter(a), V8CustomGetter(a), CustomSetter(a), JSCustomSetter(a), V8CustomSetter(a)][[br]]
@@ -63 +64 @@
  - [#ArrayClass ArrayClass(i)][[br]]
  - [#OmitConstructor OmitConstructor, Immutable, MasqueradesAsUndefined, CustomGetOwnPropertySlot, ReplaceableConstructor, ExtendsDOMGlobalObject, IsIndex, V8DoNotCheckSignature, NumericIndexedGetter][[br]]
- - [#Clamp Clamp(a,p)][[br]]
 
 = Overview = #Overview
@@ -328 +328 @@
 d.IsEmpty() and d.IsNull() return true.
 
+== [Clamp](a,p) == #Clamp
+
+ * [http://www.w3.org/TR/2012/CR-WebIDL-20120419/#Clamp The spec of Clamp]
+
+Summary: [Clamp] indicates that when an ECMAScript Number is converted to the IDL type, out of range values will be clamped to the range of valid values, 
+rather than using the operators that use a modulo operation (ToInt32, ToUint32, etc.).
+
+Usage: The [Clamp] extended attribute MUST NOT appear on a read only attribute, or an attribute, operation argument or dictionary member 
+that is not of an integer type.
+
+[Clamp] can be specified on  writable attributes:
+
+{{{
+    interface XXX {
+        attribute [Clamp] unsigned short attributeName;
+    };
+}}}
+
+[Clamp] can be specified on  extended attributes on methods arguments:
+
+{{{
+    interface GraphicsContext {
+        void setColor(octet red, octet green, octet blue);
+        void setColorClamped([Clamp] octet red, [Clamp] octet green, [Clamp] octet blue);
+    };
+}}}
+
+Calling the non-[Clamp] version of setColor() uses ToUint8 to coerce the Numbers to octets.
+Hence calling context.setColor(-1, 255, 257) is equivalent to calling setColor(255, 255, 1).
+
+Calling the [Clamp] version of setColor() uses clampTo() to coerce the Numbers to octets.
+Hence calling context.setColor(-1, 255, 257) is equivalent to calling setColorClamped(0, 255, 255).
+
 == [Callback](i,p) FIXME == #Callback
 
@@ -1803 +1836 @@
 
 Might be deprecated. Discussion is on-going.
-
-== [Clamp](a,p) == #Clamp
-
- * [http://www.w3.org/TR/2012/CR-WebIDL-20120419/#Clamp The spec of Clamp]
-
-Summary: [Clamp] indicates that when an ECMAScript Number is converted to the IDL type, out of range values will be clamped to the range of valid values, 
-rather than using the operators that use a modulo operation (ToInt32, ToUint32, etc.).
-
-Usage: The [Clamp] extended attribute MUST NOT appear on a read only attribute, or an attribute, operation argument or dictionary member 
-that is not of an integer type. It also MUST NOT be used in conjunction with the [EnforceRange] extended attribute.
-
-[Clamp] can be specified on  writable attributes:
-
-{{{
-    interface XXX {
-        attribute [Clamp] unsigned short attributeName;
-    };
-}}}
-
-[Clamp] can be specified on  extended attributes on methods arguments:
-
-{{{
-    interface GraphicsContext {
-        void setColor(octet red, octet green, octet blue);
-        void setColorClamped([Clamp] octet red, [Clamp] octet green, [Clamp] octet blue);
-    };
-}}}
-
-Calling the non-[Clamp] version of setColor() uses ToUint8 to coerce the Numbers to octets.
-Hence calling context.setColor(-1, 255, 257); // Is equivalent to calling setColor(255, 255, 1).
-
-Calling the [Clamp] version of setColor() uses clampTo() to coerce the Numbers to octets.
-Hence calling context.setColor(-1, 255, 257); // Is equivalent to calling setColorClamped(0, 255, 255).