[gobject-introspection] Update GLib introspection data



commit 18ba77c7d3e32466b14cd094edf6c66612fa2c64
Author: Sebastian Dröge <sebastian centricular com>
Date:   Fri Apr 29 11:20:11 2022 +0300

    Update GLib introspection data
    
    This is based on 0c6a1af9d616e110b4610d5a6a992d02ed1a5c21

 gir/gio-2.0.c     | 27 ++++++++++++++++++++++-----
 gir/glib-2.0.c    | 20 ++++++++++++++++----
 gir/gobject-2.0.c | 16 ++++++++++++++++
 3 files changed, 54 insertions(+), 9 deletions(-)
---
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c
index cdb080f2..d0adef41 100644
--- a/gir/gio-2.0.c
+++ b/gir/gio-2.0.c
@@ -7981,10 +7981,10 @@
  * some systems).
  *
  * When in “Low Power” mode, it is recommended that applications:
- * - disabling automatic downloads
+ * - disable automatic downloads;
  * - reduce the rate of refresh from online sources such as calendar or
- *   email synchronisation
- * - if the application has expensive visual effects, reduce them
+ *   email synchronisation;
+ * - reduce the use of expensive visual effects.
  *
  * It is also likely that OS components providing services to applications will
  * lower their own background activity, for the sake of the system.
@@ -28398,7 +28398,7 @@
  * @position: (out) (optional): the first position of @item, if it was found.
  *
  * Looks up the given @item in the list store by looping over the items and
- * comparing them with @compare_func until the first occurrence of @item which
+ * comparing them with @equal_func until the first occurrence of @item which
  * matches. If @item was not found, then @position will not be set, and this
  * method will return %FALSE.
  *
@@ -28408,6 +28408,23 @@
  */
 
 
+/**
+ * g_list_store_find_with_equal_func_full:
+ * @store: a #GListStore
+ * @item: (type GObject): an item
+ * @equal_func: (scope call): A custom equality check function
+ * @user_data: (closure): user data for @equal_func
+ * @position: (out) (optional): the first position of @item, if it was found.
+ *
+ * Like g_list_store_find_with_equal_func() but with an additional @user_data
+ * that is passed to @equal_func.
+ *
+ * Returns: Whether @store contains @item. If it was found, @position will be
+ * set to the position where @item occurred for the first time.
+ * Since: 2.74
+ */
+
+
 /**
  * g_list_store_insert:
  * @store: a #GListStore
@@ -41131,7 +41148,7 @@
  * #GTlsClientConnection:validation-flags).
  *
  * There are nonintuitive security implications when using a non-default
- * database. See #GDtlsConnection:database for details.
+ * database. See #GTlsConnection:database for details.
  *
  * Since: 2.30
  */
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c
index 9d66e744..ba9e2b8f 100644
--- a/gir/glib-2.0.c
+++ b/gir/glib-2.0.c
@@ -539,6 +539,12 @@
  *     Network and storage sizes should be reported in the normal SI units.
  * @G_FORMAT_SIZE_BITS: set the size as a quantity in bits, rather than
  *     bytes, and return units in bits. For example, ‘Mb’ rather than ‘MB’.
+ * @G_FORMAT_SIZE_ONLY_VALUE: return only value, without unit; this should
+ *     not be used together with @G_FORMAT_SIZE_LONG_FORMAT
+ *     nor @G_FORMAT_SIZE_ONLY_UNIT. Since: 2.74
+ * @G_FORMAT_SIZE_ONLY_UNIT: return only unit, without value; this should
+ *     not be used together with @G_FORMAT_SIZE_LONG_FORMAT
+ *     nor @G_FORMAT_SIZE_ONLY_VALUE. Since: 2.74
  *
  * Flags to modify the format of the string returned by g_format_size_full().
  */
@@ -19342,9 +19348,9 @@
  * g_iconv: (skip)
  * @converter: conversion descriptor from g_iconv_open()
  * @inbuf: bytes to convert
- * @inbytes_left: inout parameter, bytes remaining to convert in @inbuf
+ * @inbytes_left: (inout): inout parameter, bytes remaining to convert in @inbuf
  * @outbuf: converted output bytes
- * @outbytes_left: inout parameter, bytes available to fill in @outbuf
+ * @outbytes_left: (inout): inout parameter, bytes available to fill in @outbuf
  *
  * Same as the standard UNIX routine iconv(), but
  * may be implemented via libiconv on UNIX flavors that lack
@@ -35417,7 +35423,13 @@
  * This is equivalent to calling g_time_zone_new() with a string in the form
  * `[+|-]hh[:mm[:ss]]`.
  *
- * Returns: (transfer full): a timezone at the given offset from UTC
+ * It is possible for this function to fail if @seconds is too big (greater than
+ * 24 hours), in which case this function will return the UTC timezone for
+ * backwards compatibility. To detect failures like this, use
+ * g_time_zone_new_identifier() directly.
+ *
+ * Returns: (transfer full): a timezone at the given offset from UTC, or UTC on
+ *   failure
  * Since: 2.58
  */
 
@@ -38474,7 +38486,7 @@
  * must be valid UTF-8 encoded text. (Use g_utf8_validate() on all
  * text before trying to use UTF-8 utility functions with it.)
  *
- * Note you must ensure @dest is at least 4 * @n to fit the
+ * Note you must ensure @dest is at least 4 * @n + 1 to fit the
  * largest possible UTF-8 characters
  *
  * Returns: (transfer none): @dest
diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c
index 79eb8b78..cfbf3473 100644
--- a/gir/gobject-2.0.c
+++ b/gir/gobject-2.0.c
@@ -5016,6 +5016,22 @@
  */
 
 
+/**
+ * g_signal_group_connect_closure:
+ * @self: a #GSignalGroup
+ * @detailed_signal: a string of the form `signal-name` with optional `::signal-detail`
+ * @closure: (not nullable): the closure to connect.
+ * @after: whether the handler should be called before or after the
+ *  default handler of the signal.
+ *
+ * Connects @closure to the signal @detailed_signal on #GSignalGroup:target.
+ *
+ * You cannot connect a signal handler after #GSignalGroup:target has been set.
+ *
+ * Since: 2.74
+ */
+
+
 /**
  * g_signal_group_connect_data:
  * @self: a #GSignalGroup


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]