Update GIR files

Author: sdroege

GObject-2.0.gir

@@ -11202,7 +11202,7 @@ class pointer after g_type_class_unref() are invalid.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="g_class" transfer-ownership="full">
+          <instance-parameter name="g_class" transfer-ownership="none">
             <doc xml:space="preserve">a #GTypeClass structure to unref</doc>
             <type name="TypeClass" c:type="gpointer"/>
           </instance-parameter>
@@ -11297,13 +11297,13 @@ static types.</doc>
           </parameter>
         </parameters>
       </function>
-      <function name="ref" c:identifier="g_type_class_ref" introspectable="0" deprecated="1" deprecated-version="2.84">
+      <function name="ref" c:identifier="g_type_class_ref" deprecated="1" deprecated-version="2.84">
         <doc xml:space="preserve">Increments the reference count of the class structure belonging to
 @type.
 
 This function will demand-create the class if it doesn't exist already.</doc>
         <doc-deprecated xml:space="preserve">Use g_type_class_get() instead</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">the #GTypeClass
   structure for the given type ID</doc>
           <type name="TypeClass" c:type="gpointer"/>
@@ -18956,6 +18956,24 @@ static types.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="type_class_ref" c:identifier="g_type_class_ref" moved-to="TypeClass.ref" deprecated="1" deprecated-version="2.84">
+      <doc xml:space="preserve">Increments the reference count of the class structure belonging to
+@type.
+
+This function will demand-create the class if it doesn't exist already.</doc>
+      <doc-deprecated xml:space="preserve">Use g_type_class_get() instead</doc-deprecated>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the #GTypeClass
+  structure for the given type ID</doc>
+        <type name="TypeClass" c:type="gpointer"/>
+      </return-value>
+      <parameters>
+        <parameter name="type" transfer-ownership="none">
+          <doc xml:space="preserve">type ID of a classed type</doc>
+          <type name="GType" c:type="GType"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="type_create_instance" c:identifier="g_type_create_instance" introspectable="0">
       <doc xml:space="preserve">Creates and initializes an instance of @type if @type is valid and
 can be instantiated. The type system only performs basic allocation
@@ -19027,7 +19045,7 @@ default interface vtable.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="type_default_interface_ref" c:identifier="g_type_default_interface_ref" version="2.4" introspectable="0" deprecated="1" deprecated-version="2.84">
+    <function name="type_default_interface_ref" c:identifier="g_type_default_interface_ref" version="2.4" deprecated="1" deprecated-version="2.84">
       <doc xml:space="preserve">Increments the reference count for the interface type @g_type,
 and returns the default interface vtable for the type.
 
@@ -19039,7 +19057,7 @@ Calling g_type_default_interface_ref() is useful when you
 want to make sure that signals and properties for an interface
 have been installed.</doc>
       <doc-deprecated xml:space="preserve">Use g_type_default_interface_get() instead</doc-deprecated>
-      <return-value transfer-ownership="full">
+      <return-value transfer-ownership="none">
         <doc xml:space="preserve">the default
   vtable for the interface; call g_type_default_interface_unref()
   when you are done using the interface.</doc>
@@ -19066,7 +19084,7 @@ default vtable (the @class_finalize member of #GTypeInfo) will be called.</doc>
         <type name="none" c:type="void"/>
       </return-value>
       <parameters>
-        <parameter name="g_iface" transfer-ownership="full">
+        <parameter name="g_iface" transfer-ownership="none">
           <doc xml:space="preserve">the default vtable
     structure for an interface, as returned by g_type_default_interface_ref()</doc>
           <type name="TypeInterface" c:type="gpointer"/>

Gdk-4.0.gir

@@ -19039,6 +19039,19 @@ in the range 0 to 1.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="print" c:identifier="gdk_rgba_print">
+        <return-value transfer-ownership="full">
+          <type name="GLib.String" c:type="GString*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="rgba" transfer-ownership="none">
+            <type name="RGBA" c:type="const GdkRGBA*"/>
+          </instance-parameter>
+          <parameter name="string" transfer-ownership="none">
+            <type name="GLib.String" c:type="GString*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="to_string" c:identifier="gdk_rgba_to_string">
         <doc xml:space="preserve">Returns a textual specification of @rgba in the form
 `rgb(r,g,b)` or `rgba(r,g,b,a)`, where &#x201C;r&#x201D;, &#x201C;g&#x201D;, &#x201C;b&#x201D; and
@@ -19242,13 +19255,16 @@ zero width or height).</doc>
     </enumeration>
     <class name="ScrollEvent" c:symbol-prefix="scroll_event" c:type="GdkScrollEvent" parent="Event" glib:type-name="GdkScrollEvent" glib:get-type="gdk_scroll_event_get_type" glib:fundamental="1">
       <doc xml:space="preserve">An event related to a scrolling motion.</doc>
-      <function name="get_relative_direction" c:identifier="gdk_scroll_event_get_relative_direction">
+      <function name="get_relative_direction" c:identifier="gdk_scroll_event_get_relative_direction" version="4.20">
+        <doc xml:space="preserve">Extracts the scroll direction relative to the physical motion.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the relative scroll direction.</doc>
           <type name="ScrollRelativeDirection" c:type="GdkScrollRelativeDirection"/>
         </return-value>
         <parameters>
           <parameter name="event" transfer-ownership="none">
