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

Update GIR files (2023-09-29)

Gtk-4.0.gir

@@ -26991,7 +26991,8 @@ from a list of options.
 
 ![An example GtkDropDown](drop-down.png)
 
-The `GtkDropDown` displays the selected choice.
+The `GtkDropDown` displays the [selected][property@Gtk.DropDown:selected]
+choice.
 
 The options are given to `GtkDropDown` in the form of `GListModel`
 and how the individual options are represented is determined by
@@ -27011,6 +27012,7 @@ useful if the list of options is long. To enable the search entry,
 use [method@Gtk.DropDown.set_enable_search].
 
 Here is a UI definition example for `GtkDropDown` with a simple model:
+
 ```xml
 <object class="GtkDropDown">
   <property name="model">
@@ -27028,12 +27030,12 @@ Here is a UI definition example for `GtkDropDown` with a simple model:
 To learn more about the list widget framework, see the
 [overview](section-list-widget.html).
 
-# CSS nodes
+## CSS nodes
 
 `GtkDropDown` has a single CSS node with name dropdown,
 with the button and popover nodes as children.
 
-# Accessibility
+## Accessibility
 
 `GtkDropDown` uses the %GTK_ACCESSIBLE_ROLE_COMBO_BOX role.</doc>
       <implements name="Accessible"/>
@@ -86124,12 +86126,13 @@ The expression must have a value type of %G_TYPE_STRING.</doc>
     <class name="StringList" c:symbol-prefix="string_list" c:type="GtkStringList" parent="GObject.Object" glib:type-name="GtkStringList" glib:get-type="gtk_string_list_get_type" glib:type-struct="StringListClass">
       <doc xml:space="preserve">`GtkStringList` is a list model that wraps an array of strings.
 
-The objects in the model have a "string" property.
+The objects in the model are of type [class@Gtk.StringObject] and have
+a "string" property that can be used inside expressions.
 
 `GtkStringList` is well-suited for any place where you would
 typically use a `char*[]`, but need a list model.
 
-# GtkStringList as GtkBuildable
+## GtkStringList as GtkBuildable
 
 The `GtkStringList` implementation of the `GtkBuildable` interface
 supports adding items directly using the `&lt;items&gt;` element and
@@ -86301,7 +86304,8 @@ gtk_string_list_take (self, g_strdup_print ("%d dollars", lots));
       <doc xml:space="preserve">`GtkStringObject` is the type of items in a `GtkStringList`.
 
 A `GtkStringObject` is a wrapper around a `const char*`; it has
-a [property@Gtk.StringObject:string] property.</doc>
+a [property@Gtk.StringObject:string] property that can be used
+for property bindings and expressions.</doc>
       <constructor name="new" c:identifier="gtk_string_object_new">
         <doc xml:space="preserve">Wraps a string in an object for use with `GListModel`.</doc>
         <return-value transfer-ownership="full">
@@ -114798,14 +114802,15 @@ If @window is hidden, this function also makes it visible.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="present_with_time" c:identifier="gtk_window_present_with_time">
+      <method name="present_with_time" c:identifier="gtk_window_present_with_time" deprecated="1" deprecated-version="4.14">
         <doc xml:space="preserve">Presents a window to the user in response to an user interaction.
 
 See [method@Gtk.Window.present] for more details.
 
 The timestamp should be gathered when the window was requested
 to be shown (when clicking a link for example), rather than once
 the window is ready to be shown.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_window_present()</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>