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

Update GIR files (2025-01-12)

Atk-1.0.gir

@@ -553,7 +553,7 @@ A string name/value pair representing a generic attribute.</doc>
         </parameters>
       </function>
     </record>
-    <constant name="BINARY_AGE" value="25410" c:type="ATK_BINARY_AGE" version="2.7.4">
+    <constant name="BINARY_AGE" value="25510" c:type="ATK_BINARY_AGE" version="2.7.4">
       <doc xml:space="preserve">Like atk_get_binary_age(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -4727,7 +4727,7 @@ application compile time, rather than from the library linked
 against at application run time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MINOR_VERSION" value="54" c:type="ATK_MINOR_VERSION" version="2.7.4">
+    <constant name="MINOR_VERSION" value="55" c:type="ATK_MINOR_VERSION" version="2.7.4">
       <doc xml:space="preserve">Like atk_get_minor_version(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>

Gtk-4.0.gir

@@ -9890,16 +9890,20 @@ property types:
 - booleans (strings like “TRUE”, “t”, “yes”, “y”, “1” are interpreted
   as true values, strings like “FALSE”, “f”, “no”, “n”, “0” are interpreted
   as false values)
+- string lists (separated by newlines)
 - enumeration types (can be specified by their full C identifier their short
   name used when registering the enumeration type, or their integer value)
 - flag types (can be specified by their C identifier or short name,
   optionally combined with “|” for bitwise OR, or a single integer value
   e.g., “GTK_INPUT_HINT_EMOJI|GTK_INPUT_HINT_LOWERCASE”, or “emoji|lowercase” or 520).
-- colors (in a format understood by [[email protected]])
-- `GVariant` (can be specified in the format understood by
-   [[email protected]])
-- pixbufs (can be specified as an object id, a resource path or a filename of an image file to load relative to the Builder file or the CWD if [[email protected]_from_string] was used)
-- GFile (like pixbufs, can be specified as an object id, a URI or a filename of a file to load relative to the Builder file or the CWD if [[email protected]_from_string] was used)
+- colors (in the format understood by [[email protected]])
+- transforms (in the format understood by [[email protected]])
+- Pango attribute lists (in the format understood by [[email protected]_string])
+- Pango tab arrays (in the format understood by [[email protected]_string])
+- Pango font descriptions (in the format understood by [[email protected]_string])
+- `GVariant` (in the format understood by [[email protected]])
+- textures (can be specified as an object id, a resource path or a filename of an image file to load relative to the Builder file or the CWD if [[email protected]_from_string] was used)
+- GFile (like textures, can be specified as an object id, a URI or a filename of a file to load relative to the Builder file or the CWD if [[email protected]_from_string] was used)
 
 Objects can be referred to by their name and by default refer to
 objects declared in the local XML fragment and objects exposed via
@@ -25989,8 +25993,7 @@ only available when GTK has been configured with `-Ddebug=true`.</doc>
       <member name="printing" value="64" c:identifier="GTK_DEBUG_PRINTING" glib:nick="printing" glib:name="GTK_DEBUG_PRINTING">
         <doc xml:space="preserve">Information about printing</doc>
       </member>
-      <member name="builder" value="128" c:identifier="GTK_DEBUG_BUILDER" glib:nick="builder" glib:name="GTK_DEBUG_BUILDER">
-        <doc xml:space="preserve">Trace GtkBuilder operation</doc>
+      <member name="builder_trace" value="128" c:identifier="GTK_DEBUG_BUILDER_TRACE" glib:nick="builder-trace" glib:name="GTK_DEBUG_BUILDER_TRACE">
       </member>
       <member name="size_request" value="256" c:identifier="GTK_DEBUG_SIZE_REQUEST" glib:nick="size-request" glib:name="GTK_DEBUG_SIZE_REQUEST">
         <doc xml:space="preserve">Information about size requests</doc>
@@ -26028,6 +26031,9 @@ only available when GTK has been configured with `-Ddebug=true`.</doc>
       <member name="css" value="1048576" c:identifier="GTK_DEBUG_CSS" version="4.16" glib:nick="css" glib:name="GTK_DEBUG_CSS">
         <doc xml:space="preserve">Information about deprecated CSS features.</doc>
       </member>
+      <member name="builder" value="2097152" c:identifier="GTK_DEBUG_BUILDER" glib:nick="builder" glib:name="GTK_DEBUG_BUILDER">
+        <doc xml:space="preserve">Trace GtkBuilder operation</doc>
+      </member>
     </bitfield>
     <enumeration name="DeleteType" glib:type-name="GtkDeleteType" glib:get-type="gtk_delete_type_get_type" c:type="GtkDeleteType">
       <doc xml:space="preserve">Passed to various keybinding signals for deleting text.</doc>
@@ -36646,6 +36652,68 @@ The @callback will be called when the dialog is dismissed.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="open_text_file" c:identifier="gtk_file_dialog_open_text_file" version="4.18" glib:finish-func="open_text_file_finish">
+        <doc xml:space="preserve">Initiates a file selection operation by presenting a file chooser
+dialog to the user.
+
+In contrast to [[email protected]], this function
+lets the user select the text encoding for the file, if possible.
+
+The @callback will be called when the dialog is dismissed.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a `GtkFileDialog`</doc>
+            <type name="FileDialog" c:type="GtkFileDialog*"/>
+          </instance-parameter>
+          <parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">the parent `GtkWindow`</doc>
+            <type name="Window" c:type="GtkWindow*"/>
+          </parameter>
+          <parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">a `GCancellable` to cancel the operation</doc>
+            <type name="Gio.Cancellable" c:type="GCancellable*"/>
+          </parameter>
+          <parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
+            <doc xml:space="preserve">a callback to call when the
+  operation is complete</doc>
+            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
+          </parameter>
+          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">data to pass to @callback</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="open_text_file_finish" c:identifier="gtk_file_dialog_open_text_file_finish" version="4.18" throws="1">
+        <doc xml:space="preserve">Finishes the [[email protected]_text_file] call
+and returns the resulting file and text encoding.
+
+If the user has explicitly selected a text encoding to use
+for the file, then @encoding will be set to a codeset name that
+is suitable for passing to iconv_open(). Otherwise, it will
+be `NULL`.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the file that was selected</doc>
+          <type name="Gio.File" c:type="GFile*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a `GtkFileDialog`</doc>
+            <type name="FileDialog" c:type="GtkFileDialog*"/>
+          </instance-parameter>
+          <parameter name="result" transfer-ownership="none">
+            <doc xml:space="preserve">a `GAsyncResult`</doc>
+            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
+          </parameter>
+          <parameter name="encoding" direction="out" caller-allocates="0" transfer-ownership="full">
+            <doc xml:space="preserve">return location for the text encoding to use</doc>
+            <type name="utf8" c:type="const char**"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="save" c:identifier="gtk_file_dialog_save" version="4.10" glib:finish-func="save_finish">
         <doc xml:space="preserve">Presents a file chooser dialog to the user.
 
@@ -36696,6 +36764,77 @@ The @callback will be called when the dialog is dismissed.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="save_text_file" c:identifier="gtk_file_dialog_save_text_file" version="4.18" glib:finish-func="save_text_file_finish">
+        <doc xml:space="preserve">Initiates a file save operation by presenting a file chooser
+dialog to the user.
+
+In contrast to [[email protected]], this function
+lets the user select the text encoding and line endings for
+the text file, if possible.
+
+The @callback will be called when the dialog is dismissed.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a `GtkFileDialog`</doc>
+            <type name="FileDialog" c:type="GtkFileDialog*"/>
+          </instance-parameter>
+          <parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">the parent `GtkWindow`</doc>
+            <type name="Window" c:type="GtkWindow*"/>
+          </parameter>
+          <parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">a `GCancellable` to cancel the operation</doc>
+            <type name="Gio.Cancellable" c:type="GCancellable*"/>
+          </parameter>
+          <parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
+            <doc xml:space="preserve">a callback to call when the
+  operation is complete</doc>
+            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
+          </parameter>
+          <parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
+            <doc xml:space="preserve">data to pass to @callback</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="save_text_file_finish" c:identifier="gtk_file_dialog_save_text_file_finish" version="4.18" throws="1">
+        <doc xml:space="preserve">Finishes the [[email protected]_text_file] call
+and returns the resulting file, text encoding and line endings.
+
+If the user has explicitly selected a text encoding to use
+for the file, then @encoding will be set to a codeset name that
+is suitable for passing to iconv_open(). Otherwise, it will
+be `NULL`.
+
+The @line_ending will be set to one of "\n", "\r\n", "\r" or "",
+where the latter means to preserve existing line endings.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the file that was selected.
+  Otherwise, `NULL` is returned and @error is set</doc>
+          <type name="Gio.File" c:type="GFile*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a `GtkFileDialog`</doc>
+            <type name="FileDialog" c:type="GtkFileDialog*"/>
+          </instance-parameter>
+          <parameter name="result" transfer-ownership="none">
+            <doc xml:space="preserve">a `GAsyncResult`</doc>
+            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
+          </parameter>
+          <parameter name="encoding" direction="out" caller-allocates="0" transfer-ownership="full">
+            <doc xml:space="preserve">return location for the text encoding to use</doc>
+            <type name="utf8" c:type="const char**"/>
+          </parameter>
+          <parameter name="line_ending" direction="out" caller-allocates="0" transfer-ownership="full">
+            <doc xml:space="preserve">return location for the line endings to use</doc>
+            <type name="utf8" c:type="const char**"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="select_folder" c:identifier="gtk_file_dialog_select_folder" version="4.10" glib:finish-func="select_folder_finish">
         <doc xml:space="preserve">Presents a file chooser dialog to the user.