[glibmm] Regenereated teh -docs.xml files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Regenereated teh -docs.xml files.
- Date: Tue, 19 Mar 2013 09:42:46 +0000 (UTC)
commit 10fb2a42c02b6acf9a79924c04e0f93ca38d2e79
Author: Murray Cumming <murrayc murrayc com>
Date: Tue Mar 19 10:36:44 2013 +0100
Regenereated teh -docs.xml files.
* gio/src/gio_docs.xml:
* glib/src/glib_docs.xml: Regenerated using
tools/defs_gen/docextract_to_xml.py
ChangeLog | 8 +
gio/src/gio_docs.xml | 908 ++++++++++++++++++++++++++++++++++++++++++++++--
glib/src/glib_docs.xml | 607 ++++++++++++++++++++++++++++-----
3 files changed, 1412 insertions(+), 111 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 7e711db..fb751b8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2013-03-19 Murray Cumming <murrayc murrayc com>
+
+ Regenereated teh -docs.xml files.
+
+ * gio/src/gio_docs.xml:
+ * glib/src/glib_docs.xml: Regenerated using
+ tools/defs_gen/docextract_to_xml.py
+
2.35.9:
2013-03-13 José Alburquerque <jaalburquerque gmail com>
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 9302b9e..100acee 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -1566,8 +1566,9 @@ Since: 2.28
</parameter>
<parameter name="G_APPLICATION_IS_SERVICE">
<parameter_description> Run as a service. In this mode, registration
-fails if the service is already running, and the application will
-stay around for a while when the use count falls to zero.
+fails if the service is already running, and the application
+will initially wait up to 10 seconds for an initial activation
+message to arrive.
</parameter_description>
</parameter>
<parameter name="G_APPLICATION_IS_LAUNCHER">
@@ -3430,6 +3431,11 @@ behaviour -without specifying this flag- is to send single DELETED
and CREATED events).
</parameter_description>
</parameter>
+<parameter name="G_FILE_MONITOR_WATCH_HARD_LINKS">
+<parameter_description> Watch for changes to the file made
+via another hard link. Since 2.36.
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -3673,7 +3679,7 @@ this limit. Since 2.20
</parameter_description>
</parameter>
<parameter name="G_IO_ERROR_INVALID_DATA">
-<parameter_description> There input data was invalid. Since 2.24
+<parameter_description> The input data was invalid. Since 2.24
</parameter_description>
</parameter>
<parameter name="G_IO_ERROR_DBUS_ERROR">
@@ -3713,6 +3719,10 @@ message so it matches what was received on the wire. Since 2.26.
Since 2.26
</parameter_description>
</parameter>
+<parameter name="G_IO_ERROR_BROKEN_PIPE">
+<parameter_description> Broken pipe. Since 2.36
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -5575,6 +5585,27 @@ Since: 2.24
</parameters>
</enum>
+<function name="convert_kqueue_events_to_gio">
+<description>
+Translates kqueue filter flags into GIO event flags.
+
+
+</description>
+<parameters>
+<parameter name="flags">
+<parameter_description> a set of kqueue filter flags
+</parameter_description>
+</parameter>
+<parameter name="done">
+<parameter_description> a pointer to #gboolean indicating that the
+conversion has been done (out)
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileMonitorEvent
+</return>
+</function>
+
<function name="example_animal_call_poke">
<description>
Asynchronously invokes the <link
linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus
method on @proxy.
@@ -19902,8 +19933,8 @@ Since: 2.32
</parameter_description>
</parameter>
<parameter name="entries">
-<parameter_description> a pointer to the first item in an array of #GActionEntry
-structs
+<parameter_description> a pointer to
+the first item in an array of #GActionEntry structs
</parameter_description>
</parameter>
<parameter name="n_entries">
@@ -20863,6 +20894,33 @@ Since: 2.28
<return></return>
</function>
+<function name="g_application_command_line_create_file_for_arg">
+<description>
+Creates a #GFile corresponding to a filename that was given as part
+of the invocation of @cmdline.
+
+This differs from g_file_new_for_commandline_arg() in that it
+resolves relative pathnames using the current working directory of
+the invoking process rather than the local process.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
+</parameter_description>
+</parameter>
+<parameter name="arg">
+<parameter_description> an argument from @cmdline
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile
+
+</return>
+</function>
+
<function name="g_application_command_line_get_arguments">
<description>
Gets the list of arguments that was passed on the command line.
@@ -21011,6 +21069,33 @@ Since: 2.28
</return>
</function>
+<function name="g_application_command_line_get_stdin">
+<description>
+Gets the stdin of the invoking process.
+
+The #GInputStream can be used to read data passed to the standard
+input of the invoking process.
+This doesn't work on all platforms. Presently, it is only available
+on UNIX when using a DBus daemon capable of passing file descriptors.
+If stdin is not available then %NULL will be returned. In the
+future, support may be expanded to other platforms.
+
+You must only call this function once per commandline invocation.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream for stdin
+
+</return>
+</function>
+
<function name="g_application_command_line_getenv">
<description>
Gets the value of a particular environment variable of the command
@@ -21608,9 +21693,12 @@ then the exit status is returned immediately. If the use count is
non-zero then the default main context is iterated until the use count
falls to zero, at which point 0 is returned.
-If the %G_APPLICATION_IS_SERVICE flag is set, then the exiting at
-use count of zero is delayed for a while (ie: the instance stays
-around to provide its <emphasis>service</emphasis> to others).
+If the %G_APPLICATION_IS_SERVICE flag is set, then the service will
+run for as much as 10 seconds with a use count of zero while waiting
+for the message that caused the activation to arrive. After that,
+if the use count falls to zero the application will exit immediately,
+except in the case that g_application_set_inactivity_timeout() is in
+use.
Since: 2.28
@@ -21925,8 +22013,8 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GObject, or %NULL on error.
-Free with g_object_unref().
+<return> a newly created #GObject,
+or %NULL on error. Free with g_object_unref().
</return>
</function>
@@ -24018,6 +24106,33 @@ data, it is owned by @credentials.
</return>
</function>
+<function name="g_credentials_get_unix_pid">
+<description>
+Tries to get the UNIX process identifier from @credentials. This
+method is only available on UNIX platforms.
+
+This operation can fail if #GCredentials is not supported on the
+OS or if the native credentials type does not contain information
+about the UNIX process ID.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="credentials">
+<parameter_description> A #GCredentials
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The UNIX process ID, or -1 if @error is set.
+
+</return>
+</function>
+
<function name="g_credentials_get_unix_user">
<description>
Tries to get the UNIX user identifier from @credentials. This
@@ -25246,6 +25361,32 @@ Since: 2.32
</return>
</function>
+<function name="g_dbus_address_escape_value">
+<description>
+Escape @string so it can appear in a D-Bus address as the value
+part of a key-value pair.
+
+For instance, if @string is <code>/run/bus-for-:0</code>,
+this function would return <code>/run/bus-for-%3A0</code>,
+which could be used in a D-Bus address like
+<code>unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0</code>.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> an unescaped string to be included in a D-Bus address
+as the value in a key-value pair
+</parameter_description>
+</parameter>
+</parameters>
+<return> a copy of @string with all
+non-optionally-escaped bytes escaped
+
+</return>
+</function>
+
<function name="g_dbus_address_get_for_bus_sync">
<description>
Synchronously looks up the D-Bus address for the well-known message
@@ -26199,7 +26340,7 @@ Exports @menu on @connection at @object_path.
The implemented D-Bus API should be considered private.
It is subject to change in the future.
-An object path can only have one action group exported on it. If this
+An object path can only have one menu model exported on it. If this
constraint is violated, the export will fail and 0 will be
returned (with @error set accordingly).
@@ -32191,6 +32332,31 @@ Since: 2.26
<return></return>
</function>
+<function name="g_desktop_app_info_get_boolean">
+<description>
+Looks up a boolean value in the keyfile backing @info.
+
+The @key is looked up in the "Desktop Entry" group.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the boolean value, or %FALSE if the key
+is not found
+
+</return>
+</function>
+
<function name="g_desktop_app_info_get_categories">
<description>
Gets the categories from the desktop file.
@@ -32351,6 +32517,54 @@ in the desktop file.
</return>
</function>
+<function name="g_desktop_app_info_get_string">
+<description>
+Looks up a string value in the keyfile backing @info.
+
+The @key is looked up in the "Desktop Entry" group.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string, or %NULL if the key
+is not found
+
+</return>
+</function>
+
+<function name="g_desktop_app_info_has_key">
+<description>
+Returns whether @key exists in the "Desktop Entry" group
+of the keyfile backing @info.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @key exists
+
+</return>
+</function>
+
<function name="g_desktop_app_info_launch_uris_as_manager">
<description>
This function performs the equivalent of g_app_info_launch_uris(),
@@ -34511,7 +34725,7 @@ operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
returned.
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
-be returned. If the file is not a directory, the %G_FILE_ERROR_NOTDIR
+be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY
error will be returned. Other errors are possible too.
@@ -34720,6 +34934,38 @@ ignore.
</return>
</function>
+<function name="g_file_enumerator_get_child">
+<description>
+Return a new #GFile which refers to the file named by @info in the source
+directory of @enumerator. This function is primarily intended to be used
+inside loops with g_file_enumerator_next_file().
+
+This is a convenience method that's equivalent to:
+|[
+gchar *name = g_file_info_get_name (info);
+GFile *child = g_file_get_child (g_file_enumerator_get_container (enumr),
+name);
+]|
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> a #GFileInfo gotten from g_file_enumerator_next_file()
+or the async equivalents.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile for the #GFileInfo passed it.
+
+</return>
+</function>
+
<function name="g_file_enumerator_get_container">
<description>
Get the #GFile container which is being enumerated.
@@ -35759,6 +36005,26 @@ Gets the file's content type.
</return>
</function>
+<function name="g_file_info_get_deletion_date">
+<description>
+Returns the #GDateTime representing the deletion date of the file, as
+available in G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the
+G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GDateTime, or %NULL.
+
+</return>
+</function>
+
<function name="g_file_info_get_display_name">
<description>
Gets a display name for a file.
@@ -37289,6 +37555,12 @@ If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
+It does not make sense for @flags to contain
+%G_FILE_MONITOR_WATCH_HARD_LINKS, since hard links can not be made to
+directories. It is not possible to monitor all the files in a
+directory for changes made via hard links; if you want to do this then
+you must register individual watches with g_file_monitor().
+
Virtual: monitor_dir
</description>
@@ -37358,6 +37630,14 @@ If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
+If @flags contains %G_FILE_MONITOR_WATCH_HARD_LINKS then the monitor
+will also attempt to report changes made to the file via another
+filename (ie, a hard link). Without this flag, you can only rely on
+changes made through the filename contained in @file to be
+reported. Using this flag may result in an increase in resource
+usage, and may not have any effect depending on the #GFileMonitor
+backend and/or filesystem type.
+
</description>
<parameters>
@@ -37668,6 +37948,38 @@ Free the returned object with g_object_unref().
</return>
</function>
+<function name="g_file_new_for_commandline_arg_and_cwd">
+<description>
+Creates a #GFile with the given argument from the command line.
+
+This function is similar to g_file_new_for_commandline_arg() except
+that it allows for passing the current working directory as an
+argument instead of using the current working directory of the
+process.
+
+This is useful if the commandline argument was given in a context
+other than the invocation of the current process.
+
+See also g_application_command_line_create_file_for_arg().
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="arg">
+<parameter_description> a command line string
+</parameter_description>
+</parameter>
+<parameter name="cwd">
+<parameter_description> the current working directory of the commandline
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile
+
+</return>
+</function>
+
<function name="g_file_new_for_path">
<description>
Constructs a #GFile for a given path. This operation never
@@ -39501,7 +39813,7 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if there was any error, %FALSE otherwise.
+<return> %FALSE if there was any error, %TRUE otherwise.
</return>
</function>
@@ -40976,7 +41288,8 @@ value pairs, and ended by %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
+<return> a newly allocated
+#GObject, or %NULL on error
</return>
</function>
@@ -41014,7 +41327,8 @@ ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
+<return> a newly allocated
+#GObject, or %NULL on error
</return>
</function>
@@ -41051,7 +41365,8 @@ ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
+<return> a newly allocated
+#GObject, or %NULL on error
</return>
</function>
@@ -41242,7 +41557,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">
@@ -41286,7 +41602,8 @@ the number of bytes read into @buffer before the error occurred.
</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">
@@ -41343,7 +41660,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">
@@ -42876,6 +43194,7 @@ Since: 2.34
</parameter>
</parameters>
<return> new #GInputStream read from @bytes
+
</return>
</function>
@@ -43015,6 +43334,19 @@ finalized, or %NULL
</return>
</function>
+<function name="g_memory_output_stream_new_resizable">
+<description>
+Creates a new #GMemoryOutputStream, using g_realloc() and g_free()
+for memory allocation.
+
+Since: 2.36
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_memory_output_stream_steal_as_bytes">
<description>
Returns data from the @ostream as a #GBytes. @ostream must be
@@ -45974,6 +46306,21 @@ Since: 2.26
<return></return>
</function>
+<function name="g_networking_init">
+<description>
+Initializes the platform networking libraries (eg, on Windows, this
+calls WSAStartup()). GLib will call this itself if it is needed, so
+you only need to call it if you directly call system networking
+functions (without calling any GLib networking functions first).
+
+Since: 2.36
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_null_settings_backend_new">
<description>
Creates a readonly #GSettingsBackend.
@@ -51968,6 +52315,92 @@ Since: 2.26
</return>
</function>
+<function name="g_simple_proxy_resolver_new">
+<description>
+Creates a new #GSimpleProxyResolver. See
+#GSimpleProxyResolver:default-proxy and
+#GSimpleProxyResolver:ignore-hosts for more details on how the
+arguments are interpreted.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="default_proxy">
+<parameter_description> the default proxy to use, eg
+"socks://192.168.1.1"
+</parameter_description>
+</parameter>
+<parameter name="ignore_hosts">
+<parameter_description> an optional list of hosts/IP addresses
+to not use a proxy for.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSimpleProxyResolver
+
+</return>
+</function>
+
+<function name="g_simple_proxy_resolver_set_default_proxy">
+<description>
+Sets the default proxy on @resolver, to be used for any URIs that
+don't match #GSimpleProxyResolver:ignore-hosts or a proxy set
+via g_simple_proxy_resolver_set_uri_proxy().
+
+If @default_proxy starts with "<literal>socks://</literal>",
+#GSimpleProxyResolver will treat it as referring to all three of
+the <literal>socks5</literal>, <literal>socks4a</literal>, and
+<literal>socks4</literal> proxy types.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GSimpleProxyResolver
+</parameter_description>
+</parameter>
+<parameter name="default_proxy">
+<parameter_description> the default proxy to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_proxy_resolver_set_uri_proxy">
+<description>
+Adds a URI-scheme-specific proxy to @resolver; URIs whose scheme
+matches @uri_scheme (and which don't match
+#GSimpleProxyResolver:ignore-hosts) will be proxied via @proxy.
+
+As with #GSimpleProxyResolver:default-proxy, if @proxy starts with
+"<literal>socks://</literal>", #GSimpleProxyResolver will treat it
+as referring to all three of the <literal>socks5</literal>,
+<literal>socks4a</literal>, and <literal>socks4</literal> proxy
+types.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GSimpleProxyResolver
+</parameter_description>
+</parameter>
+<parameter name="uri_scheme">
+<parameter_description> the URI scheme to add a proxy for
+</parameter_description>
+</parameter>
+<parameter name="proxy">
+<parameter_description> the proxy to use for @uri_scheme
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_accept">
<description>
Accept incoming connections on a connection-based socket. This removes
@@ -52855,6 +53288,27 @@ Since: 2.22
</return>
</function>
+<function name="g_socket_client_get_proxy_resolver">
+<description>
+Gets the #GProxyResolver being used by @client. Normally, this will
+be the resolver returned by g_proxy_resolver_get_default(), but you
+can override it with g_socket_client_set_proxy_resolver().
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The #GProxyResolver being used by
+ client
+
+</return>
+</function>
+
<function name="g_socket_client_get_socket_type">
<description>
Gets the socket type of the socket client.
@@ -52955,6 +53409,8 @@ proxy server. When enabled (the default), #GSocketClient will use a
#GProxyResolver to determine if a proxy protocol such as SOCKS is
needed, and automatically do the necessary proxy negotiation.
+See also g_socket_client_set_proxy_resolver().
+
Since: 2.26
</description>
@@ -53049,6 +53505,33 @@ Since: 2.22
<return></return>
</function>
+<function name="g_socket_client_set_proxy_resolver">
+<description>
+Overrides the #GProxyResolver used by @client. You can call this if
+you want to use specific proxies, rather than using the system
+default proxy settings.
+
+Note that whether or not the proxy resolver is actually used
+depends on the setting of #GSocketClient:enable-proxy, which is not
+changed by this function (but which is %TRUE by default)
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="proxy_resolver">
+<parameter_description> a #GProxyResolver, or %NULL for the
+default.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_socket_client_set_socket_type">
<description>
Sets the socket type of the socket client.
@@ -54073,6 +54556,56 @@ Since: 2.32
</return>
</function>
+<function name="g_socket_get_option">
+<description>
+Gets the value of an integer-valued option on @socket, as with
+<literal>getsockopt ()</literal>. (If you need to fetch a
+non-integer-valued option, you will need to call
+<literal>getsockopt ()</literal> directly.)
+
+The <link
linkend="gio-gnetworking.h"><literal><gio/gnetworking.h></literal></link>
+header pulls in system headers that will define most of the
+standard/portable socket options. For unusual socket protocols or
+platform-dependent options, you may need to include additional
+headers.
+
+Note that even for socket options that are a single byte in size,
+ value is still a pointer to a #gint variable, not a #guchar;
+g_socket_get_option() will handle the conversion internally.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="level">
+<parameter_description> the "API level" of the option (eg,
<literal>SOL_SOCKET</literal>)
+</parameter_description>
+</parameter>
+<parameter name="optname">
+<parameter_description> the "name" of the option (eg, <literal>SO_BROADCAST</literal>)
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> return location for the option value
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> success or failure. On failure, @error will be set, and
+the system error value (<literal>errno</literal> or
+<literal>WSAGetLastError ()</literal>) will still be set to the
+result of the <literal>getsockopt ()</literal> call.
+
+</return>
+</function>
+
<function name="g_socket_get_protocol">
<description>
Gets the socket protocol id the socket was created with.
@@ -54861,8 +55394,8 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter_description> a buffer to
+read data into (which should be at least @size bytes long).
</parameter_description>
</parameter>
<parameter name="size">
@@ -55056,8 +55589,8 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter_description> a buffer to
+read data into (which should be at least @size bytes long).
</parameter_description>
</parameter>
<parameter name="size">
@@ -55537,6 +56070,52 @@ Since: 2.32
<return></return>
</function>
+<function name="g_socket_set_option">
+<description>
+Sets the value of an integer-valued option on @socket, as with
+<literal>setsockopt ()</literal>. (If you need to set a
+non-integer-valued option, you will need to call
+<literal>setsockopt ()</literal> directly.)
+
+The <link
linkend="gio-gnetworking.h"><literal><gio/gnetworking.h></literal></link>
+header pulls in system headers that will define most of the
+standard/portable socket options. For unusual socket protocols or
+platform-dependent options, you may need to include additional
+headers.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="level">
+<parameter_description> the "API level" of the option (eg,
<literal>SOL_SOCKET</literal>)
+</parameter_description>
+</parameter>
+<parameter name="optname">
+<parameter_description> the "name" of the option (eg, <literal>SO_BROADCAST</literal>)
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set the option to
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> success or failure. On failure, @error will be set, and
+the system error value (<literal>errno</literal> or
+<literal>WSAGetLastError ()</literal>) will still be set to the
+result of the <literal>setsockopt ()</literal> call.
+
+</return>
+</function>
+
<function name="g_socket_set_timeout">
<description>
Sets the time in seconds after which I/O operations on @socket will
@@ -56105,8 +56684,8 @@ Since: 2.36
</parameter_description>
</parameter>
<parameter name="source_object">
-<parameter_description> the source object expected to be
-associated with the task
+<parameter_description> the source object
+expected to be associated with the task
</parameter_description>
</parameter>
</parameters>
@@ -56141,7 +56720,8 @@ Since: 2.36
</description>
<parameters>
<parameter name="source_object">
-<parameter_description> the #GObject that owns this task, or %NULL.
+<parameter_description> the #GObject that owns
+this task, or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -56263,7 +56843,8 @@ Since: 2.36
</description>
<parameters>
<parameter name="source_object">
-<parameter_description> the #GObject that owns this task, or %NULL.
+<parameter_description> the #GObject that owns
+this task, or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
@@ -56303,7 +56884,8 @@ Since: 2.36
</description>
<parameters>
<parameter name="source_object">
-<parameter_description> the #GObject that owns this task, or %NULL.
+<parameter_description> the #GObject that owns
+this task, or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
@@ -58486,8 +59068,8 @@ Since: 2.30
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated list of #GTlsCertificate objects.
-Use g_object_unref() on each certificate, and g_list_free() on the release the list.
+<return> a newly allocated list of #GTlsCertificate
+objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.
</return>
</function>
@@ -62061,6 +62643,243 @@ the sublist occurs and no corresponding @close_func call is made.
<return></return>
</function>
+<function name="handle_created">
+<description>
+A callback function for the directory diff calculation routine,
+produces G_FILE_MONITOR_EVENT_CREATED event for a created file.
+
+</description>
+<parameters>
+<parameter name="udata">
+<parameter_description> a pointer to user data (#handle_context).
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> file name of a new file.
+</parameter_description>
+</parameter>
+<parameter name="inode">
+<parameter_description> inode number of a new file.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="handle_deleted">
+<description>
+A callback function for the directory diff calculation routine,
+produces G_FILE_MONITOR_EVENT_DELETED event for a deleted file.
+
+</description>
+<parameters>
+<parameter name="udata">
+<parameter_description> a pointer to user data (#handle_context).
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> file name of the removed file.
+</parameter_description>
+</parameter>
+<parameter name="inode">
+<parameter_description> inode number of the removed file.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="handle_moved">
+<description>
+A callback function for the directory diff calculation routine,
+produces G_FILE_MONITOR_EVENT_MOVED event on a move.
+
+</description>
+<parameters>
+<parameter name="udata">
+<parameter_description> a pointer to user data (#handle_context).
+</parameter_description>
+</parameter>
+<parameter name="from_path">
+<parameter_description> file name of the source file.
+</parameter_description>
+</parameter>
+<parameter name="from_inode">
+<parameter_description> inode number of the source file.
+</parameter_description>
+</parameter>
+<parameter name="to_path">
+<parameter_description> file name of the replaced file.
+</parameter_description>
+</parameter>
+<parameter name="to_inode">
+<parameter_description> inode number of the replaced file.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="handle_overwritten">
+<description>
+A callback function for the directory diff calculation routine,
+produces G_FILE_MONITOR_EVENT_DELETED/CREATED event pair when
+an overwrite occurs in the directory (see dep-list for details).
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> a pointer to user data (#handle_context).
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> file name of the overwritten file.
+</parameter_description>
+</parameter>
+<parameter name="node">
+<parameter_description> inode number of the overwritten file.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="kevents_extend_sz">
+<description>
+Extends the allocated memory, if needed.
+
+</description>
+<parameters>
+<parameter name="kv">
+<parameter_description> a #kevents
+</parameter_description>
+</parameter>
+<parameter name="n_new">
+<parameter_description> the number of new objects to be added
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="kevents_free">
+<description>
+Resets the kevents object and frees all the associated memory.
+
+</description>
+<parameters>
+<parameter name="kv">
+<parameter_description> a #kevents
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="kevents_init_sz">
+<description>
+Initializes a #kevents object.
+
+</description>
+<parameters>
+<parameter name="kv">
+<parameter_description> a #kevents
+</parameter_description>
+</parameter>
+<parameter name="n_initial">
+<parameter_description> the initial preallocated memory size. If it is less than
+%KEVENTS_EXTEND_COUNT, this value will be used instead.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="kevents_reduce">
+<description>
+Reduces the allocated heap size, if needed.
+
+If the allocated heap size is >= 3*used
+and 2*used >= %KEVENTS_EXTEND_COUNT, reduce it to 2*used.
+
+</description>
+<parameters>
+<parameter name="kv">
+<parameter_description> a #kevents
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="km_scan_missing">
+<description>
+The core missing files watching routine.
+
+Traverses through a list of missing files, tries to start watching each with
+kqueue, removes the appropriate entry and invokes a user callback if the file
+has appeared.
+
+
+</description>
+<parameters>
+<parameter name="user_data">
+<parameter_description> unused
+</parameter_description>
+</parameter>
+</parameters>
+<return> %FALSE if no missing files left, %TRUE otherwise.
+</return>
+</function>
+
+<function name="kqueue_notification">
+<description>
+Represents a pool of (struct kevent) objects.
+
+</description>
+<parameters>
+<parameter name="memory">
+<parameter_description> a pointer to the allocated memory
+</parameter_description>
+</parameter>
+<parameter name="kq_size">
+<parameter_description> the number of used items
+</parameter_description>
+</parameter>
+<parameter name="kq_allocated">
+<parameter_description> the number of allocated items
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="kqueue_sub">
+<description>
+Represents a subscription on a file or directory.
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a name of the file to monitor
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the pointer to user data
+</parameter_description>
+</parameter>
+<parameter name="pair_moves">
+<parameter_description> unused (currently not implemented)
+</parameter_description>
+</parameter>
+<parameter name="fd">
+<parameter_description> the associated file descriptor (used by kqueue)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="mime_info_cache_reload">
<description>
Reload the mime information for the @dir.
@@ -62075,4 +62894,33 @@ Reload the mime information for the @dir.
<return></return>
</function>
+<function name="process_kqueue_notifications">
+<description>
+Processes notifications, coming from the kqueue thread.
+
+Reads notifications from the command file descriptor, emits the
+"changed" event on the appropriate monitor.
+
+A typical GIO Channel callback function.
+
+
+</description>
+<parameters>
+<parameter name="gioc">
+<parameter_description> unused.
+</parameter_description>
+</parameter>
+<parameter name="cond">
+<parameter_description> unused.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> unused.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE
+</return>
+</function>
+
</root>
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 9f8daea..100a025 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -105,6 +105,10 @@ Since: 2.16
<parameter_description> Use the SHA-256 hashing algorithm
</parameter_description>
</parameter>
+<parameter name="G_CHECKSUM_SHA512">
+<parameter_description> Use the SHA-512 hashing algorithm
+</parameter_description>
+</parameter>
</parameters>
</enum>
@@ -6022,7 +6026,9 @@ Since: 2.30
<function name="g_base64_decode">
<description>
-Decode a sequence of Base-64 encoded text into binary data
+Decode a sequence of Base-64 encoded text into binary data. Note
+that the returned binary data is not necessarily zero-terminated,
+so it should not be used as a character string.
Since: 2.12
@@ -8327,7 +8333,8 @@ Since: 2.32
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the byte data
+<return> a pointer to the
+byte data
</return>
</function>
@@ -8384,7 +8391,8 @@ Since: 2.32
</description>
<parameters>
<parameter name="data">
-<parameter_description> the data to be used for the bytes
+<parameter_description>
+the data to be used for the bytes
</parameter_description>
</parameter>
<parameter name="size">
@@ -8438,7 +8446,8 @@ Since: 2.32
</description>
<parameters>
<parameter name="data">
-<parameter_description> the data to be used for the bytes
+<parameter_description>
+ the data to be used for the bytes
</parameter_description>
</parameter>
<parameter name="size">
@@ -8469,7 +8478,8 @@ Since: 2.32
</description>
<parameters>
<parameter name="data">
-<parameter_description> the data to be used for the bytes
+<parameter_description>
+ the data to be used for the bytes
</parameter_description>
</parameter>
<parameter name="size">
@@ -10177,6 +10187,30 @@ Since: 2.34
<return></return>
</function>
+<function name="g_close">
+<description>
+This wraps the close() call; in case of error, %errno will be
+preserved, but the error will also be stored as a #GError in @error.
+
+Besides using #GError, there is another major reason to prefer this
+function over the call provided by the system; on Unix, it will
+attempt to correctly handle %EINTR, which has platform-specific
+semantics.
+
+</description>
+<parameters>
+<parameter name="fd">
+<parameter_description> A file descriptor
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_closure_add_finalize_notifier">
<description>
Registers a finalization notifier which will be called when the
@@ -11105,6 +11139,8 @@ Deprecated:2.32: Use g_cond_wait_until() instead.
<function name="g_cond_wait">
<description>
Atomically releases @mutex and waits until @cond is signalled.
+When this function returns, @mutex is locked again and owned by the
+calling thread.
When using condition variables, it is possible that a spurious wakeup
may occur (ie: g_cond_wait() returns even though g_cond_signal() was
@@ -13267,7 +13303,7 @@ than @dt2.
<description>
Calculates the difference in time between @end and @begin. The
#GTimeSpan that is returned is effectively @end - @begin (ie:
-positive if the first simparameter is larger).
+positive if the first parameter is larger).
Since: 2.26
@@ -16441,31 +16477,31 @@ Since: 2.6
<function name="g_get_home_dir">
<description>
-Gets the current user's home directory as defined in the
-password database.
-
-Note that in contrast to traditional UNIX tools, this function
-prefers <filename>passwd</filename> entries over the <envar>HOME</envar>
-environment variable.
-
-One of the reasons for this decision is that applications in many
-cases need special handling to deal with the case where
-<envar>HOME</envar> is
-<simplelist>
-<member>Not owned by the user</member>
-<member>Not writeable</member>
-<member>Not even readable</member>
-</simplelist>
-Since applications are in general <emphasis>not</emphasis> written
-to deal with these situations it was considered better to make
-g_get_home_dir() not pay attention to <envar>HOME</envar> and to
-return the real home directory for the user. If applications
-want to pay attention to <envar>HOME</envar>, they can do:
-|[
-const char *homedir = g_getenv ("HOME");
-if (!homedir)
-homedir = g_get_home_dir (<!-- -->);
-]|
+Gets the current user's home directory.
+
+As with most UNIX tools, this function will return the value of the
+<envar>HOME</envar> environment variable if it is set to an existing
+absolute path name, falling back to the <filename>passwd</filename>
+file in the case that it is unset.
+
+If the path given in <envar>HOME</envar> is non-absolute, does not
+exist, or is not a directory, the result is undefined.
+
+<note><para>
+Before version 2.36 this function would ignore the
+<envar>HOME</envar> environment variable, taking the value from the
+<filename>passwd</filename> database instead. This was changed to
+increase the compatibility of GLib with other programs (and the XDG
+basedir specification) and to increase testability of programs
+based on GLib (by making it easier to run them from test
+frameworks).
+</para><para>
+If your program has a strong requirement for either the new or the
+old behaviour (and if you don't wish to increase your GLib
+dependency to ensure that the new behaviour is in effect) then you
+should either directly check the <envar>HOME</envar> environment
+variable yourself or unset it before calling any functions in GLib.
+</para></note>
</description>
@@ -16583,6 +16619,23 @@ Since: 2.28
</return>
</function>
+<function name="g_get_num_processors">
+<description>
+Determine the approximate number of threads that the system will
+schedule simultaneously for this process. This is intended to be
+used as a parameter to g_thread_pool_new() for CPU bound tasks and
+similar cases.
+
+Since: 2.36
+
+</description>
+<parameters>
+</parameters>
+<return> Number of schedulable threads, always greater than 0
+
+</return>
+</function>
+
<function name="g_get_prgname">
<description>
Gets the name of the program. This name should <emphasis>not</emphasis>
@@ -17109,8 +17162,8 @@ release of GLib. It does nothing.
<function name="g_hash_table_get_keys">
<description>
-Retrieves every key inside @hash_table. The returned data
-is valid until @hash_table is modified.
+Retrieves every key inside @hash_table. The returned data is valid
+until changes to the hash release those keys.
Since: 2.14
@@ -22083,9 +22136,9 @@ If none of the elements contain the data, the #GList is unchanged.
<function name="g_list_remove_all">
<description>
-Removes all list nodes with data equal to @data.
-Returns the new head of the list. Contrast with
-g_list_remove() which removes only the first node
+Removes all list nodes with data equal to @data.
+Returns the new head of the list. Contrast with
+g_list_remove() which removes only the first node
matching the given data.
@@ -22633,7 +22686,7 @@ this thread is now the owner of @context.
<description>
Adds a file descriptor to the set of file descriptors polled for
this context. This will very seldom be used directly. Instead
-a typical event source will use g_source_add_poll() instead.
+a typical event source will use g_source_add_unix_fd() instead.
</description>
<parameters>
@@ -24415,6 +24468,41 @@ Since: 2.18
<return></return>
</function>
+<function name="g_markup_parse_context_ref">
+<description>
+Increases the reference count of @context.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GMarkupParseContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> the same @context
+
+</return>
+</function>
+
+<function name="g_markup_parse_context_unref">
+<description>
+Decreases the reference count of @context. When its reference count
+drops to 0, it is freed.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GMarkupParseContext
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_markup_printf_escaped">
<description>
Formats arguments according to @format, escaping
@@ -30354,8 +30442,8 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="default_value">
-<parameter_description> a #GVariant of type @type to use as the
-default value, or %NULL
+<parameter_description> a #GVariant of type @type to
+use as the default value, or %NULL
</parameter_description>
</parameter>
<parameter name="flags">
@@ -35738,7 +35826,8 @@ Since: 2.28
</parameter>
</parameters>
<return> an #GSequenceIter pointing to the position of the
-first item found equal to @data according to @cmp_func and @cmp_data.
+first item found equal to @data according to @cmp_func and
+ cmp_data, or %NULL if no such item exists.
</return>
</function>
@@ -35784,7 +35873,7 @@ Since: 2.28
</parameters>
<return> an #GSequenceIter pointing to the position of
the first item found equal to @data according to @cmp_func
-and @cmp_data.
+and @cmp_data, or %NULL if no such item exists.
</return>
</function>
@@ -36837,7 +36926,7 @@ This is similar to g_signal_connect_data(), but uses a closure which
ensures that the @gobject stays alive during the call to @c_handler
by temporarily adding a reference count to @gobject.
-When the object is destroyed the signal handler will be automatically
+When the @gobject is destroyed the signal handler will be automatically
disconnected. Note that this is not currently threadsafe (ie:
emitting a signal while @gobject is being destroyed in another thread
is not safe).
@@ -39108,6 +39197,10 @@ event source. The event source's check function will typically test
the @revents field in the #GPollFD struct and return %TRUE if events need
to be processed.
+Using this API forces the linear scanning of event sources on each
+main loop iteration. Newly-written event sources should try to use
+g_source_add_unix_fd() instead of this API.
+
</description>
<parameters>
<parameter name="source">
@@ -39123,6 +39216,41 @@ descriptor to watch.
<return></return>
</function>
+<function name="g_source_add_unix_fd">
+<description>
+Monitors @fd for the IO events in @events.
+
+The tag returned by this function can be used to remove or modify the
+monitoring of the fd using g_source_remove_unix_fd() or
+g_source_modify_unix_fd().
+
+It is not necessary to remove the fd before destroying the source; it
+will be cleaned up automatically.
+
+As the name suggests, this function is not available on Windows.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+<parameter name="fd">
+<parameter_description> the fd to monitor
+</parameter_description>
+</parameter>
+<parameter name="events">
+<parameter_description> an event mask
+</parameter_description>
+</parameter>
+</parameters>
+<return> an opaque tag
+
+</return>
+</function>
+
<function name="g_source_attach">
<description>
Adds a #GSource to a @context so that it will be executed within
@@ -39278,6 +39406,26 @@ Gets the priority of a source.
</return>
</function>
+<function name="g_source_get_ready_time">
+<description>
+Gets the "ready time" of @source, as set by
+g_source_set_ready_time().
+
+Any time before the current monotonic time (including 0) is an
+indication that the source will fire immediately.
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+</parameters>
+<return> the monotonic ready time, -1 for "never"
+</return>
+</function>
+
<function name="g_source_get_time">
<description>
Gets the time to be used when checking this source. The advantage of
@@ -39379,6 +39527,37 @@ Since: 2.12
</return>
</function>
+<function name="g_source_modify_unix_fd">
+<description>
+Updates the event mask to watch for the fd identified by @tag.
+
+ tag is the tag returned from g_source_add_unix_fd().
+
+If you want to remove a fd, don't set its event mask to zero.
+Instead, call g_source_remove_unix_fd().
+
+As the name suggests, this function is not available on Windows.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+<parameter name="tag">
+<parameter_description> the tag from g_source_add_unix_fd()
+</parameter_description>
+</parameter>
+<parameter name="new_events">
+<parameter_description> the new event mask to watch
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_source_new">
<description>
Creates a new #GSource structure. The size is specified to
@@ -39407,6 +39586,34 @@ the sources behavior.
</return>
</function>
+<function name="g_source_query_unix_fd">
+<description>
+Queries the events reported for the fd corresponding to @tag on
+ source during the last poll.
+
+The return value of this function is only defined when the function
+is called from the check or dispatch functions for @source.
+
+As the name suggests, this function is not available on Windows.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+<parameter name="tag">
+<parameter_description> the tag from g_source_add_unix_fd()
+</parameter_description>
+</parameter>
+</parameters>
+<return> the conditions reported on the fd
+
+</return>
+</function>
+
<function name="g_source_ref">
<description>
Increases the reference count on a source by one.
@@ -39527,6 +39734,32 @@ this source.
<return></return>
</function>
+<function name="g_source_remove_unix_fd">
+<description>
+Reverses the effect of a previous call to g_source_add_unix_fd().
+
+You only need to call this if you want to remove an fd from being
+watched while keeping the same source around. In the normal case you
+will just want to destroy the source.
+
+As the name suggests, this function is not available on Windows.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+<parameter name="tag">
+<parameter_description> the tag from g_source_add_unix_fd()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_source_set_callback">
<description>
Sets the callback function for a source. The callback for a source is
@@ -39750,6 +39983,42 @@ dispatched.
<return></return>
</function>
+<function name="g_source_set_ready_time">
+<description>
+Sets a #GSource to be dispatched when the given monotonic time is
+reached (or passed). If the monotonic time is in the past (as it
+always will be if @ready_time is 0) then the source will be
+dispatched immediately.
+
+If @ready_time is -1 then the source is never woken up on the basis
+of the passage of time.
+
+Dispatching the source does not reset the ready time. You should do
+so yourself, from the source dispatch function.
+
+Note that if you have a pair of sources where the ready time of one
+suggests that it will be delivered first but the priority for the
+other suggests that it would be delivered first, and the ready time
+for both sources is reached during the same main context iteration
+then the order of dispatch is undefined.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSource
+</parameter_description>
+</parameter>
+<parameter name="ready_time">
+<parameter_description> the monotonic time at which the source will be ready,
+0 for "immediately", -1 for "never"
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_source_unref">
<description>
Decreases the reference count of a source by one. If the
@@ -40382,7 +40651,7 @@ freed, you should also free the #GStaticMutex.
<note><para>Calling g_static_mutex_free() on a locked mutex may
result in undefined behaviour.</para></note>
-Deprecated: 2.32: Use g_mutex_free()
+Deprecated: 2.32: Use g_mutex_clear()
</description>
<parameters>
@@ -42573,9 +42842,10 @@ locale-sensitive, and it's broken if your string is localized, since
it doesn't work on many encodings at all, including UTF-8, EUC-JP,
etc.
-There are therefore two replacement functions: g_ascii_strncasecmp(),
+There are therefore two replacement techniques: g_ascii_strncasecmp(),
which only works on ASCII and is not locale-sensitive, and
-g_utf8_casefold(), which is good for case-insensitive sorting of UTF-8.
+g_utf8_casefold() followed by strcmp() on the resulting strings, which is
+good for case-insensitive sorting of UTF-8.
</description>
<parameters>
@@ -43212,7 +43482,7 @@ For example:
* /
g_test_expect_message (G_LOG_DOMAIN,
G_LOG_LEVEL_CRITICAL,
-"assertion.*acquired_context.*failed");
+"assertion*acquired_context*failed");
g_main_context_push_thread_default (bad_context);
g_test_assert_expected_messages ();
]|
@@ -43382,6 +43652,20 @@ Any parameters understood by g_test_init() stripped before return.
<return></return>
</function>
+<function name="g_test_initialized">
+<description>
+Returns %TRUE if g_test_init() has been called.
+
+Since: 2.36
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if g_test_init() has been called.
+
+</return>
+</function>
+
<function name="g_test_log_buffer_free">
<description>
Internal function for gtester to free test log messages, no ABI guarantees provided.
@@ -45123,20 +45407,50 @@ Creates a #GTimeZone corresponding to @identifier.
something that would pass as a valid value for the
<varname>TZ</varname> environment variable (including %NULL).
+In Windows, @identifier can also be the unlocalized name of a time
+zone for standard time, for example "Pacific Standard Time".
+
Valid RFC3339 time offsets are <literal>"Z"</literal> (for UTC) or
<literal>"±hh:mm"</literal>. ISO 8601 additionally specifies
-<literal>"±hhmm"</literal> and <literal>"±hh"</literal>.
-
-The <varname>TZ</varname> environment variable typically corresponds
-to the name of a file in the zoneinfo database, but there are many
-other possibilities. Note that those other possibilities are not
-currently implemented, but are planned.
+<literal>"±hhmm"</literal> and <literal>"±hh"</literal>.
Offsets are
+time values to be added to Coordinated Universal Time (UTC) to get
+the local time.
+
+In Unix, the <varname>TZ</varname> environment variable typically
+corresponds to the name of a file in the zoneinfo database, or
+string in "std offset [dst [offset],start[/time],end[/time]]"
+(POSIX) format. There are no spaces in the specification. The
+name of standard and daylight savings time zone must be three or more
+alphabetic characters. Offsets are time values to be added to local
+time to get Coordinated Universal Time (UTC) and should be
+<literal>"[±]hh[[:]mm[:ss]]"</literal>. Dates are either
+<literal>"Jn"</literal> (Julian day with n between 1 and 365, leap
+years not counted), <literal>"n"</literal> (zero-based Julian day
+with n between 0 and 365) or <literal>"Mm.w.d"</literal> (day d
+(0 <= d <= 6) of week w (1 <= w <= 5) of month m (1 <= m <= 12), day
+0 is a Sunday). Times are in local wall clock time, the default is
+02:00:00.
+
+In Windows, the "tzn[+|–]hh[:mm[:ss]][dzn]" format is used, but also
+accepts POSIX format. The Windows format uses US rules for all time
+zones; daylight savings time is 60 minutes behind the standard time
+with date and time of change taken from Pacific Standard Time.
+Offsets are time values to be added to the local time to get
+Coordinated Universal Time (UTC).
g_time_zone_new_local() calls this function with the value of the
<varname>TZ</varname> environment variable. This function itself is
independent of the value of <varname>TZ</varname>, but if @identifier
is %NULL then <filename>/etc/localtime</filename> will be consulted
-to discover the correct timezone.
+to discover the correct time zone on Unix and the registry will be
+consulted or GetTimeZoneInformation() will be used to get the local
+time zone on Windows.
+
+If intervals are not available, only time zone rules from
+<varname>TZ</varname> environment variable or other means, then they
+will be computed from year 1900 to 2037. If the maximum year for the
+rules is available and it is greater than 2037, then it will followed
+instead.
See <ulink
url='http://tools.ietf.org/html/rfc3339#section-5.6'>RFC3339
@@ -45145,7 +45459,10 @@ url='http://tools.ietf.org/html/rfc3339#section-5.6'>RFC3339
full list of valid time offsets. See <ulink
url='http://www.gnu.org/s/libc/manual/html_node/TZ-Variable.html'>The
GNU C Library manual</ulink> for an explanation of the possible
-values of the <varname>TZ</varname> environment variable.
+values of the <varname>TZ</varname> environment variable. See <ulink
+url='http://msdn.microsoft.com/en-us/library/ms912391%28v=winembedded.11%29.aspx'>
+Microsoft Time Zone Index Values</ulink> for the list of time zones
+on Windows.
You should release the return value by calling g_time_zone_unref()
when you are done with it.
@@ -46550,7 +46867,7 @@ sequentially in the same memory block as the public
structures.
Note that the accumulated size of the private structures of
-a type and all its parent types cannot excced 64 KiB.
+a type and all its parent types cannot exceed 64 KiB.
This function should be called in the type's class_init() function.
The private structure can be retrieved using the
@@ -47004,6 +47321,24 @@ be retrieved from a subtype using g_type_get_qdata().
</return>
</function>
+<function name="g_type_get_type_registration_serial">
+<description>
+Returns an opaque serial number that represents the state of the set of registered
+types. Any time a type is registred this serial changes, which means you can
+cache information based on type lookups (such as g_type_from_name) and know if
+the cache is still valid at a later time by comparing the current serial with
+the one at the type lookup.
+
+Since: 2.36
+
+
+</description>
+<parameters>
+</parameters>
+<return> An unsigned int, representing the state of type registrations.
+</return>
+</function>
+
<function name="g_type_init">
<description>
This function used to initialise the type system. Since GLib 2.36,
@@ -48716,6 +49051,116 @@ ISO 15924 code 'Zzzz' (script code for UNKNOWN) if @script is not understood.
</return>
</function>
+<function name="g_unix_fd_add">
+<description>
+Sets a function to be called when the IO condition, as specified by
+ condition becomes true for @fd.
+
+ function will be called when the specified IO condition becomes
+%TRUE. The function is expected to clear whatever event caused the
+IO condition to become true and return %TRUE in order to be notified
+when it happens again. If @function returns %FALSE then the watch
+will be cancelled.
+
+The return value of this function can be passed to g_source_remove()
+to cancel the watch at any time that it exists.
+
+The source will never close the fd -- you must do it yourself.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="fd">
+<parameter_description> a file descriptor
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> IO conditions to watch for on @fd
+</parameter_description>
+</parameter>
+<parameter name="function">
+<parameter_description> a #GPollFDFunc
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @function
+</parameter_description>
+</parameter>
+</parameters>
+<return> the ID (greater than 0) of the event source
+
+</return>
+</function>
+
+<function name="g_unix_fd_add_full">
+<description>
+Sets a function to be called when the IO condition, as specified by
+ condition becomes true for @fd.
+
+This is the same as g_unix_fd_add(), except that it allows you to
+specify a non-default priority and a provide a #GDestroyNotify for
+ user_data
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="priority">
+<parameter_description> the priority of the source
+</parameter_description>
+</parameter>
+<parameter name="fd">
+<parameter_description> a file descriptor
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> IO conditions to watch for on @fd
+</parameter_description>
+</parameter>
+<parameter name="function">
+<parameter_description> a #GUnixFDSourceFunc
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @function
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to call when the idle is removed, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the ID (greater than 0) of the event source
+
+</return>
+</function>
+
+<function name="g_unix_fd_source_new">
+<description>
+Creates a #GSource to watch for a particular IO condition on a file
+descriptor.
+
+The source will never close the fd -- you must do it yourself.
+
+Since: 2.36
+
+</description>
+<parameters>
+<parameter name="fd">
+<parameter_description> a file descriptor
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> IO conditions to watch for on @fd
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #GSource
+
+</return>
+</function>
+
<function name="g_unix_open_pipe">
<description>
Similar to the UNIX pipe() call, but on modern systems like Linux
@@ -54632,6 +55077,7 @@ avoid this situation.
Makes a copy of a #GVariantType. It is appropriate to call
g_variant_type_free() on the return value. @type may not be %NULL.
+Since 2.24
</description>
<parameters>
@@ -54642,7 +55088,6 @@ g_variant_type_free() on the return value. @type may not be %NULL.
</parameters>
<return> a new #GVariantType
-Since 2.24
</return>
</function>
@@ -54652,6 +55097,7 @@ Returns a newly-allocated copy of the type string corresponding to
@type. The returned string is nul-terminated. It is appropriate to
call g_free() on the return value.
+Since 2.24
</description>
<parameters>
@@ -54662,7 +55108,6 @@ call g_free() on the return value.
</parameters>
<return> the corresponding type string
-Since 2.24
</return>
</function>
@@ -54672,6 +55117,7 @@ Determines the element type of an array or maybe type.
This function may only be used with array or maybe types.
+Since 2.24
</description>
<parameters>
@@ -54682,7 +55128,6 @@ This function may only be used with array or maybe types.
</parameters>
<return> the element type of @type
-Since 2.24
</return>
</function>
@@ -54699,6 +55144,7 @@ The argument types of @type1 and @type2 are only #gconstpointer to
allow use with #GHashTable without function pointer casting. For
both arguments, a valid #GVariantType must be provided.
+Since 2.24
</description>
<parameters>
@@ -54713,7 +55159,6 @@ both arguments, a valid #GVariantType must be provided.
</parameters>
<return> %TRUE if @type1 and @type2 are exactly equal
-Since 2.24
</return>
</function>
@@ -54734,6 +55179,7 @@ the key.
This call, together with g_variant_type_next() provides an iterator
interface over tuple and dictionary entry types.
+Since 2.24
</description>
<parameters>
@@ -54744,7 +55190,6 @@ interface over tuple and dictionary entry types.
</parameters>
<return> the first item type of @type, or %NULL
-Since 2.24
</return>
</function>
@@ -54774,6 +55219,7 @@ Returns the length of the type string corresponding to the given
@type. This function must be used to determine the valid extent of
the memory region returned by g_variant_type_peek_string().
+Since 2.24
</description>
<parameters>
@@ -54784,7 +55230,6 @@ the memory region returned by g_variant_type_peek_string().
</parameters>
<return> the length of the corresponding type string
-Since 2.24
</return>
</function>
@@ -54796,6 +55241,7 @@ The argument type of @type is only #gconstpointer to allow use with
#GHashTable without function pointer casting. A valid
#GVariantType must be provided.
+Since 2.24
</description>
<parameters>
@@ -54806,7 +55252,6 @@ The argument type of @type is only #gconstpointer to allow use with
</parameters>
<return> the hash value
-Since 2.24
</return>
</function>
@@ -54819,6 +55264,7 @@ This function returns %TRUE for any indefinite type for which every
definite subtype is an array type -- %G_VARIANT_TYPE_ARRAY, for
example.
+Since 2.24
</description>
<parameters>
@@ -54829,7 +55275,6 @@ example.
</parameters>
<return> %TRUE if @type is an array type
-Since 2.24
</return>
</function>
@@ -54845,6 +55290,7 @@ Only a basic type may be used as the key of a dictionary entry.
This function returns %FALSE for all indefinite types except
%G_VARIANT_TYPE_BASIC.
+Since 2.24
</description>
<parameters>
@@ -54855,7 +55301,6 @@ This function returns %FALSE for all indefinite types except
</parameters>
<return> %TRUE if @type is a basic type
-Since 2.24
</return>
</function>
@@ -54870,6 +55315,7 @@ This function returns %TRUE for any indefinite type for which every
definite subtype is a container -- %G_VARIANT_TYPE_ARRAY, for
example.
+Since 2.24
</description>
<parameters>
@@ -54880,7 +55326,6 @@ example.
</parameters>
<return> %TRUE if @type is a container type
-Since 2.24
</return>
</function>
@@ -54897,6 +55342,7 @@ result in %TRUE being returned. Calling this function on an
indefinite type like %G_VARIANT_TYPE_ARRAY, however, will result in
%FALSE being returned.
+Since 2.24
</description>
<parameters>
@@ -54907,7 +55353,6 @@ indefinite type like %G_VARIANT_TYPE_ARRAY, however, will result in
</parameters>
<return> %TRUE if @type is definite
-Since 2.24
</return>
</function>
@@ -54920,6 +55365,7 @@ This function returns %TRUE for any indefinite type for which every
definite subtype is a dictionary entry type --
%G_VARIANT_TYPE_DICT_ENTRY, for example.
+Since 2.24
</description>
<parameters>
@@ -54930,7 +55376,6 @@ definite subtype is a dictionary entry type --
</parameters>
<return> %TRUE if @type is a dictionary entry type
-Since 2.24
</return>
</function>
@@ -54943,6 +55388,7 @@ This function returns %TRUE for any indefinite type for which every
definite subtype is a maybe type -- %G_VARIANT_TYPE_MAYBE, for
example.
+Since 2.24
</description>
<parameters>
@@ -54953,7 +55399,6 @@ example.
</parameters>
<return> %TRUE if @type is a maybe type
-Since 2.24
</return>
</function>
@@ -54965,6 +55410,7 @@ This function returns %TRUE if @type is a subtype of @supertype. All
types are considered to be subtypes of themselves. Aside from that,
only indefinite types can have subtypes.
+Since 2.24
</description>
<parameters>
@@ -54979,7 +55425,6 @@ only indefinite types can have subtypes.
</parameters>
<return> %TRUE if @type is a subtype of @supertype
-Since 2.24
</return>
</function>
@@ -54993,6 +55438,7 @@ This function returns %TRUE for any indefinite type for which every
definite subtype is a tuple type -- %G_VARIANT_TYPE_TUPLE, for
example.
+Since 2.24
</description>
<parameters>
@@ -55003,7 +55449,6 @@ example.
</parameters>
<return> %TRUE if @type is a tuple type
-Since 2.24
</return>
</function>
@@ -55011,6 +55456,7 @@ Since 2.24
<description>
Determines if the given @type is the variant type.
+Since 2.24
</description>
<parameters>
@@ -55021,7 +55467,6 @@ Determines if the given @type is the variant type.
</parameters>
<return> %TRUE if @type is the variant type
-Since 2.24
</return>
</function>
@@ -55033,6 +55478,7 @@ This function may only be used with a dictionary entry type. Other
than the additional restriction, this call is equivalent to
g_variant_type_first().
+Since 2.24
</description>
<parameters>
@@ -55043,7 +55489,6 @@ g_variant_type_first().
</parameters>
<return> the key type of the dictionary entry
-Since 2.24
</return>
</function>
@@ -55059,6 +55504,7 @@ but must not be used with the generic tuple type
In the case of a dictionary entry type, this function will always
return 2.
+Since 2.24
</description>
<parameters>
@@ -55069,7 +55515,6 @@ return 2.
</parameters>
<return> the number of items in @type
-Since 2.24
</return>
</function>
@@ -55103,6 +55548,7 @@ type @type.
It is appropriate to call g_variant_type_free() on the return value.
+Since 2.24
</description>
<parameters>
@@ -55113,7 +55559,6 @@ It is appropriate to call g_variant_type_free() on the return value.
</parameters>
<return> a new array #GVariantType
-Since 2.24
</return>
</function>
@@ -55124,6 +55569,7 @@ of type @key and a value of type @value.
It is appropriate to call g_variant_type_free() on the return value.
+Since 2.24
</description>
<parameters>
@@ -55138,7 +55584,6 @@ It is appropriate to call g_variant_type_free() on the return value.
</parameters>
<return> a new dictionary entry #GVariantType
-Since 2.24
</return>
</function>
@@ -55149,6 +55594,7 @@ type @type or Nothing.
It is appropriate to call g_variant_type_free() on the return value.
+Since 2.24
</description>
<parameters>
@@ -55159,7 +55605,6 @@ It is appropriate to call g_variant_type_free() on the return value.
</parameters>
<return> a new maybe #GVariantType
-Since 2.24
</return>
</function>
@@ -55172,6 +55617,7 @@ Constructs a new tuple type, from @items.
It is appropriate to call g_variant_type_free() on the return value.
+Since 2.24
</description>
<parameters>
@@ -55186,7 +55632,6 @@ It is appropriate to call g_variant_type_free() on the return value.
</parameters>
<return> a new tuple #GVariantType
-Since 2.24
</return>
</function>
@@ -55204,6 +55649,7 @@ entry then this call returns %NULL.
For tuples, %NULL is returned when @type is the last item in a tuple.
+Since 2.24
</description>
<parameters>
@@ -55214,7 +55660,6 @@ For tuples, %NULL is returned when @type is the last item in a tuple.
</parameters>
<return> the next #GVariantType after @type, or %NULL
-Since 2.24
</return>
</function>
@@ -55226,6 +55671,7 @@ must call g_variant_type_get_string_length().
To get a nul-terminated string, see g_variant_type_dup_string().
+Since 2.24
</description>
<parameters>
@@ -55236,7 +55682,6 @@ To get a nul-terminated string, see g_variant_type_dup_string().
</parameters>
<return> the corresponding type string (not nul-terminated)
-Since 2.24
</return>
</function>
@@ -55246,6 +55691,7 @@ Checks if @type_string is a valid GVariant type string. This call is
equivalent to calling g_variant_type_string_scan() and confirming
that the following character is a nul terminator.
+Since 2.24
</description>
<parameters>
@@ -55256,7 +55702,6 @@ that the following character is a nul terminator.
</parameters>
<return> %TRUE if @type_string is exactly one valid type string
-Since 2.24
</return>
</function>
@@ -55304,6 +55749,7 @@ Determines the value type of a dictionary entry type.
This function may only be used with a dictionary entry type.
+Since 2.24
</description>
<parameters>
@@ -55314,7 +55760,6 @@ This function may only be used with a dictionary entry type.
</parameters>
<return> the value type of the dictionary entry
-Since 2.24
</return>
</function>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
