clutter 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32

data/vendor/local/lib/pkgconfig/json-glib-1.0.pc

@@ -5,7 +5,7 @@ includedir=${prefix}/include
 
 Name: JSON-GLib
 Description: JSON Parser for GLib
-Version: 1.0.2
+Version: 1.0.4
 Libs: -L${libdir} -ljson-glib-1.0
 Cflags: -I${includedir}/json-glib-1.0
 Requires: gobject-2.0 gio-2.0

data/vendor/local/share/gir-1.0/Clutter-1.0.gir

@@ -1352,7 +1352,7 @@ The implementation of this function is equivalent to:
                                           &natural_height);
       height = CLAMP (natural_height, min_height, available_height);
     }
-  else
+  else if (request_mode == CLUTTER_REQUEST_WIDTH_FOR_HEIGHT)
     {
       clutter_actor_get_preferred_height (self, available_width,
                                           &min_height,
@@ -1364,6 +1364,13 @@ The implementation of this function is equivalent to:
                                          &natural_width);
       width = CLAMP (natural_width, min_width, available_width);
     }
+  else if (request_mode == CLUTTER_REQUEST_CONTENT_SIZE)
+    {
+      clutter_content_get_preferred_size (content, &natural_width, &natural_height);
+
+      width = CLAMP (natural_width, 0, available_width);
+      height = CLAMP (natural_height, 0, available_height);
+    }
 
   box.x1 = x; box.y1 = y;
   box.x2 = box.x1 + available_width;
@@ -1583,7 +1590,9 @@ g_signal_connect_after() to connect the callback function, for instance:
     ...
 ]|</doc>
         <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
-  in #ClutterActor instead.</doc-deprecated>
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is
   owned by the #ClutterActor and should not be unreferenced with
@@ -1628,7 +1637,10 @@ See clutter_actor_animate() for further details.
 
 This function is useful if you want to use an existing #ClutterAlpha
 to animate @actor.</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_animate_with_timeline() instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is owned by the
   #ClutterActor and should not be unreferenced with g_object_unref()</doc>
@@ -1673,7 +1685,10 @@ useful for language bindings.
 
 Unlike clutter_actor_animate_with_alpha(), this function will
 not allow you to specify "signal::" names and callbacks.</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_animate_with_timelinev() instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is owned by the
   #ClutterActor and should not be unreferenced with g_object_unref()</doc>
@@ -1723,7 +1738,9 @@ See clutter_actor_animate() for further details.
 This function is useful if you want to use an existing timeline
 to animate @actor.</doc>
         <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
-  in #ClutterActor instead.</doc-deprecated>
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is
    owned by the #ClutterActor and should not be unreferenced with
@@ -1774,7 +1791,9 @@ useful for language bindings.
 Unlike clutter_actor_animate_with_timeline(), this function
 will not allow you to specify "signal::" names and callbacks.</doc>
         <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
-  in #ClutterActor instead.</doc-deprecated>
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is
    owned by the #ClutterActor and should not be unreferenced with
@@ -1829,7 +1848,9 @@ for language bindings.
 Unlike clutter_actor_animate(), this function will not
 allow you to specify "signal::" names and callbacks.</doc>
         <doc-deprecated xml:space="preserve">Use the implicit transition for animatable properties
-  in #ClutterActor instead.</doc-deprecated>
+  in #ClutterActor instead. See clutter_actor_save_easing_state(),
+  clutter_actor_set_easing_mode(), clutter_actor_set_easing_duration(),
+  clutter_actor_set_easing_delay(), and clutter_actor_restore_easing_state().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterAnimation object. The object is
   owned by the #ClutterActor and should not be unreferenced with
@@ -2975,7 +2996,8 @@ requested size and position if the actor's allocation is invalid.</doc>
               deprecated="1"
               deprecated-version="1.8">
         <doc xml:space="preserve">Retrieves the unique id for @self.</doc>
-        <doc-deprecated xml:space="preserve">The id is not used any longer.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">The id is not used any longer, and this function
+  always returns 0.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">Globally unique value for this object instance.</doc>
           <type name="guint32" c:type="guint32"/>
@@ -3272,7 +3294,7 @@ function, to paint themselves with the correct opacity.</doc>
       </method>
       <method name="get_paint_visibility"
               c:identifier="clutter_actor_get_paint_visibility"
-              version="0.8.4">
+              version="0.8">
         <doc xml:space="preserve">Retrieves the 'paint' visibility of an actor recursively checking for non
 visible parents.
 
@@ -4413,7 +4435,7 @@ be allocated before it is next drawn on the screen.</doc>
       </method>
       <method name="has_clip"
               c:identifier="clutter_actor_has_clip"
-              version="0.1.1">
+              version="0.2">
         <doc xml:space="preserve">Determines whether the actor has a clip area set or not.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the actor has a clip area set.</doc>
@@ -7183,7 +7205,7 @@ implementation, but it is guaranteed to be called before the
       </method>
       <method name="unparent"
               c:identifier="clutter_actor_unparent"
-              version="0.1.1"
+              version="0.2"
               deprecated="1"
               deprecated-version="1.10">
         <doc xml:space="preserve">Removes the parent of @self.
@@ -7797,7 +7819,7 @@ For instance:
                                           &amp;min_height,
                                           &amp;natural_height);
     }
-  else
+  else if (mode == CLUTTER_REQUEST_WIDTH_FOR_HEIGHT)
     {
       clutter_actor_get_preferred_height (child, -1,
                                           &amp;min_height,
@@ -7806,6 +7828,16 @@ For instance:
                                          &amp;min_width,
                                          &amp;natural_width);
     }
+  else if (mode == CLUTTER_REQUEST_CONTENT_SIZE)
+    {
+      ClutterContent *content = clutter_actor_get_content (child);
+
+      min_width, min_height = 0;
+      natural_width = natural_height = 0;
+
+      if (content != NULL)
+        clutter_content_get_preferred_size (content, &amp;natural_width, &amp;natural_height);
+    }
 ]|
 
 will retrieve the minimum and natural width and height depending on the
@@ -10347,6 +10379,8 @@ and to the clutter_actor_allocate() function.</doc>
            c:symbol-prefix="alpha"
            c:type="ClutterAlpha"
            version="0.2"
+           deprecated="1"
+           deprecated-version="1.12"
            parent="GObject.InitiallyUnowned"
            glib:type-name="ClutterAlpha"
            glib:get-type="clutter_alpha_get_type"
@@ -10354,6 +10388,7 @@ and to the clutter_actor_allocate() function.</doc>
       <doc xml:space="preserve">#ClutterAlpha combines a #ClutterTimeline and a function.
 The contents of the #ClutterAlpha structure are private and should
 only be accessed using the provided API.</doc>
+      <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
       <implements name="Scriptable"/>
       <constructor name="new"
                    c:identifier="clutter_alpha_new"
@@ -10367,6 +10402,7 @@ using clutter_alpha_set_timeline().
 
 You should use the newly created #ClutterAlpha instance inside
 a #ClutterBehaviour object.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the newly created empty #ClutterAlpha instance.</doc>
           <type name="Alpha" c:type="ClutterAlpha*"/>
@@ -10381,6 +10417,7 @@ a #ClutterBehaviour object.</doc>
 and animation mode.
 
 See also clutter_alpha_set_timeline() and clutter_alpha_set_mode().</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the newly created #ClutterAlpha</doc>
           <type name="Alpha" c:type="ClutterAlpha*"/>
@@ -10407,6 +10444,7 @@ and the alpha function.
 This function will not register @func as a global alpha function.
 
 See also clutter_alpha_set_timeline() and clutter_alpha_set_func().</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the newly created #ClutterAlpha</doc>
           <type name="Alpha" c:type="ClutterAlpha*"/>
@@ -10446,6 +10484,9 @@ Registers a global alpha function and returns its logical id
 to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
 
 The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this
+  function. Use clutter_timeline_set_progress_func() on each
+  specific #ClutterTimeline instance</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the logical id of the alpha function</doc>
           <type name="gulong" c:type="gulong"/>
@@ -10468,6 +10509,9 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
 to be used by clutter_alpha_set_mode() or by #ClutterAnimation.
 
 The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this
+  function. Use clutter_timeline_set_progress_func() on each
+  specific #ClutterTimeline instance</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the logical id of the alpha function</doc>
           <type name="gulong" c:type="gulong"/>
@@ -10489,6 +10533,7 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Query the current alpha value.</doc>
+        <doc-deprecated xml:space="preserve">Use clutter_timeline_get_progress()</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The current alpha value for the alpha</doc>
           <type name="gdouble" c:type="gdouble"/>
@@ -10506,6 +10551,7 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the #ClutterAnimationMode used by @alpha.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the animation mode</doc>
           <type name="gulong" c:type="gulong"/>
@@ -10523,6 +10569,7 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Gets the #ClutterTimeline bound to @alpha.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline directlry</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #ClutterTimeline instance</doc>
           <type name="Timeline" c:type="ClutterTimeline*"/>
@@ -10541,6 +10588,7 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Sets the #GClosure used to compute the alpha value at each
 frame of the #ClutterTimeline bound to @alpha.</doc>
+        <doc-deprecated xml:space="preserve">Use clutter_timeline_set_progress_func()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10565,6 +10613,7 @@ the alpha value at each frame of the #ClutterTimeline
 bound to @alpha.
 
 This function will not register @func as a global alpha function.</doc>
