Update GIR files

Author: bilelmoussaoui

Gio-2.0.gir

@@ -4998,7 +4998,7 @@ The application must be registered before calling this function.</doc>
       </virtual-method>
       <virtual-method name="add_platform_data">
         <doc xml:space="preserve">invoked (locally) to add 'platform data' to be sent to
-    the primary instance when activating, opening or invoking actions</doc>
+    the primary instance when activating, opening or invoking actions. Must chain up</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -5014,7 +5014,7 @@ The application must be registered before calling this function.</doc>
       <virtual-method name="after_emit">
         <doc xml:space="preserve">invoked on the primary instance after 'activate', 'open',
     'command-line' or any action invocation, gets the 'platform data' from
-    the calling instance</doc>
+    the calling instance. Must chain up</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -5030,7 +5030,7 @@ The application must be registered before calling this function.</doc>
       <virtual-method name="before_emit">
         <doc xml:space="preserve">invoked on the primary instance before 'activate', 'open',
     'command-line' or any action invocation, gets the 'platform data' from
-    the calling instance</doc>
+    the calling instance. Must chain up</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -6525,7 +6525,7 @@ after registration. See g_application_register().</doc>
       <field name="before_emit">
         <doc xml:space="preserve">invoked on the primary instance before 'activate', 'open',
     'command-line' or any action invocation, gets the 'platform data' from
-    the calling instance</doc>
+    the calling instance. Must chain up</doc>
         <callback name="before_emit">
           <return-value transfer-ownership="none">
             <type name="none" c:type="void"/>
@@ -6543,7 +6543,7 @@ after registration. See g_application_register().</doc>
       <field name="after_emit">
         <doc xml:space="preserve">invoked on the primary instance after 'activate', 'open',
     'command-line' or any action invocation, gets the 'platform data' from
-    the calling instance</doc>
+    the calling instance. Must chain up</doc>
         <callback name="after_emit">
           <return-value transfer-ownership="none">
             <type name="none" c:type="void"/>
@@ -6560,7 +6560,7 @@ after registration. See g_application_register().</doc>
       </field>
       <field name="add_platform_data">
         <doc xml:space="preserve">invoked (locally) to add 'platform data' to be sent to
-    the primary instance when activating, opening or invoking actions</doc>
+    the primary instance when activating, opening or invoking actions. Must chain up</doc>
         <callback name="add_platform_data">
           <return-value transfer-ownership="none">
             <type name="none" c:type="void"/>
@@ -46894,8 +46894,43 @@ for @family.
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_bytes_with_ipv6_info" c:identifier="g_inet_address_new_from_bytes_with_ipv6_info" version="2.86">
+        <doc xml:space="preserve">Creates a new [[email protected]] from the given @family, @bytes
+and @scope_id.
+
+@bytes must be 4 bytes for [[email protected]] and 16 bytes for
+[[email protected]].</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new internet address corresponding to
+  @family, @bytes and @scope_id</doc>
+          <type name="InetAddress" c:type="GInetAddress*"/>
+        </return-value>
+        <parameters>
+          <parameter name="bytes" transfer-ownership="none">
+            <doc xml:space="preserve">raw address data</doc>
+            <array zero-terminated="0" c:type="const guint8*">
+              <type name="guint8"/>
+            </array>
+          </parameter>
+          <parameter name="family" transfer-ownership="none">
+            <doc xml:space="preserve">the address family of @bytes</doc>
+            <type name="SocketFamily" c:type="GSocketFamily"/>
+          </parameter>
+          <parameter name="flowinfo" transfer-ownership="none">
+            <type name="guint32" c:type="guint32"/>
+          </parameter>
+          <parameter name="scope_id" transfer-ownership="none">
+            <doc xml:space="preserve">the scope-id of the address</doc>
+            <type name="guint32" c:type="guint32"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_string" c:identifier="g_inet_address_new_from_string" version="2.22">
-        <doc xml:space="preserve">Parses @string as an IP address and creates a new #GInetAddress.</doc>
+        <doc xml:space="preserve">Parses @string as an IP address and creates a new #GInetAddress.
+
+If @address is an IPv6 address, it can also contain a scope ID
+(separated from the address by a `%`). Note that currently this
+behavior is platform specific. This may change in a future release.</doc>
         <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a new #GInetAddress corresponding
 to @string, or %NULL if @string could not be parsed.
