clutter 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

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

@@ -1957,6 +1957,129 @@ transformation (i.e. scale, rotation, etc)</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="bind_model"
+              c:identifier="clutter_actor_bind_model"
+              version="1.24">
+        <doc xml:space="preserve">Binds a #GListModel to a #ClutterActor.
+
+If the #ClutterActor was already bound to a #GListModel, the previous
+binding is destroyed.
+
+The existing children of #ClutterActor are destroyed when setting a
+model, and new children are created and added, representing the contents
+of the @model. The #ClutterActor is updated whenever the @model changes.
+If @model is %NULL, the #ClutterActor is left empty.
+
+When a #ClutterActor is bound to a model, adding and removing children
+directly is undefined behaviour.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #ClutterActor</doc>
+            <type name="Actor" c:type="ClutterActor*"/>
+          </instance-parameter>
+          <parameter name="model"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GListModel</doc>
+            <type name="Gio.ListModel" c:type="GListModel*"/>
+          </parameter>
+          <parameter name="create_child_func"
+                     transfer-ownership="none"
+                     scope="notified"
+                     closure="2"
+                     destroy="3">
+            <doc xml:space="preserve">a function that creates #ClutterActor instances
+  from the contents of the @model</doc>
+            <type name="ActorCreateChildFunc"
+                  c:type="ClutterActorCreateChildFunc"/>
+          </parameter>
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">user data passed to @create_child_func</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+          <parameter name="notify" transfer-ownership="none" scope="async">
+            <doc xml:space="preserve">function called when unsetting the @model</doc>
+            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="bind_model_with_properties"
+              c:identifier="clutter_actor_bind_model_with_properties"
+              version="1.24"
+              introspectable="0">
+        <doc xml:space="preserve">Binds a #GListModel to a #ClutterActor.
+
+Unlike clutter_actor_bind_model(), this function automatically creates
+a child #ClutterActor of type @child_type, and binds properties on the
+items inside the @model to the corresponding properties on the child,
+for instance:
+
+|[&lt;!-- language="C" --&gt;
+  clutter_actor_bind_model_with_properties (actor, model,
+                                            MY_TYPE_CHILD_VIEW,
+                                            "label", "text", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE,
+                                            "icon", "image", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE,
+                                            "selected", "selected", G_BINDING_BIDIRECTIONAL,
+                                            "active", "active", G_BINDING_BIDIRECTIONAL,
+                                            NULL);
+]|
+
+is the equivalent of calling clutter_actor_bind_model() with a
+#ClutterActorCreateChildFunc of:
+
+|[&lt;!-- language="C" --&gt;
+  ClutterActor *res = g_object_new (MY_TYPE_CHILD_VIEW, NULL);
+
+  g_object_bind_property (item, "label", res, "text", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE);
+  g_object_bind_property (item, "icon", res, "image", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE);
+  g_object_bind_property (item, "selected", res, "selected", G_BINDING_BIDIRECTIONAL);
+  g_object_bind_property (item, "active", res, "active", G_BINDING_BIDIRECTIONAL);
+
+  return res;
+]|
+
+If the #ClutterActor was already bound to a #GListModel, the previous
+binding is destroyed.
+
+When a #ClutterActor is bound to a model, adding and removing children
+directly is undefined behaviour.
+
+See also: clutter_actor_bind_model()</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #ClutterActor</doc>
+            <type name="Actor" c:type="ClutterActor*"/>
+          </instance-parameter>
+          <parameter name="model" transfer-ownership="none">
+            <doc xml:space="preserve">a #GListModel</doc>
+            <type name="Gio.ListModel" c:type="GListModel*"/>
+          </parameter>
+          <parameter name="child_type" transfer-ownership="none">
+            <doc xml:space="preserve">the type of #ClutterActor to use when creating
+  children mapping to items inside the @model</doc>
+            <type name="GType" c:type="GType"/>
+          </parameter>
+          <parameter name="first_model_property" transfer-ownership="none">
+            <doc xml:space="preserve">the first property of @model to bind</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="..." transfer-ownership="none">
+            <doc xml:space="preserve">tuples of property names on the @model, on the child, and the
+  #GBindingFlags used to bind them, terminated by %NULL</doc>
+            <varargs/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="clear_actions"
               c:identifier="clutter_actor_clear_actions"
               version="1.4">
@@ -4701,6 +4824,40 @@ This function should not be used by applications</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="is_mapped"
+              c:identifier="clutter_actor_is_mapped"
+              version="1.24">
+        <doc xml:space="preserve">Checks whether a #ClutterActor has been set as mapped.
+
+See also %CLUTTER_ACTOR_IS_MAPPED and #ClutterActor:mapped</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the actor is mapped</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #ClutterActor</doc>
+            <type name="Actor" c:type="ClutterActor*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="is_realized"
+              c:identifier="clutter_actor_is_realized"
+              version="1.24">
+        <doc xml:space="preserve">Checks whether a #ClutterActor is realized.
+
+See also %CLUTTER_ACTOR_IS_REALIZED and #ClutterActor:realized.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the actor is realized</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #ClutterActor</doc>
+            <type name="Actor" c:type="ClutterActor*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="is_rotated"
               c:identifier="clutter_actor_is_rotated"
               version="0.6">
@@ -4731,6 +4888,23 @@ This function should not be used by applications</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="is_visible"
+              c:identifier="clutter_actor_is_visible"
+              version="1.24">
+        <doc xml:space="preserve">Checks whether an actor is marked as visible.
+
+See also %CLUTTER_ACTOR_IS_VISIBLE and #ClutterActor:visible.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the actor visible</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #ClutterActor</doc>
+            <type name="Actor" c:type="ClutterActor*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="lower"
               c:identifier="clutter_actor_lower"
               deprecated="1"
@@ -4806,7 +4980,8 @@ implementation.</doc>
               deprecated-version="1.12">
         <doc xml:space="preserve">Sets an anchor point for the actor, and adjusts the actor postion so that
 the relative position of the actor toward its parent remains the same.</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point and
+clutter_actor_set_translation() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -4839,7 +5014,8 @@ that if the actor changes size then the anchor point will move. For
 example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST
 and later double the size of the actor, the anchor point will move
 to the bottom right.</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point and
+clutter_actor_set_translation() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -5600,7 +5776,9 @@ that if the actor changes size then the anchor point will move. For
 example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST
 and later double the size of the actor, the anchor point will move
 to the bottom right.</doc>
-        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point instead.</doc-deprecated>
+        <doc-deprecated xml:space="preserve">Use #ClutterActor:pivot-point and
+clutter_actor_set_translation() instead. E.g. For %CLUTTER_GRAVITY_CENTER set
+pivot_point to (0.5,0.5) and the translation to (width/2,height/2).</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -9667,6 +9845,34 @@ using @progress</doc>
         </array>
       </field>
     </record>
+    <callback name="ActorCreateChildFunc"
+              c:type="ClutterActorCreateChildFunc"
+              version="1.24">
+      <doc xml:space="preserve">Creates a #ClutterActor using the @item in the model.
+
+The usual way to implement this function is to create a #ClutterActor
+instance and then bind the #GObject properties to the actor properties
+of interest, using g_object_bind_property(). This way, when the @item
+in the #GListModel changes, the #ClutterActor changes as well.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">The newly created child #ClutterActor</doc>
+        <type name="Actor" c:type="ClutterActor*"/>
+      </return-value>
+      <parameters>
+        <parameter name="item" transfer-ownership="none">
+          <doc xml:space="preserve">the item in the model</doc>
+          <type name="GObject.Object" c:type="gpointer"/>
+        </parameter>
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
+          <doc xml:space="preserve">Data passed to clutter_actor_bind_model()</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </callback>
     <bitfield name="ActorFlags"
               glib:type-name="ClutterActorFlags"
               glib:get-type="clutter_actor_flags_get_type"
@@ -10462,7 +10668,10 @@ See also clutter_alpha_set_timeline() and clutter_alpha_set_func().</doc>
             <doc xml:space="preserve">a #ClutterAlphaFunc</doc>
             <type name="AlphaFunc" c:type="ClutterAlphaFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -10521,7 +10730,10 @@ The logical id is always greater than %CLUTTER_ANIMATION_LAST.</doc>
             <doc xml:space="preserve">a #ClutterAlphaFunc</doc>
             <type name="AlphaFunc" c:type="ClutterAlphaFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @func, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -10630,7 +10842,10 @@ This function will not register @func as a global alpha function.</doc>
             <doc xml:space="preserve">A #ClutterAlphaFunc</doc>
             <type name="AlphaFunc" c:type="ClutterAlphaFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to be passed to the alpha function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -10795,7 +11010,11 @@ the #ClutterTimeline bound to @alpha.</doc>
           <doc xml:space="preserve">a #ClutterAlpha</doc>
           <type name="Alpha" c:type="ClutterAlpha*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">user data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -12633,7 +12852,10 @@ value will be replaced with the new values.</doc>
             <doc xml:space="preserve">a #ClutterAnimator</doc>
             <type name="Animator" c:type="ClutterAnimator*"/>
           </instance-parameter>
