Merge pull request #207 from gtk-rs/create-pull-request/patch

Update GIR files (2024-07-07)

GObject-2.0.gir

@@ -2616,11 +2616,11 @@ the last parameter.
           <type name="Closure" c:type="GClosure*"/>
         </return-value>
         <parameters>
-          <parameter name="callback_func" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="callback_func" transfer-ownership="none" closure="1">
             <doc xml:space="preserve">the function to invoke</doc>
             <type name="Callback" c:type="GCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
+          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">user data to pass to @callback_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -2682,11 +2682,11 @@ the first parameter.
           <type name="Closure" c:type="GClosure*"/>
         </return-value>
         <parameters>
-          <parameter name="callback_func" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="callback_func" transfer-ownership="none" closure="1">
             <doc xml:space="preserve">the function to invoke</doc>
             <type name="Callback" c:type="GCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
+          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">user data to pass to @callback_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -3073,11 +3073,11 @@ notifiers will be run before the finalize notifiers.</doc>
             <doc xml:space="preserve">a #GClosure</doc>
             <type name="Closure" c:type="GClosure*"/>
           </instance-parameter>
-          <parameter name="notify_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="notify_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">data to pass to @notify_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="notify_func" transfer-ownership="none" nullable="1" allow-none="1">
+          <parameter name="notify_func" transfer-ownership="none">
             <doc xml:space="preserve">the callback function to register</doc>
             <type name="ClosureNotify" c:type="GClosureNotify"/>
           </parameter>
@@ -3097,11 +3097,11 @@ in an unspecified order.</doc>
             <doc xml:space="preserve">a #GClosure</doc>
             <type name="Closure" c:type="GClosure*"/>
           </instance-parameter>
-          <parameter name="notify_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="notify_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">data to pass to @notify_func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="notify_func" transfer-ownership="none" nullable="1" allow-none="1">
+          <parameter name="notify_func" transfer-ownership="none">
             <doc xml:space="preserve">the callback function to register</doc>
             <type name="ClosureNotify" c:type="GClosureNotify"/>
           </parameter>
@@ -3122,21 +3122,21 @@ example of marshal guards.</doc>
             <doc xml:space="preserve">a #GClosure</doc>
             <type name="Closure" c:type="GClosure*"/>
           </instance-parameter>
-          <parameter name="pre_marshal_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="pre_marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">data to pass
  to @pre_marshal_notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="pre_marshal_notify" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
+          <parameter name="pre_marshal_notify" transfer-ownership="none" closure="2">
             <doc xml:space="preserve">a function to call before the closure callback</doc>
             <type name="ClosureNotify" c:type="GClosureNotify"/>
           </parameter>
-          <parameter name="post_marshal_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
+          <parameter name="post_marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">data to pass
  to @post_marshal_notify</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="post_marshal_notify" transfer-ownership="none" nullable="1" allow-none="1">
+          <parameter name="post_marshal_notify" transfer-ownership="none">
             <doc xml:space="preserve">a function to call after the closure callback</doc>
             <type name="ClosureNotify" c:type="GClosureNotify"/>
           </parameter>
@@ -3313,12 +3313,12 @@ the right callback and passes it to the marshaller as the
             <doc xml:space="preserve">a #GClosure</doc>
             <type name="Closure" c:type="GClosure*"/>
           </instance-parameter>
-          <parameter name="marshal_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+          <parameter name="marshal_data" transfer-ownership="none" nullable="1" allow-none="1">
             <doc xml:space="preserve">context-dependent data to pass
  to @meta_marshal</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
-          <parameter name="meta_marshal" transfer-ownership="none" nullable="1" allow-none="1">
+          <parameter name="meta_marshal" transfer-ownership="none">
             <doc xml:space="preserve">a #GClosureMarshal function</doc>
             <type name="ClosureMarshal" c:type="GClosureMarshal"/>
           </parameter>
@@ -15406,11 +15406,11 @@ the last parameter.
         <type name="Closure" c:type="GClosure*"/>
       </return-value>
       <parameters>
-        <parameter name="callback_func" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+        <parameter name="callback_func" transfer-ownership="none" closure="1">
           <doc xml:space="preserve">the function to invoke</doc>
           <type name="Callback" c:type="GCallback"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
+        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data to pass to @callback_func</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -15472,11 +15472,11 @@ the first parameter.
         <type name="Closure" c:type="GClosure*"/>
       </return-value>
       <parameters>
-        <parameter name="callback_func" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
+        <parameter name="callback_func" transfer-ownership="none" closure="1">
           <doc xml:space="preserve">the function to invoke</doc>
           <type name="Callback" c:type="GCallback"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="0">
+        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data to pass to @callback_func</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -16955,7 +16955,7 @@ for signals which don't have %G_SIGNAL_NO_HOOKS flag set.</doc>
           <doc xml:space="preserve">a #GSignalEmissionHook function.</doc>
           <type name="SignalEmissionHook" c:type="GSignalEmissionHook"/>
         </parameter>
-        <parameter name="hook_data" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="2">
+        <parameter name="hook_data" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
           <doc xml:space="preserve">user data for @hook_func.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17152,7 +17152,7 @@ warning is emitted.</doc>
           <doc xml:space="preserve">the #GCallback to connect.</doc>
           <type name="Callback" c:type="GCallback"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="2">