@@ -46983,6 +47018,19 @@ freed after use.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_flowinfo" c:identifier="g_inet_address_get_flowinfo" glib:get-property="flowinfo" version="2.86">
+        <doc xml:space="preserve">Gets the value of [[email protected]:flowinfo].</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The flowinfo for the address, `0` if unset or not IPv6 address.</doc>
+          <type name="guint32" c:type="guint32"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="address" transfer-ownership="none">
+            <doc xml:space="preserve">a #GInetAddress</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_is_any" c:identifier="g_inet_address_get_is_any" glib:get-property="is-any" version="2.22">
         <doc xml:space="preserve">Tests whether @address is the "any" address for its family.</doc>
         <return-value transfer-ownership="none">
@@ -47132,6 +47180,19 @@ is the size of the data that you get from g_inet_address_to_bytes().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_scope_id" c:identifier="g_inet_address_get_scope_id" glib:get-property="scope-id" version="2.86">
+        <doc xml:space="preserve">Gets the value of [[email protected]:scope-id].</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">The scope-id for the address, `0` if unset or not IPv6 address.</doc>
+          <type name="guint32" c:type="guint32"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="address" transfer-ownership="none">
+            <doc xml:space="preserve">a #GInetAddress</doc>
+            <type name="InetAddress" c:type="GInetAddress*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="to_bytes" c:identifier="g_inet_address_to_bytes" version="2.22" introspectable="0">
         <doc xml:space="preserve">Gets the raw binary address data from @address.</doc>
         <return-value transfer-ownership="none">
@@ -47169,6 +47230,11 @@ freed after use.</doc>
         <doc xml:space="preserve">The address family (IPv4 or IPv6).</doc>
         <type name="SocketFamily"/>
       </property>
+      <property name="flowinfo" version="2.86" writable="1" construct-only="1" transfer-ownership="none" getter="get_flowinfo" default-value="0">
+        <doc xml:space="preserve">The flowinfo for an IPv6 address.
+See [[email protected]_flowinfo].</doc>
+        <type name="guint" c:type="guint"/>
+      </property>
       <property name="is-any" version="2.22" transfer-ownership="none" getter="get_is_any" default-value="FALSE">
         <doc xml:space="preserve">Whether this is the "any" address for its family.
 See g_inet_address_get_is_any().</doc>
@@ -47219,6 +47285,11 @@ See g_inet_address_get_is_multicast().</doc>
 See g_inet_address_get_is_loopback().</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="scope-id" version="2.86" writable="1" construct-only="1" transfer-ownership="none" getter="get_scope_id" default-value="0">
+        <doc xml:space="preserve">The scope-id for an IPv6 address.
+See [[email protected]_scope_id].</doc>
+        <type name="guint" c:type="guint"/>
+      </property>
       <field name="parent_instance">
         <type name="GObject.Object" c:type="GObject"/>
       </field>
@@ -47444,7 +47515,8 @@ In UNIX terms, `GInetSocketAddress` corresponds to a
         <doc xml:space="preserve">Creates a new #GInetSocketAddress for @address and @port.
 
 If @address is an IPv6 address, it can also contain a scope ID
-(separated from the address by a `%`).</doc>
+(separated from the address by a `%`). Note that currently this
+behavior is platform specific. This may change in a future release.</doc>
         <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a new #GInetSocketAddress,
 or %NULL if @address cannot be parsed.</doc>
