[glibmm/glibmm-2-62] Glib, Gio: Regenerate docs.xml and .defs files
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm/glibmm-2-62] Glib, Gio: Regenerate docs.xml and .defs files
- Date: Sun, 15 Sep 2019 17:22:43 +0000 (UTC)
commit aff8ef158afbca3c0bd6dfaa004d84b66b46729a
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date: Sun Sep 15 19:17:34 2019 +0200
Glib, Gio: Regenerate docs.xml and .defs files
gio/src/gio_docs.xml | 352 ++++++++++-----
gio/src/gio_enums.defs | 2 +-
gio/src/gio_methods.defs | 24 ++
glib/src/glib_docs.xml | 929 ++++++++++++++++++++++++++++++++++++----
glib/src/glib_enums.defs | 24 +-
glib/src/glib_functions.defs | 143 +++++++
glib/src/gobject_enums.defs | 6 +-
glib/src/gobject_functions.defs | 33 +-
8 files changed, 1284 insertions(+), 229 deletions(-)
---
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 37cc29a5..ef3f6114 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -3209,6 +3209,15 @@ Flags used when querying a #GFileInfo.
<description>
Indicates the file's on-disk type.
+On Windows systems a file will never have %G_FILE_TYPE_SYMBOLIC_LINK type;
+use #GFileInfo and %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK to determine
+whether a file is a symlink or not. This is due to the fact that NTFS does
+not have a single filesystem object type for symbolic links - it has
+files that symlink to files, and directories that symlink to directories.
+#GFileType enumeration cannot precisely represent this important distinction,
+which is why all Windows symlinks will continue to be reported as
+%G_FILE_TYPE_REGULAR or %G_FILE_TYPE_DIRECTORY.
+
</description>
<parameters>
<parameter name="G_FILE_TYPE_UNKNOWN">
@@ -3709,9 +3718,12 @@ Defaults to "/".
<signal name="GListModel::items-changed">
<description>
-This signal is emitted whenever items were added or removed to
-@list. At @position, @removed items were removed and @added items
-were added in their place.
+This signal is emitted whenever items were added to or removed
+from @list. At @position, @removed items were removed and @added
+items were added in their place.
+
+Note: If @removed != @added, the positions of all later items
+in the model change.
Since: 2.44
@@ -4649,47 +4661,53 @@ as lists of #GVariant tuples. Each record type has different values in
the variant tuples returned.
%G_RESOLVER_RECORD_SRV records are returned as variants with the signature
-'(qqqs)', containing a guint16 with the priority, a guint16 with the
-weight, a guint16 with the port, and a string of the hostname.
+`(qqqs)`, containing a `guint16` with the priority, a `guint16` with the
+weight, a `guint16` with the port, and a string of the hostname.
%G_RESOLVER_RECORD_MX records are returned as variants with the signature
-'(qs)', representing a guint16 with the preference, and a string containing
+`(qs)`, representing a `guint16` with the preference, and a string containing
the mail exchanger hostname.
%G_RESOLVER_RECORD_TXT records are returned as variants with the signature
-'(as)', representing an array of the strings in the text record.
+`(as)`, representing an array of the strings in the text record. Note: Most TXT
+records only contain a single string, but
+[RFC 1035](https://tools.ietf.org/html/rfc1035#section-3.3.14) does allow a
+record to contain multiple strings. The RFC which defines the interpretation
+of a specific TXT record will likely require concatenation of multiple
+strings if they are present, as with
+[RFC 7208](https://tools.ietf.org/html/rfc7208#section-3.3).
%G_RESOLVER_RECORD_SOA records are returned as variants with the signature
-'(ssuuuuu)', representing a string containing the primary name server, a
-string containing the administrator, the serial as a guint32, the refresh
-interval as guint32, the retry interval as a guint32, the expire timeout
-as a guint32, and the ttl as a guint32.
+`(ssuuuuu)`, representing a string containing the primary name server, a
+string containing the administrator, the serial as a `guint32`, the refresh
+interval as a `guint32`, the retry interval as a `guint32`, the expire timeout
+as a `guint32`, and the TTL as a `guint32`.
%G_RESOLVER_RECORD_NS records are returned as variants with the signature
-'(s)', representing a string of the hostname of the name server.
+`(s)`, representing a string of the hostname of the name server.
Since: 2.34
</description>
<parameters>
<parameter name="G_RESOLVER_RECORD_SRV">
-<parameter_description> lookup DNS SRV records for a domain
+<parameter_description> look up DNS SRV records for a domain
</parameter_description>
</parameter>
<parameter name="G_RESOLVER_RECORD_MX">
-<parameter_description> lookup DNS MX records for a domain
+<parameter_description> look up DNS MX records for a domain
</parameter_description>
</parameter>
<parameter name="G_RESOLVER_RECORD_TXT">
-<parameter_description> lookup DNS TXT records for a name
+<parameter_description> look up DNS TXT records for a name
</parameter_description>
</parameter>
<parameter name="G_RESOLVER_RECORD_SOA">
-<parameter_description> lookup DNS SOA records for a zone
+<parameter_description> look up DNS SOA records for a zone
</parameter_description>
</parameter>
<parameter name="G_RESOLVER_RECORD_NS">
-<parameter_description> lookup DNS NS records for a domain
+<parameter_description> look up DNS NS records for a domain
</parameter_description>
</parameter>
</parameters>
@@ -7721,7 +7739,7 @@ Since: 2.38
</description>
<parameters>
<parameter name="action_name">
-<parameter_description> an potential action name
+<parameter_description> a potential action name
</parameter_description>
</parameter>
</parameters>
@@ -8313,7 +8331,7 @@ required.
The D-Bus–activated applications don't have to be started if your application
terminates too soon after this function. To prevent this, use
-g_app_info_launch_default_for_uri() instead.
+g_app_info_launch_default_for_uri_async() instead.
</description>
@@ -11180,7 +11198,7 @@ Asynchronously connects to the message bus specified by @bus_type.
When the operation is finished, @callback will be invoked. You can
then call g_bus_get_finish() to get the result of the operation.
-This is a asynchronous failable function. See g_bus_get_sync() for
+This is an asynchronous failable function. See g_bus_get_sync() for
the synchronous version.
Since: 2.26
@@ -11371,7 +11389,7 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> an identifier (never 0) that an be used with
+<return> an identifier (never 0) that can be used with
g_bus_unown_name() to stop owning the name.
</return>
@@ -11415,7 +11433,7 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> an identifier (never 0) that an be used with
+<return> an identifier (never 0) that can be used with
g_bus_unown_name() to stop owning the name
</return>
@@ -11453,7 +11471,7 @@ or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> an identifier (never 0) that an be used with
+<return> an identifier (never 0) that can be used with
g_bus_unown_name() to stop owning the name.
</return>
@@ -11496,7 +11514,7 @@ acquired or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> an identifier (never 0) that an be used with
+<return> an identifier (never 0) that can be used with
g_bus_unown_name() to stop owning the name.
</return>
@@ -11538,7 +11556,7 @@ Since: 2.26
<description>
Starts watching @name on the bus specified by @bus_type and calls
@name_appeared_handler and @name_vanished_handler when the name is
-known to have a owner respectively known to lose its
+known to have an owner respectively known to lose its
owner. Callbacks will be invoked in the
[thread-default main context][g-main-context-push-thread-default]
of the thread you are calling this function from.
@@ -11599,7 +11617,7 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
+<return> An identifier (never 0) that can be used with
g_bus_unwatch_name() to stop watching the name.
</return>
@@ -11643,7 +11661,7 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
+<return> An identifier (never 0) that can be used with
g_bus_unwatch_name() to stop watching the name.
</return>
@@ -11681,7 +11699,7 @@ to not exist or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
+<return> An identifier (never 0) that can be used with
g_bus_unwatch_name() to stop watching the name.
</return>
@@ -11719,7 +11737,7 @@ to not exist or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
+<return> An identifier (never 0) that can be used with
g_bus_unwatch_name() to stop watching the name.
</return>
@@ -12784,7 +12802,7 @@ Since: 2.24
Gets a pointer to native credentials of type @native_type from
@credentials.
-It is a programming error (which will cause an warning to be
+It is a programming error (which will cause a warning to be
logged) to use this method if there is no #GCredentials support for
the OS or if @native_type isn't supported by the OS.
@@ -12913,7 +12931,7 @@ Since: 2.26
Copies the native credentials of type @native_type from @native
into @credentials.
-It is a programming error (which will cause an warning to be
+It is a programming error (which will cause a warning to be
logged) to use this method if there is no #GCredentials support for
the OS or if @native_type isn't supported by the OS.
@@ -14444,8 +14462,8 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> a valid D-Bus address string for @bus_type or %NULL if
-@error is set
+<return> a valid D-Bus address string for @bus_type or
+%NULL if @error is set
</return>
</function>
@@ -15732,7 +15750,7 @@ When the operation is finished, @callback will be invoked. You can
then call g_dbus_connection_new_finish() to get the result of the
operation.
-This is a asynchronous failable constructor. See
+This is an asynchronous failable constructor. See
g_dbus_connection_new_sync() for the synchronous
version.
@@ -15745,7 +15763,7 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="guid">
-<parameter_description> the GUID to use if a authenticating as a server or %NULL
+<parameter_description> the GUID to use if authenticating as a server or %NULL
</parameter_description>
</parameter>
<parameter name="flags">
@@ -15810,13 +15828,13 @@ server. In particular, @flags cannot contain the
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
When the operation is finished, @callback will be invoked. You can
-then call g_dbus_connection_new_finish() to get the result of the
-operation.
+then call g_dbus_connection_new_for_address_finish() to get the result of
+the operation.
If @observer is not %NULL it may be used to control the
authentication process.
-This is a asynchronous failable constructor. See
+This is an asynchronous failable constructor. See
g_dbus_connection_new_for_address_sync() for the synchronous
version.
@@ -15953,7 +15971,7 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="guid">
-<parameter_description> the GUID to use if a authenticating as a server or %NULL
+<parameter_description> the GUID to use if authenticating as a server or %NULL
</parameter_description>
</parameter>
<parameter name="flags">
@@ -16448,8 +16466,8 @@ closed by the remote peer. See #GDBusConnection:exit-on-close for
more details.
Note that this function should be used with care. Most modern UNIX
-desktops tie the notion of a user session the session bus, and expect
-all of a users applications to quit when their bus connection goes away.
+desktops tie the notion of a user session with the session bus, and expect
+all of a user's applications to quit when their bus connection goes away.
If you are setting @exit_on_close to %FALSE for the shared session
bus connection, you should make sure that your application exits
when the user session ends.
@@ -16830,7 +16848,7 @@ Since: 2.26
</description>
<parameters>
<parameter name="error_domain">
-<parameter_description> A #GQuark for a error domain.
+<parameter_description> A #GQuark for an error domain.
</parameter_description>
</parameter>
<parameter name="error_code">
@@ -16974,7 +16992,7 @@ Since: 2.26
</description>
<parameters>
<parameter name="error_domain">
-<parameter_description> A #GQuark for a error domain.
+<parameter_description> A #GQuark for an error domain.
</parameter_description>
</parameter>
<parameter name="error_code">
@@ -19987,11 +20005,11 @@ Since: 2.30
</parameter_description>
</parameter>
<parameter name="object_path">
-<parameter_description> Object path to lookup.
+<parameter_description> Object path to look up.
</parameter_description>
</parameter>
<parameter name="interface_name">
-<parameter_description> D-Bus interface name to lookup.
+<parameter_description> D-Bus interface name to look up.
</parameter_description>
</parameter>
</parameters>
@@ -20014,7 +20032,7 @@ Since: 2.30
</parameter_description>
</parameter>
<parameter name="object_path">
-<parameter_description> Object path to lookup.
+<parameter_description> Object path to look up.
</parameter_description>
</parameter>
</parameters>
@@ -21439,6 +21457,10 @@ Creates a new D-Bus server that listens on the first address in
Once constructed, you can use g_dbus_server_get_client_address() to
get a D-Bus address string that clients can use to connect.
+To have control over the available authentication mechanisms and
+the users that are authorized to connect, it is strongly recommended
+to provide a non-%NULL #GDBusAuthObserver.
+
Connect to the #GDBusServer::new-connection signal to handle
incoming connections.
@@ -21447,8 +21469,8 @@ g_dbus_server_start().
#GDBusServer is used in this [example][gdbus-peer-to-peer].
-This is a synchronous failable constructor. See
-g_dbus_server_new() for the asynchronous version.
+This is a synchronous failable constructor. There is currently no
+asynchronous version.
Since: 2.26
@@ -21848,7 +21870,7 @@ Looks up a string list value in the keyfile backing @info.
The @key is looked up in the "Desktop Entry" group.
-Since: 2.60.0
+Since: 2.60
</description>
<parameters>
@@ -22090,15 +22112,16 @@ Since: 2.38
<function name="g_desktop_app_info_lookup_get_default_for_uri_scheme">
<description>
Gets the default application for launching applications
-using this URI scheme for a particular GDesktopAppInfoLookup
+using this URI scheme for a particular #GDesktopAppInfoLookup
implementation.
-The GDesktopAppInfoLookup interface and this function is used
+The #GDesktopAppInfoLookup interface and this function is used
to implement g_app_info_get_default_for_uri_scheme() backends
in a GIO module. There is no reason for applications to use it
directly. Applications should use g_app_info_get_default_for_uri_scheme().
-Deprecated: The #GDesktopAppInfoLookup interface is deprecated and unused by gio.
+Deprecated: 2.28: The #GDesktopAppInfoLookup interface is deprecated and
+unused by GIO.
</description>
<parameters>
@@ -24112,7 +24135,7 @@ Gets the file attribute with the name @name from @list.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> the name of the attribute to lookup.
+<parameter_description> the name of the attribute to look up.
</parameter_description>
</parameter>
</parameters>
@@ -25678,9 +25701,9 @@ This call does no blocking I/O.
<description>
Gets a #GMount for the #GFile.
-If the #GFileIface for @file does not have a mount (e.g.
-possibly a remote share), @error will be set to %G_IO_ERROR_NOT_FOUND
-and %NULL will be returned.
+#GMount is returned only for user interesting locations, see
+#GVolumeMonitor. If the #GFileIface for @file does not have a #mount,
+@error will be set to %G_IO_ERROR_NOT_FOUND and %NULL #will be returned.
If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
@@ -26202,7 +26225,7 @@ Duplicates a file info structure.
<description>
Gets the value of a attribute, formated as a string.
This escapes things as needed to make the string valid
-utf8.
+UTF-8.
</description>
@@ -26216,7 +26239,8 @@ utf8.
</parameter_description>
</parameter>
</parameters>
-<return> a UTF-8 string associated with the given @attribute.
+<return> a UTF-8 string associated with the given @attribute, or
+%NULL if the attribute wasn’t set.
When you're done with the string it must be freed with g_free().
</return>
</function>
@@ -26323,7 +26347,7 @@ attribute does not contain a signed 32-bit integer, or is invalid,
<function name="g_file_info_get_attribute_int64">
<description>
Gets a signed 64-bit integer contained within the attribute. If the
-attribute does not contain an signed 64-bit integer, or is invalid,
+attribute does not contain a signed 64-bit integer, or is invalid,
0 will be returned.
@@ -26663,11 +26687,36 @@ Checks if a file is a symlink.
</return>
</function>
+<function name="g_file_info_get_modification_date_time">
+<description>
+Gets the modification time of the current @info and returns it as a
+#GDateTime.
+
+This requires the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute. If
+%G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is provided, the resulting #GDateTime
+will have microsecond precision.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> modification time, or %NULL if unknown
+</return>
+</function>
+
<function name="g_file_info_get_modification_time">
<description>
Gets the modification time of the current @info and sets it
in @result.
+Deprecated: 2.62: Use g_file_info_get_modification_date_time() instead, as
+#GTimeVal is deprecated due to the year 2038 problem.
+
</description>
<parameters>
<parameter name="info">
@@ -27283,11 +27332,35 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
<return></return>
</function>
+<function name="g_file_info_set_modification_date_time">
+<description>
+Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
+info to the given date/time value.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="mtime">
+<parameter_description> a #GDateTime.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_file_info_set_modification_time">
<description>
Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
info to the given time value.
+Deprecated: 2.62: Use g_file_info_set_modification_date_time() instead, as
+#GTimeVal is deprecated due to the year 2038 problem.
+
</description>
<parameters>
<parameter name="info">
@@ -28193,7 +28266,7 @@ reports the number of directories and non-directory files encountered
By default, errors are only reported against the toplevel file
itself. Errors found while recursing are silently ignored, unless
-%G_FILE_DISK_USAGE_REPORT_ALL_ERRORS is given in @flags.
+%G_FILE_MEASURE_REPORT_ANY_ERROR is given in @flags.
The returned size, @disk_usage, is in bytes and should be formatted
with g_format_size() in order to get something reasonable for showing
@@ -29330,6 +29403,10 @@ Since: 2.60
<parameter_description> a #GFile to open
</parameter_description>
</parameter>
+<parameter name="io_priority">
+<parameter_description> the [I/O priority][io-priority] of the request
+</parameter_description>
+</parameter>
<parameter name="cancellable">
<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
@@ -31068,7 +31145,7 @@ when the request is satisfied, or %NULL
<function name="g_file_stop_mountable_finish">
<description>
-Finishes an stop operation, see g_file_stop_mountable() for details.
+Finishes a stop operation, see g_file_stop_mountable() for details.
Finish an asynchronous stop operation that was started
with g_file_stop_mountable().
@@ -32714,8 +32791,8 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to
-read data into (which should be at least count bytes long).
+<parameter_description>
+a buffer to read data into (which should be at least count bytes long).
</parameter_description>
</parameter>
<parameter name="count">
@@ -32765,8 +32842,8 @@ write your own loop around g_input_stream_read().
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to
-read data into (which should be at least count bytes long).
+<parameter_description>
+a buffer to read data into (which should be at least count bytes long).
</parameter_description>
</parameter>
<parameter name="count">
@@ -32812,8 +32889,8 @@ Since: 2.44
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to
-read data into (which should be at least count bytes long)
+<parameter_description>
+a buffer to read data into (which should be at least count bytes long)
</parameter_description>
</parameter>
<parameter name="count">
@@ -32911,8 +32988,8 @@ override one you must override all.
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to
-read data into (which should be at least count bytes long).
+<parameter_description>
+a buffer to read data into (which should be at least count bytes long).
</parameter_description>
</parameter>
<parameter name="count">
@@ -33241,7 +33318,7 @@ ignore.
</parameter_description>
</parameter>
</parameters>
-<return> the size of the bytes skipped, or %-1 on error.
+<return> the size of the bytes skipped, or `-1` on error.
</return>
</function>
@@ -37014,7 +37091,7 @@ memory cards. See the
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
specification for more on x-content types.
-This is an synchronous operation and as such may block doing IO;
+This is a synchronous operation and as such may block doing IO;
see g_mount_guess_content_type() for the asynchronous version.
Since: 2.18
@@ -37116,7 +37193,7 @@ Gets a choice from the mount operation.
</parameter>
</parameters>
<return> an integer containing an index of the user's choice from
-the choice's list, or %0.
+the choice's list, or `0`.
</return>
</function>
@@ -37795,7 +37872,7 @@ g_network_address_new() will often only return an IPv4 address when
resolving `localhost`, and an IPv6 address for `localhost6`.
g_network_address_get_hostname() will always return `localhost` for
-#GNetworkAddresses created with this constructor.
+a #GNetworkAddress created with this constructor.
Since: 2.44
@@ -40999,8 +41076,8 @@ Since: 2.26
<function name="g_proxy_get_default_for_protocol">
<description>
-Lookup "gio-proxy" extension point for a proxy implementation that supports
-specified protocol.
+Find the `gio-proxy` extension point for a proxy implementation that supports
+the specified protocol.
Since: 2.26
@@ -41685,11 +41762,11 @@ Since: 2.34
</parameter_description>
</parameter>
<parameter name="rrname">
-<parameter_description> the DNS name to lookup the record for
+<parameter_description> the DNS name to look up the record for
</parameter_description>
</parameter>
<parameter name="record_type">
-<parameter_description> the type of DNS record to lookup
+<parameter_description> the type of DNS record to look up
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -41725,11 +41802,11 @@ Since: 2.34
</parameter_description>
</parameter>
<parameter name="rrname">
-<parameter_description> the DNS name to lookup the record for
+<parameter_description> the DNS name to look up the record for
</parameter_description>
</parameter>
<parameter name="record_type">
-<parameter_description> the type of DNS record to lookup
+<parameter_description> the type of DNS record to look up
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -43220,7 +43297,7 @@ Gets the value that is stored in @settings for @key and converts it
to the flags value that it represents.
In order to use this function the type of the value must be an array
-of strings and it must be marked in the schema file as an flags type.
+of strings and it must be marked in the schema file as a flags type.
It is a programmer error to give a @key that isn't contained in the
schema for @settings or is not marked as a flags type.
@@ -43615,7 +43692,8 @@ with it.
</parameter_description>
</parameter>
</parameters>
-<return> a list of the children on @settings
+<return> a list of the children on
+@settings, in no defined order
</return>
</function>
@@ -43630,6 +43708,7 @@ function is intended for introspection reasons.
You should free the return value with g_strfreev() when you are done
with it.
+Deprecated: 2.46: Use g_settings_schema_list_keys instead().
</description>
<parameters>
@@ -43638,7 +43717,8 @@ with it.
</parameter_description>
</parameter>
</parameters>
-<return> a list of the keys on @settings
+<return> a list of the keys on
+@settings, in no defined order
</return>
</function>
@@ -43654,8 +43734,8 @@ Deprecated: 2.40: Use g_settings_schema_source_list_schemas() instead
<parameters>
</parameters>
<return> a list of relocatable
-#GSettings schemas that are available. The list must not be
-modified or freed.
+#GSettings schemas that are available, in no defined order. The list must
+not be modified or freed.
</return>
</function>
@@ -43675,8 +43755,8 @@ of your whole loop.
<parameters>
</parameters>
<return> a list of #GSettings
-schemas that are available. The list must not be modified or
-freed.
+schemas that are available, in no defined order. The list must not be
+modified or freed.
</return>
</function>
@@ -43880,7 +43960,7 @@ Deprecated:2.40:Use g_settings_schema_key_range_check() instead.
Resets @key to its default value.
This call resets the key, as much as possible, to its default value.
-That might the value specified in the schema or the one set by the
+That might be the value specified in the schema or the one set by the
administrator.
</description>
@@ -44252,7 +44332,8 @@ Since: 2.44
</parameter_description>
</parameter>
</parameters>
-<return> a list of the children on @settings
+<return> a list of the children on
+@settings, in no defined order
</return>
</function>
@@ -44275,7 +44356,7 @@ Since: 2.46
</parameter>
</parameters>
<return> a list of the keys on
-@schema
+@schema, in no defined order
</return>
</function>
@@ -44353,12 +44434,12 @@ Since: 2.40
</parameter>
<parameter name="non_relocatable">
<parameter_description> the
-list of non-relocatable schemas
+list of non-relocatable schemas, in no defined order
</parameter_description>
</parameter>
<parameter name="relocatable">
<parameter_description> the list
-of relocatable schemas
+of relocatable schemas, in no defined order
</parameter_description>
</parameter>
</parameters>
@@ -47146,7 +47227,7 @@ Sets the protocol of the socket client.
The sockets created by this object will use of the specified
protocol.
-If @protocol is %0 that means to use the default
+If @protocol is %G_SOCKET_PROTOCOL_DEFAULT that means to use the default
protocol for the socket family and type.
Since: 2.22
@@ -47542,7 +47623,7 @@ Since: 2.22
<function name="g_socket_connectable_proxy_enumerate">
<description>
Creates a #GSocketAddressEnumerator for @connectable that will
-return #GProxyAddresses for addresses that you must connect
+return a #GProxyAddress for each of its addresses that you must connect
to via a proxy.
If @connectable does not implement
@@ -48093,6 +48174,13 @@ If this operation isn't supported on the OS, the method fails with
the %G_IO_ERROR_NOT_SUPPORTED error. On Linux this is implemented
by reading the %SO_PEERCRED option on the underlying socket.
+This method can be expected to be available on the following platforms:
+
+- Linux since GLib 2.26
+- OpenBSD since GLib 2.30
+- Solaris, Illumos and OpenSolaris since GLib 2.40
+- NetBSD since GLib 2.42
+
Other ways to obtain credentials from a foreign peer includes the
#GUnixCredentialsMessage type and
g_unix_connection_send_credentials() /
@@ -49081,7 +49169,9 @@ Since: 2.22
<function name="g_socket_listener_set_backlog">
<description>
-Sets the listen backlog on the sockets in the listener.
+Sets the listen backlog on the sockets in the listener. This must be called
+before adding any sockets, addresses or ports to the #GSocketListener (for
+example, by calling g_socket_listener_add_inet_port()) to be effective.
See g_socket_set_listen_backlog() for details
@@ -49378,7 +49468,9 @@ elements in @messages, or %NULL
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a pointer to an int containing #GSocketMsgFlags flags
+<parameter_description> a pointer to an int containing #GSocketMsgFlags flags,
+which may additionally contain
+[other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -49464,7 +49556,9 @@ Since: 2.48
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags for the overall operation
+<parameter_description> an int containing #GSocketMsgFlags flags for the overall operation,
+which may additionally contain
+[other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -49646,7 +49740,8 @@ array of #GSocketControlMessages, or %NULL.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags
+<parameter_description> an int containing #GSocketMsgFlags flags, which may additionally
+contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -49704,7 +49799,8 @@ array of #GSocketControlMessages, or %NULL.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags
+<parameter_description> an int containing #GSocketMsgFlags flags, which may additionally
+contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)
</parameter_description>
</parameter>
<parameter name="timeout_us">
@@ -49785,7 +49881,8 @@ Since: 2.44
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags
+<parameter_description> an int containing #GSocketMsgFlags flags, which may additionally
+contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -50828,6 +50925,9 @@ Since: 2.40
<description>
On UNIX, returns the process ID as a decimal string.
On Windows, returns the result of GetProcessId() also as a string.
+If the subprocess has terminated, this will return %NULL.
+
+Since: 2.40
</description>
<parameters>
@@ -50836,7 +50936,9 @@ On Windows, returns the result of GetProcessId() also as a string.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the subprocess identifier, or %NULL if the subprocess
+has terminated
+</return>
</function>
<function name="g_subprocess_get_if_exited">
@@ -51040,7 +51142,7 @@ Since: 2.40
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GSubprocess
+<parameter_description> a #GSubprocessLauncher
</parameter_description>
</parameter>
<parameter name="variable">
@@ -51127,7 +51229,7 @@ Since: 2.40
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GSubprocess
+<parameter_description> a #GSubprocessLauncher
</parameter_description>
</parameter>
<parameter name="cwd">
@@ -51165,7 +51267,7 @@ Since: 2.40
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GSubprocess
+<parameter_description> a #GSubprocessLauncher
</parameter_description>
</parameter>
<parameter name="env">
@@ -51314,7 +51416,7 @@ Since: 2.40
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GSubprocess
+<parameter_description> a #GSubprocessLauncher
</parameter_description>
</parameter>
<parameter name="variable">
@@ -51542,7 +51644,7 @@ Since: 2.40
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GSubprocess
+<parameter_description> a #GSubprocessLauncher
</parameter_description>
</parameter>
<parameter name="variable">
@@ -52847,7 +52949,7 @@ called after g_test_dbus_up().
Stop the session bus started by g_test_dbus_up().
This will wait for the singleton returned by g_bus_get() or g_bus_get_sync()
-is destroyed. This is done to ensure that the next unit test won't get a
+to be destroyed. This is done to ensure that the next unit test won't get a
leaked singleton from this test.
</description>
@@ -54409,7 +54511,7 @@ handle.
<function name="g_tls_database_lookup_certificate_for_handle">
<description>
-Lookup a certificate by its handle.
+Look up a certificate by its handle.
The handle should have been created by calling
g_tls_database_create_certificate_handle() on a #GTlsDatabase object of
@@ -54459,7 +54561,7 @@ Since: 2.30
<function name="g_tls_database_lookup_certificate_for_handle_async">
<description>
-Asynchronously lookup a certificate by its handle in the database. See
+Asynchronously look up a certificate by its handle in the database. See
g_tls_database_lookup_certificate_for_handle() for more information.
Since: 2.30
@@ -54501,7 +54603,7 @@ Since: 2.30
<function name="g_tls_database_lookup_certificate_for_handle_finish">
<description>
Finish an asynchronous lookup of a certificate by its handle. See
-g_tls_database_lookup_certificate_by_handle() for more information.
+g_tls_database_lookup_certificate_for_handle() for more information.
If the handle is no longer valid, or does not point to a certificate in
this database, then %NULL will be returned.
@@ -54531,7 +54633,7 @@ Use g_object_unref() to release the certificate.
<function name="g_tls_database_lookup_certificate_issuer">
<description>
-Lookup the issuer of @certificate in the database.
+Look up the issuer of @certificate in the database.
The #GTlsCertificate:issuer property
of @certificate is not modified, and the two certificates are not hooked
@@ -54577,7 +54679,7 @@ or %NULL. Use g_object_unref() to release the certificate.
<function name="g_tls_database_lookup_certificate_issuer_async">
<description>
-Asynchronously lookup the issuer of @certificate in the database. See
+Asynchronously look up the issuer of @certificate in the database. See
g_tls_database_lookup_certificate_issuer() for more information.
Since: 2.30
@@ -54646,7 +54748,7 @@ or %NULL. Use g_object_unref() to release the certificate.
<function name="g_tls_database_lookup_certificates_issued_by">
<description>
-Lookup certificates issued by this issuer in the database.
+Look up certificates issued by this issuer in the database.
This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform
the lookup operation asynchronously.
@@ -54688,7 +54790,7 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele
<function name="g_tls_database_lookup_certificates_issued_by_async">
<description>
-Asynchronously lookup certificates issued by this issuer in the database. See
+Asynchronously look up certificates issued by this issuer in the database. See
g_tls_database_lookup_certificates_issued_by() for more information.
The database may choose to hold a reference to the issuer byte array for the duration
@@ -55282,7 +55384,7 @@ Since: 2.40
<function name="g_tls_interaction_request_certificate_finish">
<description>
-Complete an request certificate user interaction request. This should be once
+Complete a request certificate user interaction request. This should be once
the g_tls_interaction_request_certificate_async() completion callback is called.
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
@@ -55588,6 +55690,14 @@ As well as reading the credentials this also reads (and discards) a
single byte from the stream, as this is required for credentials
passing to work on some implementations.
+This method can be expected to be available on the following platforms:
+
+- Linux since GLib 2.26
+- FreeBSD since GLib 2.26
+- GNU/kFreeBSD since GLib 2.36
+- Solaris, Illumos and OpenSolaris since GLib 2.40
+- GNU/Hurd since GLib 2.40
+
Other ways to exchange credentials with a foreign peer includes the
#GUnixCredentialsMessage type and g_socket_get_credentials() function.
@@ -55719,6 +55829,14 @@ As well as sending the credentials this also writes a single NUL
byte to the stream, as this is required for credentials passing to
work on some implementations.
+This method can be expected to be available on the following platforms:
+
+- Linux since GLib 2.26
+- FreeBSD since GLib 2.26
+- GNU/kFreeBSD since GLib 2.36
+- Solaris, Illumos and OpenSolaris since GLib 2.40
+- GNU/Hurd since GLib 2.40
+
Other ways to exchange credentials with a foreign peer includes the
#GUnixCredentialsMessage type and g_socket_get_credentials() function.
@@ -56399,6 +56517,9 @@ Gets a #GUnixMountEntry for a given mount path. If @time_read
is set, it will be filled with a unix timestamp for checking
if the mounts have changed since with g_unix_mounts_changed_since().
+If more mounts have the same mount path, the last matching mount
+is returned.
+
</description>
<parameters>
@@ -56460,6 +56581,9 @@ Gets a #GUnixMountEntry for a given file path. If @time_read
is set, it will be filled with a unix timestamp for checking
if the mounts have changed since with g_unix_mounts_changed_since().
+If more mounts have the same mount path, the last matching mount
+is returned.
+
Since: 2.52
</description>
diff --git a/gio/src/gio_enums.defs b/gio/src/gio_enums.defs
index aca5af3c..a5fca4cd 100644
--- a/gio/src/gio_enums.defs
+++ b/gio/src/gio_enums.defs
@@ -1381,7 +1381,7 @@
;; G_TLS_REHANDSHAKE_NEVER,
;; G_TLS_REHANDSHAKE_SAFELY,
;; G_TLS_REHANDSHAKE_UNSAFELY
-;; } GTlsRehandshakeMode;
+;; } GTlsRehandshakeMode GLIB_DEPRECATED_TYPE_IN_2_60;
(define-enum-extended TlsRehandshakeMode
(in-module "G")
diff --git a/gio/src/gio_methods.defs b/gio/src/gio_methods.defs
index c8570555..2a1adfed 100644
--- a/gio/src/gio_methods.defs
+++ b/gio/src/gio_methods.defs
@@ -9681,6 +9681,12 @@
)
)
+(define-method get_modification_date_time
+ (of-object "GFileInfo")
+ (c-name "g_file_info_get_modification_date_time")
+ (return-type "GDateTime*")
+)
+
(define-method get_symlink_target
(of-object "GFileInfo")
(c-name "g_file_info_get_symlink_target")
@@ -9813,6 +9819,15 @@
)
)
+(define-method set_modification_date_time
+ (of-object "GFileInfo")
+ (c-name "g_file_info_set_modification_date_time")
+ (return-type "none")
+ (parameters
+ '("GDateTime*" "mtime")
+ )
+)
+
(define-method set_symlink_target
(of-object "GFileInfo")
(c-name "g_file_info_set_symlink_target")
@@ -11649,6 +11664,10 @@
+;; From gmarshal-internal.h
+
+
+
;; From gmemoryinputstream.h
(define-function g_memory_input_stream_get_type
@@ -13768,6 +13787,11 @@
(return-type "gboolean")
)
+(define-function glib_has_dconf_access_in_sandbox
+ (c-name "glib_has_dconf_access_in_sandbox")
+ (return-type "gboolean")
+)
+
;; From gpropertyaction.h
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 2358f9db..41daf11d 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -1275,7 +1275,7 @@ option: `--name arg` or combined in a single argument: `--name=arg`.
</parameter_description>
</parameter>
<parameter name="G_OPTION_ARG_STRING">
-<parameter_description> The option takes a string argument.
+<parameter_description> The option takes a UTF-8 string argument.
</parameter_description>
</parameter>
<parameter name="G_OPTION_ARG_INT">
@@ -1288,7 +1288,8 @@ option: `--name arg` or combined in a single argument: `--name=arg`.
</parameter_description>
</parameter>
<parameter name="G_OPTION_ARG_FILENAME">
-<parameter_description> The option takes a filename as argument.
+<parameter_description> The option takes a filename as argument, which will
+ be in the GLib filename encoding rather than UTF-8.
</parameter_description>
</parameter>
<parameter name="G_OPTION_ARG_STRING_ARRAY">
@@ -2167,7 +2168,7 @@ Error codes returned by spawning processes.
</parameter_description>
</parameter>
<parameter name="G_SPAWN_ERROR_2BIG">
-<parameter_description> deprecated alias for %G_SPAWN_ERROR_TOO_BIG
+<parameter_description> deprecated alias for %G_SPAWN_ERROR_TOO_BIG (deprecated since GLib 2.32)
</parameter_description>
</parameter>
<parameter name="G_SPAWN_ERROR_NOEXEC">
@@ -2363,7 +2364,7 @@ later tests with g_test_trap_assert_stderr().
Test traps are guards around forked tests.
These flags determine what traps to set.
-Deprecated: #GTestTrapFlags is used only with g_test_trap_fork(),
+Deprecated: 2.38: #GTestTrapFlags is used only with g_test_trap_fork(),
which is deprecated. g_test_trap_subprocess() uses
#GTestSubprocessFlags.
@@ -3536,6 +3537,22 @@ Old South Arabian. Since 2.26
<parameter_description> Sogdian. Since: 2.58
</parameter_description>
</parameter>
+<parameter name="G_UNICODE_SCRIPT_ELYMAIC">
+<parameter_description> Elym. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_NANDINAGARI">
+<parameter_description> Nand. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG">
+<parameter_description> Rohg. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_WANCHO">
+<parameter_description> Wcho. Since: 2.62
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -4055,6 +4072,81 @@ Adds @len elements onto the end of the array.
</return>
</function>
+<function name="g_array_binary_search">
+<description>
+Checks whether @target exists in @array by performing a binary
+search based on the given comparison function @compare_func which
+get pointers to items as arguments. If the element is found, %TRUE
+is returned and the element’s index is returned in @out_match_index
+(if non-%NULL). Otherwise, %FALSE is returned and @out_match_index
+is undefined. If @target exists multiple times in @array, the index
+of the first instance is returned. This search is using a binary
+search, so the @array must absolutely be sorted to return a correct
+result (if not, the function may produce false-negative).
+
+This example defines a comparison function and search an element in a #GArray:
+|[<!-- language="C" -->
+static gint*
+cmpint (gconstpointer a, gconstpointer b)
+{
+const gint *_a = a;
+const gint *_b = b;
+
+return *_a - *_b;
+}
+...
+gint i = 424242;
+guint matched_index;
+gboolean result = g_array_binary_search (garray, &i, cmpint, &matched_index);
+...
+]|
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #GArray.
+</parameter_description>
+</parameter>
+<parameter name="target">
+<parameter_description> a pointer to the item to look up.
+</parameter_description>
+</parameter>
+<parameter name="compare_func">
+<parameter_description> A #GCompareFunc used to locate @target.
+</parameter_description>
+</parameter>
+<parameter name="out_match_index">
+<parameter_description> return location
+for the index of the element, if found.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @target is one of the elements of @array, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_array_copy">
+<description>
+Create a shallow copy of a #GArray. If the array elements consist of
+pointers to data, the pointers are copied but the actual data is not.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> A #GArray.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A copy of @array.
+
+</return>
+</function>
+
<function name="g_array_free">
<description>
Frees the memory allocated for the #GArray. If @free_segment is
@@ -5342,7 +5434,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="n1">
-<parameter_description> an floating point number
+<parameter_description> a floating point number
</parameter_description>
</parameter>
<parameter name="cmp">
@@ -5372,7 +5464,7 @@ Since: 2.58
</description>
<parameters>
<parameter name="n1">
-<parameter_description> an floating point number
+<parameter_description> a floating point number
</parameter_description>
</parameter>
<parameter name="n2">
@@ -5640,6 +5732,29 @@ Since: 2.38
<return></return>
</function>
+<function name="g_assert_finalize_object">
+<description>
+Assert that @object is non-%NULL, then release one reference to it with
+g_object_unref() and assert that it has been finalized (i.e. that there
+are no more references).
+
+If assertions are disabled via `G_DISABLE_ASSERT`,
+this macro just calls g_object_unref() without any further checks.
+
+This macro should only be used in regression tests.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> an object
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_assert_no_error">
<description>
Debugging macro to check that a #GError is not set.
@@ -6254,7 +6369,7 @@ Pops data from the @queue. If the queue is empty, blocks until
If no data is received before @end_time, %NULL is returned.
-To easily calculate @end_time, a combination of g_get_current_time()
+To easily calculate @end_time, a combination of g_get_real_time()
and g_time_val_add() can be used.
Deprecated: use g_async_queue_timeout_pop().
@@ -6283,7 +6398,7 @@ Pops data from the @queue. If the queue is empty, blocks until
If no data is received before @end_time, %NULL is returned.
-To easily calculate @end_time, a combination of g_get_current_time()
+To easily calculate @end_time, a combination of g_get_real_time()
and g_time_val_add() can be used.
This function must be called while holding the @queue's lock.
@@ -7019,7 +7134,7 @@ Since: 2.58
<function name="g_atomic_rc_box_dup">
<description>
-Allocates a new block of data with atomit reference counting
+Allocates a new block of data with atomic reference counting
semantics, and copies @block_size bytes of @mem_block
into it.
@@ -7231,6 +7346,8 @@ Helper to declare a variable with automatic cleanup.
The variable is cleaned up in a way appropriate to its type when the
variable goes out of scope. The type must support this.
+The way to clean up the type must have been defined using one of the macros
+G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC() or G_DEFINE_AUTO_CLEANUP_FREE_FUNC().
This feature is only supported on GCC and clang. This macro is not
defined on other compilers and should not be used in programs that
@@ -7243,7 +7360,7 @@ g_autoptr().
This macro can be used to avoid having to do explicit cleanups of
local variables when exiting functions. It often vastly simplifies
handling of error conditions, removing the need for various tricks
-such as 'goto out' or repeating of cleanup code. It is also helpful
+such as `goto out` or repeating of cleanup code. It is also helpful
for non-error cases.
Consider the following example:
@@ -7270,8 +7387,8 @@ return g_variant_builder_end (&builder);
}
]|
-You must initialize the variable in some way -- either by use of an
-initialiser or by ensuring that an _init function will be called on
+You must initialize the variable in some way — either by use of an
+initialiser or by ensuring that an `_init` function will be called on
it unconditionally before it goes out of scope.
Since: 2.44
@@ -7298,7 +7415,7 @@ of using a type-specific lookup, this macro always calls g_free() directly.
This means it's useful for any type that is returned from
g_malloc().
-Otherwise, this macro has similar constraints as g_autoptr() - only
+Otherwise, this macro has similar constraints as g_autoptr(): only
supported on GCC and clang, the variable must be initialized, etc.
|[
@@ -7336,13 +7453,13 @@ defined on other compilers and should not be used in programs that
are intended to be portable to those compilers.
This is meant to be used to declare lists of a type with a cleanup
-function. The type of the variable is a GList *. You
-must not add your own '*'.
+function. The type of the variable is a `GList *`. You
+must not add your own `*`.
This macro can be used to avoid having to do explicit cleanups of
local variables when exiting functions. It often vastly simplifies
handling of error conditions, removing the need for various tricks
-such as 'goto out' or repeating of cleanup code. It is also helpful
+such as `goto out` or repeating of cleanup code. It is also helpful
for non-error cases.
See also g_autoslist(), g_autoptr() and g_steal_pointer().
@@ -7365,6 +7482,8 @@ Helper to declare a pointer variable with automatic cleanup.
The variable is cleaned up in a way appropriate to its type when the
variable goes out of scope. The type must support this.
+The way to clean up the type must have been defined using the macro
+G_DEFINE_AUTOPTR_CLEANUP_FUNC().
This feature is only supported on GCC and clang. This macro is not
defined on other compilers and should not be used in programs that
@@ -7372,12 +7491,12 @@ are intended to be portable to those compilers.
This is meant to be used to declare pointers to types with cleanup
functions. The type of the variable is a pointer to @TypeName. You
-must not add your own '*'.
+must not add your own `*`.
This macro can be used to avoid having to do explicit cleanups of
local variables when exiting functions. It often vastly simplifies
handling of error conditions, removing the need for various tricks
-such as 'goto out' or repeating of cleanup code. It is also helpful
+such as `goto out` or repeating of cleanup code. It is also helpful
for non-error cases.
Consider the following example:
@@ -7407,7 +7526,7 @@ return g_access (path, R_OK) == 0;
}
]|
-You must initialise the variable in some way -- either by use of an
+You must initialise the variable in some way — either by use of an
initialiser or by ensuring that it is assigned to unconditionally
before it goes out of scope.
@@ -7425,6 +7544,41 @@ Since: 2.44
<return></return>
</function>
+<function name="g_autoqueue">
+<description>
+Helper to declare a double-ended queue variable with automatic deep cleanup.
+
+The queue is deeply freed, in a way appropriate to the specified type, when the
+variable goes out of scope. The type must support this.
+
+This feature is only supported on GCC and clang. This macro is not
+defined on other compilers and should not be used in programs that
+are intended to be portable to those compilers.
+
+This is meant to be used to declare queues of a type with a cleanup
+function. The type of the variable is a `GQueue *`. You
+must not add your own `*`.
+
+This macro can be used to avoid having to do explicit cleanups of
+local variables when exiting functions. It often vastly simplifies
+handling of error conditions, removing the need for various tricks
+such as `goto out` or repeating of cleanup code. It is also helpful
+for non-error cases.
+
+See also g_autolist(), g_autoptr() and g_steal_pointer().
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="TypeName">
+<parameter_description> a supported variable type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_autoslist">
<description>
Helper to declare a singly linked list variable with automatic deep cleanup.
@@ -7437,13 +7591,13 @@ defined on other compilers and should not be used in programs that
are intended to be portable to those compilers.
This is meant to be used to declare lists of a type with a cleanup
-function. The type of the variable is a GSList *. You
-must not add your own '*'.
+function. The type of the variable is a `GSList *`. You
+must not add your own `*`.
This macro can be used to avoid having to do explicit cleanups of
local variables when exiting functions. It often vastly simplifies
handling of error conditions, removing the need for various tricks
-such as 'goto out' or repeating of cleanup code. It is also helpful
+such as `goto out` or repeating of cleanup code. It is also helpful
for non-error cases.
See also g_autolist(), g_autoptr() and g_steal_pointer().
@@ -12465,7 +12619,7 @@ After the call it contains the length of the digest.
<function name="g_checksum_get_string">
<description>
-Gets the digest as an hexadecimal string.
+Gets the digest as a hexadecimal string.
Once this function has been called the #GChecksum can no longer be
updated with g_checksum_update().
@@ -12871,6 +13025,33 @@ pointer
<return></return>
</function>
+<function name="g_clear_signal_handler">
+<description>
+Disconnects a handler from @instance so it will not be called during
+any future or currently ongoing emissions of the signal it has been
+connected to. The @handler_id_ptr is then set to zero, which is never a valid handler ID value (see
g_signal_connect()).
+
+If the handler ID is 0 then this function does nothing.
+
+A macro is also included that allows this function to be used without
+pointer casts.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="handler_id_ptr">
+<parameter_description> A pointer to a handler ID (of type #gulong) of the handler to be disconnected.
+</parameter_description>
+</parameter>
+<parameter name="instance">
+<parameter_description> The instance to remove the signal handler from.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_clear_weak_pointer">
<description>
Clears a weak reference to a #GObject.
@@ -13859,7 +14040,7 @@ If @abs_time is %NULL, g_cond_timed_wait() acts like g_cond_wait().
This function can be used even if g_thread_init() has not yet been
called, and, in that case, will immediately return %TRUE.
-To easily calculate @abs_time a combination of g_get_current_time()
+To easily calculate @abs_time a combination of g_get_real_time()
and g_time_val_add() can be used.
Deprecated:2.32: Use g_cond_wait_until() instead.
@@ -15740,6 +15921,8 @@ additional precision.
The time to date conversion is done using the user's current timezone.
Since: 2.10
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use g_date_set_time_t()
+instead.
</description>
<parameters>
@@ -16313,6 +16496,27 @@ should be freed with g_free().
</return>
</function>
+<function name="g_date_time_format_iso8601">
+<description>
+Format @datetime in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601),
+including the date, time and time zone, and return that as a UTF-8 encoded
+string.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="datetime">
+<parameter_description> A #GDateTime
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string formatted in ISO 8601 format
+or %NULL in the case that there was an error. The string
+should be freed with g_free().
+</return>
+</function>
+
<function name="g_date_time_get_day_of_month">
<description>
Retrieves the day of the month represented by @datetime in the gregorian
@@ -16853,6 +17057,8 @@ You should release the return value by calling g_date_time_unref()
when you are done with it.
Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_unix_local() instead.
</description>
<parameters>
@@ -16880,6 +17086,8 @@ You should release the return value by calling g_date_time_unref()
when you are done with it.
Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_unix_utc() instead.
</description>
<parameters>
@@ -17151,6 +17359,8 @@ out of range.
On systems where 'long' is 64bit, this function never fails.
Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_to_unix() instead.
</description>
<parameters>
@@ -19245,6 +19455,41 @@ of the character set. This string must be freed with g_free().
</return>
</function>
+<function name="g_get_console_charset">
+<description>
+Obtains the character set used by the console attached to the process,
+which is suitable for printing output to the terminal.
+
+Usually this matches the result returned by g_get_charset(), but in
+environments where the locale's character set does not match the encoding
+of the console this function tries to guess a more suitable value instead.
+
+On Windows the character set returned by this function is the
+output code page used by the console associated with the calling process.
+If the codepage can't be determined (for example because there is no
+console attached) UTF-8 is assumed.
+
+The return value is %TRUE if the locale's encoding is UTF-8, in that
+case you can perhaps avoid calling g_convert().
+
+The string returned in @charset is not allocated, and should not be
+freed.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="charset">
+<parameter_description> return location for character set
+name, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the returned charset is UTF-8
+
+</return>
+</function>
+
<function name="g_get_current_dir">
<description>
Gets the current directory.
@@ -19272,6 +19517,9 @@ Equivalent to the UNIX gettimeofday() function, but portable.
You may find g_get_real_time() to be more convenient.
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use g_get_real_time()
+instead.
+
</description>
<parameters>
<parameter name="result">
@@ -19544,7 +19792,8 @@ taking the last component of @argv[0].
</description>
<parameters>
</parameters>
-<return> the name of the program. The returned string belongs
+<return> the name of the program, or %NULL if it has not been
+set yet. The returned string belongs
to GLib and must not be modified or freed.
</return>
</function>
@@ -20779,7 +21028,7 @@ size of @buffer. After the call it contains the length of the digest
<function name="g_hmac_get_string">
<description>
-Gets the HMAC as an hexadecimal string.
+Gets the HMAC as a hexadecimal string.
Once this function has been called the #GHmac can no longer be
updated with g_hmac_update().
@@ -21927,6 +22176,10 @@ can be compared for equality by comparing the pointers, instead of
using strcmp(). g_intern_static_string() does not copy the string,
therefore @string must not be freed or modified.
+This function must not be used before library constructors have finished
+running. In particular, this means it cannot be used to initialize global
+variables in C++.
+
Since: 2.10
</description>
@@ -21947,6 +22200,10 @@ Returns a canonical representation for @string. Interned strings
can be compared for equality by comparing the pointers, instead of
using strcmp().
+This function must not be used before library constructors have finished
+running. In particular, this means it cannot be used to initialize global
+variables in C++.
+
Since: 2.10
</description>
@@ -24263,7 +24520,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> an double value
+<parameter_description> a double value
</parameter_description>
</parameter>
</parameters>
@@ -25073,6 +25330,34 @@ is inserted or %NULL to insert at the end of the list
</return>
</function>
+<function name="g_list_insert_before_link">
+<description>
+Inserts @link_ into the list before the given position.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a pointer to a #GList, this must point to the top of the list
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> the list element before which the new element
+is inserted or %NULL to insert at the end of the list
+</parameter_description>
+</parameter>
+<parameter name="link_">
+<parameter_description> the list element to be added, which must not be part of
+any other list
+</parameter_description>
+</parameter>
+</parameters>
+<return> the (possibly changed) start of the #GList
+
+</return>
+</function>
+
<function name="g_list_insert_sorted">
<description>
Inserts a new element into the list, using the given comparison
@@ -26565,7 +26850,7 @@ the first one found will be returned.
<description>
Finds a #GSource given a pair of context and ID.
-It is a programmer error to attempt to lookup a non-existent source.
+It is a programmer error to attempt to look up a non-existent source.
More specifically: source IDs can be reissued after a source has been
destroyed and therefore it is never valid to use this function with a
@@ -30872,7 +31157,7 @@ A convenience function to connect multiple signals at once.
The signal specs expected by this function have the form
"modifier::signal_name", where modifier can be one of the following:
-* - signal: equivalent to g_signal_connect_data (..., NULL, 0)
+- signal: equivalent to g_signal_connect_data (..., NULL, 0)
- object-signal, object_signal: equivalent to g_signal_connect_object (..., 0)
- swapped-signal, swapped_signal: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)
- swapped_object_signal, swapped-object-signal: equivalent to g_signal_connect_object (...,
G_CONNECT_SWAPPED)
@@ -31145,9 +31430,16 @@ or %NULL if no such data exists.
<function name="g_object_get_property">
<description>
-Gets a property of an object. @value must have been initialized to the
-expected type of the property (or a type to which the expected type can be
-transformed) using g_value_init().
+Gets a property of an object.
+
+The @value can be:
+
+- an empty #GValue initialized by %G_VALUE_INIT, which will be
+automatically initialized with the expected type of the property
+(since GLib 2.60)
+- a #GValue initialized with the expected type of the property
+- a #GValue initialized with a type to which the expected type
+of the property can be transformed
In general, a copy is made of the property contents and the caller is
responsible for freeing the memory by calling g_value_unset().
@@ -31273,7 +31565,7 @@ interface, or the default vtable for the interface
</parameter_description>
</parameter>
<parameter name="property_name">
-<parameter_description> name of a property to lookup.
+<parameter_description> name of a property to look up.
</parameter_description>
</parameter>
</parameters>
@@ -31689,6 +31981,9 @@ It’s up to the caller to free this as needed, which may
or may not include using @old_destroy as sometimes replacement
should not destroy the object in the normal way.
+See g_object_set_data() for guidance on using a small, bounded set of values
+for @key.
+
Since: 2.34
</description>
@@ -31827,6 +32122,11 @@ strings to pointers. This function lets you set an association.
If the object already had an association with that name,
the old association will be destroyed.
+Internally, the @key is converted to a #GQuark using g_quark_from_string().
+This means a copy of @key is kept permanently (even after @object has been
+finalized) — so it is recommended to only use a small, bounded set of values
+for @key in your program, to avoid the #GQuark storage growing unbounded.
+
</description>
<parameters>
<parameter name="object">
@@ -32253,6 +32553,10 @@ If "[P]roceed" is selected, the function returns.
This function may cause different actions on non-UNIX platforms.
+On Windows consider using the `G_DEBUGGER` environment
+variable (see [Running GLib Applications](glib-running.html)) and
+calling g_on_error_stack_trace() instead.
+
</description>
<parameters>
<parameter name="prg_name">
@@ -32276,6 +32580,12 @@ gdk_init().
This function may cause different actions on non-UNIX platforms.
+When running on Windows, this function is *not* called by
+g_on_error_query(). If called directly, it will raise an
+exception, which will crash the program. If the `G_DEBUGGER` environment
+variable is set, a debugger will be invoked to attach and
+handle that exception (see [Running GLib Applications](glib-running.html)).
+
</description>
<parameters>
<parameter name="prg_name">
@@ -32781,8 +33091,10 @@ Since: 2.40
</parameter_description>
</parameter>
<parameter name="arguments">
-<parameter_description> a pointer to the
-command line arguments (which must be in UTF-8 on Windows)
+<parameter_description> a pointer
+to the command line arguments (which must be in UTF-8 on Windows).
+Starting with GLib 2.62, @arguments can be %NULL, which matches
+g_option_context_parse().
</parameter_description>
</parameter>
<parameter name="error">
@@ -35457,6 +35769,110 @@ in size automatically if necessary.
<return></return>
</function>
+<function name="g_ptr_array_copy">
+<description>
+Makes a full (deep) copy of a #GPtrArray.
+
+@func, as a #GCopyFunc, takes two arguments, the data to be copied
+and a @user_data pointer. On common processor architectures, it's safe to
+pass %NULL as @user_data if the copy function takes only one argument. You
+may get compiler warnings from this though if compiling with GCC’s
+`-Wcast-function-type` warning.
+
+If @func is %NULL, then only the pointers (and not what they are
+pointing to) are copied to the new #GPtrArray.
+
+The copy of @array will have the same #GDestroyNotify for its elements as
+@array.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> #GPtrArray to duplicate
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a copy function used to copy every element in the array
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to the copy function @func, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a deep copy of the initial #GPtrArray.
+
+</return>
+</function>
+
+<function name="g_ptr_array_extend">
+<description>
+Adds all pointers of @array to the end of the array @array_to_extend.
+The array will grow in size automatically if needed. @array_to_extend is
+modified in-place.
+
+@func, as a #GCopyFunc, takes two arguments, the data to be copied
+and a @user_data pointer. On common processor architectures, it's safe to
+pass %NULL as @user_data if the copy function takes only one argument. You
+may get compiler warnings from this though if compiling with GCC’s
+`-Wcast-function-type` warning.
+
+If @func is %NULL, then only the pointers (and not what they are
+pointing to) are copied to the new #GPtrArray.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="array_to_extend">
+<parameter_description> a #GPtrArray.
+</parameter_description>
+</parameter>
+<parameter name="array">
+<parameter_description> a #GPtrArray to add to the end of @array_to_extend.
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a copy function used to copy every element in the array
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to the copy function @func, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_ptr_array_extend_and_steal">
+<description>
+Adds all the pointers in @array to the end of @array_to_extend, transferring
+ownership of each element from @array to @array_to_extend and modifying
+@array_to_extend in-place. @array is then freed.
+
+As with g_ptr_array_free(), @array will be destroyed if its reference count
+is 1. If its reference count is higher, it will be decremented and the
+length of @array set to zero.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="array_to_extend">
+<parameter_description> a #GPtrArray.
+</parameter_description>
+</parameter>
+<parameter name="array">
+<parameter_description> a #GPtrArray to add to the end of
+@array_to_extend.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_ptr_array_find">
<description>
Checks whether @needle exists in @haystack. If the element is found, %TRUE is
@@ -36087,6 +36503,10 @@ statically allocated memory in dynamically loaded modules, if you
expect to ever unload the module again (e.g. do not use this
function in GTK+ theme engines).
+This function must not be used before library constructors have finished
+running. In particular, this means it cannot be used to initialize global
+variables in C++.
+
</description>
<parameters>
@@ -36105,6 +36525,10 @@ Gets the #GQuark identifying the given string. If the string does
not currently have an associated #GQuark, a new #GQuark is created,
using a copy of the string.
+This function must not be used before library constructors have finished
+running. In particular, this means it cannot be used to initialize global
+variables in C++.
+
</description>
<parameters>
@@ -36141,6 +36565,9 @@ Gets the #GQuark associated with the given string, or 0 if string is
If you want the GQuark to be created if it doesn't already exist,
use g_quark_from_string() or g_quark_from_static_string().
+This function must not be used before library constructors have finished
+running.
+
</description>
<parameters>
@@ -36446,6 +36873,33 @@ push at the head of the queue.
<return></return>
</function>
+<function name="g_queue_insert_after_link">
+<description>
+Inserts @link_ into @queue after @sibling.
+
+@sibling must be part of @queue.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a #GQueue
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> a #GList link that must be part of @queue, or %NULL to
+push at the head of the queue.
+</parameter_description>
+</parameter>
+<parameter name="link_">
+<parameter_description> a #GList link to insert which must not be part of any other list.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_queue_insert_before">
<description>
Inserts @data into @queue before @sibling.
@@ -36474,6 +36928,33 @@ push at the tail of the queue.
<return></return>
</function>
+<function name="g_queue_insert_before_link">
+<description>
+Inserts @link_ into @queue before @sibling.
+
+@sibling must be part of @queue.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a #GQueue
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> a #GList link that must be part of @queue, or %NULL to
+push at the tail of the queue.
+</parameter_description>
+</parameter>
+<parameter name="link_">
+<parameter_description> a #GList link to insert which must not be part of any other list.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_queue_insert_sorted">
<description>
Inserts @data into @queue using @func to determine the new position.
@@ -37022,7 +37503,7 @@ Since: 2.4
<function name="g_rand_boolean">
<description>
Returns a random #gboolean from @rand_.
-This corresponds to a unbiased coin toss.
+This corresponds to an unbiased coin toss.
</description>
@@ -37258,7 +37739,7 @@ Since: 2.4
<function name="g_random_boolean">
<description>
Returns a random #gboolean.
-This corresponds to a unbiased coin toss.
+This corresponds to an unbiased coin toss.
</description>
@@ -38829,7 +39310,7 @@ token.
As a special case, the result of splitting the empty string "" is an
empty vector, not a vector containing a single string. The reason for
-this special case is that being able to represent a empty vector is
+this special case is that being able to represent an empty vector is
typically more useful than consistent handling of empty elements. If
you do need to represent empty elements, you'll need to check for the
empty string before calling this function.
@@ -38872,7 +39353,7 @@ token.
As a special case, the result of splitting the empty string "" is an
empty vector, not a vector containing a single string. The reason for
-this special case is that being able to represent a empty vector is
+this special case is that being able to represent an empty vector is
typically more useful than consistent handling of empty elements. If
you do need to represent empty elements, you'll need to check for the
empty string before calling this function.
@@ -38946,7 +39427,7 @@ g_regex_new() and then use g_regex_split().
As a special case, the result of splitting the empty string ""
is an empty vector, not a vector containing a single string.
The reason for this special case is that being able to represent
-a empty vector is typically more useful than consistent handling
+an empty vector is typically more useful than consistent handling
of empty elements. If you do need to represent empty elements,
you'll need to check for the empty string before calling this
function.
@@ -39535,8 +40016,10 @@ Since: 2.32
<function name="g_rw_lock_reader_lock">
<description>
Obtain a read lock on @rw_lock. If another thread currently holds
-the write lock on @rw_lock or blocks waiting for it, the current
-thread will block. Read locks can be taken recursively.
+the write lock on @rw_lock, the current thread will block. If another thread
+does not hold the write lock, but is waiting for it, it is implementation
+defined whether the reader or writer will block. Read locks can be taken
+recursively.
It is implementation-defined how many threads are allowed to
hold read locks on the same lock simultaneously. If the limit is hit,
@@ -39554,6 +40037,46 @@ Since: 2.32
<return></return>
</function>
+<function name="g_rw_lock_reader_locker_free">
+<description>
+Release a read lock on @locker's read-write lock. See
+g_rw_lock_reader_locker_new() for details.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="locker">
+<parameter_description> a GRWLockReaderLocker
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_reader_locker_new">
+<description>
+Obtain a read lock on @rw_lock and return a new #GRWLockReaderLocker.
+Unlock with g_rw_lock_reader_locker_free(). Using g_rw_lock_reader_unlock()
+on @rw_lock while a #GRWLockReaderLocker exists can lead to undefined
+behaviour.
+
+This is intended to be used with g_autoptr(). For a code sample, see
+g_rw_lock_writer_locker_new().
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GRWLockReaderLocker
+</return>
+</function>
+
<function name="g_rw_lock_reader_trylock">
<description>
Tries to obtain a read lock on @rw_lock and returns %TRUE if
@@ -39611,6 +40134,102 @@ Since: 2.32
<return></return>
</function>
+<function name="g_rw_lock_writer_locker_free">
+<description>
+Release a write lock on @locker's read-write lock. See
+g_rw_lock_writer_locker_new() for details.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="locker">
+<parameter_description> a GRWLockWriterLocker
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_writer_locker_new">
+<description>
+Obtain a write lock on @rw_lock and return a new #GRWLockWriterLocker.
+Unlock with g_rw_lock_writer_locker_free(). Using g_rw_lock_writer_unlock()
+on @rw_lock while a #GRWLockWriterLocker exists can lead to undefined
+behaviour.
+
+This is intended to be used with g_autoptr(). Note that g_autoptr()
+is only available when using GCC or clang, so the following example
+will only work with those compilers:
+|[
+typedef struct
+{
+...
+GRWLock rw_lock;
+GPtrArray *array;
+...
+} MyObject;
+
+static gchar *
+my_object_get_data (MyObject *self, guint index)
+{
+g_autoptr(GRWLockReaderLocker) locker = g_rw_lock_reader_locker_new (&self->rw_lock);
+
+// Code with a read lock obtained on rw_lock here
+
+if (self->array == NULL)
+// No need to unlock
+return NULL;
+
+if (index < self->array->len)
+// No need to unlock
+return g_ptr_array_index (self->array, index);
+
+// Optionally early unlock
+g_clear_pointer (&locker, g_rw_lock_reader_locker_free);
+
+// Code with rw_lock unlocked here
+return NULL;
+}
+
+static void
+my_object_set_data (MyObject *self, guint index, gpointer data)
+{
+g_autoptr(GRWLockWriterLocker) locker = g_rw_lock_writer_locker_new (&self->rw_lock);
+
+// Code with a write lock obtained on rw_lock here
+
+if (self->array == NULL)
+self->array = g_ptr_array_new ();
+
+if (cond)
+// No need to unlock
+return;
+
+if (index >= self->array->len)
+g_ptr_array_set_size (self->array, index+1);
+g_ptr_array_index (self->array, index) = data;
+
+// Optionally early unlock
+g_clear_pointer (&locker, g_rw_lock_writer_locker_free);
+
+// Code with rw_lock unlocked here
+}
+]|
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GRWLockWriterLocker
+</return>
+</function>
+
<function name="g_rw_lock_writer_trylock">
<description>
Tries to obtain a write lock on @rw_lock. If any other thread holds
@@ -40725,7 +41344,7 @@ Since: 2.28
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> data to lookup
+<parameter_description> data to look up
</parameter_description>
</parameter>
<parameter name="cmp_func">
@@ -40766,7 +41385,7 @@ Since: 2.28
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> data to lookup
+<parameter_description> data to look up
</parameter_description>
</parameter>
<parameter name="iter_cmp">
@@ -42676,8 +43295,14 @@ If 0 is used for @class_offset subclasses cannot override the class handler
in their class_init method by doing super_class->signal_handler = my_signal_handler.
Instead they will have to use g_signal_override_class_handler().
-If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as
-the marshaller for this signal.
+If @c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as
+the marshaller for this signal. In some simple cases, g_signal_new()
+will use a more optimized c_marshaller and va_marshaller for the signal
+instead of g_cclosure_marshal_generic().
+
+If @c_marshaller is non-%NULL, you need to also specify a va_marshaller
+using g_signal_set_va_marshaller() or the generic va_marshaller will
+be used.
</description>
@@ -44445,6 +45070,9 @@ destroyed. The source cannot be subsequently added to another
context. It is safe to call this on sources which have already been
removed from their context.
+This does not unref the #GSource: if you still hold a reference, use
+g_source_unref() to drop it.
+
</description>
<parameters>
<parameter name="source">
@@ -46818,10 +47446,17 @@ For each character in @string, if the character is not in @valid_chars,
replaces the character with @substitutor. Modifies @string in place,
and return @string itself, not a copy. The return value is to allow
nesting such as
-|[<!-- language="C" -->
+|[<!-- language="C" -->
g_ascii_strup (g_strcanon (str, "abc", '?'))
]|
+In order to modify a copy, you may use `g_strdup()`:
+|[<!-- language="C" -->
+reformatted = g_strcanon (g_strdup (const_str), "abc", '?');
+...
+g_free (reformatted);
+]|
+
</description>
<parameters>
@@ -46994,10 +47629,17 @@ Any characters in @string which are found in @delimiters are
changed to the @new_delimiter character. Modifies @string in place,
and returns @string itself, not a copy. The return value is to
allow nesting such as
-|[<!-- language="C" -->
+|[<!-- language="C" -->
g_ascii_strup (g_strdelimit (str, "abc", '?'))
]|
+In order to modify a copy, you may use `g_strdup()`:
+|[<!-- language="C" -->
+reformatted = g_strdelimit (g_strdup (const_str), "abc", '?');
+...
+g_free (reformatted);
+]|
+
</description>
<parameters>
@@ -48592,7 +49234,7 @@ and "".
As a special case, the result of splitting the empty string "" is an empty
vector, not a vector containing a single string. The reason for this
-special case is that being able to represent a empty vector is typically
+special case is that being able to represent an empty vector is typically
more useful than consistent handling of empty elements. If you do need
to represent empty elements, you'll need to check for the empty string
before calling g_strsplit().
@@ -48637,7 +49279,7 @@ vector containing the four strings "", "def", "ghi"
As a special case, the result of splitting the empty string "" is an empty
vector, not a vector containing a single string. The reason for this
-special case is that being able to represent a empty vector is typically
+special case is that being able to represent an empty vector is typically
more useful than consistent handling of empty elements. If you do need
to represent empty elements, you'll need to check for the empty string
before calling g_strsplit_set().
@@ -48997,9 +49639,12 @@ Since: 2.34
This function adds a message to test reports that
associates a bug URI with a test case.
Bug URIs are constructed from a base URI set with g_test_bug_base()
-and @bug_uri_snippet.
+and @bug_uri_snippet. If g_test_bug_base() has not been called, it is
+assumed to be the empty string, so a full URI can be provided to
+g_test_bug() instead.
Since: 2.16
+See also: g_test_summary()
</description>
<parameters>
@@ -49025,6 +49670,9 @@ Bug URIs are constructed by appending a bug specific URI
portion to @uri_pattern, or by replacing the special string
'\%s' within @uri_pattern if that is present.
+If g_test_bug_base() is not called, bug URIs are formed solely
+from the value provided by g_test_bug().
+
Since: 2.16
</description>
@@ -50004,6 +50652,41 @@ Since: 2.16
<return></return>
</function>
+<function name="g_test_summary">
+<description>
+Set the summary for a test, which describes what the test checks, and how it
+goes about checking it. This may be included in test report output, and is
+useful documentation for anyone reading the source code or modifying a test
+in future. It must be a single line.
+
+This should be called at the top of a test function.
+
+For example:
+|[<!-- language="C" -->
+static void
+test_array_sort (void)
+{
+g_test_summary ("Test my_array_sort() sorts the array correctly and stably, "
+"including testing zero length and one-element arrays.");
+
+…
+}
+]|
+
+Since: 2.62
+See also: g_test_bug()
+
+</description>
+<parameters>
+<parameter name="summary">
+<parameter_description> One or two sentences summarising what the test checks, and how it
+checks it.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_test_thorough">
<description>
Returns %TRUE if tests are run in thorough mode, equivalent to
@@ -51167,6 +51850,9 @@ This function is often used as a method to make busy wait less evil.
Adds the given number of microseconds to @time_. @microseconds can
also be negative to decrease the value of @time_.
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use `guint64` for
+representing microseconds since the epoch, or use #GDateTime.
+
</description>
<parameters>
<parameter name="time_">
@@ -51193,7 +51879,17 @@ timestamp is assumed to be in local time.)
Any leading or trailing space in @iso_date is ignored.
+This function was deprecated, along with #GTimeVal itself, in GLib 2.62.
+Equivalent functionality is available using code like:
+|[
+GDateTime *dt = g_date_time_new_from_iso8601 (iso8601_string, NULL);
+gint64 time_val = g_date_time_to_unix (dt);
+g_date_time_unref (dt);
+]|
+
Since: 2.12
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_iso8601() instead.
</description>
<parameters>
@@ -51237,12 +51933,20 @@ variation of ISO 8601 format is required.
If @time_ represents a date which is too large to fit into a `struct tm`,
%NULL will be returned. This is platform dependent. Note also that since
`GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it
-is subject to the year 2038 problem.
+is subject to the year 2038 problem. Accordingly, since GLib 2.62, this
+function has been deprecated. Equivalent functionality is available using:
+|[
+GDateTime *dt = g_date_time_new_from_unix_utc (time_val);
+iso8601_string = g_date_time_format_iso8601 (dt);
+g_date_time_unref (dt);
+]|
The return value of g_time_val_to_iso8601() has been nullable since GLib
2.54; before then, GLib would crash under the same conditions.
Since: 2.12
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_format_iso8601(dt) instead.
</description>
<parameters>
@@ -51300,7 +52004,7 @@ Since: 2.26
<function name="g_time_zone_find_interval">
<description>
-Finds an the interval within @tz that corresponds to the given @time_.
+Finds an interval within @tz that corresponds to the given @time_.
The meaning of @time_ depends on @type.
If @type is %G_TIME_TYPE_UNIVERSAL then this function will always
@@ -51954,6 +52658,23 @@ fractional part.
</return>
</function>
+<function name="g_timer_is_active">
+<description>
+Exposes whether the timer is currently active.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="timer">
+<parameter_description> a #GTimer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the timer is running, %FALSE otherwise
+</return>
+</function>
+
<function name="g_timer_new">
<description>
Creates a new timer, and starts timing (i.e. g_timer_start() is
@@ -52817,7 +53538,7 @@ Since: 2.24
</description>
<parameters>
<parameter name="class_type">
-<parameter_description> GType of an classed type
+<parameter_description> GType of a classed type
</parameter_description>
</parameter>
<parameter name="private_size">
@@ -53272,7 +53993,7 @@ Since: 2.4
<parameters>
<parameter name="g_iface">
<parameter_description> the default vtable
-structure for a interface, as returned by g_type_default_interface_ref()
+structure for an interface, as returned by g_type_default_interface_ref()
</parameter_description>
</parameter>
</parameters>
@@ -53343,7 +54064,7 @@ implementors of fundamental types.
<function name="g_type_from_name">
<description>
-Lookup the type ID from a given type name, returning 0 if no type
+Look up the type ID from a given type name, returning 0 if no type
has been registered under this name (this is the preferred method
to find out by name whether a specific type has been registered
yet).
@@ -53352,7 +54073,7 @@ yet).
</description>
<parameters>
<parameter name="name">
-<parameter_description> type name to lookup
+<parameter_description> type name to look up
</parameter_description>
</parameter>
</parameters>
@@ -55165,7 +55886,7 @@ Converts a character to uppercase.
</parameter>
</parameters>
<return> the result of converting @c to uppercase.
-If @c is not an lowercase or titlecase character,
+If @c is not a lowercase or titlecase character,
or has no upper case equivalent @c is returned unchanged.
</return>
</function>
@@ -56242,9 +56963,9 @@ less capable Unicode handling.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string, that is the
-normalized form of @str, or %NULL if @str is not
-valid UTF-8.
+<return> a newly allocated string, that
+is the normalized form of @str, or %NULL if @str
+is not valid UTF-8.
</return>
</function>
@@ -56282,7 +57003,7 @@ text rendering and therefore has to be as fast as possible.
<function name="g_utf8_pointer_to_offset">
<description>
-Converts from a pointer to position within a string to a integer
+Converts from a pointer to position within a string to an integer
character offset.
Since 2.10, this function allows @pos to be before @str, and returns
@@ -56347,7 +57068,7 @@ If @len is -1, allow unbounded search.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if the string does not contain the character,
+<return> %NULL if the string does not contain the character,
otherwise, a pointer to the start of the leftmost occurrence
of the character in the string.
</return>
@@ -56455,7 +57176,7 @@ If @len is -1, allow unbounded search.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if the string does not contain the character,
+<return> %NULL if the string does not contain the character,
otherwise, a pointer to the start of the rightmost occurrence
of the character in the string.
</return>
@@ -58140,8 +58861,8 @@ Since: 2.26
<function name="g_value_take_boxed">
<description>
Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed
-and takes over the ownership of the callers reference to @v_boxed;
-the caller doesn't have to unref it any more.
+and takes over the ownership of the caller’s reference to @v_boxed;
+the caller doesn’t have to unref it any more.
Since: 2.4
@@ -58162,8 +58883,8 @@ Since: 2.4
<function name="g_value_take_object">
<description>
Sets the contents of a %G_TYPE_OBJECT derived #GValue to @v_object
-and takes over the ownership of the callers reference to @v_object;
-the caller doesn't have to unref it any more (i.e. the reference
+and takes over the ownership of the caller’s reference to @v_object;
+the caller doesn’t have to unref it any more (i.e. the reference
count of the object is not increased).
If you want the #GValue to hold its own reference to @v_object, use
@@ -58188,8 +58909,8 @@ Since: 2.4
<function name="g_value_take_param">
<description>
Sets the contents of a %G_TYPE_PARAM #GValue to @param and takes
-over the ownership of the callers reference to @param; the caller
-doesn't have to unref it any more.
+over the ownership of the caller’s reference to @param; the caller
+doesn’t have to unref it any more.
Since: 2.4
@@ -58902,7 +59623,7 @@ Since: 2.40
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> the key to lookup in the dictionary
+<parameter_description> the key to look up in the dictionary
</parameter_description>
</parameter>
</parameters>
@@ -59049,7 +59770,7 @@ Since: 2.40
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> the key to lookup in the dictionary
+<parameter_description> the key to look up in the dictionary
</parameter_description>
</parameter>
<parameter name="format_string">
@@ -59089,7 +59810,7 @@ Since: 2.40
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> the key to lookup in the dictionary
+<parameter_description> the key to look up in the dictionary
</parameter_description>
</parameter>
<parameter name="expected_type">
@@ -59762,7 +60483,7 @@ Since: 2.24
</description>
<parameters>
<parameter name="value">
-<parameter_description> a int16 #GVariant instance
+<parameter_description> an int16 #GVariant instance
</parameter_description>
</parameter>
</parameters>
@@ -59783,7 +60504,7 @@ Since: 2.24
</description>
<parameters>
<parameter name="value">
-<parameter_description> a int32 #GVariant instance
+<parameter_description> an int32 #GVariant instance
</parameter_description>
</parameter>
</parameters>
@@ -59804,7 +60525,7 @@ Since: 2.24
</description>
<parameters>
<parameter name="value">
-<parameter_description> a int64 #GVariant instance
+<parameter_description> an int64 #GVariant instance
</parameter_description>
</parameter>
</parameters>
@@ -60686,7 +61407,7 @@ Since: 2.28
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> the key to lookup in the dictionary
+<parameter_description> the key to look up in the dictionary
</parameter_description>
</parameter>
<parameter name="format_string">
@@ -60736,7 +61457,7 @@ Since: 2.28
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> the key to lookup in the dictionary
+<parameter_description> the key to look up in the dictionary
</parameter_description>
</parameter>
<parameter name="expected_type">
@@ -63498,6 +64219,58 @@ failure and lack of short names.
</return>
</function>
+<function name="g_win32_readlink_utf8">
+<description>
+Tries to read the reparse point indicated by @filename, filling
+@buf or @alloc_buf with the path that the reparse point redirects to.
+The path will be UTF-8-encoded, and an extended path prefix
+or a NT object manager prefix will be removed from it, if
+possible, but otherwise the path is returned as-is. Specifically,
+it could be a "\\\\Volume{GUID}\\" path. It also might use
+backslashes as path separators.
+
+Since: 2.60
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a pathname in UTF-8
+</parameter_description>
+</parameter>
+<parameter name="buf">
+<parameter_description> a buffer to receive the reparse point
+target path. Mutually-exclusive
+with @alloc_buf.
+</parameter_description>
+</parameter>
+<parameter name="buf_size">
+<parameter_description> size of the @buf, in bytes
+</parameter_description>
+</parameter>
+<parameter name="alloc_buf">
+<parameter_description> points to a location where internally-allocated buffer
+pointer will be written. That buffer receives the
+link data. Mutually-exclusive with @buf.
+</parameter_description>
+</parameter>
+<parameter name="terminate">
+<parameter_description> ensures that the buffer is NUL-terminated if
+it isn't already. If %FALSE, the returned string
+might not be NUL-terminated (depends entirely on
+what the contents of the filesystem are).
+</parameter_description>
+</parameter>
+</parameters>
+<return> -1 on error (sets errno), 0 if there's no (recognizable)
+path in the reparse point (@alloc_buf will not be allocated in that case,
+and @buf will be left unmodified),
+or the number of bytes placed into @buf otherwise,
+including NUL-terminator (if present or if @terminate is TRUE).
+The buffer returned via @alloc_buf should be freed with g_free().
+
+</return>
+</function>
+
<function name="gatomicrefcount">
<description>
A type for implementing atomic reference count semantics.
diff --git a/glib/src/glib_enums.defs b/glib/src/glib_enums.defs
index a967468b..b0876fa9 100644
--- a/glib/src/glib_enums.defs
+++ b/glib/src/glib_enums.defs
@@ -1038,7 +1038,7 @@
'("left-paren" "G_TOKEN_LEFT_PAREN" "'('")
'("right-paren" "G_TOKEN_RIGHT_PAREN" "')'")
'("left-curly" "G_TOKEN_LEFT_CURLY" "'{'")
- '("right-curly" "G_TOKEN_RIGHT_CURLY" "']'")
+ '("right-curly" "G_TOKEN_RIGHT_CURLY" "'}'")
'("left-brace" "G_TOKEN_LEFT_BRACE" "'['")
'("right-brace" "G_TOKEN_RIGHT_BRACE" "']'")
'("equal-sign" "G_TOKEN_EQUAL_SIGN" "'='")
@@ -1119,9 +1119,7 @@
;; G_SPAWN_ERROR_ACCES, /* execv() returned EACCES */
;; G_SPAWN_ERROR_PERM, /* execv() returned EPERM */
;; G_SPAWN_ERROR_TOO_BIG,/* execv() returned E2BIG */
-;; #ifndef G_DISABLE_DEPRECATED
-;; G_SPAWN_ERROR_2BIG = G_SPAWN_ERROR_TOO_BIG,
-;; #endif
+;; G_SPAWN_ERROR_2BIG GLIB_DEPRECATED_ENUMERATOR_IN_2_32_FOR(G_SPAWN_ERROR_TOO_BIG) =
G_SPAWN_ERROR_TOO_BIG,
;; G_SPAWN_ERROR_NOEXEC, /* execv() returned ENOEXEC */
;; G_SPAWN_ERROR_NAMETOOLONG, /* "" "" ENAMETOOLONG */
;; G_SPAWN_ERROR_NOENT, /* "" "" ENOENT */
@@ -1260,7 +1258,7 @@
;; G_TEST_TRAP_SILENCE_STDOUT = 1 << 7,
;; G_TEST_TRAP_SILENCE_STDERR = 1 << 8,
;; G_TEST_TRAP_INHERIT_STDIN = 1 << 9
-;; } GTestTrapFlags;
+;; } GTestTrapFlags GLIB_DEPRECATED_TYPE_IN_2_38_FOR(GTestSubprocessFlags);
(define-flags-extended TestTrapFlags
(in-module "G")
@@ -1717,7 +1715,7 @@
;; G_UNICODE_SCRIPT_KHUDAWADI, /* Sind */
;; G_UNICODE_SCRIPT_LINEAR_A, /* Lina */
;; G_UNICODE_SCRIPT_MAHAJANI, /* Mahj */
-;; G_UNICODE_SCRIPT_MANICHAEAN, /* Manu */
+;; G_UNICODE_SCRIPT_MANICHAEAN, /* Mani */
;; G_UNICODE_SCRIPT_MENDE_KIKAKUI, /* Mend */
;; G_UNICODE_SCRIPT_MODI, /* Modi */
;; G_UNICODE_SCRIPT_MRO, /* Mroo */
@@ -1761,7 +1759,13 @@
;; G_UNICODE_SCRIPT_MAKASAR, /* Maka */
;; G_UNICODE_SCRIPT_MEDEFAIDRIN, /* Medf */
;; G_UNICODE_SCRIPT_OLD_SOGDIAN, /* Sogo */
-;; G_UNICODE_SCRIPT_SOGDIAN /* Sogd */
+;; G_UNICODE_SCRIPT_SOGDIAN, /* Sogd */
+;;
+;; /* Unicode 12.0 additions */
+;; G_UNICODE_SCRIPT_ELYMAIC, /* Elym */
+;; G_UNICODE_SCRIPT_NANDINAGARI, /* Nand */
+;; G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG, /* Rohg */
+;; G_UNICODE_SCRIPT_WANCHO /* Wcho */
;; } GUnicodeScript;
(define-enum-extended UnicodeScript
@@ -1918,6 +1922,10 @@
'("medefaidrin" "G_UNICODE_SCRIPT_MEDEFAIDRIN" "146")
'("old-sogdian" "G_UNICODE_SCRIPT_OLD_SOGDIAN" "147")
'("sogdian" "G_UNICODE_SCRIPT_SOGDIAN" "148")
+ '("elymaic" "G_UNICODE_SCRIPT_ELYMAIC" "149")
+ '("nandinagari" "G_UNICODE_SCRIPT_NANDINAGARI" "150")
+ '("nyiakeng-puachue-hmong" "G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG" "151")
+ '("wancho" "G_UNICODE_SCRIPT_WANCHO" "152")
)
)
@@ -2127,7 +2135,7 @@
;; G_THREAD_PRIORITY_NORMAL,
;; G_THREAD_PRIORITY_HIGH,
;; G_THREAD_PRIORITY_URGENT
-;; } GThreadPriority;
+;; } GThreadPriority GLIB_DEPRECATED_TYPE_IN_2_32;
(define-enum-extended ThreadPriority
(in-module "G")
diff --git a/glib/src/glib_functions.defs b/glib/src/glib_functions.defs
index 22f9c2a1..1885ee08 100644
--- a/glib/src/glib_functions.defs
+++ b/glib/src/glib_functions.defs
@@ -978,6 +978,10 @@
'("medefaidrin" "G_UNICODE_SCRIPT_MEDEFAIDRIN")
'("old-sogdian" "G_UNICODE_SCRIPT_OLD_SOGDIAN")
'("sogdian" "G_UNICODE_SCRIPT_SOGDIAN")
+ '("elymaic" "G_UNICODE_SCRIPT_ELYMAIC")
+ '("nandinagari" "G_UNICODE_SCRIPT_NANDINAGARI")
+ '("nyiakeng-puachue-hmong" "G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG")
+ '("wancho" "G_UNICODE_SCRIPT_WANCHO")
)
)
@@ -1127,6 +1131,12 @@
)
)
+(define-method copy
+ (of-object "GArray")
+ (c-name "g_array_copy")
+ (return-type "GArray*")
+)
+
(define-method free
(of-object "GArray")
(c-name "g_array_free")
@@ -1241,6 +1251,17 @@
)
)
+(define-method binary_search
+ (of-object "GArray")
+ (c-name "g_array_binary_search")
+ (return-type "gboolean")
+ (parameters
+ '("gconstpointer" "target")
+ '("GCompareFunc" "compare_func")
+ '("guint*" "out_match_index")
+ )
+)
+
(define-method set_clear_func
(of-object "GArray")
(c-name "g_array_set_clear_func")
@@ -1264,6 +1285,16 @@
)
)
+(define-method copy
+ (of-object "GPtrArray")
+ (c-name "g_ptr_array_copy")
+ (return-type "GPtrArray*")
+ (parameters
+ '("GCopyFunc" "func")
+ '("gpointer" "user_data")
+ )
+)
+
(define-function g_ptr_array_sized_new
(c-name "g_ptr_array_sized_new")
(is-constructor-of "GPtrArraySized")
@@ -1394,6 +1425,26 @@
)
)
+(define-method extend
+ (of-object "GPtrArray")
+ (c-name "g_ptr_array_extend")
+ (return-type "none")
+ (parameters
+ '("GPtrArray*" "array")
+ '("GCopyFunc" "func")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method extend_and_steal
+ (of-object "GPtrArray")
+ (c-name "g_ptr_array_extend_and_steal")
+ (return-type "none")
+ (parameters
+ '("GPtrArray*" "array")
+ )
+)
+
(define-method insert
(of-object "GPtrArray")
(c-name "g_ptr_array_insert")
@@ -2740,6 +2791,14 @@
(return-type "gchar*")
)
+(define-function g_get_console_charset
+ (c-name "g_get_console_charset")
+ (return-type "gboolean")
+ (parameters
+ '("const-char**" "charset")
+ )
+)
+
(define-function g_get_language_names
(c-name "g_get_language_names")
(return-type "const-gchar*-const*")
@@ -3987,6 +4046,12 @@
)
)
+(define-method format_iso8601
+ (of-object "GDateTime")
+ (c-name "g_date_time_format_iso8601")
+ (return-type "gchar*")
+)
+
;; From gdir.h
@@ -6199,6 +6264,16 @@
(return-type "none")
)
+(define-function g_crash_handler_win32_init
+ (c-name "g_crash_handler_win32_init")
+ (return-type "none")
+)
+
+(define-function g_crash_handler_win32_deinit
+ (c-name "g_crash_handler_win32_deinit")
+ (return-type "none")
+)
+
;; From glibintl.h
@@ -6411,6 +6486,16 @@
)
)
+(define-method insert_before_link
+ (of-object "GList")
+ (c-name "g_list_insert_before_link")
+ (return-type "GList*")
+ (parameters
+ '("GList*" "sibling")
+ '("GList*" "link_")
+ )
+)
+
(define-method concat
(of-object "GList")
(c-name "g_list_concat")
@@ -8918,6 +9003,16 @@
)
)
+(define-method insert_before_link
+ (of-object "GQueue")
+ (c-name "g_queue_insert_before_link")
+ (return-type "none")
+ (parameters
+ '("GList*" "sibling")
+ '("GList*" "link_")
+ )
+)
+
(define-method insert_after
(of-object "GQueue")
(c-name "g_queue_insert_after")
@@ -8928,6 +9023,16 @@
)
)
+(define-method insert_after_link
+ (of-object "GQueue")
+ (c-name "g_queue_insert_after_link")
+ (return-type "none")
+ (parameters
+ '("GList*" "sibling")
+ '("GList*" "link_")
+ )
+)
+
(define-method insert_sorted
(of-object "GQueue")
(c-name "g_queue_insert_sorted")
@@ -11939,6 +12044,14 @@
)
)
+(define-function g_test_summary
+ (c-name "g_test_summary")
+ (return-type "none")
+ (parameters
+ '("const-char*" "summary")
+ )
+)
+
(define-function g_test_timer_start
(c-name "g_test_timer_start")
(return-type "none")
@@ -12573,6 +12686,30 @@
(return-type "none")
)
+(define-method writer_locker_new
+ (of-object "GRWLock")
+ (c-name "g_rw_lock_writer_locker_new")
+ (return-type "GRWLockWriterLocker*")
+)
+
+(define-method free
+ (of-object "GRWLockWriterLocker")
+ (c-name "g_rw_lock_writer_locker_free")
+ (return-type "none")
+)
+
+(define-method reader_locker_new
+ (of-object "GRWLock")
+ (c-name "g_rw_lock_reader_locker_new")
+ (return-type "GRWLockReaderLocker*")
+)
+
+(define-method free
+ (of-object "GRWLockReaderLocker")
+ (c-name "g_rw_lock_reader_locker_free")
+ (return-type "none")
+)
+
;; From gthreadpool.h
@@ -12742,6 +12879,12 @@
)
)
+(define-method is_active
+ (of-object "GTimer")
+ (c-name "g_timer_is_active")
+ (return-type "gboolean")
+)
+
(define-function g_usleep
(c-name "g_usleep")
(return-type "none")
diff --git a/glib/src/gobject_enums.defs b/glib/src/gobject_enums.defs
index e3b157b2..aba1fbdf 100644
--- a/glib/src/gobject_enums.defs
+++ b/glib/src/gobject_enums.defs
@@ -32,9 +32,7 @@
;; G_PARAM_CONSTRUCT_ONLY = 1 << 3,
;; G_PARAM_LAX_VALIDATION = 1 << 4,
;; G_PARAM_STATIC_NAME = 1 << 5,
-;; #ifndef G_DISABLE_DEPRECATED
-;; G_PARAM_PRIVATE = G_PARAM_STATIC_NAME,
-;; #endif
+;; G_PARAM_PRIVATE GLIB_DEPRECATED_ENUMERATOR_IN_2_26 = G_PARAM_STATIC_NAME,
;; G_PARAM_STATIC_NICK = 1 << 6,
;; G_PARAM_STATIC_BLURB = 1 << 7,
;; /* User defined flags go here */
@@ -144,7 +142,7 @@
;; G_TYPE_DEBUG_SIGNALS = 1 << 1,
;; G_TYPE_DEBUG_INSTANCE_COUNT = 1 << 2,
;; G_TYPE_DEBUG_MASK = 0x07
-;; } GTypeDebugFlags;
+;; } GTypeDebugFlags GLIB_DEPRECATED_TYPE_IN_2_36;
(define-flags-extended TypeDebugFlags
(in-module "G")
diff --git a/glib/src/gobject_functions.defs b/glib/src/gobject_functions.defs
index 154968e0..acb86489 100644
--- a/glib/src/gobject_functions.defs
+++ b/glib/src/gobject_functions.defs
@@ -2936,6 +2936,15 @@
)
)
+(define-function g_clear_signal_handler
+ (c-name "g_clear_signal_handler")
+ (return-type "none")
+ (parameters
+ '("gulong*" "handler_id_ptr")
+ '("gpointer" "instance")
+ )
+)
+
(define-function g_signal_override_class_closure
(c-name "g_signal_override_class_closure")
(return-type "none")
@@ -4217,27 +4226,3 @@
)
-
-;; From gobjectenumtypes.h
-
-(define-function g_unicode_type_get_type
- (c-name "g_unicode_type_get_type")
- (return-type "GType")
-)
-
-(define-function g_unicode_break_type_get_type
- (c-name "g_unicode_break_type_get_type")
- (return-type "GType")
-)
-
-(define-function g_unicode_script_get_type
- (c-name "g_unicode_script_get_type")
- (return-type "GType")
-)
-
-(define-function g_normalize_mode_get_type
- (c-name "g_normalize_mode_get_type")
- (return-type "GType")
-)
-
-
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