-          <parameter name="first_object" transfer-ownership="none">
+          <parameter name="first_object"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GObject</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -14122,7 +14344,10 @@ be accessed with the functions below.</doc>
             <type name="BehaviourForeachFunc"
                   c:type="ClutterBehaviourForeachFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">optional data to be passed to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -15101,7 +15326,11 @@ will be called for each actor driven by @behaviour.</doc>
           <doc xml:space="preserve">an actor driven by @behaviour</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" closure="2">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">optional data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -16504,7 +16733,11 @@ clutter_binding_pool_activate().</doc>
           <doc xml:space="preserve">bitmask of the modifier flags</doc>
           <type name="ModifierType" c:type="ClutterModifierType"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="4">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="4">
           <doc xml:space="preserve">data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -16578,7 +16811,10 @@ clutter_binding_pool_find() with the class type name:
           <type name="BindingPool" c:type="ClutterBindingPool*"/>
         </return-value>
         <parameters>
-          <parameter name="klass" transfer-ownership="none">
+          <parameter name="klass"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GObjectClass pointer</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -16717,7 +16953,10 @@ and then unblocked using clutter_binding_pool_unblock_action().</doc>
   when the action is activated</doc>
             <type name="BindingActionFunc" c:type="GCallback"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to @callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -16805,7 +17044,10 @@ and then unblocked using clutter_binding_pool_unblock_action().</doc>
             <doc xml:space="preserve">function to be called when the action is activated</doc>
             <type name="GObject.Callback" c:type="GCallback"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to @callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -17998,7 +18240,7 @@ The default value is %CLUTTER_EASE_OUT_CUBIC.</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">Whether the #ClutterBoxLayout should arrange its children
-homogeneously, i.e. all childs get the same size</doc>
+homogeneously, i.e. all children get the same size</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="orientation"
@@ -18922,7 +19164,11 @@ cairo_restore().</doc>
           <doc xml:space="preserve">a #ClutterActor</doc>
           <type name="Actor" c:type="ClutterActor*"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" closure="1">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -20747,7 +20993,11 @@ virtual function, which has been deprecated.</doc>
             <doc xml:space="preserve">a function to be called for each child</doc>
             <type name="Callback" c:type="ClutterCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none" closure="1">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     closure="1">
             <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -20780,7 +21030,11 @@ virtual function, which has been deprecated.</doc>
             <doc xml:space="preserve">a function to be called for each child</doc>
             <type name="Callback" c:type="ClutterCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none" closure="1">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1"
+                     closure="1">
             <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21259,7 +21513,10 @@ virtual function, which has been deprecated.</doc>
             <doc xml:space="preserve">a function to be called for each child</doc>
             <type name="Callback" c:type="ClutterCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21292,7 +21549,10 @@ virtual function, which has been deprecated.</doc>
             <doc xml:space="preserve">a function to be called for each child</doc>
             <type name="Callback" c:type="ClutterCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -21626,7 +21886,11 @@ virtual functions are optional.</doc>
               <doc xml:space="preserve">a function to be called for each child</doc>
               <type name="Callback" c:type="ClutterCallback"/>
             </parameter>
-            <parameter name="user_data" transfer-ownership="none" closure="2">
+            <parameter name="user_data"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1"
+                       closure="2">
               <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -21650,7 +21914,11 @@ virtual functions are optional.</doc>
               <doc xml:space="preserve">a function to be called for each child</doc>
               <type name="Callback" c:type="ClutterCallback"/>
             </parameter>
-            <parameter name="user_data" transfer-ownership="none" closure="2">
+            <parameter name="user_data"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1"
+                       closure="2">
               <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -24817,6 +25085,12 @@ flag set.</doc>
       <field name="touch" readable="0" private="1">
         <type name="TouchEvent" c:type="ClutterTouchEvent"/>
       </field>
+      <field name="touchpad_pinch" readable="0" private="1">
+        <type name="TouchpadPinchEvent" c:type="ClutterTouchpadPinchEvent"/>
+      </field>
+      <field name="touchpad_swipe" readable="0" private="1">
+        <type name="TouchpadSwipeEvent" c:type="ClutterTouchpadSwipeEvent"/>
+      </field>
       <constructor name="new" c:identifier="clutter_event_new">
         <doc xml:space="preserve">Creates a new #ClutterEvent of the specified type.</doc>
         <return-value transfer-ownership="full">
@@ -25062,6 +25336,104 @@ be cast to the platform-specific implementation.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_gesture_motion_delta"
+              c:identifier="clutter_event_get_gesture_motion_delta"
+              version="1.24">
+        <doc xml:space="preserve">Returns the gesture motion deltas relative to the current pointer
+position.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">A clutter touchpad gesture event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+          <parameter name="dx"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the displacement relative to the pointer
+     position in the X axis, or %NULL</doc>
+            <type name="gdouble" c:type="gdouble*"/>
+          </parameter>
+          <parameter name="dy"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the displacement relative to the pointer
+     position in the Y axis, or %NULL</doc>
+            <type name="gdouble" c:type="gdouble*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_gesture_phase"
+              c:identifier="clutter_event_get_gesture_phase">
+        <doc xml:space="preserve">Returns the phase of the event, See #ClutterTouchpadGesturePhase.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the phase of the gesture event.</doc>
+          <type name="TouchpadGesturePhase"
+                c:type="ClutterTouchpadGesturePhase"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">a touchpad gesture event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_gesture_pinch_angle_delta"
+              c:identifier="clutter_event_get_gesture_pinch_angle_delta"
+              version="1.24">
+        <doc xml:space="preserve">Returns the angle delta reported by this specific event.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The angle delta relative to the previous event.</doc>
+          <type name="gdouble" c:type="gdouble"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">a touchpad pinch event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_gesture_pinch_scale"
+              c:identifier="clutter_event_get_gesture_pinch_scale"
+              version="1.24">
+        <doc xml:space="preserve">Returns the current scale as reported by @event, 1.0 being the original
+distance at the time the corresponding event with phase
+%CLUTTER_TOUCHPAD_GESTURE_PHASE_BEGIN is received.
+is received.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the current pinch gesture scale</doc>
+          <type name="gdouble" c:type="gdouble"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">a touchpad pinch event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_gesture_swipe_finger_count"
+              c:identifier="clutter_event_get_gesture_swipe_finger_count"
+              version="1.24">
+        <doc xml:space="preserve">Returns the number of fingers that is triggering the touchpad gesture.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the number of fingers swiping.</doc>
+          <type name="guint" c:type="guint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">a touchpad swipe event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_key_code"
               c:identifier="clutter_event_get_key_code"
               version="1.0">
@@ -25189,6 +25561,38 @@ of %CLUTTER_SCROLL_SMOOTH.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_scroll_finish_flags"
+              c:identifier="clutter_event_get_scroll_finish_flags"
+              version="1.26">
+        <doc xml:space="preserve">Returns the #ClutterScrollFinishFlags of an scroll event. Those
+can be used to determine whether post-scroll effects like kinetic
+scrolling should be applied.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The scroll finish flags</doc>
+          <type name="ScrollFinishFlags" c:type="ClutterScrollFinishFlags"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">an scroll event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_scroll_source"
+              c:identifier="clutter_event_get_scroll_source"
+              version="1.26">
+        <doc xml:space="preserve">Returns the #ClutterScrollSource that applies to an scroll event.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The source of scroll events</doc>
+          <type name="ScrollSource" c:type="ClutterScrollSource"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="event" transfer-ownership="none">
+            <doc xml:space="preserve">an scroll event</doc>
+            <type name="Event" c:type="const ClutterEvent*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_source"
               c:identifier="clutter_event_get_source"
               version="0.6">
@@ -25741,7 +26145,10 @@ emitted for the event and it will take precedence over any grabs.</doc>
             <doc xml:space="preserve">A #GDestroyNotify</doc>
             <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">A data pointer to pass to the function.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -25796,7 +26203,11 @@ clutter_event_add_filter().</doc>
           <doc xml:space="preserve">the event that is going to be emitted</doc>
           <type name="Event" c:type="const ClutterEvent*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">the data pointer passed to clutter_event_add_filter()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -25942,8 +26353,22 @@ type used to denote the event sequence of a touch event.</doc>
         <doc xml:space="preserve">A touch event sequence has been canceled;
   event added in 1.10</doc>
       </member>