@@ -47477,7 +47549,9 @@ g_object_ref()'d if it will be stored</doc>
       </method>
       <method name="get_flowinfo" c:identifier="g_inet_socket_address_get_flowinfo" glib:get-property="flowinfo" version="2.32">
         <doc xml:space="preserve">Gets the `sin6_flowinfo` field from @address,
-which must be an IPv6 address.</doc>
+which must be an IPv6 address.
+
+If not overridden this value will be inherited from [[email protected]:address].</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the flowinfo field</doc>
           <type name="guint32" c:type="guint32"/>
@@ -47504,7 +47578,9 @@ which must be an IPv6 address.</doc>
       </method>
       <method name="get_scope_id" c:identifier="g_inet_socket_address_get_scope_id" glib:get-property="scope-id" version="2.32">
         <doc xml:space="preserve">Gets the `sin6_scope_id` field from @address,
-which must be an IPv6 address.</doc>
+which must be an IPv6 address.
+
+If not overridden this value will be inherited from [[email protected]:address].</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the scope id field</doc>
           <type name="guint32" c:type="guint32"/>
@@ -47521,15 +47597,19 @@ which must be an IPv6 address.</doc>
         <type name="InetAddress"/>
       </property>
       <property name="flowinfo" version="2.32" writable="1" construct-only="1" transfer-ownership="none" getter="get_flowinfo" default-value="0">
-        <doc xml:space="preserve">The `sin6_flowinfo` field, for IPv6 addresses.</doc>
+        <doc xml:space="preserve">The `sin6_flowinfo` field, for IPv6 addresses.
+
+If unset this property is inherited from [[email protected]:address].</doc>
         <type name="guint" c:type="guint"/>
       </property>
       <property name="port" version="2.22" writable="1" construct-only="1" transfer-ownership="none" getter="get_port" default-value="0">
         <doc xml:space="preserve">The port.</doc>
         <type name="guint" c:type="guint"/>
       </property>
       <property name="scope-id" version="2.32" writable="1" construct-only="1" transfer-ownership="none" getter="get_scope_id" default-value="0">
-        <doc xml:space="preserve">The `sin6_scope_id` field, for IPv6 addresses.</doc>
+        <doc xml:space="preserve">The `sin6_scope_id` field, for IPv6 addresses.
+
+If unset this property is inherited from [[email protected]:address].</doc>
         <type name="guint" c:type="guint"/>
       </property>
       <field name="parent_instance">

Gsk-4.0.gir

@@ -2438,6 +2438,45 @@ This function serves two purposes:
           </parameter>
         </parameters>
       </method>
+      <method name="foreach_intersection" c:identifier="gsk_path_foreach_intersection" version="4.20">
+        <doc xml:space="preserve">Finds intersections between two paths.
+
+This function finds intersections between @path1 and @path2,
+and calls @func for each of them, in increasing order for @path1.
+
+If @path2 is not provided or equal to @path1, the function finds
+non-trivial self-intersections of @path1.
+
+When segments of the paths coincide, the callback is called once
+for the start of the segment, with @GSK_PATH_INTERSECTION_START, and
+once for the end of the segment, with @GSK_PATH_INTERSECTION_END.
+Note that other intersections may occur between the start and end
+of such a segment.
+
+If @func returns `FALSE`, the iteration is stopped.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">`FALSE` if @func returned FALSE`, `TRUE` otherwise.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="path1" transfer-ownership="none">
+            <doc xml:space="preserve">the first path</doc>
+            <type name="Path" c:type="GskPath*"/>
+          </instance-parameter>
+          <parameter name="path2" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">the second path</doc>
+            <type name="Path" c:type="GskPath*"/>
+          </parameter>
+          <parameter name="func" transfer-ownership="none" scope="call" closure="2">
+            <doc xml:space="preserve">the function to call for intersections</doc>
+            <type name="PathIntersectionFunc" c:type="GskPathIntersectionFunc"/>
+          </parameter>
+          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">user data passed to @func</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_bounds" c:identifier="gsk_path_get_bounds" version="4.14">
         <doc xml:space="preserve">Computes the bounds of the given path.
 
