Update GIR files

Author: sdroege

GLib-2.0.gir

@@ -555,8 +555,10 @@ than #gsize.</doc>
           </array>
         </return-value>
         <parameters>
-          <parameter name="data" transfer-ownership="none">
-            <doc xml:space="preserve">an array of elements of @element_size</doc>
+          <parameter name="data" transfer-ownership="full" nullable="1" allow-none="1">
+            <doc xml:space="preserve">an array
+    of elements of @element_size, %NULL terminated,
+    or %NULL for an empty array</doc>
             <array c:type="gpointer">
               <type name="gpointer" c:type="gpointer"/>
             </array>
@@ -853,8 +855,9 @@ This did not actually work, so any such code should be removed.</doc>
 the underlying array is preserved for use elsewhere and returned
 to the caller.
 
-If the array was created with the @zero_terminate property
-set to %TRUE, the returned data is zero terminated too.
+Note that if the array was created with the @zero_terminate
+property set to %TRUE, this may still return %NULL if the length
+of the array was zero and data was not yet allocated.
 
 If array elements contain dynamically-allocated memory,
 the array elements should also be freed by the caller.
@@ -41291,8 +41294,10 @@ than #gsize.</doc>
         </array>
       </return-value>
       <parameters>
-        <parameter name="data" transfer-ownership="none">
-          <doc xml:space="preserve">an array of elements of @element_size</doc>
+        <parameter name="data" transfer-ownership="full" nullable="1" allow-none="1">
+          <doc xml:space="preserve">an array
+    of elements of @element_size, %NULL terminated,
+    or %NULL for an empty array</doc>
           <array c:type="gpointer">
             <type name="gpointer" c:type="gpointer"/>
           </array>

GModule-2.0.gir

