[glibmm] Glib, Gio: Regenerate docs.xml and .defs files
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Glib, Gio: Regenerate docs.xml and .defs files
- Date: Wed, 17 Jul 2019 13:00:45 +0000 (UTC)
commit 95b747826ba2be82dece63e6cccfe9bf64832189
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date: Wed Jul 17 14:46:31 2019 +0200
Glib, Gio: Regenerate docs.xml and .defs files
and update gio_signals.defs.patch and generate_defs_gio.cc.
gio/src/gio_docs.xml | 265 ++++++----
gio/src/gio_enums.defs | 2 +-
gio/src/gio_methods.defs | 9 +
gio/src/gio_signals.defs | 217 +++++++++
gio/src/gio_signals.defs.patch | 41 +-
glib/src/glib_docs.xml | 770 ++++++++++++++++++++++++++++--
glib/src/glib_enums.defs | 24 +-
glib/src/glib_functions.defs | 137 ++++++
glib/src/gobject_enums.defs | 6 +-
glib/src/gobject_functions.defs | 33 +-
tools/extra_defs_gen/generate_defs_gio.cc | 12 +-
11 files changed, 1330 insertions(+), 186 deletions(-)
---
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 37cc29a5..31bc44b4 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>
@@ -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
@@ -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.
@@ -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.
@@ -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.
@@ -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>
@@ -28193,7 +28217,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 +29354,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>
@@ -32714,8 +32742,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 +32793,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 +32840,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 +32939,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 +33269,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>
@@ -37116,7 +37144,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 +37823,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 +41027,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 +41713,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 +41753,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">
@@ -43615,7 +43643,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 +43659,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 +43668,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 +43685,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 +43706,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 +43911,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 +44283,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 +44307,7 @@ Since: 2.46
</parameter>
</parameters>
<return> a list of the keys on
-@schema
+@schema, in no defined order
</return>
</function>
@@ -44353,12 +44385,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 +47178,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 +47574,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 +48125,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 +49120,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 +49419,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 +49507,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 +49691,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 +49750,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 +49832,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 +50876,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 +50887,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">
@@ -52847,7 +52900,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 +54462,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 +54512,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 +54554,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 +54584,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 +54630,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 +54699,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 +54741,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
@@ -55588,6 +55641,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 +55780,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 +56468,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 +56532,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>
@@ -59496,4 +59571,18 @@ GetLogicalDrives() is returned.
</return>
</function>
+<function name="inet_addresses_to_inet_socket_addresses">
+<description>
+
+</description>
+<parameters>
+<parameter name="addresses">
+<parameter_description> #GList of #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GList of #GInetSocketAddress
+</return>
+</function>
+
</root>
diff --git a/gio/src/gio_enums.defs b/gio/src/gio_enums.defs
index 1043c019..2b85aed0 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..3aa62405 100644
--- a/gio/src/gio_methods.defs
+++ b/gio/src/gio_methods.defs
@@ -11649,6 +11649,10 @@
+;; From gmarshal-internal.h
+
+
+
;; From gmemoryinputstream.h
(define-function g_memory_input_stream_get_type
@@ -13768,6 +13772,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/gio/src/gio_signals.defs b/gio/src/gio_signals.defs
index 8a49e6fb..16a893f5 100644
--- a/gio/src/gio_signals.defs
+++ b/gio/src/gio_signals.defs
@@ -2759,6 +2759,223 @@
)
)
+;; From GDBusObjectManager
+
+(define-signal interface-added
+ (of-object "GDBusObjectManager")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObject*" "p0")
+ '("GDBusInterface*" "p1")
+ )
+)
+
+(define-signal interface-removed
+ (of-object "GDBusObjectManager")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObject*" "p0")
+ '("GDBusInterface*" "p1")
+ )
+)
+
+(define-signal object-added
+ (of-object "GDBusObjectManager")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObject*" "p0")
+ )
+)
+
+(define-signal object-removed
+ (of-object "GDBusObjectManager")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObject*" "p0")
+ )
+)
+
+;; From GDBusObjectManagerClient
+
+(define-signal interface-proxy-signal
+ (of-object "GDBusObjectManagerClient")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObjectProxy*" "p0")
+ '("GDBusProxy*" "p1")
+ '("const-gchar*" "p2")
+ '("const-gchar*" "p3")
+ '("GVariant*" "p4")
+ )
+)
+
+(define-signal interface-proxy-properties-changed
+ (of-object "GDBusObjectManagerClient")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObjectProxy*" "p0")
+ '("GDBusProxy*" "p1")
+ '("GVariant*" "p2")
+ '("const-gchar*const*" "p3")
+ )
+)
+
+(define-property bus-type
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamEnum")
+ (docs "The bus to connect to, if any")
+ (readable #f)
+ (writable #t)
+ (construct-only #t)
+ (default-value "G_BUS_TYPE_NONE")
+)
+
+(define-property connection
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamObject")
+ (docs "The connection to use")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
+(define-property flags
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamFlags")
+ (docs "Flags for the proxy manager")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+ (default-value "G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE")
+)
+
+(define-property object-path
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamString")
+ (docs "The object path of the control object")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+ (default-value "")
+)
+
+(define-property name
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamString")
+ (docs "Name that the manager is for")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+ (default-value "")
+)
+
+(define-property name-owner
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamString")
+ (docs "The owner of the name we are watching")
+ (readable #t)
+ (writable #f)
+ (construct-only #f)
+ (default-value "")
+)
+
+(define-property get-proxy-type-func
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamPointer")
+ (docs "The GDBusProxyTypeFunc pointer to use")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
+(define-property get-proxy-type-user-data
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamPointer")
+ (docs "The GDBusProxyTypeFunc user_data")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
+(define-property get-proxy-type-destroy-notify
+ (of-object "GDBusObjectManagerClient")
+ (prop-type "GParamPointer")
+ (docs "The GDBusProxyTypeFunc user data free function")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
+;; From GDBusObjectManagerServer
+
+(define-property connection
+ (of-object "GDBusObjectManagerServer")
+ (prop-type "GParamObject")
+ (docs "The connection to export objects on")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+)
+
+(define-property object-path
+ (of-object "GDBusObjectManagerServer")
+ (prop-type "GParamString")
+ (docs "The object path to register the manager object at")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+ (default-value "")
+)
+
+;; From GDBusObjectProxy
+
+(define-property g-object-path
+ (of-object "GDBusObjectProxy")
+ (prop-type "GParamString")
+ (docs "The object path of the proxy")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+ (default-value "")
+)
+
+(define-property g-connection
+ (of-object "GDBusObjectProxy")
+ (prop-type "GParamObject")
+ (docs "The connection of the proxy")
+ (readable #t)
+ (writable #t)
+ (construct-only #t)
+)
+
+;; From GDBusObjectSkeleton
+
+(define-signal authorize-method
+ (of-object "GDBusObjectSkeleton")
+ (return-type "gboolean")
+ (flags "Run Last")
+ (parameters
+ '("GDBusInterfaceSkeleton*" "p0")
+ '("GDBusMethodInvocation*" "p1")
+ )
+)
+
+(define-property g-object-path
+ (of-object "GDBusObjectSkeleton")
+ (prop-type "GParamString")
+ (docs "The object path where the object is exported")
+ (readable #t)
+ (writable #t)
+ (construct-only #f)
+ (default-value "")
+)
+
;; GDBusNodeInfo is neither a GObject nor a GInterface. Not checked for signals and properties.
;; From GDBusMessage
diff --git a/gio/src/gio_signals.defs.patch b/gio/src/gio_signals.defs.patch
index f3db90fe..cfa13827 100644
--- a/gio/src/gio_signals.defs.patch
+++ b/gio/src/gio_signals.defs.patch
@@ -1,5 +1,5 @@
---- ./../../gio/src/gio_signals.defs.orig 2017-09-11 09:52:55.272837455 +0200
-+++ ./../../gio/src/gio_signals.defs 2017-09-11 14:56:39.662521043 +0200
+--- tools/gen_scripts/../../gio/src/gio_signals.defs.orig 2019-07-15 15:42:00.493060856 +0200
++++ tools/gen_scripts/../../gio/src/gio_signals.defs 2019-07-15 15:42:00.513060927 +0200
@@ -87,11 +87,11 @@
(return-type "void")
(flags "Run Last, Must Collect")
@@ -13,7 +13,7 @@
;; From GApplication
-@@ -738,11 +738,11 @@
+@@ -744,11 +744,11 @@
(of-object "GMountOperation")
(return-type "void")
(flags "Run Last")
@@ -26,7 +26,7 @@
(define-signal reply
(of-object "GMountOperation")
-@@ -1106,11 +1106,11 @@
+@@ -1142,11 +1142,11 @@
(define-signal writable-change-event
(of-object "GSettings")
(return-type "gboolean")
@@ -39,7 +39,7 @@
(define-property settings-schema
(of-object "GSettings")
-@@ -1190,20 +1190,20 @@
+@@ -1226,20 +1226,20 @@
(define-signal activate
(of-object "GSimpleAction")
(return-type "void")
@@ -62,7 +62,7 @@
(define-property name
(of-object "GSimpleAction")
-@@ -1850,11 +1850,11 @@
+@@ -1886,11 +1886,11 @@
(define-signal writable-change-event
(of-object "GSettings")
(return-type "gboolean")
@@ -75,7 +75,34 @@
(define-property settings-schema
(of-object "GSettings")
-@@ -2723,23 +2723,23 @@
+@@ -2808,23 +2808,23 @@
+ (parameters
+ '("GDBusObjectProxy*" "p0")
+ '("GDBusProxy*" "p1")
+ '("const-gchar*" "p2")
+ '("const-gchar*" "p3")
+- '("GVariant" "p4")
++ '("GVariant*" "p4")
+ )
+ )
+
+ (define-signal interface-proxy-properties-changed
+ (of-object "GDBusObjectManagerClient")
+ (return-type "void")
+ (flags "Run Last")
+ (parameters
+ '("GDBusObjectProxy*" "p0")
+ '("GDBusProxy*" "p1")
+- '("GVariant" "p2")
+- '("GStrv*" "p3")
++ '("GVariant*" "p2")
++ '("const-gchar*const*" "p3")
+ )
+ )
+
+ (define-property bus-type
+ (of-object "GDBusObjectManagerClient")
+@@ -2997,23 +2997,23 @@
(define-signal g-properties-changed
(of-object "GDBusProxy")
(return-type "void")
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 2358f9db..ed807ca6 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.
@@ -4055,6 +4056,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
@@ -7019,7 +7095,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 +7307,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 +7321,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 +7348,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 +7376,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 +7414,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 +7443,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 +7452,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 +7487,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 +7505,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 +7552,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().
@@ -12871,6 +12986,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.
@@ -19245,6 +19387,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.
@@ -19544,7 +19721,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>
@@ -21927,6 +22105,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 +22129,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>
@@ -25073,6 +25259,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 +26779,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
@@ -31145,9 +31359,15 @@ 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
+- 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 +31493,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 +31909,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 +32050,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 +32481,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 +32508,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">
@@ -35457,6 +35695,107 @@ 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.
+
+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 +36426,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 +36448,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 +36488,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 +36796,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 +36851,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.
@@ -39535,8 +39939,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 +39960,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 +40057,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 +41267,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 +41308,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 +43218,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 +44993,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 +47369,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 +47552,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>
@@ -49000,6 +49565,7 @@ Bug URIs are constructed from a base URI set with g_test_bug_base()
and @bug_uri_snippet.
Since: 2.16
+See also: g_test_summary()
</description>
<parameters>
@@ -50004,6 +50570,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
@@ -51954,6 +52555,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
@@ -53343,7 +53961,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 +53970,7 @@ yet).
</description>
<parameters>
<parameter name="name">
-<parameter_description> type name to lookup
+<parameter_description> type name to look up
</parameter_description>
</parameter>
</parameters>
@@ -56242,9 +56860,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>
@@ -56347,7 +56965,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 +57073,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 +58758,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 +58780,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 +58806,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 +59520,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 +59667,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 +59707,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">
@@ -60686,7 +61304,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 +61354,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 +64116,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..daf056fb 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*")
@@ -6199,6 +6258,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 +6480,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 +8997,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 +9017,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 +12038,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 +12680,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 +12873,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")
-)
-
-
diff --git a/tools/extra_defs_gen/generate_defs_gio.cc b/tools/extra_defs_gen/generate_defs_gio.cc
index 229c155f..36ad4fca 100644
--- a/tools/extra_defs_gen/generate_defs_gio.cc
+++ b/tools/extra_defs_gen/generate_defs_gio.cc
@@ -39,6 +39,7 @@ main(int, char**)
// g_type_init();
// Until the glib bug https://bugzilla.gnome.org/show_bug.cgi?id=465631
+ // (https://gitlab.gnome.org/GNOME/glib/issues/100)
// is fixed, get_defs() must be called for a GObject before it's
// called for a GInterface.
(void)get_defs(G_TYPE_APPLICATION);
@@ -77,9 +78,6 @@ main(int, char**)
<< get_defs(G_TYPE_SIMPLE_ACTION) << get_defs(G_TYPE_SIMPLE_IO_STREAM)
<< get_defs(G_TYPE_SUBPROCESS) << get_defs(G_TYPE_SUBPROCESS_LAUNCHER)
<< get_defs(G_TYPE_THEMED_ICON)
-
- // TODO: This causes a g_warning:
- // GLib-GObject-CRITICAL **: g_param_spec_pool_list: assertion `pool != NULL' failed"
<< get_defs(G_TYPE_VOLUME)
<< get_defs(G_TYPE_VOLUME_MONITOR) << get_defs(G_TYPE_ZLIB_COMPRESSOR)
@@ -113,7 +111,13 @@ main(int, char**)
<< get_defs(G_TYPE_DBUS_ARG_INFO) << get_defs(G_TYPE_DBUS_MENU_MODEL)
<< get_defs(G_TYPE_DBUS_METHOD_INFO) << get_defs(G_TYPE_DBUS_SIGNAL_INFO)
<< get_defs(G_TYPE_DBUS_PROPERTY_INFO) << get_defs(G_TYPE_DBUS_INTERFACE_INFO)
- << get_defs(G_TYPE_DBUS_INTERFACE_SKELETON) << get_defs(G_TYPE_DBUS_OBJECT)
+ << get_defs(G_TYPE_DBUS_INTERFACE_SKELETON)
+ << get_defs(G_TYPE_DBUS_OBJECT)
+ << get_defs(G_TYPE_DBUS_OBJECT_MANAGER)
+ << get_defs(G_TYPE_DBUS_OBJECT_MANAGER_CLIENT)
+ << get_defs(G_TYPE_DBUS_OBJECT_MANAGER_SERVER)
+ << get_defs(G_TYPE_DBUS_OBJECT_PROXY)
+ << get_defs(G_TYPE_DBUS_OBJECT_SKELETON)
<< get_defs(G_TYPE_DBUS_NODE_INFO) << get_defs(G_TYPE_DBUS_MESSAGE)
<< get_defs(G_TYPE_DBUS_METHOD_INVOCATION) << get_defs(G_TYPE_DBUS_PROXY)
<< get_defs(G_TYPE_DBUS_SERVER)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
