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

Update GIR files (2024-12-23)

GLib-2.0.gir

@@ -18483,7 +18483,7 @@ the pointer passed to it should not be `volatile`.</doc>
             <type name="gpointer" c:type="void*"/>
           </parameter>
           <parameter name="result" transfer-ownership="none">
-            <doc xml:space="preserve">new non-0 value for *@value_location</doc>
+            <doc xml:space="preserve">new non-0 value for `*value_location`</doc>
             <type name="gsize" c:type="gsize"/>
           </parameter>
         </parameters>
@@ -44068,8 +44068,8 @@ See your C library manual for more details about chmod().</doc>
       </parameters>
     </function-macro>
     <function name="clear_error" c:identifier="g_clear_error" throws="1">
-      <doc xml:space="preserve">If @err or *@err is %NULL, does nothing. Otherwise,
-calls g_error_free() on *@err and sets *@err to %NULL.</doc>
+      <doc xml:space="preserve">If @err or `*err` is %NULL, does nothing. Otherwise,
+calls g_error_free() on `*err` and sets `*err` to %NULL.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -51262,7 +51262,7 @@ the pointer passed to it should not be `volatile`.</doc>
           <type name="gpointer" c:type="void*"/>
         </parameter>
         <parameter name="result" transfer-ownership="none">
-          <doc xml:space="preserve">new non-0 value for *@value_location</doc>
+          <doc xml:space="preserve">new non-0 value for `*value_location`</doc>
           <type name="gsize" c:type="gsize"/>
         </parameter>
       </parameters>
@@ -51788,7 +51788,7 @@ if the call was interrupted.</doc>
 error message. If @err is %NULL (ie: no error variable) then do
 nothing.
 
-If *@err is %NULL (ie: an error variable is present but there is no
+If `*err` is %NULL (ie: an error variable is present but there is no
 error condition) then also do nothing.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
@@ -51809,7 +51809,7 @@ error condition) then also do nothing.</doc>
       </parameters>
     </function>
     <function name="prefix_error_literal" c:identifier="g_prefix_error_literal" version="2.70">
-      <doc xml:space="preserve">Prefixes @prefix to an existing error message. If @err or *@err is
+      <doc xml:space="preserve">Prefixes @prefix to an existing error message. If @err or `*err` is
 %NULL (i.e.: no error variable) then do nothing.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
@@ -51942,7 +51942,7 @@ placeholders in any case, as their behaviour is locale-dependent.</doc>
       </parameters>
     </function>
     <function name="propagate_error" c:identifier="g_propagate_error">
-      <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into *@dest.
+      <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into `*dest`.
 The error variable @dest points to must be %NULL.
 
 @src must be non-%NULL.
@@ -51965,8 +51965,8 @@ after calling this function on it.</doc>
       </parameters>
     </function>
     <function name="propagate_prefixed_error" c:identifier="g_propagate_prefixed_error" version="2.16" introspectable="0">
-      <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into *@dest.
-*@dest must be %NULL. After the move, add a prefix as with
+      <doc xml:space="preserve">If @dest is %NULL, free @src; otherwise, moves @src into `*dest`.
+`*dest` must be %NULL. After the move, add a prefix as with
 g_prefix_error().</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
@@ -53455,8 +53455,8 @@ or when displaying an application's name in the task list.</doc>
       </parameters>
     </function>
     <function name="set_error" c:identifier="g_set_error" introspectable="0">
-      <doc xml:space="preserve">Does nothing if @err is %NULL; if @err is non-%NULL, then *@err
-must be %NULL. A new #GError is created and assigned to *@err.</doc>
+      <doc xml:space="preserve">Does nothing if @err is %NULL; if @err is non-%NULL, then `*err`
+must be %NULL. A new #GError is created and assigned to `*err`.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -53484,8 +53484,8 @@ must be %NULL. A new #GError is created and assigned to *@err.</doc>
       </parameters>
     </function>
     <function name="set_error_literal" c:identifier="g_set_error_literal" version="2.18">
-      <doc xml:space="preserve">Does nothing if @err is %NULL; if @err is non-%NULL, then *@err
-must be %NULL. A new #GError is created and assigned to *@err.
+      <doc xml:space="preserve">Does nothing if @err is %NULL; if @err is non-%NULL, then `*err`
+must be %NULL. A new #GError is created and assigned to `*err`.
 Unlike g_set_error(), @message is not a printf()-style format string.
 Use this function if @message contains text you don't have control over,
 that could include printf() escape sequences.</doc>
@@ -56361,10 +56361,6 @@ Elements are compared using [[email protected]_equal]. To match independently
 of order, sort the arrays first (using [[email protected]_with_data]
 or similar).
 
-Elements are compared using [[email protected]_equal]. To match independently
-of order, sort the arrays first (using [[email protected]_with_data]
-or similar).
-
 Two empty arrays are considered equal. Neither @strv1 nor @strv2 may be
 `NULL`.</doc>
       <return-value transfer-ownership="none">
@@ -58902,10 +58898,10 @@ This function does not include compatibility
 decompositions. It does, however, include algorithmic
 Hangul Jamo decomposition, as well as 'singleton'
 decompositions which replace a character by a single
-other character. In the case of singletons *@b will
+other character. In the case of singletons `*b` will
 be set to zero.
 
-If @ch is not decomposable, *@a is set to @ch and *@b
+If @ch is not decomposable, `*a` is set to @ch and `*b`
 is set to zero.
 
 Note that the way Unicode decomposition pairs are

GdkWayland-4.0.gir

@@ -408,6 +408,16 @@ provides access to the Wayland `wl_seat` object with
 Beyond the [[email protected]] API, the Wayland implementation offers
 access to the Wayland `wl_surface` object with
 [[email protected]_wl_surface].</doc>
+      <function name="force_next_commit" c:identifier="gdk_wayland_surface_force_next_commit">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="surface" transfer-ownership="none">
+            <type name="Gdk.Surface" c:type="GdkSurface*"/>
+          </parameter>
+        </parameters>
+      </function>
       <method name="get_wl_surface" c:identifier="gdk_wayland_surface_get_wl_surface" introspectable="0">
         <doc xml:space="preserve">Returns the Wayland `wl_surface` of a `GdkSurface`.</doc>
         <return-value transfer-ownership="none" nullable="1">