@@ -773,7 +773,11 @@ and/or use gtk-doc annotations.  -->
     <record name="Module" c:type="GModule" disguised="1" opaque="1">
       <doc xml:space="preserve">The #GModule struct is an opaque data structure to represent a
 [dynamically-loaded module](modules.html#dynamic-loading-of-modules).
-It should only be accessed via the following functions.</doc>
+It should only be accessed via the following functions.
+
+To ensure correct lock ordering, these functions must not be called from
+global constructors (for example, those using GCC&#x2019;s
+`__attribute__((constructor))` attribute).</doc>
       <method name="close" c:identifier="g_module_close">
         <doc xml:space="preserve">Closes a module.</doc>
         <return-value transfer-ownership="none">

Gdk-4.0.gir

@@ -5739,7 +5739,7 @@ Initially, the hotspot is at the top left corner of the drag surface.</doc>
           </parameter>
         </parameters>
       </method>
-      <property name="actions" writable="1" transfer-ownership="none" getter="get_actions" default-value="0">
+      <property name="actions" writable="1" transfer-ownership="none" getter="get_actions" default-value="GDK_ACTION_NONE">
         <doc xml:space="preserve">The possible actions of this drag.</doc>
         <type name="DragAction"/>
       </property>
@@ -5759,7 +5759,7 @@ Initially, the hotspot is at the top left corner of the drag surface.</doc>
         <doc xml:space="preserve">The possible formats that the drag can provide its data in.</doc>
         <type name="ContentFormats"/>
       </property>
-      <property name="selected-action" writable="1" transfer-ownership="none" getter="get_selected_action" default-value="0">
+      <property name="selected-action" writable="1" transfer-ownership="none" getter="get_selected_action" default-value="GDK_ACTION_NONE">
         <doc xml:space="preserve">The currently selected action of the drag.</doc>
         <type name="DragAction"/>
       </property>
@@ -5797,6 +5797,9 @@ The drag object can now free all miscellaneous data.</doc>
     <bitfield name="DragAction" glib:type-name="GdkDragAction" glib:get-type="gdk_drag_action_get_type" c:type="GdkDragAction">
       <doc xml:space="preserve">Used in `GdkDrop` and `GdkDrag` to indicate the actions that the
 destination can and should do with the dropped data.</doc>
+      <member name="none" value="0" c:identifier="GDK_ACTION_NONE" version="4.20" glib:nick="none" glib:name="GDK_ACTION_NONE">
+        <doc xml:space="preserve">No action.</doc>
+      </member>
       <member name="copy" value="1" c:identifier="GDK_ACTION_COPY" glib:nick="copy" glib:name="GDK_ACTION_COPY">
         <doc xml:space="preserve">Copy the data.</doc>
       </member>
@@ -5816,7 +5819,7 @@ destination can and should do with the dropped data.</doc>
         <doc xml:space="preserve">Checks if @action represents a single action or includes
 multiple actions.
 
-When @action is 0 - ie no action was given, %TRUE
+When @action is `GDK_ACTION_NONE` - ie no action was given, `TRUE`
 is returned.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if exactly one action was given</doc>
@@ -6096,7 +6099,8 @@ available via [[email protected]_actions].</doc>
             <type name="Drop" c:type="GdkDrop*"/>
           </instance-parameter>
           <parameter name="action" transfer-ownership="none">
-            <doc xml:space="preserve">the action performed by the destination or 0 if the drop failed</doc>
+            <doc xml:space="preserve">the action performed by the destination or `GDK_ACTION_NONE` if the
+  drop failed</doc>
             <type name="DragAction" c:type="GdkDragAction"/>
           </parameter>
         </parameters>
@@ -6340,8 +6344,8 @@ actions first and then later call this function again.</doc>
             <type name="Drop" c:type="GdkDrop*"/>
           </instance-parameter>
           <parameter name="actions" transfer-ownership="none">
-            <doc xml:space="preserve">Supported actions of the destination, or 0 to indicate
-   that a drop will not be accepted</doc>
+            <doc xml:space="preserve">Supported actions of the destination, or `GDK_ACTION_NONE` to
+   indicate that a drop will not be accepted</doc>
             <type name="DragAction" c:type="GdkDragAction"/>
           </parameter>
           <parameter name="preferred" transfer-ownership="none">
@@ -22321,7 +22325,7 @@ indicate a higher priority.</doc>
       <doc xml:space="preserve">Checks if @action represents a single action or includes
 multiple actions.
 
-When @action is 0 - ie no action was given, %TRUE
+When @action is `GDK_ACTION_NONE` - ie no action was given, `TRUE`
 is returned.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE if exactly one action was given</doc>

Gsk-4.0.gir

@@ -280,7 +280,7 @@ The 4 sides of the border can have different widths and colors.</doc>
       <doc xml:space="preserve">A Broadway based renderer.
 
 See [[email protected]].</doc>
-      <constructor name="new" c:identifier="gsk_broadway_renderer_new">
+      <constructor name="new" c:identifier="gsk_broadway_renderer_new" deprecated="1" deprecated-version="4.20">
         <doc xml:space="preserve">Creates a new Broadway renderer.
 
 The Broadway renderer is the default renderer for the broadway backend.
@@ -289,6 +289,7 @@ call to gsk_renderer_realize().
 
 This function is only available when GTK was compiled with Broadway
 support.</doc>
+        <doc-deprecated xml:space="preserve">Broadway will be retired in GTK 5</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new Broadway renderer.</doc>
           <type name="Renderer" c:type="GskRenderer*"/>
@@ -5955,7 +5956,7 @@ See [[email protected]] for details.</doc>
       <method name="set_line_width" c:identifier="gsk_stroke_set_line_width" version="4.14">
         <doc xml:space="preserve">Sets the line width to be used when stroking.
 
-The line width must be &gt; 0.</doc>
+The line width must be &gt;= 0.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -6457,6 +6458,50 @@ if you want to keep it around.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="matrix_2d" c:identifier="gsk_transform_matrix_2d" version="4.20">
+        <doc xml:space="preserve">Multiplies @next with the matrix [ xx yx x0; xy yy y0; 0 0 1 ].
+
+The result of calling [[email protected]_2d] on the returned
+[[email protected]] should match the input passed to this
+function.
+
+This function consumes @next. Use [[email protected]] first
+if you want to keep it around.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">The new transform</doc>
+          <type name="Transform" c:type="GskTransform*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="next" transfer-ownership="full" nullable="1" allow-none="1">
+            <doc xml:space="preserve">the next transform</doc>
+            <type name="Transform" c:type="GskTransform*"/>
+          </instance-parameter>
+          <parameter name="xx" transfer-ownership="none">
+            <doc xml:space="preserve">the xx member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="yx" transfer-ownership="none">
+            <doc xml:space="preserve">the yx member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="xy" transfer-ownership="none">
+            <doc xml:space="preserve">the xy member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="yy" transfer-ownership="none">
+            <doc xml:space="preserve">the yy member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="dx" transfer-ownership="none">
+            <doc xml:space="preserve">the x0 member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+          <parameter name="dy" transfer-ownership="none">
+            <doc xml:space="preserve">the y0 member</doc>
+            <type name="gfloat" c:type="float"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="perspective" c:identifier="gsk_transform_perspective">
         <doc xml:space="preserve">Applies a perspective projection transform.