-            <type name="Event" c:type="GdkEvent*"/>
+            <doc xml:space="preserve">a relative scroll direction.</doc>
+            <type name="ScrollRelativeDirection" c:type="GdkEvent*"/>
           </parameter>
         </parameters>
       </function>
@@ -21038,6 +21054,7 @@ calling this function.</doc>
       <method name="get_capabilities" c:identifier="gdk_toplevel_get_capabilities" glib:get-property="capabilities" version="4.20">
         <doc xml:space="preserve">The capabilities that are available for this toplevel.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the capabilities of the `GdkToplevel`.</doc>
           <type name="ToplevelCapabilities" c:type="GdkToplevelCapabilities"/>
         </return-value>
         <parameters>

Gio-2.0.gir

@@ -2957,7 +2957,7 @@ will return `NULL`.
 This function does not take in consideration associations added with
 [[email protected]_supports_type], but only those exported directly by
 the application.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">
   a list of content types.</doc>
           <array c:type="const char**">
@@ -3435,7 +3435,7 @@ will return `NULL`.
 This function does not take in consideration associations added with
 [[email protected]_supports_type], but only those exported directly by
 the application.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">
   a list of content types.</doc>
           <array c:type="const char**">
@@ -4121,7 +4121,7 @@ no display name is available.</doc>
         <doc xml:space="preserve">Retrieves the list of content types that @app_info
   claims to support.</doc>
         <callback name="get_supported_types">
-          <return-value transfer-ownership="none">
+          <return-value transfer-ownership="none" nullable="1">
             <doc xml:space="preserve">
   a list of content types.</doc>
             <array c:type="const char**">
@@ -7066,7 +7066,7 @@ long as @cmdline exists.
 
 See g_application_command_line_getenv() if you are only interested
 in the value of a single environment variable.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">
     the environment strings, or %NULL if they were not sent</doc>
           <array c:type="const gchar* const*">
@@ -72370,7 +72370,7 @@ a UNIX socket).
 These messages are sent with [[email protected]_message] and received
 with [[email protected]_message].
 
-To extend the set of control message that can be sent, subclass this
+To extend the set of control messages that can be sent, subclass this
 class and override the `get_size`, `get_level`, `get_type` and `serialize`
 methods.
 

GioUnix-2.0.gir

@@ -295,7 +295,7 @@ in it is set to `True`.</doc>
       </method>
       <method name="get_keywords" c:identifier="g_desktop_app_info_get_keywords" version="2.32">
         <doc xml:space="preserve">Gets the keywords from the desktop file.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The value of the
   [`Keywords` key](https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s06.html#key-keywords)</doc>
           <array c:type="const char* const*">
@@ -416,7 +416,7 @@ The @key is looked up in the `Desktop Entry` group.</doc>
         <doc xml:space="preserve">Looks up a string list value in the keyfile backing @info.
 
 The @key is looked up in the `Desktop Entry` group.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">
   a `NULL`-terminated string array or `NULL` if the specified
   key cannot be found. The array should be freed with [[email protected]].</doc>

Gsk-4.0.gir

@@ -777,6 +777,8 @@ where k is the smallest value such that
       </function>
     </record>
     <class name="ComponentTransferNode" c:symbol-prefix="component_transfer_node" c:type="GskComponentTransferNode" version="4.20" parent="RenderNode" glib:type-name="GskComponentTransferNode" glib:get-type="gsk_component_transfer_node_get_type" glib:fundamental="1">
+      <doc xml:space="preserve">A render node for applying a `GskComponentTransfer` for each color
+component of the child node.</doc>
       <constructor name="new" c:identifier="gsk_component_transfer_node_new" version="4.20">
         <doc xml:space="preserve">Creates a render node that will apply component
 transfers to a child node.</doc>
@@ -2689,6 +2691,26 @@ constructed from B&#xE9;zier segments.
   &lt;source srcset="path-dark.png" media="(prefers-color-scheme: dark)"&gt;
   &lt;img alt="A Path" src="path-light.png"&gt;
 &lt;/picture&gt;</doc>
+      <method name="equal" c:identifier="gsk_path_equal" version="4.22">
+        <doc xml:space="preserve">Returns whether two paths have identical structure.
+
+Note that it is possible to construct paths that render
+identical even though they don't have the same structure.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">true if @path1 and @path2 have identical structure</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="path1" transfer-ownership="none">
+            <doc xml:space="preserve">a path</doc>
+            <type name="Path" c:type="const GskPath*"/>
+          </instance-parameter>
+          <parameter name="path2" transfer-ownership="none">
+            <doc xml:space="preserve">another path</doc>
+            <type name="Path" c:type="const GskPath*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="foreach" c:identifier="gsk_path_foreach" version="4.14">
         <doc xml:space="preserve">Calls @func for every operation of the path.
 
@@ -7044,7 +7066,7 @@ by this function, use
     gsk_transform_skew (
         gsk_transform_scale (
             gsk_transform_rotate (
-                gsk_transform_translate (NULL, &amp;GRAPHENE_POINT_T (dx, dy)),
+                gsk_transform_translate (NULL, &amp;GRAPHENE_POINT_INIT (dx, dy)),
                 angle),
             scale_x, scale_y),
         skew_x, skew_y)