+        <doc-deprecated xml:space="preserve">Use clutter_timeline_set_progress_func()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10599,6 +10648,8 @@ This function will not register @func as a global alpha function.</doc>
         <doc xml:space="preserve">Sets the progress function of @alpha using the symbolic value
 of @mode, as taken by the #ClutterAnimationMode enumeration or
 using the value returned by clutter_alpha_register_func().</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline and
+  clutter_timeline_set_progress_mode() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10619,6 +10670,7 @@ using the value returned by clutter_alpha_register_func().</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Binds @alpha to @timeline.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline directly</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10641,6 +10693,8 @@ using the value returned by clutter_alpha_register_func().</doc>
         <doc xml:space="preserve">The alpha value as computed by the alpha function. The linear
 interval is 0.0 to 1.0, but the Alpha allows overshooting by
 one unit in each direction, so the valid interval is -1.0 to 2.0.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline::new-frame and
+  clutter_timeline_get_progress() instead</doc-deprecated>
         <type name="gdouble" c:type="gdouble"/>
       </property>
       <property name="mode"
@@ -10657,6 +10711,7 @@ clutter_alpha_register_func().
 If %CLUTTER_CUSTOM_MODE is used then the function set using
 clutter_alpha_set_closure() or clutter_alpha_set_func()
 will be used.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterTimeline:progress-mode</doc-deprecated>
         <type name="gulong" c:type="gulong"/>
       </property>
       <property name="timeline"
@@ -10678,8 +10733,11 @@ will be used.</doc>
     <record name="AlphaClass"
             c:type="ClutterAlphaClass"
             glib:is-gtype-struct-for="Alpha"
-            version="0.2">
+            version="0.2"
+            deprecated="1"
+            deprecated-version="1.12">
       <doc xml:space="preserve">Base class for #ClutterAlpha</doc>
+      <doc-deprecated xml:space="preserve">Use #ClutterTimeline instead</doc-deprecated>
       <field name="parent_class" readable="0" private="1">
         <type name="GObject.InitiallyUnownedClass"
               c:type="GInitiallyUnownedClass"/>
@@ -10720,9 +10778,14 @@ will be used.</doc>
         </callback>
       </field>
     </record>
-    <callback name="AlphaFunc" c:type="ClutterAlphaFunc" version="0.2">
+    <callback name="AlphaFunc"
+              c:type="ClutterAlphaFunc"
+              version="0.2"
+              deprecated="1"
+              deprecated-version="1.12">
       <doc xml:space="preserve">A function returning a value depending on the position of
 the #ClutterTimeline bound to @alpha.</doc>
+      <doc-deprecated xml:space="preserve">Use #ClutterTimelineProgressFunc instead.</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a floating point value</doc>
         <type name="gdouble" c:type="gdouble"/>
@@ -11229,12 +11292,15 @@ a #ClutterAnimation.</doc>
            c:symbol-prefix="animation"
            c:type="ClutterAnimation"
            version="1.0"
+           deprecated="1"
+           deprecated-version="1.12"
            parent="GObject.Object"
            glib:type-name="ClutterAnimation"
            glib:get-type="clutter_animation_get_type"
            glib:type-struct="AnimationClass">
       <doc xml:space="preserve">The #ClutterAnimation structure contains only private data and should
 be accessed using the provided functions.</doc>
+      <doc-deprecated xml:space="preserve">Use the implicit animation on #ClutterActor</doc-deprecated>
       <implements name="Scriptable"/>
       <constructor name="new"
                    c:identifier="clutter_animation_new"
@@ -11863,9 +11929,12 @@ started</doc>
     <record name="AnimationClass"
             c:type="ClutterAnimationClass"
             glib:is-gtype-struct-for="Animation"
-            version="1.0">
+            version="1.0"
+            deprecated="1"
+            deprecated-version="1.12">
       <doc xml:space="preserve">The #ClutterAnimationClass structure contains only private data and
 should be accessed using the provided functions.</doc>
+      <doc-deprecated xml:space="preserve">Use the implicit animation on #ClutterActor</doc-deprecated>
       <field name="parent_class" readable="0" private="1">
         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
       </field>
@@ -12743,6 +12812,8 @@ animation</doc>
     <record name="AnimatorKey"
             c:type="ClutterAnimatorKey"
             version="1.2"
+            deprecated="1"
+            deprecated-version="1.12"
             glib:type-name="ClutterAnimatorKey"
             glib:get-type="clutter_animator_key_get_type"
             c:symbol-prefix="animator_key">
@@ -13617,6 +13688,11 @@ Use g_value_unset() when done.</doc>
     <constant name="AudioMedia" value="269025074" c:type="CLUTTER_AudioMedia">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="AudioMicMute"
+              value="269025202"
+              c:type="CLUTTER_AudioMicMute">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="AudioMute" value="269025042" c:type="CLUTTER_AudioMute">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -16968,7 +17044,8 @@ and clutter_layout_manager_child_set()
 
 Language bindings should use the vector-based clutter_box_packv()
 variant instead</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_add_child() instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_add_child() instead. To set
+  specific layout properties, use clutter_layout_manager_child_set()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17006,7 +17083,8 @@ list of children, to be allocated and painted after every other child
 
 This function is a wrapper around clutter_container_add_actor(),
 clutter_container_raise_child() and clutter_layout_manager_child_set()</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_above() instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_above() instead.
+  To set specific layout properties, use clutter_layout_manager_child_set()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17049,7 +17127,8 @@ properties at the same time, if the #ClutterLayoutManager used by
 If @position is a negative number, or is larger than the number of
 children of @box, the new child is added at the end of the list of
 children</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_at_index() instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_at_index() instead.
+  To set specific layout properties, use clutter_layout_manager_child_set()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17091,7 +17170,8 @@ list of children, to be allocated and painted below every other child
 
 This function is a wrapper around clutter_container_add_actor(),
 clutter_container_lower_child() and clutter_layout_manager_child_set()</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_below() instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_insert_child_below() instead.
+  To set specific layout properties, use clutter_layout_manager_child_set()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17128,7 +17208,8 @@ clutter_container_lower_child() and clutter_layout_manager_child_set()</doc>
               deprecated-version="1.10">
         <doc xml:space="preserve">Vector-based variant of clutter_box_pack(), intended for language
 bindings to use</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_actor_add_child() instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_add_child() instead. To set
+  specific layout properties, use clutter_layout_manager_child_set()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -17211,18 +17292,30 @@ layout of the children of @box</doc>
       </method>
       <property name="color"
                 version="1.2"
+                deprecated="1"
+                deprecated-version="1.10"
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The color to be used to paint the background of the
 #ClutterBox. Setting this property will set the
-#ClutterBox:color-set property as a side effect</doc>
+#ClutterBox:color-set property as a side effect
+
+This property sets the #ClutterActor:background-color property
+internally.</doc>
+        <doc-deprecated xml:space="preserve">Use the #ClutterActor:background-color property</doc-deprecated>
         <type name="Color"/>
       </property>
       <property name="color-set"
                 version="1.2"
+                deprecated="1"
+                deprecated-version="1.10"
                 writable="1"
                 transfer-ownership="none">
-        <doc xml:space="preserve">Whether the #ClutterBox:color property has been set</doc>
+        <doc xml:space="preserve">Whether the #ClutterBox:color property has been set.
+
+This property reads the #ClutterActor:background-color-set property
+internally.</doc>
+        <doc-deprecated xml:space="preserve">Use the #ClutterActor:background-color-set property</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <field name="parent_instance" readable="0" private="1">
@@ -19536,7 +19629,7 @@ nodes to the 2D regions added to it.</doc>
             disguised="1"
             glib:is-gtype-struct-for="ClipNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterClipNodeClass&lt;/structname&gt; structure is an opaque
+      <doc xml:space="preserve">The `ClutterClipNodeClass` structure is an opaque
 type whose members cannot be directly accessed.</doc>
     </record>
     <class name="Clone"
@@ -19697,7 +19790,7 @@ and should be accessed using the provided API</doc>
           <type name="Color" c:type="ClutterColor*"/>
         </return-value>
       </constructor>
-      <constructor name="new" c:identifier="clutter_color_new" version="0.8.4">
+      <constructor name="new" c:identifier="clutter_color_new" version="0.8">
         <doc xml:space="preserve">Creates a new #ClutterColor with the given values.
 
 This function is the equivalent of:
@@ -20088,10 +20181,9 @@ color to a #ClutterColor.</doc>
       <function name="from_string"
                 c:identifier="clutter_color_from_string"
                 version="1.0">
-        <doc xml:space="preserve">Parses a string definition of a color, filling the
-&lt;structfield&gt;red&lt;/structfield&gt;, &lt;structfield&gt;green&lt;/structfield&gt;,
-&lt;structfield&gt;blue&lt;/structfield&gt; and &lt;structfield&gt;alpha&lt;/structfield&gt;
-channels of @color.
+        <doc xml:space="preserve">Parses a string definition of a color, filling the #ClutterColor.red,
+#ClutterColor.green, #ClutterColor.blue and #ClutterColor.alpha fields
+of @color.
 
 The @color is not allocated.
 
@@ -20198,7 +20290,7 @@ fill using @color.</doc>
             disguised="1"
             glib:is-gtype-struct-for="ColorNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterColorNodeClass&lt;/structname&gt; structure is an
+      <doc xml:space="preserve">The `ClutterColorNodeClass` structure is an
 opaque type whose members cannot be directly accessed.</doc>
     </record>
     <class name="ColorizeEffect"
@@ -20309,6 +20401,31 @@ private data and should be accessed using the provided API</doc>
           </parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="update_preferred_size">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="constraint" transfer-ownership="none">