-      <member name="event_last"
+      <member name="touchpad_pinch"
               value="17"
+              c:identifier="CLUTTER_TOUCHPAD_PINCH"
+              glib:nick="touchpad-pinch">
+        <doc xml:space="preserve">A pinch gesture event, the current state is
+  determined by its phase field; event added in 1.24</doc>
+      </member>
+      <member name="touchpad_swipe"
+              value="18"
+              c:identifier="CLUTTER_TOUCHPAD_SWIPE"
+              glib:nick="touchpad-swipe">
+        <doc xml:space="preserve">A swipe gesture event, the current state is
+  determined by its phase field; event added in 1.24</doc>
+      </member>
+      <member name="event_last"
+              value="19"
               c:identifier="CLUTTER_EVENT_LAST"
               glib:nick="event-last">
         <doc xml:space="preserve">Marks the end of the #ClutterEventType enumeration;
@@ -28450,7 +28875,12 @@ position are grown to span the new row.</doc>
       <method name="set_orientation"
               c:identifier="clutter_grid_layout_set_orientation"
               version="1.12">
-        <doc xml:space="preserve">Sets the orientation of the @layout</doc>
+        <doc xml:space="preserve">Sets the orientation of the @layout.
+
+#ClutterGridLayout uses the orientation as a hint when adding
+children to the #ClutterActor using it as a layout manager via
+clutter_actor_add_child(); changing this value will not have
+any effect on children that are already part of the layout.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -43012,16 +43442,21 @@ should never be accessed directly</doc>
            c:symbol-prefix="list_model"
            c:type="ClutterListModel"
            version="0.6"
+           deprecated="1"
+           deprecated-version="1.24"
            parent="Model"
            glib:type-name="ClutterListModel"
            glib:get-type="clutter_list_model_get_type"
            glib:type-struct="ListModelClass">
       <doc xml:space="preserve">The #ClutterListModel struct contains only private data.</doc>
+      <doc-deprecated xml:space="preserve">Use #GListStore instead</doc-deprecated>
       <implements name="Scriptable"/>
       <constructor name="new"
                    c:identifier="clutter_list_model_new"
                    version="0.6"
-                   introspectable="0">
+                   introspectable="0"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">Creates a new default model with @n_columns columns with the types
 and names passed in.
 
@@ -43040,6 +43475,7 @@ string and #GdkPixbuf respectively.
 Note that the name of the column can be set to %NULL, in which case
 the canonical name of the type held by the column will be used as
 the title.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListStore instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #ClutterListModel</doc>
           <type name="Model" c:type="ClutterModel*"/>
@@ -43057,9 +43493,12 @@ the title.</doc>
       </constructor>
       <constructor name="newv"
                    c:identifier="clutter_list_model_newv"
-                   version="0.6">
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">Non-vararg version of clutter_list_model_new(). This function is
 useful for language bindings.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListStore instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new default #ClutterModel</doc>
           <type name="Model" c:type="ClutterModel*"/>
@@ -43093,8 +43532,11 @@ useful for language bindings.</doc>
     <record name="ListModelClass"
             c:type="ClutterListModelClass"
             glib:is-gtype-struct-for="ListModel"
-            version="0.6">
+            version="0.6"
+            deprecated="1"
+            deprecated-version="1.24">
       <doc xml:space="preserve">The #ClutterListModelClass struct contains only private data.</doc>
+      <doc-deprecated xml:space="preserve">Use #GListStore instead</doc-deprecated>
       <field name="parent_class" readable="0" private="1">
         <type name="ModelClass" c:type="ClutterModelClass"/>
       </field>
@@ -43152,11 +43594,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="4" c:type="CLUTTER_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="0" 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="22" c:type="CLUTTER_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="26" 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>
@@ -43783,6 +44225,8 @@ pango_font_description_from_string().</doc>
            c:symbol-prefix="model"
            c:type="ClutterModel"
            version="0.6"
+           deprecated="1"
+           deprecated-version="1.24"
            parent="GObject.Object"
            abstract="1"
            glib:type-name="ClutterModel"
@@ -43791,6 +44235,7 @@ pango_font_description_from_string().</doc>
       <doc xml:space="preserve">Base class for list models. The #ClutterModel structure contains
 only private data and should be manipulated using the provided
 API.</doc>
+      <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
       <implements name="Scriptable"/>
       <virtual-method name="filter_changed">
         <return-value transfer-ownership="none">
@@ -43804,8 +44249,11 @@ API.</doc>
       </virtual-method>
       <virtual-method name="get_column_name"
                       invoker="get_column_name"
-                      version="0.6">
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the name of the @column</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the name of the column. The model holds the returned
   string, and it should not be modified or freed</doc>
@@ -43824,8 +44272,11 @@ API.</doc>
       </virtual-method>
       <virtual-method name="get_column_type"
                       invoker="get_column_type"
-                      version="0.6">
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the type of the @column.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the type of the column.</doc>
           <type name="GType" c:type="GType"/>
@@ -43843,12 +44294,15 @@ API.</doc>
       </virtual-method>
       <virtual-method name="get_iter_at_row"
                       invoker="get_iter_at_row"
-                      version="0.6">
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a #ClutterModelIter representing the row at the given index.
 
 If a filter function has been set using clutter_model_set_filter()
 then the @model implementation will return the first non filtered
 row.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">A new #ClutterModelIter, or %NULL if @row was
   out of bounds. When done using the iterator object, call g_object_unref()
@@ -43868,8 +44322,11 @@ row.</doc>
       </virtual-method>
       <virtual-method name="get_n_columns"
                       invoker="get_n_columns"
-                      version="0.6">
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the number of columns inside @model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of columns</doc>
           <type name="guint" c:type="guint"/>
@@ -43881,9 +44338,14 @@ row.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="get_n_rows" invoker="get_n_rows" version="0.6">
+      <virtual-method name="get_n_rows"
+                      invoker="get_n_rows"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the number of rows inside @model, eventually taking
 into account any filtering function set using clutter_model_set_filter().</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The length of the @model. If there is a filter set, then
   the length of the filtered @model is returned.</doc>
@@ -43933,7 +44395,10 @@ into account any filtering function set using clutter_model_set_filter().</doc>
           <parameter name="func" transfer-ownership="none" closure="1">
             <type name="ModelSortFunc" c:type="ClutterModelSortFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
         </parameters>
@@ -43990,7 +44455,9 @@ into account any filtering function set using clutter_model_set_filter().</doc>
       <method name="append"
               c:identifier="clutter_model_append"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Creates and appends a new row to the #ClutterModel, setting the
 row values upon creation. For example, to append a new row where
 column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
@@ -44002,6 +44469,7 @@ column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
                                      G_TYPE_STRING, "Team");
   clutter_model_append (model, 0, 42, 1, "Team #1", -1);
 &lt;/programlisting&gt;&lt;/informalexample&gt;</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44018,9 +44486,12 @@ column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
       </method>
       <method name="appendv"
               c:identifier="clutter_model_appendv"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Creates and appends a new row to the #ClutterModel, setting the row
 values for the given @columns upon creation.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44049,11 +44520,14 @@ values for the given @columns upon creation.</doc>
       </method>
       <method name="filter_iter"
               c:identifier="clutter_model_filter_iter"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Checks whether the row pointer by @iter should be filtered or not using
 the filtering function set on @model.
 
 This function should be used only by subclasses of #ClutterModel.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the row should be displayed,
   %FALSE otherwise</doc>
@@ -44072,11 +44546,14 @@ This function should be used only by subclasses of #ClutterModel.</doc>
       </method>
       <method name="filter_row"
               c:identifier="clutter_model_filter_row"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Checks whether @row should be filtered or not using the
 filtering function set on @model.
 
 This function should be used only by subclasses of #ClutterModel.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the row should be displayed,
   %FALSE otherwise</doc>
@@ -44095,8 +44572,11 @@ This function should be used only by subclasses of #ClutterModel.</doc>
       </method>
       <method name="foreach"
               c:identifier="clutter_model_foreach"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Calls @func for each row in the model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44112,7 +44592,10 @@ This function should be used only by subclasses of #ClutterModel.</doc>
             <doc xml:space="preserve">a #ClutterModelForeachFunc</doc>
             <type name="ModelForeachFunc" c:type="ClutterModelForeachFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -44120,8 +44603,11 @@ This function should be used only by subclasses of #ClutterModel.</doc>
       </method>
       <method name="get_column_name"
               c:identifier="clutter_model_get_column_name"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the name of the @column</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the name of the column. The model holds the returned
   string, and it should not be modified or freed</doc>