@@ -3726,6 +3765,58 @@ Closed contours end with a @GSK_PATH_CLOSE operation.</doc>
         </parameter>
       </parameters>
     </callback>
+    <enumeration name="PathIntersection" version="4.20" glib:type-name="GskPathIntersection" glib:get-type="gsk_path_intersection_get_type" c:type="GskPathIntersection">
+      <doc xml:space="preserve">The values of this enumeration classify intersections
+between paths.</doc>
+      <member name="none" value="0" c:identifier="GSK_PATH_INTERSECTION_NONE" glib:nick="none" glib:name="GSK_PATH_INTERSECTION_NONE">
+        <doc xml:space="preserve">No intersection</doc>
+      </member>
+      <member name="normal" value="1" c:identifier="GSK_PATH_INTERSECTION_NORMAL" glib:nick="normal" glib:name="GSK_PATH_INTERSECTION_NORMAL">
+        <doc xml:space="preserve">A normal intersection, where the two paths
+  cross each other</doc>
+      </member>
+      <member name="start" value="2" c:identifier="GSK_PATH_INTERSECTION_START" glib:nick="start" glib:name="GSK_PATH_INTERSECTION_START">
+        <doc xml:space="preserve">The start of a segment where the two paths coincide</doc>
+      </member>
+      <member name="end" value="3" c:identifier="GSK_PATH_INTERSECTION_END" glib:nick="end" glib:name="GSK_PATH_INTERSECTION_END">
+        <doc xml:space="preserve">The end of a segment where the two paths coincide</doc>
+      </member>
+    </enumeration>
+    <callback name="PathIntersectionFunc" c:type="GskPathIntersectionFunc" version="4.20">
+      <doc xml:space="preserve">Prototype of the callback to iterate through the
+intersections of two paths.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">true to continue iterating, false to
+  stop the iteration and not call the function again</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="path1" transfer-ownership="none">
+          <doc xml:space="preserve">the first path</doc>
+          <type name="Path" c:type="GskPath*"/>
+        </parameter>
+        <parameter name="point1" transfer-ownership="none">
+          <doc xml:space="preserve">the intersection as point on @path1</doc>
+          <type name="PathPoint" c:type="const GskPathPoint*"/>
+        </parameter>
+        <parameter name="path2" transfer-ownership="none">
+          <doc xml:space="preserve">the second path</doc>
+          <type name="Path" c:type="GskPath*"/>
+        </parameter>
+        <parameter name="point2" transfer-ownership="none">
+          <doc xml:space="preserve">the intersection as point on @path2</doc>
+          <type name="PathPoint" c:type="const GskPathPoint*"/>
+        </parameter>
+        <parameter name="kind" transfer-ownership="none">
+          <doc xml:space="preserve">the nature of the intersection</doc>
+          <type name="PathIntersection" c:type="GskPathIntersection"/>
+        </parameter>
+        <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
+          <doc xml:space="preserve">user data</doc>
+          <type name="gpointer" c:type="gpointer"/>
+        </parameter>
+      </parameters>
+    </callback>
     <record name="PathMeasure" c:type="GskPathMeasure" opaque="1" version="4.14" glib:type-name="GskPathMeasure" glib:get-type="gsk_path_measure_get_type" c:symbol-prefix="path_measure">
       <doc xml:space="preserve">Performs measurements on paths such as determining the length of the path.
 

Gtk-4.0.gir

@@ -35981,7 +35981,7 @@ There are various cases in which you may need to use a `GtkFileChooserDialog`:
 - To save a file under a different name, use %GTK_FILE_CHOOSER_ACTION_SAVE,
   and set the existing file with [[email protected]_file].
 
-- To choose a folder instead of a filem use %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
+- To choose a folder instead of a file, use %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
 
 In general, you should only cause the file chooser to show a specific
 folder when it is appropriate to use [[email protected]_file],