+            <type name="Constraint" c:type="ClutterConstraint*"/>
+          </instance-parameter>
+          <parameter name="actor" transfer-ownership="none">
+            <type name="Actor" c:type="ClutterActor*"/>
+          </parameter>
+          <parameter name="direction" transfer-ownership="none">
+            <type name="Orientation" c:type="ClutterOrientation"/>
+          </parameter>
+          <parameter name="for_size" transfer-ownership="none">
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="minimum_size" transfer-ownership="none">
+            <type name="gfloat" c:type="float*"/>
+          </parameter>
+          <parameter name="natural_size" transfer-ownership="none">
+            <type name="gfloat" c:type="float*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
       <field name="parent_instance" readable="0" private="1">
         <type name="ActorMeta" c:type="ClutterActorMeta"/>
       </field>
@@ -20340,6 +20457,33 @@ only private data</doc>
           </parameters>
         </callback>
       </field>
+      <field name="update_preferred_size">
+        <callback name="update_preferred_size">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="constraint" transfer-ownership="none">
+              <type name="Constraint" c:type="ClutterConstraint*"/>
+            </parameter>
+            <parameter name="actor" transfer-ownership="none">
+              <type name="Actor" c:type="ClutterActor*"/>
+            </parameter>
+            <parameter name="direction" transfer-ownership="none">
+              <type name="Orientation" c:type="ClutterOrientation"/>
+            </parameter>
+            <parameter name="for_size" transfer-ownership="none">
+              <type name="gfloat" c:type="float"/>
+            </parameter>
+            <parameter name="minimum_size" transfer-ownership="none">
+              <type name="gfloat" c:type="float*"/>
+            </parameter>
+            <parameter name="natural_size" transfer-ownership="none">
+              <type name="gfloat" c:type="float*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
       <field name="_clutter_constraint1" introspectable="0">
         <callback name="_clutter_constraint1">
           <return-value transfer-ownership="none">
@@ -20389,13 +20533,6 @@ only private data</doc>
           </return-value>
         </callback>
       </field>
-      <field name="_clutter_constraint8" introspectable="0">
-        <callback name="_clutter_constraint8">
-          <return-value transfer-ownership="none">
-            <type name="none" c:type="void"/>
-          </return-value>
-        </callback>
-      </field>
     </record>
     <interface name="Container"
                c:symbol-prefix="container"
@@ -25992,7 +26129,7 @@ type used to denote the event sequence of a touch event.</doc>
               glib:get-type="clutter_feature_flags_get_type"
               c:type="ClutterFeatureFlags">
       <doc xml:space="preserve">Runtime flags indicating specific features available via Clutter window
-sysytem and graphics backend.</doc>
+system and graphics backend.</doc>
       <member name="texture_npot"
               value="4"
               c:identifier="CLUTTER_FEATURE_TEXTURE_NPOT"
@@ -26543,11 +26680,14 @@ a #ClutterFlowLayout</doc>
     </record>
     <bitfield name="FontFlags"
               version="1.0"
+              deprecated="1"
+              deprecated-version="1.22"
               glib:type-name="ClutterFontFlags"
               glib:get-type="clutter_font_flags_get_type"
               c:type="ClutterFontFlags">
       <doc xml:space="preserve">Runtime flags to change the font quality. To be used with
 clutter_set_font_flags().</doc>
+      <doc-deprecated xml:space="preserve">Use #cairo_font_options_t instead</doc-deprecated>
       <member name="mipmapping"
               value="1"
               c:identifier="CLUTTER_FONT_MIPMAPPING"
@@ -27653,12 +27793,15 @@ once the drag exceed the configured threshold.</doc>
     </constant>
     <enumeration name="Gravity"
                  version="0.2"
+                 deprecated="1"
+                 deprecated-version="1.22"
                  glib:type-name="ClutterGravity"
                  glib:get-type="clutter_gravity_get_type"
                  c:type="ClutterGravity">
       <doc xml:space="preserve">Gravity of the scaling operations. When a gravity different than
 %CLUTTER_GRAVITY_NONE is used, an actor is scaled keeping the position
 of the specified portion at the same coordinates.</doc>
+      <doc-deprecated xml:space="preserve">Use the normalized #ClutterActor pivot point instead</doc-deprecated>
       <member name="none"
               value="0"
               c:identifier="CLUTTER_GRAVITY_NONE"
@@ -28453,7 +28596,7 @@ data and should be accessed using the provided API</doc>
     <class name="Group"
            c:symbol-prefix="group"
            c:type="ClutterGroup"
-           version="0.1"
+           version="0.2"
            parent="Actor"
            glib:type-name="ClutterGroup"
            glib:get-type="clutter_group_get_type"
@@ -28542,7 +28685,7 @@ and should be accessed using the provided API</doc>
     <record name="GroupClass"
             c:type="ClutterGroupClass"
             glib:is-gtype-struct-for="Group"
-            version="0.1">
+            version="0.2">
       <doc xml:space="preserve">The #ClutterGroupClass structure contains only private data</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="ActorClass" c:type="ClutterActorClass"/>