@@ -44140,8 +44626,11 @@ This function should be used only by subclasses of #ClutterModel.</doc>
       </method>
       <method name="get_column_type"
               c:identifier="clutter_model_get_column_type"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the type of the @column.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the type of the column.</doc>
           <type name="GType" c:type="GType"/>
@@ -44159,9 +44648,12 @@ This function should be used only by subclasses of #ClutterModel.</doc>
       </method>
       <method name="get_filter_set"
               c:identifier="clutter_model_get_filter_set"
-              version="1.0">
+              version="1.0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Returns whether the @model has a filter in place, set
 using clutter_model_set_filter()</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if a filter is set</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -44175,9 +44667,12 @@ using clutter_model_set_filter()</doc>
       </method>
       <method name="get_first_iter"
               c:identifier="clutter_model_get_first_iter"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a #ClutterModelIter representing the first non-filtered
 row in @model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">A new #ClutterModelIter.
   Call g_object_unref() when done using it</doc>
@@ -44192,12 +44687,15 @@ row in @model.</doc>
       </method>
       <method name="get_iter_at_row"
               c:identifier="clutter_model_get_iter_at_row"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a #ClutterModelIter representing the row at the given index.
 
 If a filter function has been set using clutter_model_set_filter()
 then the @model implementation will return the first non filtered
 row.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">A new #ClutterModelIter, or %NULL if @row was
   out of bounds. When done using the iterator object, call g_object_unref()
@@ -44217,9 +44715,12 @@ row.</doc>
       </method>
       <method name="get_last_iter"
               c:identifier="clutter_model_get_last_iter"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a #ClutterModelIter representing the last non-filtered
 row in @model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">A new #ClutterModelIter.
   Call g_object_unref() when done using it</doc>
@@ -44234,8 +44735,11 @@ row in @model.</doc>
       </method>
       <method name="get_n_columns"
               c:identifier="clutter_model_get_n_columns"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the number of columns inside @model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the number of columns</doc>
           <type name="guint" c:type="guint"/>
@@ -44249,9 +44753,12 @@ row in @model.</doc>
       </method>
       <method name="get_n_rows"
               c:identifier="clutter_model_get_n_rows"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the number of rows inside @model, eventually taking
 into account any filtering function set using clutter_model_set_filter().</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The length of the @model. If there is a filter set, then
   the length of the filtered @model is returned.</doc>
@@ -44266,8 +44773,11 @@ into account any filtering function set using clutter_model_set_filter().</doc>
       </method>
       <method name="get_sorting_column"
               c:identifier="clutter_model_get_sorting_column"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the number of column used for sorting the @model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a column number, or -1 if the model is not sorted</doc>
           <type name="gint" c:type="gint"/>
@@ -44282,7 +44792,9 @@ into account any filtering function set using clutter_model_set_filter().</doc>
       <method name="insert"
               c:identifier="clutter_model_insert"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Inserts a new row to the #ClutterModel at @row, setting the row
 values upon creation. For example, to insert a new row at index 100,
 where column 0 is type %G_TYPE_INT and column 1 is of type
@@ -44295,6 +44807,7 @@ where column 0 is type %G_TYPE_INT and column 1 is of type
                                      G_TYPE_STRING, "Team");
   clutter_model_insert (model, 3, 0, 42, 1, "Team #1", -1);
 &lt;/programlisting&gt;&lt;/informalexample&gt;</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44315,10 +44828,13 @@ where column 0 is type %G_TYPE_INT and column 1 is of type
       </method>
       <method name="insert_value"
               c:identifier="clutter_model_insert_value"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the data in the cell specified by @iter and @column. The type of
 @value must be convertable to the type of the column. If the row does
 not exist then it is created.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44343,9 +44859,12 @@ not exist then it is created.</doc>
       </method>
       <method name="insertv"
               c:identifier="clutter_model_insertv"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Inserts data at @row into the #ClutterModel, setting the row
 values for the given @columns upon creation.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44379,7 +44898,9 @@ values for the given @columns upon creation.</doc>
       <method name="prepend"
               c:identifier="clutter_model_prepend"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Creates and prepends a new row to the #ClutterModel, setting the row
 values upon creation. For example, to prepend a new row where column 0
 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
@@ -44391,6 +44912,7 @@ is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
                                      G_TYPE_STRING, "Team");
   clutter_model_prepend (model, 0, 42, 1, "Team #1", -1);
 &lt;/programlisting&gt;&lt;/informalexample&gt;</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44407,9 +44929,12 @@ is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING:
       </method>
       <method name="prependv"
               c:identifier="clutter_model_prependv"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Creates and prepends a new row to the #ClutterModel, setting the row
 values for the given @columns upon creation.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44436,8 +44961,13 @@ values for the given @columns upon creation.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="remove" c:identifier="clutter_model_remove" version="0.6">
+      <method name="remove"
+              c:identifier="clutter_model_remove"
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Removes the row at the given position from the model.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44452,9 +44982,14 @@ values for the given @columns upon creation.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="resort" c:identifier="clutter_model_resort" version="0.6">
+      <method name="resort"
+              c:identifier="clutter_model_resort"
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Force a resort on the @model. This function should only be
 used by subclasses of #ClutterModel.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44467,8 +45002,11 @@ used by subclasses of #ClutterModel.</doc>
       </method>
       <method name="set_filter"
               c:identifier="clutter_model_set_filter"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Filters the @model using the given filtering function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44487,7 +45025,10 @@ used by subclasses of #ClutterModel.</doc>
             <doc xml:space="preserve">a #ClutterModelFilterFunc, or #NULL</doc>
             <type name="ModelFilterFunc" c:type="ClutterModelFilterFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @func, or #NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -44499,12 +45040,15 @@ used by subclasses of #ClutterModel.</doc>
       </method>
       <method name="set_names"
               c:identifier="clutter_model_set_names"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Assigns a name to the columns of a #ClutterModel.
 
 This function is meant primarily for #GObjects that inherit from
 #ClutterModel, and should only be used when contructing a #ClutterModel.
 It will not work after the initial creation of the #ClutterModel.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44527,8 +45071,11 @@ It will not work after the initial creation of the #ClutterModel.</doc>
       </method>
       <method name="set_sort"
               c:identifier="clutter_model_set_sort"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sorts @model using the given sorting function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44551,7 +45098,10 @@ It will not work after the initial creation of the #ClutterModel.</doc>
             <doc xml:space="preserve">a #ClutterModelSortFunc, or #NULL</doc>
             <type name="ModelSortFunc" c:type="ClutterModelSortFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @func, or #NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -44563,9 +45113,12 @@ It will not work after the initial creation of the #ClutterModel.</doc>
       </method>
       <method name="set_sorting_column"
               c:identifier="clutter_model_set_sorting_column"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the model to sort by @column. If @column is a negative value
 the sorting column will be unset.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44582,12 +45135,15 @@ the sorting column will be unset.</doc>
       </method>
       <method name="set_types"
               c:identifier="clutter_model_set_types"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the types of the columns inside a #ClutterModel.
 
 This function is meant primarily for #GObjects that inherit from
 #ClutterModel, and should only be used when contructing a #ClutterModel.
 It will not work after the initial creation of the #ClutterModel.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44608,11 +45164,16 @@ It will not work after the initial creation of the #ClutterModel.</doc>
           </parameter>
         </parameters>
       </method>
-      <property name="filter-set" version="1.0" transfer-ownership="none">
+      <property name="filter-set"
+                version="1.0"
+                deprecated="1"
+                deprecated-version="1.24"
+                transfer-ownership="none">
         <doc xml:space="preserve">Whether the #ClutterModel has a filter set
 
 This property is set to %TRUE if a filter function has been
 set using clutter_model_set_filter()</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <field name="parent_instance" readable="0" private="1">
@@ -44621,16 +45182,26 @@ set using clutter_model_set_filter()</doc>
       <field name="priv" readable="0" private="1">
         <type name="ModelPrivate" c:type="ClutterModelPrivate*"/>
       </field>
-      <glib:signal name="filter-changed" when="last" version="0.6">
+      <glib:signal name="filter-changed"
+                   when="last"
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">The ::filter-changed signal is emitted when a new filter has been applied</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
       </glib:signal>
-      <glib:signal name="row-added" when="last" version="0.6">
+      <glib:signal name="row-added"
+                   when="last"
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">The ::row-added signal is emitted when a new row has been added.
 The data on the row has already been set when the ::row-added signal
 has been emitted.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44641,10 +45212,15 @@ has been emitted.</doc>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="row-changed" when="last" version="0.6">
+      <glib:signal name="row-changed"
+                   when="last"
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">The ::row-removed signal is emitted when a row has been changed.
 The data on the row has already been updated when the ::row-changed
 signal has been emitted.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44655,10 +45231,15 @@ signal has been emitted.</doc>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="row-removed" when="last" version="0.6">
