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

Update GIR files (2024-03-31)

Atk-1.0.gir

@@ -553,7 +553,7 @@ A string name/value pair representing a generic attribute.</doc>
         </parameters>
       </function>
     </record>
-    <constant name="BINARY_AGE" value="25201" c:type="ATK_BINARY_AGE" version="2.7.4">
+    <constant name="BINARY_AGE" value="25210" c:type="ATK_BINARY_AGE" version="2.7.4">
       <doc xml:space="preserve">Like atk_get_binary_age(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -4721,13 +4721,13 @@ application compile time, rather than from the library linked
 against at application run time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MICRO_VERSION" value="91" c:type="ATK_MICRO_VERSION" version="2.7.4">
+    <constant name="MICRO_VERSION" value="0" c:type="ATK_MICRO_VERSION" version="2.7.4">
       <doc xml:space="preserve">Like atk_get_micro_version(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MINOR_VERSION" value="51" c:type="ATK_MINOR_VERSION" version="2.7.4">
+    <constant name="MINOR_VERSION" value="52" c:type="ATK_MINOR_VERSION" version="2.7.4">
       <doc xml:space="preserve">Like atk_get_minor_version(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>

GLib-2.0.gir

@@ -1662,7 +1662,7 @@ In the event the URI cannot be found, -1 is returned and
    `time_t` is deprecated due to the year 2038 problem.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a timestamp</doc>
-          <type name="glong" c:type="time_t"/>
+          <type name="time_t" c:type="time_t"/>
         </return-value>
         <parameters>
           <instance-parameter name="bookmark" transfer-ownership="none">
@@ -1738,7 +1738,7 @@ set and %FALSE is returned.</doc>
           </parameter>
           <parameter name="stamp" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
             <doc xml:space="preserve">return location for the last registration time, or %NULL</doc>
-            <type name="glong" c:type="time_t*"/>
+            <type name="time_t" c:type="time_t*"/>
           </parameter>
         </parameters>
       </method>
@@ -1949,7 +1949,7 @@ In the event the URI cannot be found, -1 is returned and
    `time_t` is deprecated due to the year 2038 problem.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a timestamp</doc>
-          <type name="glong" c:type="time_t"/>
+          <type name="time_t" c:type="time_t"/>
         </return-value>
         <parameters>
           <instance-parameter name="bookmark" transfer-ownership="none">
@@ -2049,7 +2049,7 @@ In the event the URI cannot be found, -1 is returned and
    `time_t` is deprecated due to the year 2038 problem.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a timestamp.</doc>
-          <type name="glong" c:type="time_t"/>
+          <type name="time_t" c:type="time_t"/>
         </return-value>
         <parameters>
           <instance-parameter name="bookmark" transfer-ownership="none">
@@ -2339,7 +2339,7 @@ If no bookmark for @uri is found then it is created.</doc>
           </parameter>
           <parameter name="added" transfer-ownership="none">
             <doc xml:space="preserve">a timestamp or -1 to use the current time</doc>
-            <type name="glong" c:type="time_t"/>
+            <type name="time_t" c:type="time_t"/>
           </parameter>
         </parameters>
       </method>
@@ -2424,7 +2424,7 @@ for @uri is found, one is created.</doc>
           </parameter>
           <parameter name="stamp" transfer-ownership="none">
             <doc xml:space="preserve">the time of the last registration for this application</doc>
-            <type name="glong" c:type="time_t"/>
+            <type name="time_t" c:type="time_t"/>
           </parameter>
         </parameters>
       </method>
@@ -2640,7 +2640,7 @@ g_bookmark_file_set_visited_date_time().</doc>
           </parameter>
           <parameter name="modified" transfer-ownership="none">
             <doc xml:space="preserve">a timestamp or -1 to use the current time</doc>
-            <type name="glong" c:type="time_t"/>
+            <type name="time_t" c:type="time_t"/>
           </parameter>
         </parameters>
       </method>
@@ -2722,7 +2722,7 @@ does not affect the "modified" time.</doc>
           </parameter>
           <parameter name="visited" transfer-ownership="none">
             <doc xml:space="preserve">a timestamp or -1 to use the current time</doc>
-            <type name="glong" c:type="time_t"/>
+            <type name="time_t" c:type="time_t"/>
           </parameter>
         </parameters>
       </method>
@@ -5007,6 +5007,12 @@ in the macro, so you shouldn't use double quotes.</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_ENUMERATOR_IN_2_82_FOR" c:identifier="GLIB_DEPRECATED_ENUMERATOR_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_FOR" c:identifier="GLIB_DEPRECATED_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -5181,6 +5187,12 @@ in the macro, so you shouldn't use double quotes.</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_IN_2_82_FOR" c:identifier="GLIB_DEPRECATED_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_MACRO_FOR" c:identifier="GLIB_DEPRECATED_MACRO_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -5355,6 +5367,12 @@ in the macro, so you shouldn't use double quotes.</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_MACRO_IN_2_82_FOR" c:identifier="GLIB_DEPRECATED_MACRO_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_TYPE_FOR" c:identifier="GLIB_DEPRECATED_TYPE_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -5529,6 +5547,12 @@ in the macro, so you shouldn't use double quotes.</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_TYPE_IN_2_82_FOR" c:identifier="GLIB_DEPRECATED_TYPE_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <constant name="DIR_SEPARATOR" value="47" c:type="G_DIR_SEPARATOR">
       <type name="gint" c:type="gint"/>
     </constant>
@@ -6161,7 +6185,7 @@ To set the value of a date to the current day, you could write:
           </instance-parameter>
           <parameter name="timet" transfer-ownership="none">
             <doc xml:space="preserve">time_t value to set</doc>
-            <type name="glong" c:type="time_t"/>
+            <type name="time_t" c:type="time_t"/>
           </parameter>
         </parameters>
       </method>
@@ -15047,7 +15071,7 @@ linked against at application run time.</doc>
       <doc xml:space="preserve">The minimum value which can be held in a #gint8.</doc>
       <type name="gint8" c:type="gint8"/>
     </constant>
-    <constant name="MINOR_VERSION" value="80" c:type="GLIB_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="81" c:type="GLIB_MINOR_VERSION">
       <doc xml:space="preserve">The minor version number of the GLib library.
 
 Like #gtk_minor_version, but from the headers used at
@@ -29413,7 +29437,10 @@ The following example shows how to build a two element array:
   g_autoptr(GStrvBuilder) builder = g_strv_builder_new ();
   g_strv_builder_add (builder, "hello");
   g_strv_builder_add (builder, "world");
+
   g_auto(GStrv) array = g_strv_builder_end (builder);
+
+  g_assert_true (g_strv_equal (array, (const char *[]) { "hello", "world", NULL }));
 ```</doc>
       <constructor name="new" c:identifier="g_strv_builder_new" version="2.68">
         <doc xml:space="preserve">Creates a new #GStrvBuilder with a reference count of 1.
@@ -29547,6 +29574,38 @@ associated with the #GStrvBuilder.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="unref_to_strv" c:identifier="g_strv_builder_unref_to_strv" version="2.82">
+        <doc xml:space="preserve">Decreases the reference count on the string vector builder, and returns
+its contents as a `NULL`-terminated string array.
+
+This function is especially useful for cases where it's not possible
+to use `g_autoptr()`.
+
+```c
+GStrvBuilder *builder = g_strv_builder_new ();
+g_strv_builder_add (builder, "hello");
+g_strv_builder_add (builder, "world");
+
+GStrv array = g_strv_builder_unref_to_strv (builder);
+
+g_assert_true (g_strv_equal (array, (const char *[]) { "hello", "world", NULL }));
+
+g_strfreev (array);
+```</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">the constructed string
+  array</doc>
+          <array c:type="GStrv">
+            <type name="utf8"/>
+          </array>
+        </return-value>
+        <parameters>
+          <instance-parameter name="builder" transfer-ownership="full">
+            <doc xml:space="preserve">a #GStrvBuilder</doc>
+            <type name="StrvBuilder" c:type="GStrvBuilder*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
     </record>
     <constant name="TEST_OPTION_ISOLATE_DIRS" value="isolate_dirs" c:type="G_TEST_OPTION_ISOLATE_DIRS" version="2.60">
       <doc xml:space="preserve">Creates a unique temporary directory for each unit test and uses
@@ -54930,9 +54989,13 @@ containing multibyte characters. For that purpose, use
     </function>
     <function name="strrstr" c:identifier="g_strrstr">
       <doc xml:space="preserve">Searches the string @haystack for the last occurrence
-of the string @needle.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a pointer to the found occurrence, or `NULL` if not found</doc>
+of the string @needle.
+
+The fact that this function returns `gchar *` rather than `const gchar *` is
+a historical artifact.</doc>
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">a pointer to the found occurrence, or
+   `NULL` if not found</doc>
         <type name="utf8" c:type="gchar*"/>
       </return-value>
       <parameters>
@@ -54949,9 +55012,13 @@ of the string @needle.</doc>
     <function name="strrstr_len" c:identifier="g_strrstr_len">
       <doc xml:space="preserve">Searches the string @haystack for the last occurrence
 of the string @needle, limiting the length of the search
-to @haystack_len.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a pointer to the found occurrence, or `NULL` if not found</doc>
+to @haystack_len.
+
+The fact that this function returns `gchar *` rather than `const gchar *` is
+a historical artifact.</doc>
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">a pointer to the found occurrence, or
+   `NULL` if not found</doc>
         <type name="utf8" c:type="gchar*"/>
       </return-value>
       <parameters>
@@ -55078,9 +55145,13 @@ of the string @needle, limiting the length of the search
 to @haystack_len or a nul terminator byte (whichever is reached first).
 
 A length of `-1` can be used to mean &#x201C;search the entire string&#x201D;, like
-`strstr()`.</doc>
-      <return-value transfer-ownership="full">
-        <doc xml:space="preserve">a pointer to the found occurrence, or `NULL` if not found</doc>
+`strstr()`.
+
+The fact that this function returns `gchar *` rather than `const gchar *` is
+a historical artifact.</doc>
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">a pointer to the found occurrence, or
+   `NULL` if not found</doc>
         <type name="utf8" c:type="gchar*"/>
       </return-value>
       <parameters>

GModule-2.0.gir

@@ -175,6 +175,12 @@ and/or use gtk-doc annotations.  -->
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_ENUMERATOR_IN_2_82_FOR" c:identifier="GMODULE_DEPRECATED_ENUMERATOR_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_FOR" c:identifier="GMODULE_DEPRECATED_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -349,6 +355,12 @@ and/or use gtk-doc annotations.  -->
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_IN_2_82_FOR" c:identifier="GMODULE_DEPRECATED_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_MACRO_IN_2_26_FOR" c:identifier="GMODULE_DEPRECATED_MACRO_IN_2_26_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -517,6 +529,12 @@ and/or use gtk-doc annotations.  -->
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_MACRO_IN_2_82_FOR" c:identifier="GMODULE_DEPRECATED_MACRO_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_TYPE_IN_2_26_FOR" c:identifier="GMODULE_DEPRECATED_TYPE_IN_2_26_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -685,6 +703,12 @@ and/or use gtk-doc annotations.  -->
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_TYPE_IN_2_82_FOR" c:identifier="GMODULE_DEPRECATED_TYPE_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <constant name="MODULE_IMPL_AR" value="7" c:type="G_MODULE_IMPL_AR">
       <type name="gint" c:type="gint"/>
     </constant>

GObject-2.0.gir

@@ -4547,6 +4547,12 @@ See also: G_ADD_PRIVATE()</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_ENUMERATOR_IN_2_82_FOR" c:identifier="GOBJECT_DEPRECATED_ENUMERATOR_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_FOR" c:identifier="GOBJECT_DEPRECATED_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -4721,6 +4727,12 @@ See also: G_ADD_PRIVATE()</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_IN_2_82_FOR" c:identifier="GOBJECT_DEPRECATED_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_MACRO_IN_2_26_FOR" c:identifier="GOBJECT_DEPRECATED_MACRO_IN_2_26_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -4889,6 +4901,12 @@ See also: G_ADD_PRIVATE()</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_MACRO_IN_2_82_FOR" c:identifier="GOBJECT_DEPRECATED_MACRO_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <function-macro name="DEPRECATED_TYPE_IN_2_26_FOR" c:identifier="GOBJECT_DEPRECATED_TYPE_IN_2_26_FOR" introspectable="0">
       <parameters>
         <parameter name="f">
@@ -5057,6 +5075,12 @@ See also: G_ADD_PRIVATE()</doc>
         </parameter>
       </parameters>
     </function-macro>
+    <function-macro name="DEPRECATED_TYPE_IN_2_82_FOR" c:identifier="GOBJECT_DEPRECATED_TYPE_IN_2_82_FOR" introspectable="0">
+      <parameters>
+        <parameter name="f">
+        </parameter>
+      </parameters>
+    </function-macro>
     <glib:boxed glib:name="Date" c:symbol-prefix="date" glib:type-name="GDate" glib:get-type="g_date_get_type">
     </glib:boxed>
     <glib:boxed glib:name="DateTime" c:symbol-prefix="date_time" glib:type-name="GDateTime" glib:get-type="g_date_time_get_type">

Gdk-4.0.gir

@@ -16479,7 +16479,7 @@ that will make the implementation likely quite slow.</doc>
         </callback>
       </field>
       <field name="get_flags">
-        <doc xml:space="preserve">Get the flags for this instance. See [enum@Gdk.PaintableFlags]
+        <doc xml:space="preserve">Get the flags for this instance. See [flags@Gdk.PaintableFlags]
   for details.</doc>
         <callback name="get_flags">
           <return-value transfer-ownership="none">

GdkPixbuf-2.0.gir

@@ -1100,7 +1100,7 @@ provided modules.</doc>
           </parameter>
         </parameters>
       </function>
-      <function name="new_from_stream_async" c:identifier="gdk_pixbuf_new_from_stream_async" version="2.24">
+      <function name="new_from_stream_async" c:identifier="gdk_pixbuf_new_from_stream_async" version="2.24" glib:finish-func="new_from_stream_finish">
         <doc xml:space="preserve">Creates a new pixbuf by asynchronously loading an image from an input stream.
 
 For more details see gdk_pixbuf_new_from_stream(), which is the synchronous
@@ -2748,7 +2748,7 @@ The stream is not closed.</doc>
           </parameter>
         </parameters>
       </constructor>
-      <function name="new_from_stream_async" c:identifier="gdk_pixbuf_animation_new_from_stream_async" version="2.28">
+      <function name="new_from_stream_async" c:identifier="gdk_pixbuf_animation_new_from_stream_async" version="2.28" glib:finish-func="new_from_stream_finish">
         <doc xml:space="preserve">Creates a new animation by asynchronously loading an image from an input stream.
 
 For more details see gdk_pixbuf_new_from_stream(), which is the synchronous