+        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" scope="notified">
           <doc xml:space="preserve">data to pass to @c_handler calls.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17464,7 +17464,7 @@ If no handler was found, 0 is returned.</doc>
           <doc xml:space="preserve">The C closure callback of the handler (useless for non-C closures).</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">The closure data of the handler's closure.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17573,7 +17573,7 @@ Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.</doc>
           <doc xml:space="preserve">The C closure callback of the handlers (useless for non-C closures).</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">The closure data of the handlers' closures.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17663,7 +17663,7 @@ Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.</doc>
           <doc xml:space="preserve">The C closure callback of the handlers (useless for non-C closures).</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">The closure data of the handlers' closures.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17729,7 +17729,7 @@ Support for %G_SIGNAL_MATCH_ID was added in GLib 2.78.</doc>
           <doc xml:space="preserve">The C closure callback of the handlers (useless for non-C closures).</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
-        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">The closure data of the handlers' closures.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17911,7 +17911,7 @@ be used.</doc>
           <doc xml:space="preserve">the accumulator for this signal; may be %NULL.</doc>
           <type name="SignalAccumulator" c:type="GSignalAccumulator"/>
         </parameter>
-        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data for the @accumulator.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -17982,7 +17982,7 @@ the marshaller for this signal.</doc>
           <doc xml:space="preserve">the accumulator for this signal; may be %NULL.</doc>
           <type name="SignalAccumulator" c:type="GSignalAccumulator"/>
         </parameter>
-        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data for the @accumulator.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -18041,7 +18041,7 @@ the marshaller for this signal.</doc>
           <doc xml:space="preserve">the accumulator for this signal; may be %NULL.</doc>
           <type name="SignalAccumulator" c:type="GSignalAccumulator"/>
         </parameter>
-        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data for the @accumulator.</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -18065,7 +18065,7 @@ the marshaller for this signal.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="signal_newv" c:identifier="g_signal_newv">
+    <function name="signal_newv" c:identifier="g_signal_newv" introspectable="0">
       <doc xml:space="preserve">Creates a new signal. (This is usually done in the class initializer.)
 
 See g_signal_new() for details on allowed signal names.
@@ -18101,7 +18101,7 @@ the marshaller for this signal.</doc>
           <doc xml:space="preserve">the accumulator for this signal; may be %NULL</doc>
           <type name="SignalAccumulator" c:type="GSignalAccumulator"/>
         </parameter>
-        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
+        <parameter name="accu_data" transfer-ownership="none" nullable="1" allow-none="1">
           <doc xml:space="preserve">user data for the @accumulator</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -18253,7 +18253,7 @@ be considered constant and have to be left untouched.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="signal_set_va_marshaller" c:identifier="g_signal_set_va_marshaller" version="2.32">
+    <function name="signal_set_va_marshaller" c:identifier="g_signal_set_va_marshaller" version="2.32" introspectable="0">
       <doc xml:space="preserve">Change the #GSignalCVaMarshaller used for a given signal.  This is a
 specialised form of the marshaller that can often be used for the
 common case of a single connected signal handler and avoids the

Gdk-4.0.gir

@@ -15596,13 +15596,13 @@ of this enumeration. Your code should preserve and ignore them.  You can use
         <doc xml:space="preserve">the fifth mouse button.</doc>
       </member>
       <member name="super_mask" value="67108864" c:identifier="GDK_SUPER_MASK" glib:nick="super-mask" glib:name="GDK_SUPER_MASK">
-        <doc xml:space="preserve">the Super modifier</doc>
+        <doc xml:space="preserve">the Super modifier.</doc>
       </member>
       <member name="hyper_mask" value="134217728" c:identifier="GDK_HYPER_MASK" glib:nick="hyper-mask" glib:name="GDK_HYPER_MASK">
-        <doc xml:space="preserve">the Hyper modifier</doc>
+        <doc xml:space="preserve">the Hyper modifier.</doc>
       </member>
       <member name="meta_mask" value="268435456" c:identifier="GDK_META_MASK" glib:nick="meta-mask" glib:name="GDK_META_MASK">
-        <doc xml:space="preserve">the Meta modifier</doc>
+        <doc xml:space="preserve">the Meta modifier. Maps to Command on macOS.</doc>
       </member>
     </bitfield>
     <class name="Monitor" c:symbol-prefix="monitor" c:type="GdkMonitor" parent="GObject.Object" glib:type-name="GdkMonitor" glib:get-type="gdk_monitor_get_type" glib:type-struct="MonitorClass">
@@ -16708,7 +16708,7 @@ or after the [signal@Gdk.Surface::layout] signal is emitted.</doc>
       <method name="present" c:identifier="gdk_popup_present">
         <doc xml:space="preserve">Present @popup after having processed the `GdkPopupLayout` rules.
 
-If the popup was previously now showing, it will be showed,
+If the popup was previously not showing, it will be shown,
 otherwise it will change position according to @layout.
 
 After calling this function, the result should be handled in response
@@ -19454,7 +19454,9 @@ tiled window states.</doc>
         </parameters>
       </method>
       <method name="titlebar_gesture" c:identifier="gdk_toplevel_titlebar_gesture" version="4.4">
+        <doc xml:space="preserve">Performs a title bar gesture.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the gesture was performed</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>