+      <glib:signal name="row-removed"
+                   when="last"
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">The ::row-removed signal is emitted when a row has been removed.
 The data on the row pointed by the passed iterator is still valid
 when the ::row-removed signal has been emitted.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44669,8 +45250,13 @@ when the ::row-removed signal has been emitted.</doc>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="sort-changed" when="last" version="0.6">
+      <glib:signal name="sort-changed"
+                   when="last"
+                   version="0.6"
+                   deprecated="1"
+                   deprecated-version="1.24">
         <doc xml:space="preserve">The ::sort-changed signal is emitted after the model has been sorted</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -44679,8 +45265,11 @@ when the ::row-removed signal has been emitted.</doc>
     <record name="ModelClass"
             c:type="ClutterModelClass"
             glib:is-gtype-struct-for="Model"
-            version="0.6">
+            version="0.6"
+            deprecated="1"
+            deprecated-version="1.24">
       <doc xml:space="preserve">Class for #ClutterModel instances.</doc>
+      <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
       <field name="parent_class" readable="0" private="1">
         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
       </field>
@@ -44812,7 +45401,10 @@ when the ::row-removed signal has been emitted.</doc>
             <parameter name="func" transfer-ownership="none" closure="2">
               <type name="ModelSortFunc" c:type="ClutterModelSortFunc"/>
             </parameter>
-            <parameter name="data" transfer-ownership="none">
+            <parameter name="data"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
           </parameters>
@@ -44946,8 +45538,11 @@ when the ::row-removed signal has been emitted.</doc>
     </record>
     <callback name="ModelFilterFunc"
               c:type="ClutterModelFilterFunc"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
       <doc xml:space="preserve">Filters the content of a row in the model.</doc>
+      <doc-deprecated xml:space="preserve">Implement filters using a custom #GListModel instead</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">If the row should be displayed, return %TRUE</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -44961,7 +45556,11 @@ when the ::row-removed signal has been emitted.</doc>
           <doc xml:space="preserve">the iterator for the row</doc>
           <type name="ModelIter" c:type="ClutterModelIter*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">data passed to clutter_model_set_filter()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -44969,8 +45568,11 @@ when the ::row-removed signal has been emitted.</doc>
     </callback>
     <callback name="ModelForeachFunc"
               c:type="ClutterModelForeachFunc"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
       <doc xml:space="preserve">Iterates on the content of a row in the model</doc>
+      <doc-deprecated xml:space="preserve">Use #GListModel</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if the iteration should continue, %FALSE otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -44984,7 +45586,11 @@ when the ::row-removed signal has been emitted.</doc>
           <doc xml:space="preserve">the iterator for the row</doc>
           <type name="ModelIter" c:type="ClutterModelIter*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">data passed to clutter_model_foreach()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -44994,6 +45600,8 @@ when the ::row-removed signal has been emitted.</doc>
            c:symbol-prefix="model_iter"
            c:type="ClutterModelIter"
            version="0.6"
+           deprecated="1"
+           deprecated-version="1.24"
            parent="GObject.Object"
            abstract="1"
            glib:type-name="ClutterModelIter"
@@ -45002,8 +45610,14 @@ when the ::row-removed signal has been emitted.</doc>
       <doc xml:space="preserve">Base class for list models iters. The #ClutterModelIter structure
 contains only private data and should be manipulated using the
 provided API.</doc>
-      <virtual-method name="copy" invoker="copy" version="0.8">
+      <doc-deprecated xml:space="preserve">Use custom iterators for #GListModel</doc-deprecated>
+      <virtual-method name="copy"
+                      invoker="copy"
+                      version="0.8"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Copies the passed iterator.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a copy of the iterator, or %NULL</doc>
           <type name="ModelIter" c:type="ClutterModelIter*"/>
@@ -45015,8 +45629,13 @@ provided API.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="get_model" invoker="get_model" version="0.6">
+      <virtual-method name="get_model"
+                      invoker="get_model"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a pointer to the #ClutterModel that this iter is part of.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a pointer to a #ClutterModel.</doc>
           <type name="Model" c:type="ClutterModel*"/>
@@ -45028,8 +45647,13 @@ provided API.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="get_row" invoker="get_row" version="0.6">
+      <virtual-method name="get_row"
+                      invoker="get_row"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the position of the row that the @iter points to.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the position of the @iter in the model</doc>
           <type name="guint" c:type="guint"/>
@@ -45041,9 +45665,14 @@ provided API.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="get_value" invoker="get_value" version="0.6">
+      <virtual-method name="get_value"
+                      invoker="get_value"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Sets an initializes @value to that at @column. When done with @value,
 g_value_unset() needs to be called to free any allocated memory.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45065,9 +45694,14 @@ g_value_unset() needs to be called to free any allocated memory.</doc>
           </parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="is_first" invoker="is_first" version="0.6">
+      <virtual-method name="is_first"
+                      invoker="is_first"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Gets whether the current iterator is at the beginning of the model
 to which it belongs.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">#TRUE if @iter is the first iter in the filtered model</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -45079,9 +45713,14 @@ to which it belongs.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="is_last" invoker="is_last" version="0.6">
+      <virtual-method name="is_last"
+                      invoker="is_last"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Gets whether the iterator is at the end of the model to which it
 belongs.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">#TRUE if @iter is the last iter in the filtered model.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -45093,10 +45732,15 @@ belongs.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="next" invoker="next" version="0.6">
+      <virtual-method name="next"
+                      invoker="next"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Updates the @iter to point at the next position in the model.
 The model implementation should take into account the presence of
 a filter function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The passed iterator, updated to point at the next
   row in the model.</doc>
@@ -45109,10 +45753,15 @@ a filter function.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="prev" invoker="prev" version="0.6">
+      <virtual-method name="prev"
+                      invoker="prev"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Sets the @iter to point at the previous position in the model.
 The model implementation should take into account the presence of
 a filter function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The passed iterator, updated to point at the previous
   row in the model.</doc>
@@ -45125,9 +45774,14 @@ a filter function.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="set_value" invoker="set_value" version="0.6">
+      <virtual-method name="set_value"
+                      invoker="set_value"
+                      version="0.6"
+                      deprecated="1"
+                      deprecated-version="1.24">
         <doc xml:space="preserve">Sets the data in the cell specified by @iter and @column. The type of
 @value must be convertable to the type of the column.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45146,8 +45800,13 @@ a filter function.</doc>
           </parameter>
         </parameters>
       </virtual-method>
-      <method name="copy" c:identifier="clutter_model_iter_copy" version="0.8">
+      <method name="copy"
+              c:identifier="clutter_model_iter_copy"
+              version="0.8"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Copies the passed iterator.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a copy of the iterator, or %NULL</doc>
           <type name="ModelIter" c:type="ClutterModelIter*"/>
@@ -45162,7 +45821,9 @@ a filter function.</doc>
       <method name="get"
               c:identifier="clutter_model_iter_get"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Gets the value of one or more cells in the row referenced by @iter. The
 variable argument list should contain integer column numbers, each column
 column number followed by a place to store the value being retrieved. The
@@ -45175,6 +45836,7 @@ For example, to get a value from column 0 with type %G_TYPE_STRING use:
 
 where place_string_here is a gchar* to be filled with the string. If
 appropriate, the returned values have to be freed or unreferenced.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45191,8 +45853,11 @@ appropriate, the returned values have to be freed or unreferenced.</doc>
       </method>
       <method name="get_model"
               c:identifier="clutter_model_iter_get_model"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves a pointer to the #ClutterModel that this iter is part of.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a pointer to a #ClutterModel.</doc>
           <type name="Model" c:type="ClutterModel*"/>
@@ -45206,8 +45871,11 @@ appropriate, the returned values have to be freed or unreferenced.</doc>
       </method>
       <method name="get_row"
               c:identifier="clutter_model_iter_get_row"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Retrieves the position of the row that the @iter points to.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the position of the @iter in the model</doc>
           <type name="guint" c:type="guint"/>
@@ -45222,9 +45890,12 @@ appropriate, the returned values have to be freed or unreferenced.</doc>
       <method name="get_valist"
               c:identifier="clutter_model_iter_get_valist"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">See clutter_model_iter_get(). This version takes a va_list for language
 bindings.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45241,9 +45912,12 @@ bindings.</doc>
       </method>
       <method name="get_value"
               c:identifier="clutter_model_iter_get_value"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets an initializes @value to that at @column. When done with @value,
 g_value_unset() needs to be called to free any allocated memory.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45267,9 +45941,12 @@ g_value_unset() needs to be called to free any allocated memory.</doc>
       </method>
       <method name="is_first"
               c:identifier="clutter_model_iter_is_first"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Gets whether the current iterator is at the beginning of the model
 to which it belongs.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">#TRUE if @iter is the first iter in the filtered model</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -45283,9 +45960,12 @@ to which it belongs.</doc>
       </method>
       <method name="is_last"
               c:identifier="clutter_model_iter_is_last"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Gets whether the iterator is at the end of the model to which it
 belongs.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">#TRUE if @iter is the last iter in the filtered model.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -45297,10 +45977,15 @@ belongs.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="next" c:identifier="clutter_model_iter_next" version="0.6">
