Update GIR files (2023-08-22)

GLib-2.0.gir

@@ -18130,13 +18130,13 @@ or g_option_group_add_entries().</doc>
     called to handle the extra argument. Otherwise, @arg_data is a
     pointer to a location to store the value, the required type of
     the location depends on the @arg type:
-    - %G_OPTION_ARG_NONE: %gboolean
-    - %G_OPTION_ARG_STRING: %gchar*
-    - %G_OPTION_ARG_INT: %gint
-    - %G_OPTION_ARG_FILENAME: %gchar*
-    - %G_OPTION_ARG_STRING_ARRAY: %gchar**
-    - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
-    - %G_OPTION_ARG_DOUBLE: %gdouble
+     - %G_OPTION_ARG_NONE: %gboolean
+     - %G_OPTION_ARG_STRING: %gchar*
+     - %G_OPTION_ARG_INT: %gint
+     - %G_OPTION_ARG_FILENAME: %gchar*
+     - %G_OPTION_ARG_STRING_ARRAY: %gchar**
+     - %G_OPTION_ARG_FILENAME_ARRAY: %gchar**
+     - %G_OPTION_ARG_DOUBLE: %gdouble
     If @arg type is %G_OPTION_ARG_STRING or %G_OPTION_ARG_FILENAME,
     the location will contain a newly allocated string if the option
     was given. That string needs to be freed by the callee using g_free().

Gsk-4.0.gir

@@ -2857,9 +2857,9 @@ and end point. To add a closed path, use [method@Gsk.PathBuilder.add_path].</doc
 
 Note that this is different from calling [method@Gsk.PathBuilder.line_to]
 with the start point in that the contour will be closed. A closed
-contour behaves different from an open one when stroking its start
-and end point are considered connected, so they will be joined
-via the line join, and not ended with line caps.</doc>
+contour behaves differently from an open one. When stroking, its
+start and end point are considered connected, so they will be
+joined via the line join, and not ended with line caps.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -2875,7 +2875,12 @@ via the line join, and not ended with line caps.</doc>
 from the current point to @x3, @y3 with @x1, @y1 and @x2, @y2 as the control
 points.
 
-After this, @x3, @y3 will be the new current point.</doc>
+After this, @x3, @y3 will be the new current point.
+
+&lt;picture&gt;
+  &lt;source srcset="cubic-dark.png" media="(prefers-color-scheme: dark)"&gt;
+  &lt;img alt="Cubic To" src="cubic-light.png"&gt;
+&lt;/picture&gt;</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -2945,7 +2950,12 @@ a current point.</doc>
       </method>
       <method name="line_to" c:identifier="gsk_path_builder_line_to" version="4.14">
         <doc xml:space="preserve">Draws a line from the current point to @x, @y and makes it