@@ -29457,7 +29600,7 @@ instance, if you use the GdkPixbuf library:
 
   clutter_image_set_data (CLUTTER_IMAGE (image),
                           gdk_pixbuf_get_pixels (pixbuf),
-                          gdk_pixbuf_has_alpha (pixbuf)
+                          gdk_pixbuf_get_has_alpha (pixbuf)
                             ? COGL_PIXEL_FORMAT_RGBA_8888
                             : COGL_PIXEL_FORMAT_RGB_888,
                           gdk_pixbuf_get_width (pixbuf),
@@ -30026,6 +30169,21 @@ by the last event Clutter processed.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_product_id"
+              c:identifier="clutter_input_device_get_product_id"
+              version="1.22">
+        <doc xml:space="preserve">Gets the product ID of this device.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the product ID</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="device" transfer-ownership="none">
+            <doc xml:space="preserve">a slave #ClutterInputDevice</doc>
+            <type name="InputDevice" c:type="ClutterInputDevice*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_slave_devices"
               c:identifier="clutter_input_device_get_slave_devices"
               version="1.6">
@@ -30045,6 +30203,21 @@ by the last event Clutter processed.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_vendor_id"
+              c:identifier="clutter_input_device_get_vendor_id"
+              version="1.22">
+        <doc xml:space="preserve">Gets the vendor ID of this device.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the vendor ID</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="device" transfer-ownership="none">
+            <doc xml:space="preserve">a slave #ClutterInputDevice</doc>
+            <type name="InputDevice" c:type="ClutterInputDevice*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="grab"
               c:identifier="clutter_input_device_grab"
               version="1.10">
@@ -30378,6 +30551,22 @@ A device must be enabled in order to receive events from it.</doc>
         <doc xml:space="preserve">The name of the device</doc>
         <type name="utf8" c:type="gchar*"/>
       </property>
+      <property name="product-id"
+                version="1.22"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Product ID of this device.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
+      <property name="vendor-id"
+                version="1.22"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Vendor ID of this device.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
     </class>
     <record name="InputDeviceClass"
             c:type="ClutterInputDeviceClass"
@@ -30492,6 +30681,8 @@ date; not every platform supports every input device type.</doc>
     </constant>
     <enumeration name="Interpolation"
                  version="1.2"
+                 deprecated="1"
+                 deprecated-version="1.22"
                  glib:type-name="ClutterInterpolation"
                  glib:get-type="clutter_interpolation_get_type"
                  c:type="ClutterInterpolation">
@@ -32345,6 +32536,11 @@ a #GParamSpec.</doc>
               c:type="CLUTTER_KEY_AudioMedia">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="KEY_AudioMicMute"
+              value="269025202"
+              c:type="CLUTTER_KEY_AudioMicMute">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="KEY_AudioMute"
               value="269025042"
               c:type="CLUTTER_KEY_AudioMute">
@@ -38890,6 +39086,11 @@ a #GParamSpec.</doc>
               c:type="CLUTTER_KEY_dead_abovering">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="KEY_dead_aboveverticalline"
+              value="65169"
+              c:type="CLUTTER_KEY_dead_aboveverticalline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="KEY_dead_acute"
               value="65105"
               c:type="CLUTTER_KEY_dead_acute">
@@ -38935,6 +39136,11 @@ a #GParamSpec.</doc>
               c:type="CLUTTER_KEY_dead_belowtilde">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="KEY_dead_belowverticalline"
+              value="65170"
+              c:type="CLUTTER_KEY_dead_belowverticalline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="KEY_dead_breve"
               value="65109"
               c:type="CLUTTER_KEY_dead_breve">
@@ -39021,6 +39227,16 @@ a #GParamSpec.</doc>
               c:type="CLUTTER_KEY_dead_iota">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="KEY_dead_longsolidusoverlay"
+              value="65171"
+              c:type="CLUTTER_KEY_dead_longsolidusoverlay">
+      <type name="gint" c:type="gint"/>
+    </constant>
+    <constant name="KEY_dead_lowline"
+              value="65168"
+              c:type="CLUTTER_KEY_dead_lowline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="KEY_dead_macron"
               value="65108"
               c:type="CLUTTER_KEY_dead_macron">
@@ -41205,7 +41421,8 @@ device the event originated from, use clutter_event_get_source_device()</doc>
            glib:type-name="ClutterKeyframeTransition"
            glib:get-type="clutter_keyframe_transition_get_type"
            glib:type-struct="KeyframeTransitionClass">
-      <doc xml:space="preserve">FIXME</doc>
+      <doc xml:space="preserve">The `ClutterKeyframeTransition` structure contains only private
+data and should be accessed using the provided API.</doc>
       <implements name="Scriptable"/>
       <constructor name="new"
                    c:identifier="clutter_keyframe_transition_new"
@@ -41476,7 +41693,8 @@ at least as many elements as the number of key frames.</doc>
             c:type="ClutterKeyframeTransitionClass"
             glib:is-gtype-struct-for="KeyframeTransition"
             version="1.12">
-      <doc xml:space="preserve">FIXME</doc>
+      <doc xml:space="preserve">The `ClutterKeyframeTransitionClass` structure contains only
+private data.</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="PropertyTransitionClass"
               c:type="ClutterPropertyTransitionClass"/>
@@ -42934,11 +43152,11 @@ useful for language bindings.</doc>
       <doc xml:space="preserve">The major version of the Clutter library (1, if %CLUTTER_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MICRO_VERSION" value="0" c:type="CLUTTER_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="4" c:type="CLUTTER_MICRO_VERSION">
       <doc xml:space="preserve">The micro version of the Clutter library (3, if %CLUTTER_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MINOR_VERSION" value="20" c:type="CLUTTER_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="22" c:type="CLUTTER_MINOR_VERSION">
       <doc xml:space="preserve">The minor version of the Clutter library (2, if %CLUTTER_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
@@ -46430,8 +46648,8 @@ and 1.0 (fully curled)</doc>
            glib:unref-func="clutter_paint_node_unref"
            glib:set-value-func="clutter_value_set_paint_node"
            glib:get-value-func="clutter_value_get_paint_node">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterPaintNode&lt;/structname&gt; structure contains only
-private data and it should be accessed using the provided API.</doc>
+      <doc xml:space="preserve">The `ClutterPaintNode` structure contains only private data
+and it should be accessed using the provided API.</doc>
       <method name="add_child"
               c:identifier="clutter_paint_node_add_child"
               version="1.10">
@@ -46560,8 +46778,7 @@ The @node will copy the passed string.</doc>
             disguised="1"
             glib:is-gtype-struct-for="PaintNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterPaintNodeClass&lt;/structname&gt; structure contains
-only private data.</doc>
+      <doc xml:space="preserve">The `ClutterPaintNodeClass` structure contains only private data.</doc>
     </record>
     <record name="PaintNodePrivate"
             c:type="ClutterPaintNodePrivate"
@@ -47464,12 +47681,14 @@ a #ClutterColor.</doc>
            version="0.8"
            introspectable="0"
            deprecated="1"
+           deprecated-version="1.10"
            parent="GObject.ParamSpec"
            glib:type-name="ClutterParamSpecFixed"
            glib:get-type="clutter_param_fixed_get_type"
            glib:fundamental="1">
       <doc xml:space="preserve">#GParamSpec subclass for fixed point based properties</doc>
-      <doc-deprecated xml:space="preserve">Use #GParamSpecInt instead</doc-deprecated>
+      <doc-deprecated xml:space="preserve">Do not use fixed-point values in public
+  API. If you must, use #GParamSpecInt instead.</doc-deprecated>
       <field name="parent_instance" readable="0" private="1">
         <type name="GObject.ParamSpec" c:type="GParamSpec"/>
       </field>
@@ -48478,7 +48697,7 @@ type whose members cannot be directly accessed.</doc>
             disguised="1"
             glib:is-gtype-struct-for="PipelineNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterPipelineNodeClass&lt;/structname&gt; structure is an opaque
+      <doc xml:space="preserve">The `ClutterPipelineNodeClass` structure is an opaque
 type whose members cannot be directly accessed.</doc>
     </record>
     <record name="Point"
@@ -49395,7 +49614,7 @@ The returned value can be used as a guard.</doc>
     <class name="Rectangle"
            c:symbol-prefix="rectangle"
            c:type="ClutterRectangle"
-           version="0.1"
+           version="0.2"
            parent="Actor"
            glib:type-name="ClutterRectangle"
            glib:get-type="clutter_rectangle_get_type"
@@ -49406,19 +49625,27 @@ and should be accessed using the provided API</doc>
       <implements name="Animatable"/>
       <implements name="Container"/>
       <implements name="Scriptable"/>
-      <constructor name="new" c:identifier="clutter_rectangle_new">
+      <constructor name="new"
+                   c:identifier="clutter_rectangle_new"
+                   deprecated="1"
+                   deprecated-version="1.10">
         <doc xml:space="preserve">Creates a new #ClutterActor with a rectangular shape.</doc>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_new() instead</doc-deprecated>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a new #ClutterActor</doc>
+          <doc xml:space="preserve">a new #ClutterRectangle</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </return-value>
       </constructor>
       <constructor name="new_with_color"
-                   c:identifier="clutter_rectangle_new_with_color">
+                   c:identifier="clutter_rectangle_new_with_color"
+                   deprecated="1"
+                   deprecated-version="1.10">
         <doc xml:space="preserve">Creates a new #ClutterActor with a rectangular shape
 and of the given @color.</doc>
+        <doc-deprecated xml:space="preserve">Use clutter_actor_new() and
+  clutter_actor_set_background_color() instead</doc-deprecated>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a new #ClutterActor</doc>
+          <doc xml:space="preserve">a new #ClutterRectangle</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </return-value>
         <parameters>
@@ -49430,9 +49657,13 @@ and of the given @color.</doc>
       </constructor>
       <method name="get_border_color"
               c:identifier="clutter_rectangle_get_border_color"
-              version="0.2">
+              version="0.2"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Gets the color of the border used by @rectangle and places
 it into @color.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and a #ClutterCanvas to draw
+  the border with Cairo</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -49452,8 +49683,12 @@ it into @color.</doc>
       </method>
       <method name="get_border_width"
               c:identifier="clutter_rectangle_get_border_width"
-              version="0.2">
+              version="0.2"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Gets the width (in pixels) of the border used by @rectangle</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and a #ClutterCanvas content
+  to draw the border using Cairo</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the border's width</doc>
           <type name="guint" c:type="guint"/>
@@ -49465,8 +49700,13 @@ it into @color.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="get_color" c:identifier="clutter_rectangle_get_color">
+      <method name="get_color"
+              c:identifier="clutter_rectangle_get_color"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Retrieves the color of @rectangle.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and clutter_actor_get_background_color()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -49485,8 +49725,12 @@ it into @color.</doc>
         </parameters>
       </method>
       <method name="set_border_color"
-              c:identifier="clutter_rectangle_set_border_color">
+              c:identifier="clutter_rectangle_set_border_color"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Sets the color of the border used by @rectangle using @color</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and a #ClutterCanvas to draw
+  the border with Cairo</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -49503,9 +49747,13 @@ it into @color.</doc>
       </method>
       <method name="set_border_width"
               c:identifier="clutter_rectangle_set_border_width"
-              version="0.2">
+              version="0.2"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Sets the width (in pixel) of the border used by @rectangle.
 A @width of 0 will unset the border.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and a #ClutterCanvas content
+  to draw the border using Cairo</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -49520,8 +49768,13 @@ A @width of 0 will unset the border.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="set_color" c:identifier="clutter_rectangle_set_color">
+      <method name="set_color"
+              c:identifier="clutter_rectangle_set_color"
+              deprecated="1"
+              deprecated-version="1.10">
         <doc xml:space="preserve">Sets the color of @rectangle.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor and clutter_actor_set_background_color()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -49571,7 +49824,7 @@ A @width of 0 will unset the border.</doc>
     <record name="RectangleClass"
             c:type="ClutterRectangleClass"
             glib:is-gtype-struct-for="Rectangle"
-            version="0.1">
+            version="0.2">
       <doc xml:space="preserve">The #ClutterRectangleClass structure contains only private data</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="ActorClass" c:type="ClutterActorClass"/>
@@ -49675,6 +49928,13 @@ A @width of 0 will unset the border.</doc>
               glib:nick="width-for-height">
         <doc xml:space="preserve">Width for height requests</doc>
       </member>
+      <member name="content_size"
+              value="2"
+              c:identifier="CLUTTER_REQUEST_CONTENT_SIZE"
+              glib:nick="content-size">
+        <doc xml:space="preserve">Use the preferred size of the
+  #ClutterContent, if it has any (available since 1.22)</doc>
+      </member>
     </enumeration>
     <constant name="Return" value="65293" c:type="CLUTTER_Return">
       <type name="gint" c:type="gint"/>
@@ -49867,6 +50127,8 @@ only private data.</doc>
     </enumeration>
     <enumeration name="RotateDirection"
                  version="0.4"
+                 deprecated="1"
+                 deprecated-version="1.22"
                  glib:type-name="ClutterRotateDirection"
                  glib:get-type="clutter_rotate_direction_get_type"
                  c:type="ClutterRotateDirection">
@@ -50829,7 +51091,7 @@ rarely be used.</doc>
       </method>
       <method name="list_objects"
               c:identifier="clutter_script_list_objects"
-              version="0.8.2">
+              version="0.8">
         <doc xml:space="preserve">Retrieves all the objects created by @script.
 
 Note: this function does not increment the reference count of the
@@ -51795,7 +52057,7 @@ device the event originated from, use clutter_event_get_source_device()</doc>
            glib:type-name="ClutterSettings"
            glib:get-type="clutter_settings_get_type"
            glib:type-struct="SettingsClass">
-      <doc xml:space="preserve">&lt;structname&gt;ClutterSettings&lt;/structname&gt; is an opaque structure whose
+      <doc xml:space="preserve">`ClutterSettings` is an opaque structure whose
 members cannot be directly accessed.</doc>
       <function name="get_default"
                 c:identifier="clutter_settings_get_default"
@@ -51968,11 +52230,6 @@ and should be accessed using the provided API</doc>
           <type name="Shader" c:type="ClutterShader*"/>
         </return-value>
       </constructor>
-      <function name="error_quark" c:identifier="clutter_shader_error_quark">
-        <return-value transfer-ownership="none">
-          <type name="GLib.Quark" c:type="GQuark"/>
-        </return-value>
-      </function>
       <method name="compile"
               c:identifier="clutter_shader_compile"
               version="0.8"
@@ -52605,23 +52862,34 @@ only private data</doc>
                  version="0.6"
                  deprecated="1"
                  deprecated-version="1.8"
-                 c:type="ClutterShaderError">
+                 glib:type-name="ClutterShaderError"
+                 glib:get-type="clutter_shader_error_get_type"
+                 c:type="ClutterShaderError"
+                 glib:error-domain="clutter-shader-error">
       <doc xml:space="preserve">#ClutterShader error enumeration</doc>
       <member name="no_asm"
               value="0"
-              c:identifier="CLUTTER_SHADER_ERROR_NO_ASM">
+              c:identifier="CLUTTER_SHADER_ERROR_NO_ASM"
+              glib:nick="no-asm">
         <doc xml:space="preserve">No ASM shaders support</doc>
       </member>
       <member name="no_glsl"
               value="1"
-              c:identifier="CLUTTER_SHADER_ERROR_NO_GLSL">
+              c:identifier="CLUTTER_SHADER_ERROR_NO_GLSL"
+              glib:nick="no-glsl">
         <doc xml:space="preserve">No GLSL shaders support</doc>
       </member>
       <member name="compile"
               value="2"
-              c:identifier="CLUTTER_SHADER_ERROR_COMPILE">
+              c:identifier="CLUTTER_SHADER_ERROR_COMPILE"
+              glib:nick="compile">
         <doc xml:space="preserve">Compilation error</doc>
       </member>
+      <function name="quark" c:identifier="clutter_shader_error_quark">
+        <return-value transfer-ownership="none">
+          <type name="GLib.Quark" c:type="GQuark"/>
+        </return-value>
+      </function>
     </enumeration>
     <class name="ShaderFloat"
            c:symbol-prefix="shader_float"
@@ -53268,7 +53536,7 @@ and #ClutterSnapConstraint:to-edge</doc>
     <class name="Stage"
            c:symbol-prefix="stage"
            c:type="ClutterStage"
-           version="0.1"
+           version="0.2"
            parent="Group"
            glib:type-name="ClutterStage"
            glib:get-type="clutter_stage_get_type"
@@ -54341,7 +54609,7 @@ See clutter_stage_set_no_clear_hint() for further information.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="perspective"
-                version="0.8.2"
+                version="0.8"
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The parameters used for the perspective projection from 3D
@@ -54452,7 +54720,7 @@ state.</doc>
     <record name="StageClass"
             c:type="ClutterStageClass"
             glib:is-gtype-struct-for="Stage"
-            version="0.1">
+            version="0.2">
       <doc xml:space="preserve">The #ClutterStageClass structure contains only private data</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="GroupClass" c:type="ClutterGroupClass"/>
@@ -56266,10 +56534,13 @@ only private data.</doc>
     </constant>
     <enumeration name="TableAlignment"
                  version="1.4"
+                 deprecated="1"
+                 deprecated-version="1.22"
                  glib:type-name="ClutterTableAlignment"
                  glib:get-type="clutter_table_alignment_get_type"
                  c:type="ClutterTableAlignment">
       <doc xml:space="preserve">The alignment policies available on each axis of the #ClutterTableLayout</doc>
+      <doc-deprecated xml:space="preserve">Use the alignment properties of #ClutterActor</doc-deprecated>
       <member name="start"
               value="0"
               c:identifier="CLUTTER_TABLE_ALIGNMENT_START"
@@ -56361,7 +56632,7 @@ clutter_table_layout_set_alignment().</doc>
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Retrieve the current number of columns in @layout</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">No direct replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of columns</doc>
           <type name="gint" c:type="gint"/>
@@ -56379,7 +56650,7 @@ clutter_table_layout_set_alignment().</doc>
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Retrieves the spacing set using clutter_table_layout_set_column_spacing()</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:column-spacing</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the spacing between columns of the #ClutterTableLayout</doc>
           <type name="guint" c:type="guint"/>
@@ -56397,6 +56668,9 @@ clutter_table_layout_set_alignment().</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the duration set using clutter_table_layout_set_easing_duration()</doc>
+        <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the duration of the animations, in milliseconds</doc>
           <type name="guint" c:type="guint"/>
@@ -56415,7 +56689,8 @@ clutter_table_layout_set_alignment().</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the easing mode set using clutter_table_layout_set_easing_mode()</doc>
         <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
-  of the children when allocating them</doc-deprecated>
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">an easing mode</doc>
           <type name="gulong" c:type="gulong"/>
@@ -56507,7 +56782,7 @@ as set using clutter_table_layout_pack() or clutter_table_layout_set_fill()</doc
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Retrieve the current number rows in the @layout</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">No direct replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of rows</doc>
           <type name="gint" c:type="gint"/>
@@ -56525,7 +56800,7 @@ as set using clutter_table_layout_pack() or clutter_table_layout_set_fill()</doc
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Retrieves the spacing set using clutter_table_layout_set_row_spacing()</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:row-spacing instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the spacing between rows of the #ClutterTableLayout</doc>
           <type name="guint" c:type="guint"/>
@@ -56544,7 +56819,8 @@ as set using clutter_table_layout_pack() or clutter_table_layout_set_fill()</doc
               deprecated-version="1.18">
         <doc xml:space="preserve">Retrieves the row and column span for @actor as set using
 clutter_table_layout_pack() or clutter_table_layout_set_span()</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use the `width` and `height` layout properties
+  of #ClutterGridLayout instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56581,6 +56857,9 @@ clutter_table_layout_pack() or clutter_table_layout_set_span()</doc>
         <doc xml:space="preserve">Retrieves whether @layout should animate changes in the layout properties
 
 Since clutter_table_layout_set_use_animations()</doc>
+        <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the animations should be used, %FALSE otherwise</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -56599,7 +56878,7 @@ Since clutter_table_layout_set_use_animations()</doc>
               deprecated-version="1.18">
         <doc xml:space="preserve">Packs @actor inside the #ClutterContainer associated to @layout
 at the given row and column.</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use clutter_grid_layout_attach_child() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56659,7 +56938,7 @@ inside @layout</doc>
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Sets the spacing between columns of @layout</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:column-spacing instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56685,7 +56964,8 @@ in the layout properties
 Use clutter_table_layout_set_use_animations() to enable and disable the
 animations</doc>
         <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
-  of the children when allocating them</doc-deprecated>
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56711,7 +56991,8 @@ properties
 Use clutter_table_layout_set_use_animations() to enable and disable the
 animations</doc>
         <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
-  of the children when allocating them</doc-deprecated>
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56795,7 +57076,7 @@ inside @layout</doc>
               deprecated="1"
               deprecated-version="1.18">
         <doc xml:space="preserve">Sets the spacing between rows of @layout</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:row-spacing instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56817,7 +57098,8 @@ inside @layout</doc>
               deprecated-version="1.18">
         <doc xml:space="preserve">Sets the row and column span for @actor
 inside @layout</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout instead</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use the `width` and `height` layout properties
+  of #ClutterGridLayout instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56851,7 +57133,8 @@ The duration of the animations is controlled by
 clutter_table_layout_set_easing_duration(); the easing mode to be used
 by the animations is controlled by clutter_table_layout_set_easing_mode()</doc>
         <doc-deprecated xml:space="preserve">#ClutterTableLayout will honour the easing state
-  of the children when allocating them</doc-deprecated>
+  of the children when allocating them. See clutter_actor_set_easing_mode()
+  and clutter_actor_set_easing_duration().</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -56873,6 +57156,7 @@ by the animations is controlled by clutter_table_layout_set_easing_mode()</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The spacing between columns of the #ClutterTableLayout, in pixels</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:column-spacing instead</doc-deprecated>
         <type name="guint" c:type="guint"/>
       </property>
       <property name="easing-duration"
@@ -56915,6 +57199,7 @@ The default value is %CLUTTER_EASE_OUT_CUBIC.</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The spacing between rows of the #ClutterTableLayout, in pixels</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterGridLayout:row-spacing instead</doc-deprecated>
         <type name="guint" c:type="guint"/>
       </property>
       <property name="use-animations"
@@ -59805,7 +60090,7 @@ is safe to call g_object_unref() after it returns.</doc>
             disguised="1"
             glib:is-gtype-struct-for="TextNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterTextNodeClass&lt;/structname&gt; structure is an opaque
+      <doc xml:space="preserve">The `ClutterTextNodeClass` structure is an opaque
 type whose contents cannot be directly accessed.</doc>
     </record>
     <record name="TextPrivate" c:type="ClutterTextPrivate" disguised="1">
@@ -59813,7 +60098,7 @@ type whose contents cannot be directly accessed.</doc>
     <class name="Texture"
            c:symbol-prefix="texture"
            c:type="ClutterTexture"
-           version="0.1"
+           version="0.2"
            parent="Actor"
            glib:type-name="ClutterTexture"
            glib:get-type="clutter_texture_get_type"
@@ -59829,6 +60114,7 @@ and should be accessed using the provided API</doc>
                    deprecated="1"
                    deprecated-version="1.12">
         <doc xml:space="preserve">Creates a new empty #ClutterTexture object.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">A newly created #ClutterTexture object.</doc>
           <type name="Actor" c:type="ClutterActor*"/>
@@ -59911,6 +60197,8 @@ Some tips on usage:
         <doc xml:space="preserve">Creates a new ClutterTexture actor to display the image contained a
 file. If the image failed to load then NULL is returned and @error
 is set.</doc>
+        <doc-deprecated xml:space="preserve">No direct replacement is available. Use #ClutterImage
+  and platform-specific image loading API, like GdkPixbuf, instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">A newly created #ClutterTexture object or NULL on
 error.</doc>
@@ -59967,6 +60255,8 @@ error.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Gets the size in pixels of the untransformed underlying image</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_content_get_preferred_size()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -59998,6 +60288,9 @@ error.</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Returns a handle to the underlying COGL material used for drawing
 the actor.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available; it's not advisable
+  to modify the Cogl pipeline of an actor. Use a #ClutterContent
+  implementation and modify the pipeline during the paint sequence</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a handle for a #CoglMaterial. The
   material is owned by the #ClutterTexture and it should not be
@@ -60024,6 +60317,10 @@ The texture handle returned is the first layer of the material
 handle used by the #ClutterTexture. If you need to access the other
 layers you should use clutter_texture_get_cogl_material() instead
 and use the #CoglMaterial API.</doc>
+        <doc-deprecated xml:space="preserve">No replacement available; it's not advisable to
+  modify the Cogl pipeline of an actor. Use a #ClutterContent
+  implementation and set up the pipeline during the paint sequence
+  instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #CoglHandle for the texture. The returned
   handle is owned by the #ClutterTexture and it should not be unreferenced</doc>
@@ -60042,6 +60339,8 @@ and use the #CoglMaterial API.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Gets the filter quality used when scaling a texture.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_get_content_scaling_filters()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The filter quality value.</doc>
           <type name="TextureQuality" c:type="ClutterTextureQuality"/>
@@ -60059,6 +60358,8 @@ and use the #CoglMaterial API.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the value set using clutter_texture_set_keep_aspect_ratio()</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_get_content_gravity()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the #ClutterTexture should maintain the
   aspect ratio of the underlying image</doc>
@@ -60077,6 +60378,7 @@ and use the #CoglMaterial API.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the value set using clutter_texture_set_load_async()</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the #ClutterTexture should load the data from
   disk asynchronously</doc>
@@ -60095,6 +60397,7 @@ and use the #CoglMaterial API.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the value set by clutter_texture_set_load_data_async()</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the #ClutterTexture should load the image
   data from a file asynchronously</doc>
@@ -60114,6 +60417,7 @@ and use the #CoglMaterial API.</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Gets the maximum waste that will be used when creating a texture or
 -1 if slicing is disabled.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The maximum waste or -1 if the texture waste is
   unlimited.</doc>
@@ -60132,6 +60436,7 @@ and use the #CoglMaterial API.</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the value set by clutter_texture_set_load_data_async()</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the #ClutterTexture should define its shape
 using the alpha channel when picking.</doc>
@@ -60158,6 +60463,7 @@ equivalent to:
   if (handle != COGL_INVALID_HANDLE)
     format = cogl_texture_get_format (handle);
 ]|</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #CoglPixelFormat value</doc>
           <type name="Cogl.PixelFormat" c:type="CoglPixelFormat"/>
@@ -60176,6 +60482,8 @@ equivalent to:
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the horizontal and vertical repeat values set
 using clutter_texture_set_repeat()</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_get_content_repeat()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60206,6 +60514,7 @@ using clutter_texture_set_repeat()</doc>
               deprecated="1"
               deprecated-version="1.12">
         <doc xml:space="preserve">Retrieves the value set with clutter_texture_set_sync_size()</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the #ClutterTexture should have the same
   preferred size of the underlying image data</doc>
@@ -60225,6 +60534,7 @@ using clutter_texture_set_repeat()</doc>
               deprecated-version="1.12"
               throws="1">
         <doc xml:space="preserve">Updates a sub-region of the pixel data in a #ClutterTexture.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_image_set_area() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, %FALSE on failure.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -60288,6 +60598,9 @@ calling this function also replaces the Cogl
 texture. #ClutterTexture requires that the material have a texture
 layer so you should set one on the material before calling this
 function.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available; it's not advisable
+  to modify the Cogl pipeline of an actor. Use a #ClutterContent
+  implementation and modify the pipeline during the paint sequence</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60310,6 +60623,10 @@ function.</doc>
         <doc xml:space="preserve">Replaces the underlying COGL texture drawn by this actor with
 @cogl_tex. A reference to the texture is taken so if the handle is
 no longer needed it should be deref'd with cogl_handle_unref.</doc>
+        <doc-deprecated xml:space="preserve">No replacement available; it's not advisable to
+  modify the Cogl pipeline of an actor. Use a #ClutterContent
+  implementation and set up the pipeline during the paint sequence
+  instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60337,6 +60654,8 @@ bit more expensive (bilinear interpolation), and
 %CLUTTER_TEXTURE_QUALITY_HIGH which uses extra texture memory resources to
 improve scaled down rendering as well (by using mipmaps). The default value
 is %CLUTTER_TEXTURE_QUALITY_MEDIUM.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_set_content_scaling_filters()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60366,6 +60685,8 @@ from disk will be performed asynchronously. #ClutterTexture::size-change
 will be emitten when the size of the texture is available and
 #ClutterTexture::load-finished will be emitted when the image has been
 loaded or if an error occurred.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and platform-specific image
+  loading API, like GdkPixbuf, instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the image was successfully loaded and set</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -60388,6 +60709,7 @@ loaded or if an error occurred.</doc>
               deprecated-version="1.12"
               throws="1">
         <doc xml:space="preserve">Sets #ClutterTexture image data.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_image_set_data() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, %FALSE on failure.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -60445,9 +60767,9 @@ few drivers exposing this capability are not really useful.
 The proper way to convert image data in any YUV colorspace to any
 RGB colorspace is to use a fragment shader associated with the
 #ClutterTexture material.</doc>
-        <doc-deprecated xml:space="preserve">Use clutter_texture_get_cogl_material() and
-  the Cogl API to install a fragment shader for decoding YUV
-  formats on the GPU</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use a custom #ClutterContent implementation and
+  set up the Cogl pipeline using a #ClutterPipelineNode with a
+  fragment shader instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the texture was successfully updated</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -60484,6 +60806,8 @@ RGB colorspace is to use a fragment shader associated with the
               deprecated-version="1.12">
         <doc xml:space="preserve">Sets whether @texture should have a preferred size maintaining
 the aspect ratio of the underlying image</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_set_content_gravity()
+  with %CLUTTER_CONTENT_GRAVITY_RESIZE_ASPECT instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60509,6 +60833,9 @@ clutter_texture_set_from_file() return immediately.
 
 See the #ClutterTexture:load-async property documentation, and
 clutter_texture_set_load_data_async().</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function.
+  Use #ClutterImage and platform-specific API for loading image data
+  asynchronously, like GdkPixbuf</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60536,6 +60863,9 @@ determined the width and height of the image data.
 
 See the #ClutterTexture:load-async property documentation, and
 clutter_texture_set_load_async().</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function.
+  Use #ClutterImage and platform-specific API for loading image data
+  asynchronously, like GdkPixbuf</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60567,6 +60897,7 @@ internally.
 Also there is currently no control over the threshold used to
 determine what value of alpha is considered pickable, and so only
 fully opaque parts of the texture will react to picking.</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this function</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60589,6 +60920,8 @@ fully opaque parts of the texture will react to picking.</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Sets whether the @texture should repeat horizontally or
 vertically when the actor size is bigger than the image size</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and clutter_actor_set_content_repeat()
+  instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60614,6 +60947,10 @@ vertically when the actor size is bigger than the image size</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Sets whether @texture should have the same preferred size as the
 underlying image data.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available. A #ClutterActor using
+  #ClutterImage with a %CLUTTER_REQUEST_CONTENT_SIZE request mode
+  will automatically bind the preferred size of the content to the
+  preferred size of the actor</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60657,6 +60994,8 @@ the texture.
 
 This property is unset when using the clutter_texture_set_from_*_data()
 family of functions.</doc>
+        <doc-deprecated xml:space="preserve">Use #ClutterImage and platform-specific image loading
+  API, like GdkPixbuf</doc-deprecated>
         <type name="utf8" c:type="gchar*"/>
       </property>
       <property name="filter-quality"
@@ -60690,6 +61029,7 @@ the image.
 The upload of the texture data on the GL pipeline is not asynchronous, as
 it must be performed from within the same thread that called
 clutter_main().</doc>
+        <doc-deprecated xml:space="preserve">Use platform-specific image loading API, like GdkPixbuf</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="load-data-async"
@@ -60701,6 +61041,7 @@ clutter_main().</doc>
                 transfer-ownership="none">
         <doc xml:space="preserve">Like #ClutterTexture:load-async but loads the width and height
 synchronously causing some blocking.</doc>
+        <doc-deprecated xml:space="preserve">Use platform-specific image loading API, like GdkPixbuf</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="pick-with-alpha" writable="1" transfer-ownership="none">
@@ -60735,6 +61076,7 @@ synchronously causing some blocking.</doc>
         <doc xml:space="preserve">The ::load-finished signal is emitted when a texture load has
 completed. If there was an error during loading, @error will
 be set, otherwise it will be %NULL</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60751,6 +61093,7 @@ be set, otherwise it will be %NULL</doc>
                    deprecated-version="1.12">
         <doc xml:space="preserve">The ::pixbuf-change signal is emitted each time the pixbuf
 used by @texture changes.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60762,6 +61105,7 @@ used by @texture changes.</doc>
         <doc xml:space="preserve">The ::size-change signal is emitted each time the size of the
 pixbuf used by @texture changes.  The new size is given as
 argument to the callback.</doc>
+        <doc-deprecated xml:space="preserve">No replacement is available</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -60780,7 +61124,7 @@ argument to the callback.</doc>
     <record name="TextureClass"
             c:type="ClutterTextureClass"
             glib:is-gtype-struct-for="Texture"
-            version="0.1">
+            version="0.2">
       <doc xml:space="preserve">The #ClutterTextureClass structure contains only private data</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="ActorClass" c:type="ClutterActorClass"/>
@@ -60902,11 +61246,15 @@ clutter_texture_set_from_yuv_data is unsupported.</doc>
     </enumeration>
     <bitfield name="TextureFlags"
               version="0.4"
+              deprecated="1"
+              deprecated-version="1.22"
               glib:type-name="ClutterTextureFlags"
               glib:get-type="clutter_texture_flags_get_type"
               c:type="ClutterTextureFlags">
       <doc xml:space="preserve">Flags for clutter_texture_set_from_rgb_data() and
 clutter_texture_set_from_yuv_data().</doc>
+      <doc-deprecated xml:space="preserve">The #ClutterTexture class was the only user of
+  this API</doc-deprecated>
       <member name="none"
               value="0"
               c:identifier="CLUTTER_TEXTURE_NONE"
@@ -60917,19 +61265,19 @@ clutter_texture_set_from_yuv_data().</doc>
               value="2"
               c:identifier="CLUTTER_TEXTURE_RGB_FLAG_BGR"
               glib:nick="rgb-flag-bgr">
-        <doc xml:space="preserve">FIXME</doc>
+        <doc xml:space="preserve">Unused flag</doc>
       </member>
       <member name="rgb_flag_premult"
               value="4"
               c:identifier="CLUTTER_TEXTURE_RGB_FLAG_PREMULT"
               glib:nick="rgb-flag-premult">
-        <doc xml:space="preserve">FIXME</doc>
+        <doc xml:space="preserve">Unused flag</doc>
       </member>
       <member name="yuv_flag_yuv2"
               value="8"
               c:identifier="CLUTTER_TEXTURE_YUV_FLAG_YUV2"
               glib:nick="yuv-flag-yuv2">
-        <doc xml:space="preserve">FIXME</doc>
+        <doc xml:space="preserve">Unused flag</doc>
       </member>
     </bitfield>
     <class name="TextureNode"
@@ -60987,17 +61335,22 @@ be used for blending.</doc>
             disguised="1"
             glib:is-gtype-struct-for="TextureNode"
             version="1.10">
-      <doc xml:space="preserve">The &lt;structname&gt;ClutterTextureNodeClass&lt;/structname&gt; structure is an
+      <doc xml:space="preserve">The `ClutterTextureNodeClass` structure is an
 opaque type whose members cannot be directly accessed.</doc>
     </record>
     <record name="TexturePrivate" c:type="ClutterTexturePrivate" disguised="1">
     </record>
     <enumeration name="TextureQuality"
                  version="0.8"
+                 deprecated="1"
+                 deprecated-version="1.22"
                  glib:type-name="ClutterTextureQuality"
                  glib:get-type="clutter_texture_quality_get_type"
                  c:type="ClutterTextureQuality">
       <doc xml:space="preserve">Enumaration controlling the texture quality.</doc>
+      <doc-deprecated xml:space="preserve">The #ClutterTexture class was the only used ot
+  this API; use #ClutterImage and clutter_actor_set_content_scaling_filters()
+  instead.</doc-deprecated>
       <member name="low"
               value="0"
               c:identifier="CLUTTER_TEXTURE_QUALITY_LOW"
@@ -62610,6 +62963,7 @@ interval after the function completes so the delay between calls
 would be @interval * 1.5. This function does not however try to
 invoke the function multiple times to catch up missing frames if
 @func takes more than @interval ms to execute.</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the ID (greater than 0) of the timeout inside the pool.
   Use clutter_timeout_pool_remove() to stop the timeout.</doc>
@@ -62650,6 +63004,7 @@ invoke the function multiple times to catch up missing frames if
         <doc xml:space="preserve">Removes a timeout function with @id_ from the timeout pool. The id
 is the same returned when adding a function to the timeout pool with
 clutter_timeout_pool_add().</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -62677,6 +63032,7 @@ the main loop. A timeout pool allocates a single time slice of the main
 loop and runs every timeout function inside it. The timeout pool is
 always sorted, so that the extraction of the next timeout function is
 a constant time operation.</doc>
+        <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
         <return-value>
           <doc xml:space="preserve">the newly created #ClutterTimeoutPool. The created pool
   is owned by the GLib default context and will be automatically
@@ -63797,7 +64153,7 @@ If no unit is specified, pixels are assumed.</doc>
     <constant name="V" value="86" c:type="CLUTTER_V">
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="VERSION" value="1.200000" c:type="CLUTTER_VERSION">
+    <constant name="VERSION" value="1.220000" c:type="CLUTTER_VERSION">
       <doc xml:space="preserve">The full version of the Clutter library, like 1.2.3</doc>
       <type name="gdouble" c:type="gdouble"/>
     </constant>
@@ -63805,7 +64161,7 @@ If no unit is specified, pixels are assumed.</doc>
       <doc xml:space="preserve">Numerically encoded version of the Clutter library, like 0x010203</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="VERSION_S" value="1.20.0" c:type="CLUTTER_VERSION_S">
+    <constant name="VERSION_S" value="1.22.4" c:type="CLUTTER_VERSION_S">
       <doc xml:space="preserve">The full version of the Clutter library, in string form (suited for
 string concatenation)</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -66089,10 +66445,9 @@ color to a #ClutterColor.</doc>
               c:identifier="clutter_color_from_string"
               moved-to="Color.from_string"
               version="1.0">
-      <doc xml:space="preserve">Parses a string definition of a color, filling the
-&lt;structfield&gt;red&lt;/structfield&gt;, &lt;structfield&gt;green&lt;/structfield&gt;,
-&lt;structfield&gt;blue&lt;/structfield&gt; and &lt;structfield&gt;alpha&lt;/structfield&gt;
-channels of @color.
+      <doc xml:space="preserve">Parses a string definition of a color, filling the #ClutterColor.red,
+#ClutterColor.green, #ClutterColor.blue and #ClutterColor.alpha fields
+of @color.
 
 The @color is not allocated.
 
@@ -66283,6 +66638,11 @@ available and valid</doc>
               c:type="CLUTTER_dead_abovering">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="dead_aboveverticalline"
+              value="65169"
+              c:type="CLUTTER_dead_aboveverticalline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="dead_acute" value="65105" c:type="CLUTTER_dead_acute">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -66326,6 +66686,11 @@ available and valid</doc>
               c:type="CLUTTER_dead_belowtilde">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="dead_belowverticalline"
+              value="65170"
+              c:type="CLUTTER_dead_belowverticalline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="dead_breve" value="65109" c:type="CLUTTER_dead_breve">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -66394,6 +66759,14 @@ available and valid</doc>
     <constant name="dead_iota" value="65117" c:type="CLUTTER_dead_iota">
       <type name="gint" c:type="gint"/>
     </constant>
+    <constant name="dead_longsolidusoverlay"
+              value="65171"
+              c:type="CLUTTER_dead_longsolidusoverlay">
+      <type name="gint" c:type="gint"/>
+    </constant>
+    <constant name="dead_lowline" value="65168" c:type="CLUTTER_dead_lowline">
+      <type name="gint" c:type="gint"/>
+    </constant>
     <constant name="dead_macron" value="65108" c:type="CLUTTER_dead_macron">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -66767,7 +67140,7 @@ clutter_event_add_filter().</doc>
     </constant>
     <function name="feature_available"
               c:identifier="clutter_feature_available"
-              version="0.1.1">
+              version="0.2">
       <doc xml:space="preserve">Checks whether @feature is available.  @feature can be a logical
 OR of #ClutterFeatureFlags.</doc>
       <return-value transfer-ownership="none">
@@ -66783,7 +67156,7 @@ OR of #ClutterFeatureFlags.</doc>
     </function>
     <function name="feature_get_all"
               c:identifier="clutter_feature_get_all"
-              version="0.1.1">
+              version="0.2">
       <doc xml:space="preserve">Returns all the supported features.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a logical OR of all the supported features.</doc>
@@ -66864,6 +67237,7 @@ OR of #ClutterFeatureFlags.</doc>
               deprecated="1"
               deprecated-version="1.6">
       <doc xml:space="preserve">Simple wrapper around clutter_frame_source_add_full().</doc>
+      <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -66905,6 +67279,7 @@ function completes so the delay between calls would be 1.0 / @fps *
 1.5. This function does not however try to invoke the function
 multiple times to catch up missing frames if @func takes more than
 @interval ms to execute.</doc>
+      <doc-deprecated xml:space="preserve">There is no direct replacement for this API.</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -66975,7 +67350,9 @@ implementation available</doc>
               deprecated="1"
               deprecated-version="1.8">
       <doc xml:space="preserve">Retrieves the #ClutterActor with @id_.</doc>
-      <doc-deprecated xml:space="preserve">The id is not used any longer.</doc-deprecated>
+      <doc-deprecated xml:space="preserve">The id is deprecated, and this function always returns
+  %NULL. Use the proper scene graph API in #ClutterActor to find a child
+  of the stage.</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the actor with the passed id or %NULL.
   The returned actor does not have its reference count increased.</doc>
@@ -67047,7 +67424,7 @@ event or if the event has a timestamp.</doc>
               c:identifier="clutter_get_default_text_direction"
               version="1.2">
       <doc xml:space="preserve">Retrieves the default direction for the text. The text direction is
-determined by the locale and/or by the &lt;varname&gt;CLUTTER_TEXT_DIRECTION&lt;/varname&gt;
+determined by the locale and/or by the `CLUTTER_TEXT_DIRECTION`
 environment variable.
 
 The default text direction can be overridden on a per-actor basis by using
@@ -67166,7 +67543,7 @@ initialized.</doc>
     </function>
     <function name="get_option_group_without_init"
               c:identifier="clutter_get_option_group_without_init"
-              version="0.8.2"
+              version="0.8"
               introspectable="0">
       <doc xml:space="preserve">Returns a #GOptionGroup for the command line arguments recognized
 by Clutter. You should add this group to your #GOptionContext with
@@ -68423,7 +68800,7 @@ values.</doc>
     </constant>
     <function name="param_spec_color"
               c:identifier="clutter_param_spec_color"
-              version="0.8.4"
+              version="0.8"
               introspectable="0">
       <doc xml:space="preserve">Creates a #GParamSpec for properties using #ClutterColor.</doc>
       <return-value>
@@ -68871,6 +69248,13 @@ clutter_get_option_context()</doc>
               c:type="CLUTTER_sevensuperior">
       <type name="gint" c:type="gint"/>
     </constant>
+    <function name="shader_error_quark"
+              c:identifier="clutter_shader_error_quark"
+              moved-to="ShaderError.quark">
+      <return-value transfer-ownership="none">
+        <type name="GLib.Quark" c:type="GQuark"/>
+      </return-value>
+    </function>
     <constant name="signaturemark" value="2762" c:type="CLUTTER_signaturemark">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -68936,44 +69320,62 @@ clutter_get_option_context()</doc>
     </constant>
     <function name="test_add"
               c:identifier="clutter_test_add"
+              version="1.18"
               introspectable="0">
+      <doc xml:space="preserve">Adds a test unit to the Clutter test environment.
+
+See also: g_test_add()</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
         <parameter name="test_path" transfer-ownership="none">
+          <doc xml:space="preserve">unique path for identifying the test</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
         <parameter name="test_func" transfer-ownership="none">
+          <doc xml:space="preserve">function containing the test</doc>
           <type name="GLib.TestFunc" c:type="GTestFunc"/>
         </parameter>
       </parameters>
     </function>
     <function name="test_add_data"
               c:identifier="clutter_test_add_data"
+              version="1.18"
               introspectable="0">
+      <doc xml:space="preserve">Adds a test unit to the Clutter test environment.
+
+See also: g_test_add_data_func()</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
         <parameter name="test_path" transfer-ownership="none">
+          <doc xml:space="preserve">unique path for identifying the test</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
         <parameter name="test_func" transfer-ownership="none" closure="2">
+          <doc xml:space="preserve">function containing the test</doc>
           <type name="GLib.TestDataFunc" c:type="GTestDataFunc"/>
         </parameter>
         <parameter name="test_data" transfer-ownership="none">
+          <doc xml:space="preserve">data to pass to the test function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
       </parameters>
     </function>
     <function name="test_add_data_full"
-              c:identifier="clutter_test_add_data_full">
+              c:identifier="clutter_test_add_data_full"
+              version="1.18">
+      <doc xml:space="preserve">Adds a test unit to the Clutter test environment.
+
+See also: g_test_add_data_func_full()</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
         <parameter name="test_path" transfer-ownership="none">
+          <doc xml:space="preserve">unique path for identifying the test</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
         <parameter name="test_func"
@@ -68981,60 +69383,89 @@ clutter_get_option_context()</doc>
                    scope="notified"
                    closure="2"
                    destroy="3">
+          <doc xml:space="preserve">function containing the test</doc>
           <type name="GLib.TestDataFunc" c:type="GTestDataFunc"/>
         </parameter>
         <parameter name="test_data" transfer-ownership="none">
+          <doc xml:space="preserve">data to pass to the test function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
         <parameter name="test_notify" transfer-ownership="none" scope="async">
+          <doc xml:space="preserve">function called when the test function ends</doc>
           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
         </parameter>
       </parameters>
     </function>
     <function name="test_check_actor_at_point"
-              c:identifier="clutter_test_check_actor_at_point">
+              c:identifier="clutter_test_check_actor_at_point"
+              version="1.18">
+      <doc xml:space="preserve">Checks the given coordinates of the @stage and compares the
+actor found there with the given @actor.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if the actor at the given coordinates matches</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="stage" transfer-ownership="none">
+          <doc xml:space="preserve">a #ClutterStage</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </parameter>
         <parameter name="point" transfer-ownership="none">
+          <doc xml:space="preserve">coordinates to check</doc>
           <type name="Point" c:type="const ClutterPoint*"/>
         </parameter>
         <parameter name="actor" transfer-ownership="none">
+          <doc xml:space="preserve">the expected actor at the given coordinates</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </parameter>
-        <parameter name="result" transfer-ownership="none">
+        <parameter name="result"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full"
+                   nullable="1">
+          <doc xml:space="preserve">actor at the coordinates</doc>
           <type name="Actor" c:type="ClutterActor**"/>
         </parameter>
       </parameters>
     </function>
     <function name="test_check_color_at_point"
-              c:identifier="clutter_test_check_color_at_point">
+              c:identifier="clutter_test_check_color_at_point"
+              version="1.18">
+      <doc xml:space="preserve">Checks the color at the given coordinates on @stage, and matches
+it with the red, green, and blue channels of @color. The alpha
+component of @color and @result is ignored.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if the colors match</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="stage" transfer-ownership="none">
+          <doc xml:space="preserve">a #ClutterStage</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </parameter>
         <parameter name="point" transfer-ownership="none">
+          <doc xml:space="preserve">coordinates to check</doc>
           <type name="Point" c:type="const ClutterPoint*"/>
         </parameter>
         <parameter name="color" transfer-ownership="none">
+          <doc xml:space="preserve">expected color</doc>
           <type name="Color" c:type="const ClutterColor*"/>
         </parameter>
-        <parameter name="result" transfer-ownership="none">
+        <parameter name="result"
+                   direction="out"
+                   caller-allocates="1"
+                   transfer-ownership="none">
+          <doc xml:space="preserve">color at the given coordinates</doc>
           <type name="Color" c:type="ClutterColor*"/>
         </parameter>
       </parameters>
     </function>
     <function name="test_get_stage"
               c:identifier="clutter_test_get_stage"
-              introspectable="0">
-      <return-value>
+              version="1.18">
+      <doc xml:space="preserve">Retrieves the #ClutterStage used for testing.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the stage used for testing</doc>
         <type name="Actor" c:type="ClutterActor*"/>
       </return-value>
     </function>
@@ -69051,8 +69482,34 @@ clutter_get_option_context()</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="test_run" c:identifier="clutter_test_run">
+    <function name="test_run" c:identifier="clutter_test_run" version="1.18">
+      <doc xml:space="preserve">Runs the test suite using the units added by calling
+clutter_test_add().
+
+The typical test suite is composed of a list of functions
+called by clutter_test_run(), for instance:
+
+|[
+static void unit_foo (void) { ... }
+
+static void unit_bar (void) { ... }
+
+static void unit_baz (void) { ... }
+
+int
+main (int argc, char *argv[])
+{
+  clutter_test_init (&amp;argc, &amp;argv);
+
+  clutter_test_add ("/unit/foo", unit_foo);
+  clutter_test_add ("/unit/bar", unit_bar);
+  clutter_test_add ("/unit/baz", unit_baz);
+
+  return clutter_test_run ();
+}
+]|</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the exit code for the test suite</doc>
         <type name="gint" c:type="int"/>
       </return-value>
     </function>
@@ -69080,6 +69537,7 @@ clutter_get_option_context()</doc>
               deprecated="1"
               deprecated-version="1.6">
       <doc xml:space="preserve">Simple wrapper around clutter_threads_add_frame_source_full().</doc>
+      <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -69122,6 +69580,7 @@ to invoke the function multiple times to catch up missing frames if
 @func takes more than @interval ms to execute.
 
 See also clutter_threads_add_idle_full().</doc>
+      <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the ID (greater than 0) of the event source.</doc>
         <type name="guint" c:type="guint"/>
@@ -69606,6 +70065,7 @@ the main loop. A timeout pool allocates a single time slice of the main
 loop and runs every timeout function inside it. The timeout pool is
 always sorted, so that the extraction of the next timeout function is
 a constant time operation.</doc>
+      <doc-deprecated xml:space="preserve">There is no direct replacement for this API</doc-deprecated>
       <return-value>
         <doc xml:space="preserve">the newly created #ClutterTimeoutPool. The created pool
   is owned by the GLib default context and will be automatically
@@ -70067,7 +70527,7 @@ reference count.</doc>
     </function>
     <function name="value_get_color"
               c:identifier="clutter_value_get_color"
-              version="0.8.4">
+              version="0.8">
       <doc xml:space="preserve">Gets the #ClutterColor contained in @value.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the color inside the passed #GValue</doc>
@@ -70220,7 +70680,7 @@ the passed #GValue. @value must have been initialized with
     </function>
     <function name="value_set_color"
               c:identifier="clutter_value_set_color"
-              version="0.8.4">
+              version="0.8">
       <doc xml:space="preserve">Sets @value to @color.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>