+      <method name="next"
+              c:identifier="clutter_model_iter_next"
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Updates the @iter to point at the next position in the model.
 The model implementation should take into account the presence of
 a filter function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The passed iterator, updated to point at the next
   row in the model.</doc>
@@ -45313,10 +45998,15 @@ a filter function.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="prev" c:identifier="clutter_model_iter_prev" version="0.6">
+      <method name="prev"
+              c:identifier="clutter_model_iter_prev"
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the @iter to point at the previous position in the model.
 The model implementation should take into account the presence of
 a filter function.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">The passed iterator, updated to point at the previous
   row in the model.</doc>
@@ -45332,7 +46022,9 @@ a filter function.</doc>
       <method name="set"
               c:identifier="clutter_model_iter_set"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the value of one or more cells in the row referenced by @iter. The
 variable argument list should contain integer column numbers, each column
 column number followed by the value to be set. The  list is terminated by a
@@ -45342,6 +46034,7 @@ For example, to set column 0 with type %G_TYPE_STRING, use:
 &lt;informalexample&gt;&lt;programlisting&gt;
   clutter_model_iter_set (iter, 0, "foo", -1);
 &lt;/programlisting&gt;&lt;/informalexample&gt;</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45359,9 +46052,12 @@ For example, to set column 0 with type %G_TYPE_STRING, use:
       <method name="set_valist"
               c:identifier="clutter_model_iter_set_valist"
               version="0.6"
-              introspectable="0">
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">See clutter_model_iter_set(); this version takes a va_list for language
 bindings.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45378,9 +46074,12 @@ bindings.</doc>
       </method>
       <method name="set_value"
               c:identifier="clutter_model_iter_set_value"
-              version="0.6">
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
         <doc xml:space="preserve">Sets the data in the cell specified by @iter and @column. The type of
 @value must be convertable to the type of the column.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45401,16 +46100,22 @@ bindings.</doc>
       </method>
       <property name="model"
                 version="0.6"
+                deprecated="1"
+                deprecated-version="1.24"
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">A reference to the #ClutterModel that this iter belongs to.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <type name="Model"/>
       </property>
       <property name="row"
                 version="0.6"
+                deprecated="1"
+                deprecated-version="1.24"
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The row number to which this iter points to.</doc>
+        <doc-deprecated xml:space="preserve">Use #GListModel instead</doc-deprecated>
         <type name="guint" c:type="guint"/>
       </property>
       <field name="parent_instance" readable="0" private="1">
@@ -45423,8 +46128,11 @@ bindings.</doc>
     <record name="ModelIterClass"
             c:type="ClutterModelIterClass"
             glib:is-gtype-struct-for="ModelIter"
-            version="0.6">
+            version="0.6"
+            deprecated="1"
+            deprecated-version="1.24">
       <doc xml:space="preserve">Class for #ClutterModelIter instances.</doc>
+      <doc-deprecated xml:space="preserve">Use custom iterators for #GListModel</doc-deprecated>
       <field name="parent_class" readable="0" private="1">
         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
       </field>
@@ -45636,8 +46344,13 @@ bindings.</doc>
     </record>
     <record name="ModelPrivate" c:type="ClutterModelPrivate" disguised="1">
     </record>
-    <callback name="ModelSortFunc" c:type="ClutterModelSortFunc" version="0.6">
+    <callback name="ModelSortFunc"
+              c:type="ClutterModelSortFunc"
+              version="0.6"
+              deprecated="1"
+              deprecated-version="1.24">
       <doc xml:space="preserve">Compares the content of two rows in the model.</doc>
+      <doc-deprecated xml:space="preserve">Implement sorting using a custom #GListModel instead</doc-deprecated>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">a positive integer if @a is after @b, a negative integer if
   @a is before @b, or 0 if the rows are the same</doc>
@@ -45656,7 +46369,11 @@ bindings.</doc>
           <doc xml:space="preserve">a #GValue representing the contents of the second row</doc>
           <type name="GObject.Value" c:type="const GValue*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="3">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
           <doc xml:space="preserve">data passed to clutter_model_set_sort()</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -47182,6 +47899,46 @@ only private data and should be accessed using the provided API</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_constrained_motion_delta"
+              c:identifier="clutter_pan_action_get_constrained_motion_delta"
+              version="1.24">
+        <doc xml:space="preserve">Retrieves the delta, in stage space, dependent on the current state
+of the #ClutterPanAction, and respecting the constraint specified by the
+#ClutterPanAction:pan-axis property.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the distance since last motion event</doc>
+          <type name="gfloat" c:type="gfloat"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">A #ClutterPanAction</doc>
+            <type name="PanAction" c:type="ClutterPanAction*"/>
+          </instance-parameter>
+          <parameter name="point" transfer-ownership="none">
+            <doc xml:space="preserve">the touch point index, with 0 being the first touch
+  point received by the action</doc>
+            <type name="guint" c:type="guint"/>
+          </parameter>
+          <parameter name="delta_x"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for the X delta</doc>
+            <type name="gfloat" c:type="gfloat*"/>
+          </parameter>
+          <parameter name="delta_y"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for the Y delta</doc>
+            <type name="gfloat" c:type="gfloat*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_deceleration"
               c:identifier="clutter_pan_action_get_deceleration"
               version="1.12">
@@ -47655,6 +48412,13 @@ panning action</doc>
               glib:nick="y-axis">
         <doc xml:space="preserve">Set a constraint on the Y axis</doc>
       </member>
+      <member name="axis_auto"
+              value="3"
+              c:identifier="CLUTTER_PAN_AXIS_AUTO"
+              glib:nick="axis-auto">
+        <doc xml:space="preserve">Constrain panning automatically based on initial
+  movement (available since 1.24)</doc>
+      </member>
     </enumeration>
     <class name="ParamSpecColor"
            c:symbol-prefix="param_color"
@@ -48075,7 +48839,10 @@ otherwise.</doc>
             <doc xml:space="preserve">the function to call with each node</doc>
             <type name="PathCallback" c:type="ClutterPathCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to the function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -48330,7 +49097,11 @@ called for each node contained in the path.</doc>
           <doc xml:space="preserve">the node</doc>
           <type name="PathNode" c:type="const ClutterPathNode*"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" closure="1">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">optional data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -50905,7 +51676,10 @@ the platform Clutter is running on.</doc>
             <doc xml:space="preserve">a #ClutterScript</doc>
             <type name="Script" c:type="ClutterScript*"/>
           </instance-parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the signal handlers, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -50939,7 +51713,10 @@ Applications should use clutter_script_connect_signals().</doc>
             <doc xml:space="preserve">signal connection function</doc>
             <type name="ScriptConnectFunc" c:type="ClutterScriptConnectFunc"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the signal handlers, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -51394,7 +52171,11 @@ programmer wants more control over the signal connection process.</doc>
           <doc xml:space="preserve">signal connection flags</doc>
           <type name="GObject.ConnectFlags" c:type="GConnectFlags"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="6">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="6">
           <doc xml:space="preserve">user data to pass to the signal handler</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -51961,7 +52742,41 @@ has precise scrolling delta information.</doc>
 device the event originated from, use clutter_event_get_source_device()</doc>
         <type name="InputDevice" c:type="ClutterInputDevice*"/>
       </field>
+      <field name="scroll_source" writable="1">
+        <doc xml:space="preserve">the source of scroll events. This field is available since 1.26</doc>
+        <type name="ScrollSource" c:type="ClutterScrollSource"/>
+      </field>
+      <field name="finish_flags" writable="1">
+        <doc xml:space="preserve">the axes that were stopped in this event. This field is available since 1.26</doc>
+        <type name="ScrollFinishFlags" c:type="ClutterScrollFinishFlags"/>
+      </field>
     </record>