-the new current point.</doc>
+the new current point.
+
+&lt;picture&gt;
+  &lt;source srcset="line-dark.png" media="(prefers-color-scheme: dark)"&gt;
+  &lt;img alt="Line To" src="line-light.png"&gt;
+&lt;/picture&gt;</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -2992,7 +3002,12 @@ The second call will start a new contour.</doc>
         <doc xml:space="preserve">Adds a [quadratic B&#xE9;zier curve](https://en.wikipedia.org/wiki/B%C3%A9zier_curve)
 from the current point to @x2, @y2 with @x1, @y1 as the control point.
 
-After this, @x2, @y2 will be the new current point.</doc>
+After this, @x2, @y2 will be the new current point.
+
+&lt;picture&gt;
+  &lt;source srcset="quad-dark.png" media="(prefers-color-scheme: dark)"&gt;
+  &lt;img alt="Quad To" src="quad-light.png"&gt;
+&lt;/picture&gt;</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>

Gtk-4.0.gir

@@ -963,7 +963,7 @@ a side effect.</doc>
         <doc xml:space="preserve">A logo for the about box.
 
 If it is `NULL`, the default window icon set with
-[id@gtk_window_set_default_icon_name] will be used.</doc>
+[func@Gtk.Window.set_default_icon_name] will be used.</doc>
         <type name="Gdk.Paintable"/>
       </property>
       <property name="logo-icon-name" writable="1" transfer-ownership="none" setter="set_logo_icon_name" getter="get_logo_icon_name" default-value="NULL">
@@ -33934,7 +33934,7 @@ similar to GObject's `GBinding` mechanism, by using [method@Gtk.Expression.bind]
 ## GtkExpression in GObject properties
 
 In order to use a `GtkExpression` as a `GObject` property, you must use the
-[id@gtk_param_spec_expression] when creating a `GParamSpec` to install in the
+[func@Gtk.param_spec_expression] when creating a `GParamSpec` to install in the
 `GObject` class being defined; for instance:
 
 ```c
@@ -33948,8 +33948,8 @@ obj_props[PROP_EXPRESSION] =
 ```
 
 When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
-virtual functions, you must use [id@gtk_value_get_expression], to retrieve the
-stored `GtkExpression` from the `GValue` container, and [id@gtk_value_set_expression],
+virtual functions, you must use [func@Gtk.value_get_expression], to retrieve the
+stored `GtkExpression` from the `GValue` container, and [func@Gtk.value_set_expression],
 to store the `GtkExpression` into the `GValue`; for instance:
 
 ```c
@@ -40731,7 +40731,11 @@ to the buttons language.</doc>
         <doc xml:space="preserve">Whether the buttons label will use the selected font size.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
-      <glib:signal name="activate" when="first" action="1">
+      <glib:signal name="activate" when="first" action="1" version="4.14">
+        <doc xml:space="preserve">Emitted when the font dialog button is activated.
+
+The `::activate` signal on `GtkFontDialogButton` is an action signal
+and emitting it causes the button to pop up its dialog.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -67312,7 +67316,7 @@ The following attributes are used when constructing submenus:
 
 Menu items will also show accelerators, which are usually associated
 with actions via [method@Gtk.Application.set_accels_for_action],
-[id@gtk_widget_class_add_binding_action] or
+[method@WidgetClass.add_binding_action] or
 [method@Gtk.ShortcutController.add_shortcut].
 
 # CSS Nodes
@@ -107932,13 +107936,13 @@ in the [enum@Gtk.SizeRequestMode] chosen by the toplevel.
 For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
 
 First, the default minimum and natural width for each widget
-in the interface will be computed using [id@gtk_widget_measure] with an
+in the interface will be computed using [method@Gtk.Widget.measure] with an
 orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
 Because the preferred widths for each widget depend on the preferred
 widths of their children, this information propagates up the hierarchy,
 and finally a minimum and natural width is determined for the entire
 toplevel. Next, the toplevel will use the minimum width to query for the
-minimum height contextual to that width using [id@gtk_widget_measure] with an
+minimum height contextual to that width using [method@Gtk.Widget.measure] with an
 orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
 width. This will also be a highly recursive operation. The minimum height
 for the minimum width is normally used to set the minimum size constraint
@@ -108029,7 +108033,7 @@ twice. GTK therefore does not allow this and will warn if you try
 to do it.
 
 Of course if you are getting the size request for another widget, such
-as a child widget, you must use [id@gtk_widget_measure]; otherwise, you
+as a child widget, you must use [method@Gtk.Widget.measure]; otherwise, you
 would not properly consider widget margins, [class@Gtk.SizeGroup], and
 so forth.
 
@@ -108046,7 +108050,7 @@ both a minimum and natural size.
 
 If a widget ends up baseline aligned it will be allocated all the space in
 the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
-found via [id@gtk_widget_get_baseline]. If the baseline has a
+found via [method@Gtk.Widget.get_baseline]. If the baseline has a
 value other than -1 you need to align the widget such that the baseline
 appears at the position.
 
@@ -108211,7 +108215,7 @@ foo_widget_dispose (GObject *gobject)
 ```
 
 You can access widgets defined in the template using the
-[id@gtk_widget_get_template_child] function, but you will typically declare
+[method@Gtk.Widget.get_template_child] function, but you will typically declare
 a pointer in the instance private data structure of your type using the same
 name as the widget in the template definition, and call
 [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
@@ -110124,7 +110128,7 @@ widget will generally be a smaller size than the minimum height, since
 the required height for the natural width is generally smaller than the
 required height for the minimum width.
 
-Use [id@gtk_widget_measure] if you want to support baseline alignment.</doc>
+Use [method@Gtk.Widget.measure] if you want to support baseline alignment.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -116404,7 +116408,7 @@ into an application using a newer version of GTK.</doc>
       </return-value>
     </function>
     <function name="disable_setlocale" c:identifier="gtk_disable_setlocale">
-      <doc xml:space="preserve">Prevents [id@gtk_init] and [id@gtk_init_check] from automatically calling
+      <doc xml:space="preserve">Prevents [func@Gtk.init] and [func@Gtk.init_check] from automatically calling
 `setlocale (LC_ALL, "")`.
 
 You would want to use this function if you wanted to set the locale for