+    <bitfield name="ScrollFinishFlags"
+              version="1.26"
+              glib:type-name="ClutterScrollFinishFlags"
+              glib:get-type="clutter_scroll_finish_flags_get_type"
+              c:type="ClutterScrollFinishFlags">
+      <doc xml:space="preserve">Flags used to notify the axes that were stopped in a #ClutterScrollEvent.
+These can be used to trigger post-scroll effects like kinetic scrolling.</doc>
+      <member name="none"
+              value="0"
+              c:identifier="CLUTTER_SCROLL_FINISHED_NONE"
+              glib:nick="none">
+        <doc xml:space="preserve">no axis was stopped.</doc>
+      </member>
+      <member name="horizontal"
+              value="1"
+              c:identifier="CLUTTER_SCROLL_FINISHED_HORIZONTAL"
+              glib:nick="horizontal">
+        <doc xml:space="preserve">The horizontal axis stopped.</doc>
+      </member>
+      <member name="vertical"
+              value="2"
+              c:identifier="CLUTTER_SCROLL_FINISHED_VERTICAL"
+              glib:nick="vertical">
+        <doc xml:space="preserve">The vertical axis stopped.</doc>
+      </member>
+    </bitfield>
     <bitfield name="ScrollMode"
               version="1.12"
               glib:type-name="ClutterScrollMode"
@@ -51993,6 +52808,41 @@ device the event originated from, use clutter_event_get_source_device()</doc>
         <doc xml:space="preserve">Scroll in both directions</doc>
       </member>
     </bitfield>
+    <enumeration name="ScrollSource"
+                 version="1.26"
+                 glib:type-name="ClutterScrollSource"
+                 glib:get-type="clutter_scroll_source_get_type"
+                 c:type="ClutterScrollSource">
+      <doc xml:space="preserve">The scroll source determines the source of the scroll event. Keep in mind
+that the source device #ClutterInputDeviceType is not enough to infer
+the scroll source.</doc>
+      <member name="unknown"
+              value="0"
+              c:identifier="CLUTTER_SCROLL_SOURCE_UNKNOWN"
+              glib:nick="unknown">
+        <doc xml:space="preserve">Source of scroll events is unknown.</doc>
+      </member>
+      <member name="wheel"
+              value="1"
+              c:identifier="CLUTTER_SCROLL_SOURCE_WHEEL"
+              glib:nick="wheel">
+        <doc xml:space="preserve">The scroll event is originated by a mouse wheel.</doc>
+      </member>
+      <member name="finger"
+              value="2"
+              c:identifier="CLUTTER_SCROLL_SOURCE_FINGER"
+              glib:nick="finger">
+        <doc xml:space="preserve">The scroll event is originated by one or more
+  fingers on the device (eg. touchpads).</doc>
+      </member>
+      <member name="continuous"
+              value="3"
+              c:identifier="CLUTTER_SCROLL_SOURCE_CONTINUOUS"
+              glib:nick="continuous">
+        <doc xml:space="preserve">The scroll event is originated by the
+  motion of some device (eg. a scroll button is set).</doc>
+      </member>
+    </enumeration>
     <constant name="ScrollUp" value="269025144" c:type="CLUTTER_ScrollUp">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -54673,7 +55523,7 @@ but before the results are displayed on the screen.</doc>
         </return-value>
       </glib:signal>
       <glib:signal name="deactivate" when="last" version="0.6">
-        <doc xml:space="preserve">The ::activate signal is emitted when the stage loses key focus
+        <doc xml:space="preserve">The ::deactivate signal is emitted when the stage loses key focus
 from the underlying window system.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -55407,7 +56257,10 @@ and 20% of the duration after animating.</doc>
             <doc xml:space="preserve">the name of the target state keys are being added for</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="first_object" transfer-ownership="none">
+          <parameter name="first_object"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GObject</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -58999,9 +59852,11 @@ be the default cursor size of 2 pixels.</doc>
                 version="1.0"
                 writable="1"
                 transfer-ownership="none">
-        <doc xml:space="preserve">Whether the input cursor is visible or not, it will only be visible
-if both #ClutterText:cursor-visible and #ClutterText:editable are
-set to %TRUE.</doc>
+        <doc xml:space="preserve">Whether the input cursor is visible or not.
+
+The cursor will only be visible if this property and either
+the #ClutterText:editable or the #ClutterText:selectable properties
+are set to %TRUE.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="editable"
@@ -59101,7 +59956,10 @@ the actual text in a password text actor.</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">Whether it is possible to select text, either using the pointer
-or the keyboard.</doc>
+or the keyboard.
+
+This property depends on the #ClutterActor:reactive property being
+set to %TRUE.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="selected-text-color"
@@ -59249,7 +60107,10 @@ the user. It is emitted before @self text changes.</doc>
     new_text is nul-terminated</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
-          <parameter name="position" transfer-ownership="none">
+          <parameter name="position"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the position, in characters, at which to insert the
     new text. this is an in-out parameter.  After the signal
     emission is finished, it should point after the newly
@@ -60173,7 +61034,7 @@ Some tips on usage:
     data and end redirection.
   - cogl_texture_get_data() with the handle returned by
     clutter_texture_get_cogl_texture() can be used to read the
-    offscreen texture pixels into a pixbuf.&lt;/para&gt;</doc>
+    offscreen texture pixels into a pixbuf.</doc>
         <doc-deprecated xml:space="preserve">Use the #ClutterOffscreenEffect and #ClutterShaderEffect
   directly on the intended #ClutterActor to replace the functionality of
   this function.</doc-deprecated>
@@ -62467,7 +63328,10 @@ the #ClutterTimeline:progress-mode property will be set to %CLUTTER_LINEAR.</doc
             <type name="TimelineProgressFunc"
                   c:type="ClutterTimelineProgressFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -62929,7 +63793,11 @@ this signal will never be emitted.</doc>
           <doc xml:space="preserve">the total duration of the timeline, in milliseconds,</doc>
           <type name="gdouble" c:type="gdouble"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="3">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
           <doc xml:space="preserve">data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -62986,7 +63854,10 @@ invoke the function multiple times to catch up missing frames if
             <doc xml:space="preserve">function to call</doc>
             <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to the function, or %NULL</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -63119,6 +63990,56 @@ device the event originated from, use clutter_event_get_source_device()</doc>
         <type name="InputDevice" c:type="ClutterInputDevice*"/>
       </field>
     </record>
+    <enumeration name="TouchpadGesturePhase"
+                 version="1.24"
+                 glib:type-name="ClutterTouchpadGesturePhase"
+                 glib:get-type="clutter_touchpad_gesture_phase_get_type"
+                 c:type="ClutterTouchpadGesturePhase">
+      <doc xml:space="preserve">The phase of a touchpad gesture event. All gestures are guaranteed to
+begin with an event of type %CLUTTER_TOUCHPAD_GESTURE_PHASE_BEGIN,
+followed by a number of %CLUTTER_TOUCHPAD_GESTURE_PHASE_UPDATE (possibly 0).
+
+A finished gesture may have 2 possible outcomes, an event with phase
+%CLUTTER_TOUCHPAD_GESTURE_PHASE_END will be emitted when the gesture is
+considered successful, this should be used as the hint to perform any
+permanent changes.
+
+Cancelled gestures may be so for a variety of reasons, due to hardware,
+or due to the gesture recognition layers hinting the gesture did not
+finish resolutely (eg. a 3rd finger being added during a pinch gesture).
+In these cases, the last event with report the phase
+%CLUTTER_TOUCHPAD_GESTURE_PHASE_CANCEL, this should be used as a hint
+to undo any visible/permanent changes that were done throughout the
+progress of the gesture.
+
+See also #ClutterTouchpadPinchEvent and #ClutterTouchpadPinchEvent.</doc>
+      <member name="begin"
+              value="0"
+              c:identifier="CLUTTER_TOUCHPAD_GESTURE_PHASE_BEGIN"
+              glib:nick="begin">
+        <doc xml:space="preserve">The gesture has begun.</doc>
+      </member>
+      <member name="update"
+              value="1"
+              c:identifier="CLUTTER_TOUCHPAD_GESTURE_PHASE_UPDATE"
+              glib:nick="update">
+        <doc xml:space="preserve">The gesture has been updated.</doc>
+      </member>
+      <member name="end"
+              value="2"
+              c:identifier="CLUTTER_TOUCHPAD_GESTURE_PHASE_END"
+              glib:nick="end">
+        <doc xml:space="preserve">The gesture was finished, changes
+  should be permanently applied.</doc>
+      </member>
+      <member name="cancel"
+              value="3"
+              c:identifier="CLUTTER_TOUCHPAD_GESTURE_PHASE_CANCEL"
+              glib:nick="cancel">
+        <doc xml:space="preserve">The gesture was cancelled, all
+  changes should be undone.</doc>
+      </member>
+    </enumeration>
     <constant name="TouchpadOff"
               value="269025201"
               c:type="CLUTTER_TouchpadOff">
@@ -63127,6 +64048,118 @@ device the event originated from, use clutter_event_get_source_device()</doc>
     <constant name="TouchpadOn" value="269025200" c:type="CLUTTER_TouchpadOn">
       <type name="gint" c:type="gint"/>
     </constant>
+    <record name="TouchpadPinchEvent"
+            c:type="ClutterTouchpadPinchEvent"
+            version="1.24">
+      <doc xml:space="preserve">Used for touchpad pinch gesture events. The current state of the
+gesture will be determined by the @phase field.
+
+Each event with phase %CLUTTER_TOUCHPAD_GESTURE_PHASE_BEGIN
+will report a @scale of 1.0, all later phases in the gesture
+report the current scale relative to the initial 1.0 value
+(eg. 0.5 being half the size, 2.0 twice as big).</doc>
+      <field name="type" writable="1">
+        <doc xml:space="preserve">event type</doc>
+        <type name="EventType" c:type="ClutterEventType"/>
+      </field>
+      <field name="time" writable="1">
+        <doc xml:space="preserve">event time</doc>
+        <type name="guint32" c:type="guint32"/>
+      </field>
+      <field name="flags" writable="1">
+        <doc xml:space="preserve">event flags</doc>
+        <type name="EventFlags" c:type="ClutterEventFlags"/>
+      </field>
+      <field name="stage" writable="1">
+        <doc xml:space="preserve">event source stage</doc>
+        <type name="Stage" c:type="ClutterStage*"/>
+      </field>
+      <field name="source" writable="1">
+        <doc xml:space="preserve">event source actor (unused)</doc>
+        <type name="Actor" c:type="ClutterActor*"/>
+      </field>
+      <field name="phase" writable="1">
+        <doc xml:space="preserve">the current phase of the gesture</doc>
+        <type name="TouchpadGesturePhase"
+              c:type="ClutterTouchpadGesturePhase"/>
+      </field>
+      <field name="x" writable="1">
+        <doc xml:space="preserve">the X coordinate of the pointer, relative to the stage</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="y" writable="1">
+        <doc xml:space="preserve">the Y coordinate of the pointer, relative to the stage</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="dx" writable="1">
+        <doc xml:space="preserve">movement delta of the pinch focal point in the X axis</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="dy" writable="1">
+        <doc xml:space="preserve">movement delta of the pinch focal point in the Y axis</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="angle_delta" writable="1">
+        <doc xml:space="preserve">angle delta in degrees, clockwise rotations are
+  represented by positive deltas</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="scale" writable="1">
+        <doc xml:space="preserve">the current scale</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+    </record>
+    <record name="TouchpadSwipeEvent"
+            c:type="ClutterTouchpadSwipeEvent"
+            version="1.24">
+      <doc xml:space="preserve">Used for touchpad swipe gesture events. The current state of the
+gesture will be determined by the @phase field.</doc>
+      <field name="type" writable="1">
+        <doc xml:space="preserve">event type</doc>
+        <type name="EventType" c:type="ClutterEventType"/>
+      </field>
+      <field name="time" writable="1">
+        <doc xml:space="preserve">event time</doc>
+        <type name="guint32" c:type="guint32"/>
+      </field>
+      <field name="flags" writable="1">
+        <doc xml:space="preserve">event flags</doc>
+        <type name="EventFlags" c:type="ClutterEventFlags"/>
+      </field>
+      <field name="stage" writable="1">
+        <doc xml:space="preserve">event source stage</doc>
+        <type name="Stage" c:type="ClutterStage*"/>
+      </field>
+      <field name="source" writable="1">
+        <doc xml:space="preserve">event source actor (unused)</doc>
+        <type name="Actor" c:type="ClutterActor*"/>
+      </field>
+      <field name="phase" writable="1">
+        <doc xml:space="preserve">the current phase of the gesture</doc>
+        <type name="TouchpadGesturePhase"
+              c:type="ClutterTouchpadGesturePhase"/>
+      </field>
+      <field name="n_fingers" writable="1">
+        <doc xml:space="preserve">the number of fingers triggering the swipe</doc>
+        <type name="guint" c:type="guint"/>
+      </field>
+      <field name="x" writable="1">
+        <doc xml:space="preserve">the X coordinate of the pointer, relative to the stage</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="y" writable="1">
+        <doc xml:space="preserve">the Y coordinate of the pointer, relative to the stage</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="dx" writable="1">
+        <doc xml:space="preserve">movement delta of the pinch focal point in the X axis</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+      <field name="dy" writable="1">
+        <doc xml:space="preserve">movement delta of the pinch focal point in the Y axis</doc>
+        <type name="gfloat" c:type="gfloat"/>
+      </field>
+    </record>
     <constant name="TouchpadToggle"
               value="269025193"
               c:type="CLUTTER_TouchpadToggle">
@@ -64153,7 +65186,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.220000" c:type="CLUTTER_VERSION">
+    <constant name="VERSION" value="1.260000" 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>
@@ -64161,7 +65194,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.22.4" c:type="CLUTTER_VERSION_S">
+    <constant name="VERSION_S" value="1.26.0" 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*"/>
@@ -67070,7 +68103,10 @@ emitted for the event and it will take precedence over any grabs.</doc>
           <doc xml:space="preserve">A #GDestroyNotify</doc>
           <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">A data pointer to pass to the function.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -67251,7 +68287,10 @@ OR of #ClutterFeatureFlags.</doc>
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -67302,7 +68341,10 @@ multiple times to catch up missing frames if @func takes more than
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69222,15 +70264,45 @@ If @enable is %FALSE the following events will not work:
     <function name="set_windowing_backend"
               c:identifier="clutter_set_windowing_backend"
               version="1.16">
-      <doc xml:space="preserve">Restricts clutter to only use the specified backend.
-This must be called before the first API call to clutter, including
+      <doc xml:space="preserve">Restricts Clutter to only use the specified backend or list of backends.
+
+You can use one of the `CLUTTER_WINDOWING_*` symbols, e.g.
+
+|[&lt;!-- language="C" --&gt;
+  clutter_set_windowing_backend (CLUTTER_WINDOWING_X11);
+]|
+
+Will force Clutter to use the X11 windowing and input backend, and terminate
+if the X11 backend could not be initialized successfully.
+
+Since Clutter 1.26, you can also use a comma-separated list of windowing
+system backends to provide a fallback in case backends are not available or
+enabled, e.g.:
+
+|[&lt;!-- language="C" --&gt;
+  clutter_set_windowing_backend ("gdk,wayland,x11");
+]|
+
+Will make Clutter test for the GDK, Wayland, and X11 backends in that order.
+
+You can use the `*` special value to ask Clutter to use the internally
+defined list of backends. For instance:
+
+|[&lt;!-- language="C" --&gt;
+  clutter_set_windowing_backend ("x11,wayland,*");
+]|
+
+Will make Clutter test the X11 and Wayland backends, and then fall back
+to the internal list of available backends.
+
+This function must be called before the first API call to Clutter, including
 clutter_get_option_context()</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
         <parameter name="backend_type" transfer-ownership="none">
-          <doc xml:space="preserve">the name of a clutter window backend</doc>
+          <doc xml:space="preserve">a comma separated list of windowing backends</doc>
           <type name="utf8" c:type="const char*"/>
         </parameter>
       </parameters>
@@ -69358,7 +70430,10 @@ See also: g_test_add_data_func()</doc>
           <doc xml:space="preserve">function containing the test</doc>
           <type name="GLib.TestDataFunc" c:type="GTestDataFunc"/>
         </parameter>
-        <parameter name="test_data" transfer-ownership="none">
+        <parameter name="test_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the test function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69386,7 +70461,10 @@ See also: g_test_add_data_func_full()</doc>
           <doc xml:space="preserve">function containing the test</doc>
           <type name="GLib.TestDataFunc" c:type="GTestDataFunc"/>
         </parameter>
-        <parameter name="test_data" transfer-ownership="none">
+        <parameter name="test_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the test function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69551,7 +70629,10 @@ main (int argc, char *argv[])
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69603,7 +70684,10 @@ See also clutter_threads_add_idle_full().</doc>
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69629,7 +70713,10 @@ default priority.</doc>
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69737,7 +70824,10 @@ update_ui (gpointer data)
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69790,7 +70880,10 @@ See also: clutter_threads_add_repaint_func_full()</doc>
           <doc xml:space="preserve">the function to be called within the paint cycle</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69846,7 +70939,10 @@ or because clutter_threads_remove_repaint_func() has been called) the
           <doc xml:space="preserve">the function to be called within the paint cycle</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to be passed to the function, or %NULL</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69876,7 +70972,10 @@ or because clutter_threads_remove_repaint_func() has been called) the
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -69921,7 +71020,10 @@ See also clutter_threads_add_idle_full().</doc>
           <doc xml:space="preserve">function to call</doc>
           <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none">
+        <parameter name="data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">data to pass to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>