[glibmm] Regenerate XML docs for glibmm and giomm.
- From: Josà Alburquerque <jaalburqu src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Regenerate XML docs for glibmm and giomm.
- Date: Tue, 14 Feb 2012 17:38:51 +0000 (UTC)
commit fd8efdc63640e9a8c8b478f0fab634c502825d2f
Author: Josà Alburquerque <jaalburqu svn gnome org>
Date: Tue Feb 14 11:30:55 2012 -0500
Regenerate XML docs for glibmm and giomm.
* gio/src/gio_docs.xml:
* glib/src/glib_docs.xml: Regenerate these, now including the signal
docs so that gmmproc can include their docs in the source generation
process.
ChangeLog | 9 +
gio/src/gio_docs.xml |56240 ++++++++++++++++++++++++++++++++++--------------
glib/src/glib_docs.xml |14658 ++++++++++----
3 files changed, 50748 insertions(+), 20159 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index d62ac17..8e18c99 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2012-02-14 Josà Alburquerque <jaalburquerque gmail com>
+
+ Regenerate XML docs for glibmm and giomm.
+
+ * gio/src/gio_docs.xml:
+ * glib/src/glib_docs.xml: Regenerate these, now including the signal
+ docs so that gmmproc can include their docs in the source generation
+ process.
+
2.31.16.1:
2012-02-13 Josà Alburquerque <jaalburquerque gmail com>
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 4026738..b33bf2a 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -1,2863 +1,3412 @@
<root>
-<function name="fen_add">
+<signal name="ExampleAnimal::handle-poke">
<description>
-Won't hold a ref, we have a timout callback to clean unused node_t.
-If there is no value for a key, add it and return it; else return the old
-one.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus method.
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call example_animal_complete_poke() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-<function name="fen_init">
-<description>
-FEN subsystem initializing.
+Since: 2.30
</description>
<parameters>
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_make_sad">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_make_happy">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
-<function name="g_action_activate">
+</return>
+</signal>
+
+<signal name="ExampleAnimal::jumped">
<description>
-Activates the action.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped">"Jumped"</link> is received.
- parameter must be the correct type of parameter for the action (ie:
-the parameter type given at construction time). If the parameter
-type was %NULL then @parameter must also be %NULL.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
</parameter_description>
</parameter>
-<parameter name="parameter">
-<parameter_description> the parameter to the activation
+<parameter name="arg_height">
+<parameter_description> Argument.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_action_get_enabled">
+<signal name="FooiGenAuthorize::handle-check-authorized">
<description>
-Checks if @action is currently enabled.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Authorize.CheckAuthorized">CheckAuthorized()</link> D-Bus method.
-An action must be enabled in order to be activated or in order to
-have its state changed from outside callers.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_authorize_complete_check_authorized() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> whether the action is enabled
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_get_name">
+<signal name="FooiGenAuthorize::handle-check-not-authorized">
<description>
-Queries the name of @action.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorized">CheckNotAuthorized()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_authorize_complete_check_not_authorized() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the name of the action
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_get_parameter_type">
+<signal name="FooiGenAuthorize::handle-check-not-authorized-from-object">
<description>
-Queries the type of the parameter that must be given when activating
- action
-
-When activating the action using g_action_activate(), the #GVariant
-given to that function must be of the type returned by this function.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorizedFromObject">CheckNotAuthorizedFromObject()</link> D-Bus method.
-In the case that this function returns %NULL, you must not give any
-#GVariant, but %NULL instead.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_authorize_complete_check_not_authorized_from_object() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the parameter type
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_get_state">
+<signal name="FooiGenBar::another-signal">
<description>
-Queries the current state of @action.
-
-If the action is not stateful then %NULL will be returned. If the
-action is stateful then the type of the return value is the type
-given by g_action_get_state_type().
-
-The return value (if non-%NULL) should be freed with
-g_variant_unref() when it is no longer required.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-project-Bar.AnotherSignal">"AnotherSignal"</link> is received.
-Since: 2.28
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="arg_word">
+<parameter_description> Argument.
</parameter_description>
</parameter>
</parameters>
-<return> the current state of the action
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_action_get_state_hint">
+<signal name="FooiGenBar::handle-hello-world">
<description>
-Requests a hint about the valid range of values for the state of
- action
-
-If %NULL is returned it either means that the action is not stateful
-or that there is no hint about the valid range of values for the
-state of the action.
-
-If a #GVariant array is returned then each item in the array is a
-possible value for the state. If a #GVariant pair (ie: two-tuple) is
-returned then the tuple specifies the inclusive lower and upper bound
-of valid values for the state.
-
-In any case, the information is merely a hint. It may be possible to
-have a state value outside of the hinted range and setting a value
-within the range may fail.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.HelloWorld">HelloWorld()</link> D-Bus method.
-The return value (if non-%NULL) should be freed with
-g_variant_unref() when it is no longer required.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_hello_world() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_greeting">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return> the state range hint
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_get_state_type">
+<signal name="FooiGenBar::handle-property-cancellation">
<description>
-Queries the type of the state of @action.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.PropertyCancellation">PropertyCancellation()</link> D-Bus method.
-If the action is stateful (ie: was created with
-g_action_new_stateful()) then this function returns the #GVariantType
-of the state. This is the type of the initial value given as the
-state. All calls to g_action_set_state() must give a #GVariant of
-this type and g_action_get_state() will return a #GVariant of the
-same type.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_property_cancellation() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-If the action is not stateful (ie: created with g_action_new()) then
-this function will return %NULL. In that case, g_action_get_state()
-will return %NULL and you must not call g_action_set_state().
-
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the state type, if the action is stateful
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_group_action_added">
+<signal name="FooiGenBar::handle-request-multi-property-mods">
<description>
-Emits the #GActionGroup::action-added signal on @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.RequestMultiPropertyMods">RequestMultiPropertyMods()</link> D-Bus method.
-This function should only be called by #GActionGroup implementations.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_request_multi_property_mods() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of an action in the group
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_action_group_action_enabled_changed">
+<signal name="FooiGenBar::handle-request-signal-emission">
<description>
-Emits the #GActionGroup::action-enabled-changed signal on @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.RequestSignalEmission">RequestSignalEmission()</link> D-Bus method.
-This function should only be called by #GActionGroup implementations.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_request_signal_emission() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of an action in the group
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="enabled">
-<parameter_description> whether or not the action is now enabled
+<parameter name="arg_which_one">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_action_group_action_removed">
+<signal name="FooiGenBar::handle-test-non-primitive-types">
<description>
-Emits the #GActionGroup::action-removed signal on @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.TestNonPrimitiveTypes">TestNonPrimitiveTypes()</link> D-Bus method.
-This function should only be called by #GActionGroup implementations.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_test_non_primitive_types() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of an action in the group
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_dict_s_to_s">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_dict_s_to_pairs">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_a_struct">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_strings">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_objpaths">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_signatures">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_bytestrings">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_action_group_action_state_changed">
+<signal name="FooiGenBar::handle-test-primitive-types">
<description>
-Emits the #GActionGroup::action-state-changed signal on @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.TestPrimitiveTypes">TestPrimitiveTypes()</link> D-Bus method.
-This function should only be called by #GActionGroup implementations.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_test_primitive_types() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of an action in the group
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="state">
-<parameter_description> the new state of the named action
+<parameter name="arg_val_byte">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_boolean">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int16">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint16">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int32">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint32">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int64">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint64">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_double">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_string">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_objpath">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_signature">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_bytestring">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_action_group_activate_action">
+<signal name="FooiGenBar::handle-unimplemented-method">
<description>
-Activate the named action within @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar.UnimplementedMethod">UnimplementedMethod()</link> D-Bus method.
-If the action is expecting a parameter, then the correct type of
-parameter must be given as @parameter. If the action is expecting no
-parameters then @parameter must be %NULL. See
-g_action_group_get_parameter_type().
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_complete_unimplemented_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to activate
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="parameter">
-<parameter_description> parameters to the activation
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_action_group_change_action_state">
+<signal name="FooiGenBar::test-signal">
<description>
-Request for the state of the named action within @action_group to be
-changed to @value.
-
-The action must be stateful and @value must be of the correct type.
-See g_action_group_get_state_type().
-
-This call merely requests a change. The action may refuse to change
-its state or may change its state to something other than @value.
-See g_action_group_get_state_hint().
-
-If the @value GVariant is floating, it is consumed.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-project-Bar.TestSignal">"TestSignal"</link> is received.
-Since: 2.28
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to request the change on
+<parameter name="arg_val_int32">
+<parameter_description> Argument.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the new state
+<parameter name="arg_array_of_strings">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_bytestrings">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+<parameter name="arg_dict_s_to_pairs">
+<parameter_description> Argument.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_action_group_get_action_enabled">
+<signal name="FooiGenBarFrobnicator::handle-random-method">
<description>
-Checks if the named action within @action_group is currently enabled.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bar-Frobnicator.RandomMethod">RandomMethod()</link> D-Bus method.
-An action must be enabled in order to be activated or in order to
-have its state changed from outside callers.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bar_frobnicator_complete_random_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBarFrobnicator.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to query
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> whether or not the action is currently enabled
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_group_get_action_parameter_type">
+<signal name="FooiGenBat::force-signal">
<description>
-Queries the type of the parameter that must be given when activating
-the named action within @action_group.
-
-When activating the action using g_action_group_activate(), the
-#GVariant given to that function must be of the type returned by this
-function.
-
-In the case that this function returns %NULL, you must not give any
-#GVariant, but %NULL instead.
-
-The parameter type of a particular action will never change but it is
-possible for an action to be removed and for a new action to be added
-with the same name but a different parameter type.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-project-Bat.ForceSignal">"ForceSignal"</link> is received.
-Since: 2.28
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to query
+<parameter name="arg_force_i">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_s">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_ay">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_struct">
+<parameter_description> Argument.
</parameter_description>
</parameter>
</parameters>
-<return> the parameter type
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_action_group_get_action_state">
+<signal name="FooiGenBat::handle-force-method">
<description>
-Queries the current state of the named action within @action_group.
-
-If the action is not stateful then %NULL will be returned. If the
-action is stateful then the type of the return value is the type
-given by g_action_group_get_state_type().
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-Bat.ForceMethod">ForceMethod()</link> D-Bus method.
-The return value (if non-%NULL) should be freed with
-g_variant_unref() when it is no longer required.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_bat_complete_force_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to query
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_i">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_s">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_ay">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_struct">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return> the current state of the action
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_group_get_action_state_hint">
+<signal name="FooiGenChangingInterfaceV10::added-signal-in10">
<description>
-Requests a hint about the valid range of values for the state of the
-named action within @action_group.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV10.AddedSignalIn10">"AddedSignalIn10"</link> is received.
-If %NULL is returned it either means that the action is not stateful
-or that there is no hint about the valid range of values for the
-state of the action.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
-If a #GVariant array is returned then each item in the array is a
-possible value for the state. If a #GVariant pair (ie: two-tuple) is
-returned then the tuple specifies the inclusive lower and upper bound
-of valid values for the state.
+Since: 10.0
-In any case, the information is merely a hint. It may be possible to
-have a state value outside of the hinted range and setting a value
-within the range may fail.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-The return value (if non-%NULL) should be freed with
-g_variant_unref() when it is no longer required.
+<signal name="FooiGenChangingInterfaceV10::bar-signal">
+<description>
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV10.BarSignal">"BarSignal"</link> is received.
-Since: 2.28
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to query
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> the state range hint
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_action_group_get_action_state_type">
+<signal name="FooiGenChangingInterfaceV10::baz-signal">
<description>
-Queries the type of the state of the named action within
- action_group
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV10.BazSignal">"BazSignal"</link> is received.
-If the action is stateful then this function returns the
-#GVariantType of the state. All calls to g_action_group_set_state()
-must give a #GVariant of this type and g_action_group_get_state()
-will return a #GVariant of the same type.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
-If the action is not stateful then this function will return %NULL.
-In that case, g_action_group_get_state() will return %NULL and you
-must not call g_action_group_set_state().
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-The state type of a particular action will never change but it is
-possible for an action to be removed and for a new action to be added
-with the same name but a different state type.
+<signal name="FooiGenChangingInterfaceV10::foo-signal">
+<description>
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV10.FooSignal">"FooSignal"</link> is received.
-Since: 2.28
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to query
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> the state type, if the action is stateful
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_action_group_has_action">
+<signal name="FooiGenChangingInterfaceV10::handle-added-method-in10">
<description>
-Checks if the named action exists within @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV10.AddedMethodIn10">AddedMethodIn10()</link> D-Bus method.
-Since: 2.28
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v10_complete_added_method_in10() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
+
+Since: 10.0
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action to check for
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> whether the named action exists
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_group_list_actions">
+<signal name="FooiGenChangingInterfaceV10::handle-bar-method">
<description>
-Lists the actions contained within @action_group.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV10.BarMethod">BarMethod()</link> D-Bus method.
-The caller is responsible for freeing the list with g_strfreev() when
-it is no longer required.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v10_complete_bar_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of the names of the
-actions in the groupb
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_action_set_state">
+<signal name="FooiGenChangingInterfaceV10::handle-baz-method">
<description>
-Request for the state of @action to be changed to @value.
-
-The action must be stateful and @value must be of the correct type.
-See g_action_get_state_type().
-
-This call merely requests a change. The action may refuse to change
-its state or may change its state to something other than @value.
-See g_action_get_state_hint().
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV10.BazMethod">BazMethod()</link> D-Bus method.
-If the @value GVariant is floating, it is consumed.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v10_complete_baz_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the new state
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_app_info_add_supports_type">
+<signal name="FooiGenChangingInterfaceV10::handle-foo-method">
<description>
-Adds a content type to the application information to indicate the
-application is capable of opening files with the given content type.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV10.FooMethod">FooMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v10_complete_foo_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
-</parameter_description>
-</parameter>
-<parameter name="content_type">
-<parameter_description> a string.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_can_delete">
+<signal name="FooiGenChangingInterfaceV10::handle-new-method-in2">
<description>
-Obtains the information whether the #GAppInfo can be deleted.
-See g_app_info_delete().
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV10.NewMethodIn2">NewMethodIn2()</link> D-Bus method.
-Since: 2.20
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v10_complete_new_method_in2() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @appinfo can be deleted
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_can_remove_supports_type">
+<signal name="FooiGenChangingInterfaceV10::new-signal-in2">
<description>
-Checks if a supported content type can be removed from an application.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV10.NewSignalIn2">"NewSignalIn2"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if it is possible to remove supported
-content types from a given @appinfo, %FALSE if not.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_create_from_commandline">
+<signal name="FooiGenChangingInterfaceV1::bar-signal">
<description>
-Creates a new #GAppInfo from the given information.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV1.BarSignal">"BarSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="commandline">
-<parameter_description> the commandline to use
-</parameter_description>
-</parameter>
-<parameter name="application_name">
-<parameter_description> the application name, or %NULL to use @commandline
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags that can specify details of the created #GAppInfo
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
-<return> new #GAppInfo for given command.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_delete">
+<signal name="FooiGenChangingInterfaceV1::baz-signal">
<description>
-Tries to delete a #GAppInfo.
-
-On some platforms, there may be a difference between user-defined
-#GAppInfo<!-- -->s which can be deleted, and system-wide ones which
-cannot. See g_app_info_can_delete().
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV1.BazSignal">"BazSignal"</link> is received.
-Virtual: do_delete
-Since: 2.20
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @appinfo has been deleted
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_dup">
+<signal name="FooiGenChangingInterfaceV1::foo-signal">
<description>
-Creates a duplicate of a #GAppInfo.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV1.FooSignal">"FooSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
-<return> a duplicate of @appinfo.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_equal">
+<signal name="FooiGenChangingInterfaceV1::handle-bar-method">
<description>
-Checks if two #GAppInfo<!-- -->s are equal.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV1.BarMethod">BarMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v1_complete_bar_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo1">
-<parameter_description> the first #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
-<parameter name="appinfo2">
-<parameter_description> the second #GAppInfo.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_all">
+<signal name="FooiGenChangingInterfaceV1::handle-baz-method">
<description>
-Gets a list of all of the applications currently registered
-on this system.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV1.BazMethod">BazMethod()</link> D-Bus method.
-For desktop files, this includes applications that have
-<literal>NoDisplay=true</literal> set or are excluded from
-display by means of <literal>OnlyShowIn</literal> or
-<literal>NotShowIn</literal>. See g_app_info_should_show().
-The returned list does not include applications which have
-the <literal>Hidden</literal> key set.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v1_complete_baz_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
</parameters>
-<return> a newly allocated #GList of references to #GAppInfo<!---->s.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_all_for_type">
+<signal name="FooiGenChangingInterfaceV1::handle-foo-method">
<description>
-Gets a list of all #GAppInfos for a given content type.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV1.FooMethod">FooMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v1_complete_foo_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> the content type to find a #GAppInfo for
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> #GList of #GAppInfos
-for given @content_type or %NULL on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_commandline">
+<signal name="FooiGenChangingInterfaceV2::bar-signal">
<description>
-Gets the commandline with which the application will be
-started.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV2.BarSignal">"BarSignal"</link> is received.
-Since: 2.20
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the @appinfo's commandline,
-or %NULL if this information is not available
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_get_default_for_type">
+<signal name="FooiGenChangingInterfaceV2::baz-signal">
<description>
-Gets the #GAppInfo that corresponds to a given content type.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV2.BazSignal">"BazSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> the content type to find a #GAppInfo for
-</parameter_description>
-</parameter>
-<parameter name="must_support_uris">
-<parameter_description> if %TRUE, the #GAppInfo is expected to
-support URIs
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> #GAppInfo for given @content_type or
-%NULL on error.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_get_default_for_uri_scheme">
+<signal name="FooiGenChangingInterfaceV2::foo-signal">
<description>
-Gets the default application for launching applications
-using this URI scheme. A URI scheme is the initial part
-of the URI, up to but not including the ':', e.g. "http",
-"ftp" or "sip".
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV2.FooSignal">"FooSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="uri_scheme">
-<parameter_description> a string containing a URI scheme.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> #GAppInfo for given @uri_scheme or %NULL on error.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_get_description">
+<signal name="FooiGenChangingInterfaceV2::handle-bar-method">
<description>
-Gets a human-readable description of an installed application.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV2.BarMethod">BarMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v2_complete_bar_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing a description of the
-application @appinfo, or %NULL if none.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_display_name">
+<signal name="FooiGenChangingInterfaceV2::handle-baz-method">
<description>
-Gets the display name of the application. The display name is often more
-descriptive to the user than the name itself.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV2.BazMethod">BazMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v2_complete_baz_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.24
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the display name of the application for @appinfo, or the name if
-no display name is available.
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_executable">
+<signal name="FooiGenChangingInterfaceV2::handle-foo-method">
<description>
-Gets the executable's name for the installed application.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV2.FooMethod">FooMethod()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v2_complete_foo_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the @appinfo's application
-binaries name
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_fallback_for_type">
+<signal name="FooiGenChangingInterfaceV2::handle-new-method-in2">
<description>
-Gets a list of fallback #GAppInfos for a given content type, i.e.
-those applications which claim to support the given content type
-by MIME type subclassing and not directly.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-ChangingInterfaceV2.NewMethodIn2">NewMethodIn2()</link> D-Bus method.
-Since: 2.28
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_changing_interface_v2_complete_new_method_in2() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> the content type to find a #GAppInfo for
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> #GList of #GAppInfos
-for given @content_type or %NULL on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_icon">
+<signal name="FooiGenChangingInterfaceV2::new-signal-in2">
<description>
-Gets the icon for the application.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-ChangingInterfaceV2.NewSignalIn2">"NewSignalIn2"</link> is received.
+
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
+Since: 2.0
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> the default #GIcon for @appinfo.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_get_id">
+<signal name="FooiGenComAcmeCoyote::handle-attack">
<description>
-Gets the ID of an application. An id is a string that
-identifies the application. The exact format of the id is
-platform dependent. For instance, on Unix this is the
-desktop file id from the xdg menu specification.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-com-acme-Coyote.Attack">Attack()</link> D-Bus method.
-Note that the returned ID may be %NULL, depending on how
-the @appinfo has been constructed.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_com_acme_coyote_complete_attack() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the application's ID.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_name">
+<signal name="FooiGenComAcmeCoyote::handle-run">
<description>
-Gets the installed name of the application.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-com-acme-Coyote.Run">Run()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_com_acme_coyote_complete_run() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the name of the application for @appinfo.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_get_recommended_for_type">
+<signal name="FooiGenComAcmeCoyote::handle-sleep">
<description>
-Gets a list of recommended #GAppInfos for a given content type, i.e.
-those applications which claim to support the given content type exactly,
-and not by MIME type subclassing.
-Note that the first application of the list is the last used one, i.e.
-the last one for which #g_app_info_set_as_last_used_for_type has been
-called.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-com-acme-Coyote.Sleep">Sleep()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_com_acme_coyote_complete_sleep() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.28
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> the content type to find a #GAppInfo for
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> #GList of #GAppInfos
-for given @content_type or %NULL on error.
-
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_launch">
+<signal name="FooiGenComAcmeCoyote::surprised">
<description>
-Launches the application. Passes @files to the launched application
-as arguments, using the optional @launch_context to get information
-about the details of the launcher (like what screen it is on).
-On error, @error will be set accordingly.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-com-acme-Coyote.Surprised">"Surprised"</link> is received.
-To launch the application without arguments pass a %NULL @files list.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
-Note that even if the launch is successful the application launched
-can fail to start if it runs into problems during startup. There is
-no way to detect this.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Some URIs can be changed when passed through a GFile (for instance
-unsupported uris with strange formats like mailto:), so if you have
-a textual uri you want to pass in as argument, consider using
-g_app_info_launch_uris() instead.
+<signal name="FooiGenFDPassing::handle-hello-fd">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-FDPassing.HelloFD">HelloFD()</link> D-Bus method.
-On UNIX, this function sets the <envar>GIO_LAUNCHED_DESKTOP_FILE</envar>
-environment variable with the path of the launched desktop file and
-<envar>GIO_LAUNCHED_DESKTOP_FILE_PID</envar> to the process
-id of the launched process. This can be used to ignore
-<envar>GIO_LAUNCHED_DESKTOP_FILE</envar>, should it be inherited
-by further processes. The <envar>DISPLAY</envar> and
-<envar>DESKTOP_STARTUP_ID</envar> environment variables are also
-set, based on information provided in @launch_context.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_fdpassing_complete_hello_fd() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
+<parameter name="object">
+<parameter_description> A #FooiGenFDPassing.
</parameter_description>
</parameter>
-<parameter name="files">
-<parameter_description> a #GList of #GFile objects
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="launch_context">
-<parameter_description> a #GAppLaunchContext or %NULL
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="arg_greeting">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_launch_default_for_uri">
+<signal name="FooiGenInlineDocs::bar-signal">
<description>
-Utility function that launches the default application
-registered to handle the specified uri. Synchronous I/O
-is done on the uri to detect the type of the file if
-required.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-project-InlineDocs.BarSignal">"BarSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="uri">
-<parameter_description> the uri to show
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="launch_context">
-<parameter_description> an optional #GAppLaunchContext.
+<parameter name="arg_blah">
+<parameter_description> Argument.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="arg_boo">
+<parameter_description> Argument.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_launch_uris">
+<signal name="FooiGenInlineDocs::handle-foo-method">
<description>
-Launches the application. Passes @uris to the launched application
-as arguments, using the optional @launch_context to get information
-about the details of the launcher (like what screen it is on).
-On error, @error will be set accordingly.
-
-To lauch the application without arguments pass a %NULL @uris list.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-InlineDocs.FooMethod">FooMethod()</link> D-Bus method.
-Note that even if the launch is successful the application launched
-can fail to start if it runs into problems during startup. There is
-no way to detect this.
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_inline_docs_complete_foo_method() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo
-</parameter_description>
-</parameter>
-<parameter name="uris">
-<parameter_description> a #GList containing URIs to launch.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="launch_context">
-<parameter_description> a #GAppLaunchContext or %NULL
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="arg_greeting">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful launch, %FALSE otherwise.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_remove_supports_type">
+<signal name="FooiGenInlineDocs::handle-method2">
<description>
-Removes a supported type from an application, if possible.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-InlineDocs.Method2">Method2()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_inline_docs_complete_method2() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="content_type">
-<parameter_description> a string.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="arg_greeting">
+<parameter_description> Argument passed by remote caller.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_reset_type_associations">
+<signal name="FooiGenMethodThreads::handle-get-self">
<description>
-Removes all changes to the type associations done by
-g_app_info_set_as_default_for_type(),
-g_app_info_set_as_default_for_extension(),
-g_app_info_add_supports_type() or g_app_info_remove_supports_type().
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-project-MethodThreads.GetSelf">GetSelf()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_method_threads_complete_get_self() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
-Since: 2.20
</description>
<parameters>
-<parameter name="content_type">
-<parameter_description> a content type
+<parameter name="object">
+<parameter_description> A #FooiGenMethodThreads.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
-<function name="g_app_info_set_as_default_for_extension">
+<signal name="FooiGenOldieInterface::bar">
<description>
-Sets the application as the default handler for the given file extension.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-OldieInterface.Bar">"Bar"</link> is received.
+
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
+Deprecated: The D-Bus signal has been deprecated.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
</parameter_description>
</parameter>
-<parameter name="extension">
-<parameter_description> a string containing the file extension (without the dot).
+</parameters>
+<return></return>
+</signal>
+
+<signal name="FooiGenOldieInterface::handle-foo">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-OldieInterface.Foo">Foo()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_oldie_interface_complete_foo() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
+
+Deprecated: The D-Bus method has been deprecated.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+
</return>
-</function>
+</signal>
-<function name="g_app_info_set_as_default_for_type">
+<signal name="FooiGenRocket123::exploded-xyz">
<description>
-Sets the application as the default handler for a given type.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-com-acme-Rocket.Exploded">"Exploded"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
-<parameter name="content_type">
-<parameter_description> the content type.
+</parameters>
+<return></return>
+</signal>
+
+<signal name="FooiGenRocket123::handle-ignite-xyz">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-com-acme-Rocket.Ignite">Ignite()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_rocket123_complete_ignite_xyz() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_set_as_last_used_for_type">
+<signal name="FooiGenTesTuglyCASEInterface::handle-get-iscsi-servers">
<description>
-Sets the application as the last used application for a given type.
-This will make the application appear as first in the list returned by
-#g_app_info_get_recommended_for_type, regardless of the default application
-for that content type.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-TestUglyCaseInterface.GetiSCSIServers">GetiSCSIServers()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_test_ugly_case_interface_complete_get_iscsi_servers() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
-</parameter_description>
-</parameter>
-<parameter name="content_type">
-<parameter_description> the content type.
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_should_show">
+<signal name="FooiGenTesTuglyCASEInterface::servers-updated-now">
<description>
-Checks if the application info should be shown in menus that
-list available applications.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-TestUglyCaseInterface.serversUPDATEDNOW">"serversUPDATEDNOW"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @appinfo should be shown, %FALSE otherwise.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_info_supports_files">
+<signal name="FooiGenUnknownXmlTags::handle-can-set-timezone">
<description>
-Checks if the application accepts files as arguments.
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-UnknownXmlTags.CanSetTimezone">CanSetTimezone()</link> D-Bus method.
+
+If a signal handler returns %TRUE, it means the signal handler will handle the invocation (e.g. take a reference to @invocation and eventually call foo_igen_unknown_xml_tags_complete_can_set_timezone() or e.g. g_dbus_method_invocation_return_error() on it) and no order signal handlers will run. If no signal handler handles the invocation, the %G_DBUS_ERROR_UNKNOWN_METHOD error is returned.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @appinfo supports files.
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
</return>
-</function>
+</signal>
-<function name="g_app_info_supports_uris">
+<signal name="FooiGenUnknownXmlTags::some-signal">
<description>
-Checks if the application supports reading files and directories from URIs.
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-UnknownXmlTags.SomeSignal">"SomeSignal"</link> is received.
+On the service-side, this signal can be used with e.g. g_signal_emit_by_name() to make the object emit the D-Bus signal.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GAppInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @appinfo supports URIs.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_launch_context_get_display">
+<signal name="GActionGroup::action-added">
<description>
-Gets the display string for the @context. This is used to ensure new
-applications are started on the same display as the launching
-application, by setting the <envar>DISPLAY</envar> environment variable.
+Signals that a new action was just added to the group.
+This signal is emitted after the action has been added
+and is now visible.
+Since: 2.28
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a #GAppLaunchContext
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> a #GAppInfo
+<parameter name="action_group">
+<parameter_description> the #GActionGroup that changed
</parameter_description>
</parameter>
-<parameter name="files">
-<parameter_description> a #GList of #GFile objects
+<parameter name="action_name">
+<parameter_description> the name of the action in @action_group
</parameter_description>
</parameter>
</parameters>
-<return> a display string for the display.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_launch_context_get_startup_notify_id">
+<signal name="GActionGroup::action-enabled-changed">
<description>
-Initiates startup notification for the application and returns the
-<envar>DESKTOP_STARTUP_ID</envar> for the launched operation,
-if supported.
-
-Startup notification IDs are defined in the <ulink
-url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">
-FreeDesktop.Org Startup Notifications standard</ulink>.
+Signals that the enabled status of the named action has changed.
+Since: 2.28
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a #GAppLaunchContext
+<parameter name="action_group">
+<parameter_description> the #GActionGroup that changed
</parameter_description>
</parameter>
-<parameter name="info">
-<parameter_description> a #GAppInfo
+<parameter name="action_name">
+<parameter_description> the name of the action in @action_group
</parameter_description>
</parameter>
-<parameter name="files">
-<parameter_description> a #GList of of #GFile objects
+<parameter name="enabled">
+<parameter_description> whether the action is enabled or not
</parameter_description>
</parameter>
</parameters>
-<return> a startup notification ID for the application, or %NULL if
-not supported.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_app_launch_context_launch_failed">
+<signal name="GActionGroup::action-removed">
<description>
-Called when an application has failed to launch, so that it can cancel
-the application startup notification started in g_app_launch_context_get_startup_notify_id().
+Signals that an action is just about to be removed from the group.
+This signal is emitted before the action is removed, so the action
+is still visible and can be queried from the signal handler.
+Since: 2.28
</description>
<parameters>
-<parameter name="context">
-<parameter_description> a #GAppLaunchContext.
+<parameter name="action_group">
+<parameter_description> the #GActionGroup that changed
</parameter_description>
</parameter>
-<parameter name="startup_notify_id">
-<parameter_description> the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().
+<parameter name="action_name">
+<parameter_description> the name of the action in @action_group
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_app_launch_context_new">
+<signal name="GActionGroup::action-state-changed">
<description>
-Creates a new application launch context. This is not normally used,
-instead you instantiate a subclass of this, such as #GdkAppLaunchContext.
+Signals that the state of the named action has changed.
+Since: 2.28
</description>
<parameters>
-</parameters>
-<return> a #GAppLaunchContext.
-</return>
-</function>
-
-<function name="g_application_activate">
-<description>
-Activates the application.
-
-In essence, this results in the #GApplication::activate() signal being
-emitted in the primary instance.
-
-The application must be registered before calling this function.
+<parameter name="action_group">
+<parameter_description> the #GActionGroup that changed
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action in @action_group
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the new value of the state
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Since: 2.28
+<signal name="GApplication::activate">
+<description>
+The ::activate signal is emitted on the primary instance when an
+activation occurs. See g_application_activate().
</description>
<parameters>
<parameter name="application">
-<parameter_description> a #GApplication
+<parameter_description> the application
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_command_line_get_arguments">
+<signal name="GApplication::command-line">
<description>
-Gets the list of arguments that was passed on the command line.
-
-The strings in the array may contain non-utf8 data.
-
-The return value is %NULL-terminated and should be freed using
-g_strfreev().
+The ::command-line signal is emitted on the primary instance when
+a commandline is not handled locally. See g_application_run() and
+the #GApplicationCommandline documentation for more information.
-Since: 2.28
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="application">
+<parameter_description> the application
</parameter_description>
</parameter>
-<parameter name="argc">
-<parameter_description> the length of the arguments array, or %NULL
+<parameter name="command_line">
+<parameter_description> a #GApplicationCommandLine representing the
+passed commandline
</parameter_description>
</parameter>
</parameters>
-<return> the string array
-containing the arguments (the argv)
-
+<return> An integer that is set as the exit status for the calling
+process. See g_application_command_line_set_exit_status().
</return>
-</function>
+</signal>
-<function name="g_application_command_line_get_cwd">
+<signal name="GApplication::open">
<description>
-Gets the working directory of the command line invocation.
-The string may contain non-utf8 data.
-
-It is possible that the remote application did not send a working
-directory, so this may be %NULL.
+The ::open signal is emitted on the primary instance when there are
+files to open. See g_application_open() for more information.
-The return value should not be modified or freed and is valid for as
-long as @cmdline exists.
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> the application
+</parameter_description>
+</parameter>
+<parameter name="files">
+<parameter_description> an array of #GFiles
+</parameter_description>
+</parameter>
+<parameter name="n_files">
+<parameter_description> the length of @files
+</parameter_description>
+</parameter>
+<parameter name="hint">
+<parameter_description> a hint provided by the calling instance
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Since: 2.28
+<signal name="GApplication::shutdown">
+<description>
+The ::shutdown signal is emitted only on the registered primary instance
+immediately after the main loop terminates.
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="application">
+<parameter_description> the application
</parameter_description>
</parameter>
</parameters>
-<return> the current directory, or %NULL
+<return></return>
+</signal>
-</return>
-</function>
+<signal name="GApplication::startup">
+<description>
+The ::startup signal is emitted on the primary instance immediately
+after registration. See g_application_register().
-<function name="g_application_command_line_get_environ">
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> the application
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GCancellable::cancelled">
<description>
-Gets the contents of the 'environ' variable of the command line
-invocation, as would be returned by g_get_environ(), ie as a
-%NULL-terminated list of strings in the form 'NAME=VALUE'.
-The strings may contain non-utf8 data.
+Emitted when the operation has been cancelled.
-The remote application usually does not send an environment. Use
-%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
-set it is possible that the environment is still not available (due
-to invocation messages from other applications).
+Can be used by implementations of cancellable operations. If the
+operation is cancelled from another thread, the signal will be
+emitted in the thread that cancelled the operation, not the
+thread that is running the operation.
-The return value should not be modified or freed and is valid for as
-long as @cmdline exists.
+Note that disconnecting from this signal (or any signal) in a
+multi-threaded program is prone to race conditions. For instance
+it is possible that a signal handler may be invoked even
+<emphasis>after</emphasis> a call to
+g_signal_handler_disconnect() for that handler has already
+returned.
-See g_application_command_line_getenv() if you are only interested
-in the value of a single environment variable.
+There is also a problem when cancellation happen
+right before connecting to the signal. If this happens the
+signal will unexpectedly not be emitted, and checking before
+connecting to the signal leaves a race condition where this is
+still happening.
-Since: 2.28
+In order to make it safe and easy to connect handlers there
+are two helper functions: g_cancellable_connect() and
+g_cancellable_disconnect() which protect against problems
+like this.
+
+An example of how to us this:
+|[
+/<!-- -->* Make sure we don't do any unnecessary work if already cancelled *<!-- -->/
+if (g_cancellable_set_error_if_cancelled (cancellable))
+return;
+
+/<!-- -->* Set up all the data needed to be able to
+* handle cancellation of the operation *<!-- -->/
+my_data = my_data_new (...);
+
+id = 0;
+if (cancellable)
+id = g_cancellable_connect (cancellable,
+G_CALLBACK (cancelled_handler)
+data, NULL);
+
+/<!-- -->* cancellable operation here... *<!-- -->/
+
+g_cancellable_disconnect (cancellable, id);
+
+/<!-- -->* cancelled_handler is never called after this, it
+* is now safe to free the data *<!-- -->/
+my_data_free (my_data);
+]|
+
+Note that the cancelled signal is emitted in the thread that
+the user cancelled from, which may be the main thread. So, the
+cancellable signal should not do something that can block.
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="cancellable">
+<parameter_description> a #GCancellable.
</parameter_description>
</parameter>
</parameters>
-<return> the environment
-strings, or %NULL if they were not sent
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_command_line_get_exit_status">
+<signal name="GDBusAuthObserver::authorize-authenticated-peer">
<description>
-Gets the exit status of @cmdline. See
-g_application_command_line_set_exit_status() for more information.
+Emitted to check if a peer that is successfully authenticated
+is authorized.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="observer">
+<parameter_description> The #GDBusAuthObserver emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="stream">
+<parameter_description> A #GIOStream for the #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="credentials">
+<parameter_description> Credentials received from the peer or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the exit status
+<return> %TRUE if the peer is authorized, %FALSE if not.
</return>
-</function>
+</signal>
-<function name="g_application_command_line_get_is_remote">
+<signal name="GDBusConnection::closed">
<description>
-Determines if @cmdline represents a remote invocation.
+Emitted when the connection is closed.
-Since: 2.28
+The cause of this event can be
+<itemizedlist>
+<listitem><para>
+If g_dbus_connection_close() is called. In this case
+ remote_peer_vanished is set to %FALSE and @error is %NULL.
+</para></listitem>
+<listitem><para>
+If the remote peer closes the connection. In this case
+ remote_peer_vanished is set to %TRUE and @error is set.
+</para></listitem>
+<listitem><para>
+If the remote peer sends invalid or malformed data. In this
+case @remote_peer_vanished is set to %FALSE and @error
+is set.
+</para></listitem>
+</itemizedlist>
+
+Upon receiving this signal, you should give up your reference to
+ connection You are guaranteed that this signal is emitted only
+once.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="connection">
+<parameter_description> The #GDBusConnection emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="remote_peer_vanished">
+<parameter_description> %TRUE if @connection is closed because the
+remote peer closed its end of the connection.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> A #GError with more details about the event or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the invocation was remote
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_command_line_get_platform_data">
+<signal name="GDBusInterfaceSkeleton::g-authorize-method">
<description>
-Gets the platform data associated with the invocation of @cmdline.
+Emitted when a method is invoked by a remote caller and used to
+determine if the method call is authorized.
-This is a #GVariant dictionary containing information about the
-context in which the invocation occured. It typically contains
-information like the current working directory and the startup
-notification ID.
+Note that this signal is emitted in a thread dedicated to
+handling the method call so handlers are allowed to perform
+blocking IO. This means that it is appropriate to call
+e.g. <ulink
+url="http://hal.freedesktop.org/docs/polkit/PolkitAuthority.html#polkit-authority-check-authorization-sync">polkit_authority_check_authorization_sync()</ulink>
+with the <ulink
+url="http://hal.freedesktop.org/docs/polkit/PolkitAuthority.html#POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS">POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION</ulink> flag set.
-For local invocation, it will be %NULL.
+If %FALSE is returned then no further handlers are run and the
+signal handler must take a reference to @invocation and finish
+handling the call (e.g. return an error via
+g_dbus_method_invocation_return_error()).
-Since: 2.28
+Otherwise, if %TRUE is returned, signal emission continues. If no
+handlers return %FALSE, then the method is dispatched. If
+ interface has an enclosing #GDBusObjectSkeleton, then the
+#GDBusObjectSkeleton::authorize-method signal handlers run before
+the handlers for this signal.
+
+The default class handler just returns %TRUE.
+
+Please note that the common case is optimized: if no signals
+handlers are connected and the default class handler isn't
+overridden (for both @interface and the enclosing
+#GDBusObjectSkeleton, if any) and #GDBusInterfaceSkeleton:g-flags does
+not have the
+%G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD
+flags set, no dedicated thread is ever used and the call will be
+handled in the same thread as the object that @interface belongs
+to was exported in.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> #GApplicationCommandLine
+<parameter name="interface">
+<parameter_description> The #GDBusInterfaceSkeleton emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the platform data, or %NULL
+<return> %TRUE if the call is authorized, %FALSE otherwise.
</return>
-</function>
+</signal>
-<function name="g_application_command_line_getenv">
+<signal name="GDBusObject::interface-added">
<description>
-Gets the value of a particular environment variable of the command
-line invocation, as would be returned by g_getenv(). The strings may
-contain non-utf8 data.
+Emitted when @interface is added to @object.
-The remote application usually does not send an environment. Use
-%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
-set it is possible that the environment is still not available (due
-to invocation messages from other applications).
+Since: 2.30
-The return value should not be modified or freed and is valid for as
-long as @cmdline exists.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> The #GDBusObject emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="interface">
+<parameter_description> The #GDBusInterface that was added.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Since: 2.28
+<signal name="GDBusObject::interface-removed">
+<description>
+Emitted when @interface is removed from @object.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="object">
+<parameter_description> The #GDBusObject emitting the signal.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the environment variable to get
+<parameter name="interface">
+<parameter_description> The #GDBusInterface that was removed.
</parameter_description>
</parameter>
</parameters>
-<return> the value of the variable, or %NULL if unset or unsent
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_command_line_print">
+<signal name="GDBusObjectManager::interface-added">
<description>
-Formats a message and prints it using the stdout print handler in the
-invoking process.
+Emitted when @interface is added to @object.
-If @cmdline is a local invocation then this is exactly equivalent to
-g_print(). If @cmdline is remote then this is equivalent to calling
-g_print() in the invoking process.
+This signal exists purely as a convenience to avoid having to
+connect signals to all objects managed by @manager.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManager emitting the signal.
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a printf-style format string
+<parameter name="object">
+<parameter_description> The #GDBusObject on which an interface was added.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> arguments, as per @format
+<parameter name="interface">
+<parameter_description> The #GDBusInterface that was added.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_command_line_printerr">
+<signal name="GDBusObjectManager::interface-removed">
<description>
-Formats a message and prints it using the stderr print handler in the
-invoking process.
+Emitted when @interface has been removed from @object.
-If @cmdline is a local invocation then this is exactly equivalent to
-g_printerr(). If @cmdline is remote then this is equivalent to
-calling g_printerr() in the invoking process.
+This signal exists purely as a convenience to avoid having to
+connect signals to all objects managed by @manager.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManager emitting the signal.
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a printf-style format string
+<parameter name="object">
+<parameter_description> The #GDBusObject on which an interface was removed.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> arguments, as per @format
+<parameter name="interface">
+<parameter_description> The #GDBusInterface that was removed.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_command_line_set_exit_status">
+<signal name="GDBusObjectManager::object-added">
<description>
-Sets the exit status that will be used when the invoking process
-exits.
-
-The return value of the #GApplication::command-line signal is
-passed to this function when the handler returns. This is the usual
-way of setting the exit status.
-
-In the event that you want the remote invocation to continue running
-and want to decide on the exit status in the future, you can use this
-call. For the case of a remote invocation, the remote process will
-typically exit when the last reference is dropped on @cmdline. The
-exit status of the remote process will be equal to the last value
-that was set with this function.
-
-In the case that the commandline invocation is local, the situation
-is slightly more complicated. If the commandline invocation results
-in the mainloop running (ie: because the use-count of the application
-increased to a non-zero value) then the application is considered to
-have been 'successful' in a certain sense, and the exit status is
-always zero. If the application use count is zero, though, the exit
-status of the local #GApplicationCommandLine is used.
+Emitted when @object is added to @manager.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cmdline">
-<parameter_description> a #GApplicationCommandLine
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManager emitting the signal.
</parameter_description>
</parameter>
-<parameter name="exit_status">
-<parameter_description> the exit status
+<parameter name="object">
+<parameter_description> The #GDBusObject that was added.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_get_application_id">
+<signal name="GDBusObjectManager::object-removed">
<description>
-Gets the unique identifier for @application.
+Emitted when @object is removed from @manager.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManager emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> The #GDBusObject that was removed.
</parameter_description>
</parameter>
</parameters>
-<return> the identifier for @application, owned by @application
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_get_flags">
+<signal name="GDBusObjectManagerClient::interface-proxy-properties-changed">
<description>
-Gets the flags for @application.
+Emitted when one or more D-Bus properties on proxy changes. The
+local cache has already been updated when this signal fires. Note
+that both @changed_properties and @invalidated_properties are
+guaranteed to never be %NULL (either may be empty though).
-See #GApplicationFlags.
+This signal exists purely as a convenience to avoid having to
+connect signals to all interface proxies managed by @manager.
-Since: 2.28
+This signal is emitted in the
+<link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+that @manager was constructed in.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManagerClient emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="object_proxy">
+<parameter_description> The #GDBusObjectProxy on which an interface has properties that are changing.
+</parameter_description>
+</parameter>
+<parameter name="interface_proxy">
+<parameter_description> The #GDBusProxy that has properties that are changing.
+</parameter_description>
+</parameter>
+<parameter name="changed_properties">
+<parameter_description> A #GVariant containing the properties that changed.
+</parameter_description>
+</parameter>
+<parameter name="invalidated_properties">
+<parameter_description> A %NULL terminated array of properties that was invalidated.
</parameter_description>
</parameter>
</parameters>
-<return> the flags for @application
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_get_inactivity_timeout">
+<signal name="GDBusObjectManagerClient::interface-proxy-signal">
<description>
-Gets the current inactivity timeout for the application.
+Emitted when a D-Bus signal is received on @interface_proxy.
-This is the amount of time (in milliseconds) after the last call to
-g_application_release() before the application stops running.
+This signal exists purely as a convenience to avoid having to
+connect signals to all interface proxies managed by @manager.
-Since: 2.28
+This signal is emitted in the
+<link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+that @manager was constructed in.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="manager">
+<parameter_description> The #GDBusObjectManagerClient emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="object_proxy">
+<parameter_description> The #GDBusObjectProxy on which an interface is emitting a D-Bus signal.
+</parameter_description>
+</parameter>
+<parameter name="interface_proxy">
+<parameter_description> The #GDBusProxy that is emitting a D-Bus signal.
+</parameter_description>
+</parameter>
+<parameter name="sender_name">
+<parameter_description> The sender of the signal or NULL if the connection is not a bus connection.
+</parameter_description>
+</parameter>
+<parameter name="signal_name">
+<parameter_description> The signal name.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal.
</parameter_description>
</parameter>
</parameters>
-<return> the timeout, in milliseconds
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_get_is_registered">
+<signal name="GDBusObjectSkeleton::authorize-method">
<description>
-Checks if @application is registered.
+Emitted when a method is invoked by a remote caller and used to
+determine if the method call is authorized.
-An application is registered if g_application_register() has been
-successfully called.
+This signal is like #GDBusInterfaceSkeleton<!-- -->'s
+#GDBusInterfaceSkeleton::g-authorize-method signal, except that it is
+for the enclosing object.
-Since: 2.28
+The default class handler just returns %TRUE.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="object">
+<parameter_description> The #GDBusObjectSkeleton emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="interface">
+<parameter_description> The #GDBusInterfaceSkeleton that @invocation is for.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @application is registered
+<return> %TRUE if the call is authorized, %FALSE otherwise.
+
</return>
-</function>
+</signal>
-<function name="g_application_get_is_remote">
+<signal name="GDBusProxy::g-properties-changed">
<description>
-Checks if @application is remote.
+Emitted when one or more D-Bus properties on @proxy changes. The
+local cache has already been updated when this signal fires. Note
+that both @changed_properties and @invalidated_properties are
+guaranteed to never be %NULL (either may be empty though).
-If @application is remote then it means that another instance of
-application already exists (the 'primary' instance). Calls to
-perform actions on @application will result in the actions being
-performed by the primary instance.
+If the proxy has the flag
+%G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES set, then
+ invalidated_properties will always be empty.
-The value of this property cannot be accessed before
-g_application_register() has been called. See
-g_application_get_is_registered().
+This signal corresponds to the
+<literal>PropertiesChanged</literal> D-Bus signal on the
+<literal>org.freedesktop.DBus.Properties</literal> interface.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="proxy">
+<parameter_description> The #GDBusProxy emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="changed_properties">
+<parameter_description> A #GVariant containing the properties that changed
+</parameter_description>
+</parameter>
+<parameter name="invalidated_properties">
+<parameter_description> A %NULL terminated array of properties that was invalidated
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @application is remote
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_hold">
+<signal name="GDBusProxy::g-signal">
<description>
-Increases the use count of @application.
-
-Use this function to indicate that the application has a reason to
-continue to run. For example, g_application_hold() is called by GTK+
-when a toplevel window is on the screen.
+Emitted when a signal from the remote object and interface that @proxy is for, has been received.
-To cancel the hold, call g_application_release().
+Since: 2.26
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="proxy">
+<parameter_description> The #GDBusProxy emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="sender_name">
+<parameter_description> The sender of the signal or %NULL if the connection is not a bus connection.
+</parameter_description>
+</parameter>
+<parameter name="signal_name">
+<parameter_description> The name of the signal.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_id_is_valid">
+<signal name="GDBusServer::new-connection">
<description>
-Checks if @application_id is a valid application identifier.
+Emitted when a new authenticated connection has been made. Use
+g_dbus_connection_get_peer_credentials() to figure out what
+identity (if any), was authenticated.
-A valid ID is required for calls to g_application_new() and
-g_application_set_application_id().
+If you want to accept the connection, take a reference to the
+ connection object and return %TRUE. When you are done with the
+connection call g_dbus_connection_close() and give up your
+reference. Note that the other peer may disconnect at any time -
+a typical thing to do when accepting a connection is to listen to
+the #GDBusConnection::closed signal.
-For convenience, the restrictions on application identifiers are
-reproduced here:
-<itemizedlist>
-<listitem>Application identifiers must contain only the ASCII characters "[A-Z][a-z][0-9]_-." and must not begin with a digit.</listitem>
-<listitem>Application identifiers must contain at least one '.' (period) character (and thus at least three elements).</listitem>
-<listitem>Application identifiers must not begin or end with a '.' (period) character.</listitem>
-<listitem>Application identifiers must not contain consecutive '.' (period) characters.</listitem>
-<listitem>Application identifiers must not exceed 255 characters.</listitem>
-</itemizedlist>
+If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD
+then the signal is emitted in a new thread dedicated to the
+connection. Otherwise the signal is emitted in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread that @server was constructed in.
+
+You are guaranteed that signal handlers for this signal runs
+before incoming messages on @connection are processed. This means
+that it's suitable to call g_dbus_connection_register_object() or
+similar from the signal handler.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="application_id">
-<parameter_description> a potential application identifier
+<parameter name="server">
+<parameter_description> The #GDBusServer emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection for the new connection.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @application_id is valid
+<return> %TRUE to claim @connection, %FALSE to let other handlers
+run.
+
</return>
-</function>
+</signal>
-<function name="g_application_new">
+<signal name="GDrive::changed">
<description>
-Creates a new #GApplication instance.
+Emitted when the drive's state has changed.
-This function calls g_type_init() for you.
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-The application id must be valid. See g_application_id_is_valid().
+<signal name="GDrive::disconnected">
+<description>
+This signal is emitted when the #GDrive have been
+disconnected. If the recipient is holding references to the
+object they should release them so the object can be
+finalized.
</description>
<parameters>
-<parameter name="application_id">
-<parameter_description> the application id
+<parameter name="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> the application flags
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GDrive::eject-button">
+<description>
+Emitted when the physical eject button (if any) of a drive has
+been pressed.
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GApplication instance
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_open">
+<signal name="GDrive::stop-button">
<description>
-Opens the given files.
+Emitted when the physical stop button (if any) of a drive has
+been pressed.
-In essence, this results in the #GApplication::open signal being emitted
-in the primary instance.
+Since: 2.22
- n_files must be greater than zero.
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
- hint is simply passed through to the ::open signal. It is
-intended to be used by applications that have multiple modes for
-opening files (eg: "view" vs "edit", etc). Unless you have a need
-for this functionality, you should use "".
+<signal name="GFileMonitor::changed">
+<description>
+Emitted when @file has been changed.
-The application must be registered before calling this function
-and it must have the %G_APPLICATION_HANDLES_OPEN flag set.
+If using #G_FILE_MONITOR_SEND_MOVED flag and @event_type is
+#G_FILE_MONITOR_SEND_MOVED, @file will be set to a #GFile containing the
+old path, and @other_file will be set to a #GFile containing the new path.
-Since: 2.28
+In all the other cases, @other_file will be set to #NULL.
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
</parameter_description>
</parameter>
-<parameter name="files">
-<parameter_description> an array of #GFiles to open
+<parameter name="file">
+<parameter_description> a #GFile.
</parameter_description>
</parameter>
-<parameter name="n_files">
-<parameter_description> the length of the @files array
+<parameter name="other_file">
+<parameter_description> a #GFile or #NULL.
</parameter_description>
</parameter>
-<parameter name="hint">
-<parameter_description> a hint (or ""), but never %NULL
+<parameter name="event_type">
+<parameter_description> a #GFileMonitorEvent.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_register">
+<signal name="GFilenameCompleter::got-completion-data">
<description>
-Attempts registration of the application.
-
-This is the point at which the application discovers if it is the
-primary instance or merely acting as a remote for an already-existing
-primary instance. This is implemented by attempting to acquire the
-application identifier as a unique bus name on the session bus using
-GDBus.
+Emitted when the file name completion information comes available.
-Due to the internal architecture of GDBus, method calls can be
-dispatched at any time (even if a main loop is not running). For
-this reason, you must ensure that any object paths that you wish to
-register are registered before calling this function.
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
-If the application has already been registered then %TRUE is
-returned with no work performed.
+<signal name="GMenuModel::items-changed">
+<description>
+Emitted when a change has occured to the menu.
-The #GApplication::startup signal is emitted if registration succeeds
-and @application is the primary instance.
+The only changes that can occur to a menu is that items are removed
+or added. Items may not change (except by being removed and added
+back in the same location). This signal is capable of describing
+both of those changes (at the same time).
-In the event of an error (such as @cancellable being cancelled, or a
-failure to connect to the session bus), %FALSE is returned and @error
-is set appropriately.
+The signal means that starting at the index @position, @removed
+items were removed and @added items were added in their place. If
+ removed is zero then only items were added. If @added is zero
+then only items were removed.
-Note: the return value of this function is not an indicator that this
-instance is or is not the primary instance of the application. See
-g_application_get_is_remote() for that.
+As an example, if the menu contains items a, b, c, d (in that
+order) and the signal (2, 1, 3) occurs then the new composition of
+the menu will be a, b, _, _, _, d (with each _ representing some
+new item).
-Since: 2.28
+Signal handlers may query the model (particularly the added items)
+and expect to see the results of the modification that is being
+reported. The signal is emitted after the modification.
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="model">
+<parameter_description> the #GMenuModel that is changing
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="position">
+<parameter_description> the position of the change
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a NULL #GError, or %NULL
+<parameter name="removed">
+<parameter_description> the number of items removed
+</parameter_description>
+</parameter>
+<parameter name="added">
+<parameter_description> the number of items added
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if registration succeeded
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_release">
+<signal name="GMount::changed">
<description>
-Decrease the use count of @application.
-
-When the use count reaches zero, the application will stop running.
-
-Never call this function except to cancel the effect of a previous
-call to g_application_hold().
+Emitted when the mount has been changed.
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="mount">
+<parameter_description> the object on which the signal is emitted
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_run">
+<signal name="GMount::pre-unmount">
<description>
-Runs the application.
-
-This function is intended to be run from main() and its return value
-is intended to be returned by main(). Although you are expected to pass
-the @argc, @argv parameters from main() to this function, it is possible
-to pass %NULL if @argv is not available or commandline handling is not
-required.
-
-First, the local_command_line() virtual function is invoked.
-This function always runs on the local instance. It gets passed a pointer
-to a %NULL-terminated copy of @argv and is expected to remove the arguments
-that it handled (shifting up remaining arguments). See
-<xref linkend="gapplication-example-cmdline2"/> for an example of
-parsing @argv manually. Alternatively, you may use the #GOptionContext API,
-after setting <literal>argc = g_strv_length (argv);</literal>.
+This signal is emitted when the #GMount is about to be
+unmounted.
-The last argument to local_command_line() is a pointer to the @status
-variable which can used to set the exit status that is returned from
-g_application_run().
+Since: 2.22
-If local_command_line() returns %TRUE, the command line is expected
-to be completely handled, including possibly registering as the primary
-instance, calling g_application_activate() or g_application_open(), etc.
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> the object on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-If local_command_line() returns %FALSE then the application is registered
-and the #GApplication::command-line signal is emitted in the primary
-instance (which may or may not be this instance). The signal handler
-gets passed a #GApplicationCommandline object that (among other things)
-contains the remaining commandline arguments that have not been handled
-by local_command_line().
+<signal name="GMount::unmounted">
+<description>
+This signal is emitted when the #GMount have been
+unmounted. If the recipient is holding references to the
+object they should release them so the object can be
+finalized.
-If the application has the %G_APPLICATION_HANDLES_COMMAND_LINE
-flag set then the default implementation of local_command_line()
-always returns %FALSE immediately, resulting in the commandline
-always being handled in the primary instance.
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> the object on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Otherwise, the default implementation of local_command_line() tries
-to do a couple of things that are probably reasonable for most
-applications. First, g_application_register() is called to attempt
-to register the application. If that works, then the command line
-arguments are inspected. If no commandline arguments are given, then
-g_application_activate() is called. If commandline arguments are
-given and the %G_APPLICATION_HANDLES_OPEN flag is set then they
-are assumed to be filenames and g_application_open() is called.
+<signal name="GMountOperation::aborted">
+<description>
+Emitted by the backend when e.g. a device becomes unavailable
+while a mount operation is in progress.
-If you need to handle commandline arguments that are not filenames,
-and you don't mind commandline handling to happen in the primary
-instance, you should set %G_APPLICATION_HANDLED_COMMAND_LINE and
-process the commandline arguments in your #GApplication::command-line
-signal handler, either manually or using the #GOptionContext API.
+Implementations of GMountOperation should handle this signal
+by dismissing open password dialogs.
-If you are interested in doing more complicated local handling of the
-commandline then you should implement your own #GApplication subclass
-and override local_command_line(). In this case, you most likely want
-to return %TRUE from your local_command_line() implementation to
-suppress the default handling. See
-<xref linkend="gapplication-example-cmdline2"/> for an example.
+Since: 2.20
-If, after the above is done, the use count of the application is zero
-then the exit status is returned immediately. If the use count is
-non-zero then the mainloop is run until the use count falls to zero,
-at which point 0 is returned.
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
-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).
+<signal name="GMountOperation::ask-password">
+<description>
+Emitted when a mount operation asks the user for a password.
-Since: 2.28
+If the message contains a line break, the first line should be
+presented as a heading. For example, it may be used as the
+primary text in a #GtkMessageDialog.
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="op">
+<parameter_description> a #GMountOperation requesting a password.
</parameter_description>
</parameter>
-<parameter name="argc">
-<parameter_description> the argc from main() (or 0 if @argv is %NULL)
+<parameter name="message">
+<parameter_description> string containing a message to display to the user.
</parameter_description>
</parameter>
-<parameter name="argv">
-<parameter_description> the argv from main(), or %NULL
+<parameter name="default_user">
+<parameter_description> string containing the default user name.
+</parameter_description>
+</parameter>
+<parameter name="default_domain">
+<parameter_description> string containing the default domain.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GAskPasswordFlags.
</parameter_description>
</parameter>
</parameters>
-<return> the exit status
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_application_set_action_group">
+<signal name="GMountOperation::ask-question">
<description>
-Sets or unsets the group of actions associated with the application.
+Emitted when asking the user a question and gives a list of
+choices for the user to choose from.
-These actions are the actions that can be remotely invoked.
+If the message contains a line break, the first line should be
+presented as a heading. For example, it may be used as the
+primary text in a #GtkMessageDialog.
-It is an error to call this function after the application has been
-registered.
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation asking a question.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> string containing a message to display to the user.
+</parameter_description>
+</parameter>
+<parameter name="choices">
+<parameter_description> an array of strings for each possible choice.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-Since: 2.28
+<signal name="GMountOperation::reply">
+<description>
+Emitted when the user has replied to the mount operation.
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
-<parameter name="action_group">
-<parameter_description> a #GActionGroup, or %NULL
+<parameter name="result">
+<parameter_description> a #GMountOperationResult indicating how the request was handled
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_set_application_id">
+<signal name="GMountOperation::show-processes">
<description>
-Sets the unique identifier for @application.
+Emitted when one or more processes are blocking an operation
+e.g. unmounting/ejecting a #GMount or stopping a #GDrive.
-The application id can only be modified if @application has not yet
-been registered.
+Note that this signal may be emitted several times to update the
+list of blocking processes as processes close files. The
+application should only respond with g_mount_operation_reply() to
+the latest signal (setting #GMountOperation:choice to the choice
+the user made).
-The application id must be valid. See g_application_id_is_valid().
+If the message contains a line break, the first line should be
+presented as a heading. For example, it may be used as the
+primary text in a #GtkMessageDialog.
-Since: 2.28
+Since: 2.22
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="op">
+<parameter_description> a #GMountOperation.
</parameter_description>
</parameter>
-<parameter name="application_id">
-<parameter_description> the identifier for @application
+<parameter name="message">
+<parameter_description> string containing a message to display to the user.
+</parameter_description>
+</parameter>
+<parameter name="processes">
+<parameter_description> an array of #GPid for processes
+blocking the operation.
+</parameter_description>
+</parameter>
+<parameter name="choices">
+<parameter_description> an array of strings for each possible choice.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_set_flags">
+<signal name="GNetworkMonitor::network-changed">
<description>
-Sets the flags for @application.
-
-The flags can only be modified if @application has not yet been
-registered.
+Emitted when the network configuration changes. If @available is
+%TRUE, then some hosts may be reachable that were not reachable
+before, while others that were reachable before may no longer be
+reachable. If @available is %FALSE, then no remote hosts are
+reachable.
-See #GApplicationFlags.
-
-Since: 2.28
+Since: 2.32
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="monitor">
+<parameter_description> a #GNetworkMonitor
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> the flags for @application
+<parameter name="available">
+<parameter_description> the current value of #GNetworkMonitor:network-available
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_application_set_inactivity_timeout">
+<signal name="GResolver::reload">
<description>
-Sets the current inactivity timeout for the application.
+Emitted when the resolver notices that the system resolver
+configuration has changed.
-This is the amount of time (in milliseconds) after the last call to
-g_application_release() before the application stops running.
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-This call has no side effects of its own. The value set here is only
-used for next time g_application_release() drops the use count to
-zero. Any timeouts currently in progress are not impacted.
+<signal name="GSettings::change-event">
+<description>
+The "change-event" signal is emitted once per change event that
+affects this settings object. You should connect to this signal
+only if you are interested in viewing groups of changes before they
+are split out into multiple emissions of the "changed" signal.
+For most use cases it is more appropriate to use the "changed" signal.
+
+In the event that the change event applies to one or more specified
+keys, @keys will be an array of #GQuark of length @n_keys. In the
+event that the change event applies to the #GSettings object as a
+whole (ie: potentially every key has been changed) then @keys will
+be %NULL and @n_keys will be 0.
+
+The default handler for this signal invokes the "changed" signal
+for each affected key. If any other connected handler returns
+%TRUE then this default functionality will be suppressed.
-Since: 2.28
</description>
<parameters>
-<parameter name="application">
-<parameter_description> a #GApplication
+<parameter name="settings">
+<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
-<parameter name="inactivity_timeout">
-<parameter_description> the timeout, in milliseconds
+<parameter name="keys">
+<parameter_description>
+an array of #GQuark<!-- -->s for the changed keys, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="n_keys">
+<parameter_description> the length of the @keys array, or 0
</parameter_description>
</parameter>
</parameters>
-<return> the timeout, in milliseconds
-
+<return> %TRUE to stop other handlers from being invoked for the
+event. FALSE to propagate the event further.
</return>
-</function>
+</signal>
-<function name="g_async_initable_init_async">
+<signal name="GSettings::changed">
<description>
-Starts asynchronous initialization of the object implementing the
-interface. This must be done before any real use of the object after
-initial construction. If the object also implements #GInitable you can
-optionally call g_initable_init() instead.
+The "changed" signal is emitted when a key has potentially changed.
+You should call one of the g_settings_get() calls to check the new
+value.
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_init_finish() to get the result of the
-initialization.
+This signal supports detailed connections. You can connect to the
+detailed signal "changed::x" in order to only receive callbacks
+when key "x" changes.
-Implementations may also support cancellation. If @cancellable is not
-%NULL, then initialization 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 @cancellable is not %NULL, and
-the object doesn't support cancellable initialization, the error
-%G_IO_ERROR_NOT_SUPPORTED will be returned.
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> the object on which the signal was emitted
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key that changed
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-If this function is not called, or returns with an error, then all
-operations on the object should fail, generally returning the
-error %G_IO_ERROR_NOT_INITIALIZED.
+<signal name="GSettings::writable-change-event">
+<description>
+The "writable-change-event" signal is emitted once per writability
+change event that affects this settings object. You should connect
+to this signal if you are interested in viewing groups of changes
+before they are split out into multiple emissions of the
+"writable-changed" signal. For most use cases it is more
+appropriate to use the "writable-changed" signal.
-Implementations of this method must be idempotent: i.e. multiple calls
-to this function with the same argument should return the same results.
-Only the first call initializes the object; further calls return the result
-of the first call. This is so that it's safe to implement the singleton
-pattern in the GObject constructor function.
+In the event that the writability change applies only to a single
+key, @key will be set to the #GQuark for that key. In the event
+that the writability change affects the entire settings object,
+ key will be 0.
-For classes that also support the #GInitable interface, the default
-implementation of this method will run the g_initable_init() function
-in a thread, so if you want to support asynchronous initialization via
-threads, just implement the #GAsyncInitable interface without overriding
-any interface methods.
+The default handler for this signal invokes the "writable-changed"
+and "changed" signals for each affected key. This is done because
+changes in writability might also imply changes in value (if for
+example, a new mandatory setting is introduced). If any other
+connected handler returns %TRUE then this default functionality
+will be suppressed.
-Since: 2.22
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> a #GAsyncInitable.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+<parameter name="settings">
+<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="key">
+<parameter_description> the quark of the key, or 0
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameters>
+<return> %TRUE to stop other handlers from being invoked for the
+event. FALSE to propagate the event further.
+</return>
+</signal>
+
+<signal name="GSettings::writable-changed">
+<description>
+The "writable-changed" signal is emitted when the writability of a
+key has potentially changed. You should call
+g_settings_is_writable() in order to determine the new status.
+
+This signal supports detailed connections. You can connect to the
+detailed signal "writable-changed::x" in order to only receive
+callbacks when the writability of "x" changes.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> the object on which the signal was emitted
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="key">
+<parameter_description> the key
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_async_initable_init_finish">
+<signal name="GSimpleAction::activate">
<description>
-Finishes asynchronous initialization and returns the result.
-See g_async_initable_init_async().
+Indicates that the action was just activated.
-Since: 2.22
+ parameter will always be of the expected type. In the event that
+an incorrect type was given, no signal will be emitted.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> a #GAsyncInitable.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter name="simple">
+<parameter_description> the #GSimpleAction
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="parameter">
+<parameter_description> the parameter to the activation
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error has occurred, this function
-will return %FALSE and set @error appropriately if present.
-
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_async_initable_new_async">
+<signal name="GSimpleAction::change-state">
<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_new() but also initializes the object asynchronously.
+Indicates that the action just received a request to change its
+state.
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_new_finish() to get the new object and check
-for any errors.
+ value will always be of the correct state type. In the event that
+an incorrect type was given, no signal will be emitted.
-Since: 2.22
+If no handler is connected to this signal then the default
+behaviour is to call g_simple_action_set_state() to set the state
+to the requested value. If you connect a signal handler then no
+default action is taken. If the state should change then you must
+call g_simple_action_set_state() from the handler.
+
+<example>
+<title>Example 'change-state' handler</title>
+<programlisting>
+static void
+change_volume_state (GSimpleAction *action,
+GVariant *value,
+gpointer user_data)
+{
+gint requested;
+
+requested = g_variant_get_int32 (value);
+
+// Volume only goes from 0 to 10
+if (0 <= requested && requested <= 10)
+g_simple_action_set_state (action, value);
+}
+</programlisting>
+</example>
+
+The handler need not set the state to the requested value. It
+could set it to any value at all, or take some other action.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GAsyncInitable.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+<parameter name="simple">
+<parameter_description> the #GSimpleAction
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="value">
+<parameter_description> the requested value for the state
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the initialization is
-finished
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GSocketClient::event">
+<description>
+Emitted when @client's activity on @connectable changes state.
+Among other things, this can be used to provide progress
+information about a network connection in the UI. The meanings of
+the different @event values are as follows:
+
+<variablelist>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_RESOLVING:</term>
+<listitem><para>
+ client is about to look up @connectable in DNS.
+ connection will be %NULL.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_RESOLVED:</term>
+<listitem><para>
+ client has successfully resolved @connectable in DNS.
+ connection will be %NULL.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_CONNECTING:</term>
+<listitem><para>
+ client is about to make a connection to a remote host;
+either a proxy server or the destination server itself.
+ connection is the #GSocketConnection, which is not yet
+connected.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_CONNECTED:</term>
+<listitem><para>
+ client has successfully connected to a remote host.
+ connection is the connected #GSocketConnection.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_PROXY_NEGOTIATING:</term>
+<listitem><para>
+ client is about to negotiate with a proxy to get it to
+connect to @connectable. @connection is the
+#GSocketConnection to the proxy server.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_PROXY_NEGOTIATED:</term>
+<listitem><para>
+ client has negotiated a connection to @connectable through
+a proxy server. @connection is the stream returned from
+g_proxy_connect(), which may or may not be a
+#GSocketConnection.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_TLS_HANDSHAKING:</term>
+<listitem><para>
+ client is about to begin a TLS handshake. @connection is a
+#GTlsClientConnection.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_TLS_HANDSHAKED:</term>
+<listitem><para>
+ client has successfully completed the TLS handshake.
+ connection is a #GTlsClientConnection.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>%G_SOCKET_CLIENT_COMPLETE:</term>
+<listitem><para>
+ client has either successfully connected to @connectable
+(in which case @connection is the #GSocketConnection that
+it will be returning to the caller) or has failed (in which
+case @connection is %NULL and the client is about to return
+an error).
+</para></listitem>
+</varlistentry>
+</variablelist>
+
+Each event except %G_SOCKET_CLIENT_COMPLETE may be emitted
+multiple times (or not at all) for a given connectable (in
+particular, if @client ends up attempting to connect to more than
+one address). However, if @client emits the #GSocketClient:event
+signal at all for a given connectable, that it will always emit
+it with %G_SOCKET_CLIENT_COMPLETE when it is done.
+
+Note that there may be additional #GSocketClientEvent values in
+the future; unrecognized @event values should be ignored.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> the #GSocketClient
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="event">
+<parameter_description> the event that is occurring
</parameter_description>
</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, or %NULL if no
-properties
+<parameter name="connectable">
+<parameter_description> the #GSocketConnectable that @event is occurring on
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the value of the first property, followed by other property
-value pairs, and ended by %NULL.
+<parameter name="connection">
+<parameter_description> the current representation of the connection
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_async_initable_new_finish">
+<signal name="GSocketService::incoming">
<description>
-Finishes the async construction for the various g_async_initable_new calls,
-returning the created object or %NULL on error.
+The ::incoming signal is emitted when a new incoming connection
+to @service needs to be handled. The handler must initiate the
+handling of @connection, but may not block; in essence,
+asynchronous operations must be used.
+
+ connection will be unreffed once the signal handler returns,
+so you need to ref it yourself if you are planning to use it.
Since: 2.22
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> the #GAsyncInitable from the callback
+<parameter name="service">
+<parameter_description> the #GSocketService
</parameter_description>
</parameter>
-<parameter name="res">
-<parameter_description> the #GAsyncResult.from the callback
+<parameter name="connection">
+<parameter_description> a new #GSocketConnection object
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="source_object">
+<parameter_description> the source_object passed to
+g_socket_listener_add_address()
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GObject, or %NULL on error. Free with
-g_object_unref().
+<return> %TRUE to stop other handlers from being called
</return>
-</function>
+</signal>
-<function name="g_async_initable_new_valist_async">
+<signal name="GThreadedSocketService::run">
<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_new_valist() but also initializes the object
-asynchronously.
-
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_new_finish() to get the new object and check
-for any errors.
+The ::run signal is emitted in a worker thread in response to an
+incoming connection. This thread is dedicated to handling
+ connection and may perform blocking IO. The signal handler need
+not return until the connection is closed.
-Since: 2.22
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GAsyncInitable.
+<parameter name="service">
+<parameter_description> the #GThreadedSocketService.
</parameter_description>
</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, followed by
-the value, and other property value pairs, and ended by %NULL.
+<parameter name="connection">
+<parameter_description> a new #GSocketConnection object.
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> The var args list generated from @first_property_name.
+<parameter name="source_object">
+<parameter_description> the source_object passed to g_socket_listener_add_address().
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+</parameters>
+<return> %TRUE to stop further signal handlers from being called
+</return>
+</signal>
+
+<signal name="GTlsConnection::accept-certificate">
+<description>
+Emitted during the TLS handshake after the peer certificate has
+been received. You can examine @peer_cert's certification path by
+calling g_tls_certificate_get_issuer() on it.
+
+For a client-side connection, @peer_cert is the server's
+certificate, and the signal will only be emitted if the
+certificate was not acceptable according to @conn's
+#GTlsClientConnection:validation_flags. If you would like the
+certificate to be accepted despite @errors, return %TRUE from the
+signal handler. Otherwise, if no handler accepts the certificate,
+the handshake will fail with %G_TLS_ERROR_BAD_CERTIFICATE.
+
+For a server-side connection, @peer_cert is the certificate
+presented by the client, if this was requested via the server's
+#GTlsServerConnection:authentication_mode. On the server side,
+the signal is always emitted when the client presents a
+certificate, and the certificate will only be accepted if a
+handler returns %TRUE.
+
+Note that if this signal is emitted as part of asynchronous I/O
+in the main thread, then you should not attempt to interact with
+the user before returning from the signal handler. If you want to
+let the user decide whether or not to accept the certificate, you
+would have to return %FALSE from the signal handler on the first
+attempt, and then after the connection attempt returns a
+%G_TLS_ERROR_HANDSHAKE, you can interact with the user, and if
+the user decides to accept the certificate, remember that fact,
+create a new connection, and return %TRUE from the signal handler
+the next time.
+
+If you are doing I/O in another thread, you do not
+need to worry about this, and can simply block in the signal
+handler until the UI thread returns an answer.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="peer_cert">
+<parameter_description> the peer's #GTlsCertificate
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the initialization is
-finished
+<parameter name="errors">
+<parameter_description> the problems with @peer_cert.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+</parameters>
+<return> %TRUE to accept @peer_cert (which will also
+immediately end the signal emission). %FALSE to allow the signal
+emission to continue, which will cause the handshake to fail if
+no one else overrides it.
+
+</return>
+</signal>
+
+<signal name="GUnixMountMonitor::mountpoints-changed">
+<description>
+Emitted when the unix mount points have changed.
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> the object on which the signal is emitted
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_async_initable_newv_async">
+<signal name="GUnixMountMonitor::mounts-changed">
<description>
-Helper function for constructing #GAsyncInitiable object. This is
-similar to g_object_newv() but also initializes the object asynchronously.
-
-When the initialization is finished, @callback will be called. You can
-then call g_async_initable_new_finish() to get the new object and check
-for any errors.
-
-Since: 2.22
+Emitted when the unix mounts have changed.
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GAsyncInitable.
+<parameter name="monitor">
+<parameter_description> the object on which the signal is emitted
</parameter_description>
</parameter>
-<parameter name="n_parameters">
-<parameter_description> the number of parameters in @parameters
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GVolume::changed">
+<description>
+Emitted when the volume has been changed.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GVolume::removed">
+<description>
+This signal is emitted when the #GVolume have been removed. If
+the recipient is holding references to the object they should
+release them so the object can be finalized.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GVolumeMonitor::drive-changed">
+<description>
+Emitted when a drive changes.
+
+</description>
+<parameters>
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> the parameters to use to construct the object
+<parameter name="drive">
+<parameter_description> the drive that changed
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the operation.
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GVolumeMonitor::drive-connected">
+<description>
+Emitted when a drive is connected to the system.
+
+</description>
+<parameters>
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="drive">
+<parameter_description> a #GDrive that was connected.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the initialization is
-finished
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GVolumeMonitor::drive-disconnected">
+<description>
+Emitted when a drive is disconnected from the system.
+
+</description>
+<parameters>
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="drive">
+<parameter_description> a #GDrive that was disconnected.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_async_result_get_source_object">
+<signal name="GVolumeMonitor::drive-eject-button">
<description>
-Gets the source object from a #GAsyncResult.
+Emitted when the eject button is pressed on @drive.
+Since: 2.18
</description>
<parameters>
-<parameter name="res">
-<parameter_description> a #GAsyncResult
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="drive">
+<parameter_description> the drive where the eject button was pressed
</parameter_description>
</parameter>
</parameters>
-<return> a new reference to the source object for the @res,
-or %NULL if there is none.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_async_result_get_user_data">
+<signal name="GVolumeMonitor::drive-stop-button">
<description>
-Gets the user data from a #GAsyncResult.
+Emitted when the stop button is pressed on @drive.
+Since: 2.22
</description>
<parameters>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-</parameters>
-<return> the user data for @res.
-</return>
-</function>
+<parameter name="drive">
+<parameter_description> the drive where the stop button was pressed
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_fill">
+<signal name="GVolumeMonitor::mount-added">
<description>
-Tries to read @count bytes from the stream into the buffer.
-Will block during this read.
-
-If @count is zero, returns zero and does nothing. A value of @count
-larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-
-On success, the number of bytes read into the buffer is returned.
-It is not an error if this is not the same as the requested size, as it
-can happen e.g. near the end of a file. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
-
-If @count is -1 then the attempted read size is equal to the number of
-bytes that are required to fill the buffer.
-
-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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
-
-On error -1 is returned and @error is set accordingly.
-
-For the asynchronous, non-blocking, version of this function, see
-g_buffered_input_stream_fill_async().
-
+Emitted when a mount is added.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="mount">
+<parameter_description> a #GMount that was added.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes read into @stream's buffer, up to @count,
-or -1 on error.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_fill_async">
+<signal name="GVolumeMonitor::mount-changed">
<description>
-Reads data into @stream's buffer asynchronously, up to @count size.
- io_priority can be used to prioritize reads. For the synchronous
-version of this function, see g_buffered_input_stream_fill().
-
-If @count is -1 then the attempted read size is equal to the number
-of bytes that are required to fill the buffer.
+Emitted when a mount changes.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> a #gpointer
+<parameter name="mount">
+<parameter_description> a #GMount that changed.
</parameter_description>
</parameter>
</parameters>
<return></return>
-</function>
+</signal>
-<function name="g_buffered_input_stream_fill_finish">
+<signal name="GVolumeMonitor::mount-pre-unmount">
<description>
-Finishes an asynchronous read.
-
+Emitted when a mount is about to be removed.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="mount">
+<parameter_description> a #GMount that is being unmounted.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize of the read stream, or %-1 on an error.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_get_available">
+<signal name="GVolumeMonitor::mount-removed">
<description>
-Gets the size of the available data within the stream.
-
+Emitted when a mount is removed.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> #GBufferedInputStream
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="mount">
+<parameter_description> a #GMount that was removed.
</parameter_description>
</parameter>
</parameters>
-<return> size of the available stream.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_get_buffer_size">
+<signal name="GVolumeMonitor::volume-added">
<description>
-Gets the size of the input buffer.
-
+Emitted when a mountable volume is added to the system.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="volume">
+<parameter_description> a #GVolume that was added.
</parameter_description>
</parameter>
</parameters>
-<return> the current buffer size.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_new">
+<signal name="GVolumeMonitor::volume-changed">
<description>
-Creates a new #GInputStream from the given @base_stream, with
-a buffer set to the default size (4 kilobytes).
-
+Emitted when mountable volume is changed.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GInputStream
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="volume">
+<parameter_description> a #GVolume that changed.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream for the given @base_stream.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_new_sized">
+<signal name="GVolumeMonitor::volume-removed">
<description>
-Creates a new #GBufferedInputStream from the given @base_stream,
-with a buffer set to @size.
-
+Emitted when a mountable volume is removed from the system.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GInputStream
+<parameter name="volume_monitor">
+<parameter_description> The volume monitor emitting the signal.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> a #gsize
+<parameter name="volume">
+<parameter_description> a #GVolume that was removed.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream.
-</return>
-</function>
+<return></return>
+</signal>
-<function name="g_buffered_input_stream_peek">
+<function name="example_animal_call_poke">
<description>
-Peeks in the buffer, copying data of size @count into @buffer,
-offset @offset bytes.
+Asynchronously invokes the <link linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_animal_call_poke_finish() to get the result of the operation.
+
+See example_animal_call_poke_sync() for the synchronous, blocking version of this method.
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
+<parameter name="proxy">
+<parameter_description> A #ExampleAnimalProxy.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> a pointer to an allocated chunk of memory
+<parameter name="arg_make_sad">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> a #gsize
+<parameter name="arg_make_happy">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="count">
-<parameter_description> a #gsize
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #gsize of the number of bytes peeked, or -1 on error.
-</return>
+<return></return>
</function>
-<function name="g_buffered_input_stream_peek_buffer">
+<function name="example_animal_call_poke_finish">
<description>
-Returns the buffer with the currently available bytes. The returned
-buffer must not be modified and will become invalid when reading from
-the stream or filling the buffer.
+Finishes an operation started with example_animal_call_poke().
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
+<parameter name="proxy">
+<parameter_description> A #ExampleAnimalProxy.
</parameter_description>
</parameter>
-<parameter name="count">
-<parameter_description> a #gsize to get the number of bytes available in the buffer
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_animal_call_poke().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return>
-read-only buffer
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+
</return>
</function>
-<function name="g_buffered_input_stream_read_byte">
+<function name="example_animal_call_poke_sync">
<description>
-Tries to read a single byte from the stream or the buffer. Will block
-during this read.
-
-On success, the byte read from the stream is returned. On end of stream
--1 is returned but it's not an exceptional error and @error is not set.
-
-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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
+Synchronously invokes the <link linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-On error -1 is returned and @error is set accordingly.
+See example_animal_call_poke() for the asynchronous version of this method.
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
+<parameter name="proxy">
+<parameter_description> A #ExampleAnimalProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_make_sad">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_make_happy">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the byte read from the @stream, or -1 on end of stream or error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+
</return>
</function>
-<function name="g_buffered_input_stream_set_buffer_size">
+<function name="example_animal_complete_poke">
<description>
-Sets the size of the internal buffer of @stream to @size, or to the
-size of the contents of the buffer. The buffer can never be resized
-smaller than its current contents.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedInputStream
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> a #gsize
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_buffered_output_stream_get_auto_grow">
+<function name="example_animal_dup_mood">
<description>
-Checks if the buffer automatically grows as data is added.
+Gets a copy of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedOutputStream.
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @stream's buffer automatically grows,
-%FALSE otherwise.
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+
</return>
</function>
-<function name="g_buffered_output_stream_get_buffer_size">
+<function name="example_animal_emit_jumped">
<description>
-Gets the size of the buffer in the @stream.
+Emits the <link linkend="gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped">"Jumped"</link> D-Bus signal.
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedOutputStream.
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
+</parameter_description>
+</parameter>
+<parameter name="arg_height">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
</parameters>
-<return> the current size of the buffer.
-</return>
+<return></return>
</function>
-<function name="g_buffered_output_stream_new">
+<function name="example_animal_get_mood">
<description>
-Creates a new buffered output stream for a base stream.
+Gets the value of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use example_animal_dup_mood() if on another thread.</warning>
+
+Since: 2.30
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream.
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
</parameter_description>
</parameter>
</parameters>
-<return> a #GOutputStream for the given @base_stream.
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+
</return>
</function>
-<function name="g_buffered_output_stream_new_sized">
+<function name="example_animal_interface_info">
<description>
-Creates a new buffered output stream with a given buffer size.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link> D-Bus interface.
+Since: 2.30
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> a #gsize.
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GOutputStream with an internal buffer set to @size.
+<return> A #GDBusInterfaceInfo. Do not free.
+
</return>
</function>
-<function name="g_buffered_output_stream_set_auto_grow">
+<function name="example_animal_override_properties">
<description>
-Sets whether or not the @stream's buffer should automatically grow.
-If @auto_grow is true, then each write will just make the buffer
-larger, and you must manually flush the buffer to actually write out
-the data to the underlying stream.
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="auto_grow">
-<parameter_description> a #gboolean.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Overrides all #GObject properties in the #ExampleAnimal interface for a concrete class.
+The properties are overridden in the order they are defined.
-<function name="g_buffered_output_stream_set_buffer_size">
-<description>
-Sets the size of the internal buffer to @size.
+Since: 2.30
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GBufferedOutputStream.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> a #gsize.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+
+</return>
</function>
-<function name="g_bus_get">
+<function name="example_animal_proxy_new">
<description>
-Asynchronously connects to the message bus specified by @bus_type.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link>. See g_dbus_proxy_new() for more details.
-When the operation is finished, @callback will be invoked. You can
-then call g_bus_get_finish() to get the result of the operation.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_animal_proxy_new_finish() to get the result of the operation.
-This is a asynchronous failable function. See g_bus_get_sync() for
-the synchronous version.
+See example_animal_proxy_new_sync() for the synchronous, blocking version of this constructor.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> A #GBusType.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -2869,64 +3418,45 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_bus_get_finish">
+<function name="example_animal_proxy_new_finish">
<description>
-Finishes an operation started with g_bus_get().
-
-The returned object is a singleton, that is, shared with other
-callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
-event that you need a private message bus connection, use
-g_dbus_address_get_for_bus() and
-g_dbus_connection_new_for_address().
-
-Note that the returned #GDBusConnection object will (usually) have
-the #GDBusConnection:exit-on-close property set to %TRUE.
+Finishes an operation started with example_animal_proxy_new().
-Since: 2.26
+Since: 2.30
</description>
<parameters>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_animal_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_get_sync">
+<function name="example_animal_proxy_new_for_bus">
<description>
-Synchronously connects to the message bus specified by @bus_type.
-Note that the returned object may shared with other callers,
-e.g. if two separate parts of a process calls this function with
-the same @bus_type, they will share the same object.
-
-This is a synchronous failable function. See g_bus_get() and
-g_bus_get_finish() for the asynchronous version.
+Like example_animal_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-The returned object is a singleton, that is, shared with other
-callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
-event that you need a private message bus connection, use
-g_dbus_address_get_for_bus_sync() and
-g_dbus_connection_new_for_address().
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_animal_proxy_new_for_bus_finish() to get the result of the operation.
-Note that the returned #GDBusConnection object will (usually) have
-the #GDBusConnection:exit-on-close property set to %TRUE.
+See example_animal_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
@@ -2934,122 +3464,107 @@ Since: 2.26
<parameter_description> A #GBusType.
</parameter_description>
</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_bus_own_name">
+<function name="example_animal_proxy_new_for_bus_finish">
<description>
-Starts acquiring @name on the bus specified by @bus_type and calls
- name_acquired_handler and @name_lost_handler when the name is
-acquired respectively lost. Callbacks will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this function from.
+Finishes an operation started with example_animal_proxy_new_for_bus().
-You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
-callbacks will be invoked after calling this function - there are three
-possible cases:
-<itemizedlist>
-<listitem><para>
- name_lost_handler with a %NULL connection (if a connection to the bus can't be made).
-</para></listitem>
-<listitem><para>
- bus_acquired_handler then @name_lost_handler (if the name can't be obtained)
-</para></listitem>
-<listitem><para>
- bus_acquired_handler then @name_acquired_handler (if the name was obtained).
-</para></listitem>
-</itemizedlist>
-When you are done owning the name, just call g_bus_unown_name()
-with the owner id this function returns.
+Since: 2.30
-If the name is acquired or lost (for example another application
-could acquire the name if you allow replacement or the application
-currently owning the name exits), the handlers are also invoked. If the
-#GDBusConnection that is used for attempting to own the name
-closes, then @name_lost_handler is invoked since it is no
-longer possible for other processes to access the process.
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_animal_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> The constructed proxy object or %NULL if @error is set.
-You cannot use g_bus_own_name() several times for the same name (unless
-interleaved with calls to g_bus_unown_name()) - only the first call
-will work.
+</return>
+</function>
-Another guarantee is that invocations of @name_acquired_handler
-and @name_lost_handler are guaranteed to alternate; that
-is, if @name_acquired_handler is invoked then you are
-guaranteed that the next time one of the handlers is invoked, it
-will be @name_lost_handler. The reverse is also true.
+<function name="example_animal_proxy_new_for_bus_sync">
+<description>
+Like example_animal_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-If you plan on exporting objects (using e.g.
-g_dbus_connection_register_object()), note that it is generally too late
-to export the objects in @name_acquired_handler. Instead, you can do this
-in @bus_acquired_handler since you are guaranteed that this will run
-before @name is requested from the bus.
+The calling thread is blocked until a reply is received.
-This behavior makes it very simple to write applications that wants
-to own names and export objects, see <xref linkend="gdbus-owning-names"/>.
-Simply register objects to be exported in @bus_acquired_handler and
-unregister the objects (if any) in @name_lost_handler.
+See example_animal_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
<parameter name="bus_type">
-<parameter_description> The type of bus to own a name on.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> The well-known name to own.
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
-</parameter_description>
-</parameter>
-<parameter name="bus_acquired_handler">
-<parameter_description> Handler to invoke when connected to the bus of type @bus_type or %NULL.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="name_acquired_handler">
-<parameter_description> Handler to invoke when @name is acquired or %NULL.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="name_lost_handler">
-<parameter_description> Handler to invoke when @name is lost or %NULL.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> User data to pass to handlers.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function for freeing @user_data or %NULL.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unown_name() to stop owning the name.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_own_name_on_connection">
+<function name="example_animal_proxy_new_sync">
<description>
-Like g_bus_own_name() but takes a #GDBusConnection instead of a
-#GBusType.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link>. See g_dbus_proxy_new_sync() for more details.
-Since: 2.26
+The calling thread is blocked until a reply is received.
+
+See example_animal_proxy_new() for the asynchronous version of this constructor.
+
+Since: 2.30
</description>
<parameters>
@@ -3057,1366 +3572,1323 @@ Since: 2.26
<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> The well-known name to own.
-</parameter_description>
-</parameter>
<parameter name="flags">
-<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="name_acquired_handler">
-<parameter_description> Handler to invoke when @name is acquired or %NULL.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="name_lost_handler">
-<parameter_description> Handler to invoke when @name is lost or %NULL.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> User data to pass to handlers.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function for freeing @user_data or %NULL.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unown_name() to stop owning the name.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_own_name_on_connection_with_closures">
+<function name="example_animal_set_mood">
<description>
-Version of g_bus_own_name_on_connection() using closures instead of callbacks for
-easier binding in other languages.
+Sets the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> The well-known name to own.
+<parameter name="object">
+<parameter_description> A #ExampleAnimal.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
-</parameter_description>
-</parameter>
-<parameter name="name_acquired_closure">
-<parameter_description> #GClosure to invoke when @name is
-acquired or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name_lost_closure">
-<parameter_description> #GClosure to invoke when @name is lost or
-%NULL.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unown_name() to stop owning the name.
-
-</return>
+<return></return>
</function>
-<function name="g_bus_own_name_with_closures">
+<function name="example_animal_skeleton_new">
<description>
-Version of g_bus_own_name() using closures instead of callbacks for
-easier binding in other languages.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link>.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> The type of bus to own a name on.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> The well-known name to own.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
-</parameter_description>
-</parameter>
-<parameter name="bus_acquired_closure">
-<parameter_description> #GClosure to invoke when connected to
-the bus of type @bus_type or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name_acquired_closure">
-<parameter_description> #GClosure to invoke when @name is
-acquired or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name_lost_closure">
-<parameter_description> #GClosure to invoke when @name is lost or
-%NULL.
-</parameter_description>
-</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unown_name() to stop owning the name.
+<return> The skeleton object.
</return>
</function>
-<function name="g_bus_unown_name">
+<function name="example_cat_interface_info">
<description>
-Stops owning a name.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link> D-Bus interface.
-Since: 2.26
</description>
<parameters>
-<parameter name="owner_id">
-<parameter_description> An identifier obtained from g_bus_own_name()
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
</function>
-<function name="g_bus_unwatch_name">
+<function name="example_cat_override_properties">
<description>
-Stops watching a name.
+Overrides all #GObject properties in the #ExampleCat interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
</description>
<parameters>
-<parameter name="watcher_id">
-<parameter_description> An identifier obtained from g_bus_watch_name()
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+</return>
</function>
-<function name="g_bus_watch_name">
+<function name="example_cat_proxy_new">
<description>
-Starts watching @name on the bus specified by @bus_type and calls
- name_appeared_handler and @name_vanished_handler when the name is
-known to have a owner respectively known to lose its
-owner. Callbacks will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this function from.
-
-You are guaranteed that one of the handlers will be invoked after
-calling this function. When you are done watching the name, just
-call g_bus_unwatch_name() with the watcher id this function
-returns.
-
-If the name vanishes or appears (for example the application owning
-the name could restart), the handlers are also invoked. If the
-#GDBusConnection that is used for watching the name disconnects, then
- name_vanished_handler is invoked since it is no longer
-possible to access the name.
-
-Another guarantee is that invocations of @name_appeared_handler
-and @name_vanished_handler are guaranteed to alternate; that
-is, if @name_appeared_handler is invoked then you are
-guaranteed that the next time one of the handlers is invoked, it
-will be @name_vanished_handler. The reverse is also true.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link>. See g_dbus_proxy_new() for more details.
-This behavior makes it very simple to write applications that wants
-to take action when a certain name exists, see <xref
-linkend="gdbus-watching-names"/>. Basically, the application
-should create object proxies in @name_appeared_handler and destroy
-them again (if any) in @name_vanished_handler.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_cat_proxy_new_finish() to get the result of the operation.
-Since: 2.26
+See example_cat_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> The type of bus to watch a name on.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> The name (well-known or unique) to watch.
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="name_appeared_handler">
-<parameter_description> Handler to invoke when @name is known to exist or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="name_vanished_handler">
-<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to handlers.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function for freeing @user_data or %NULL.
+</parameters>
+<return></return>
+</function>
+
+<function name="example_cat_proxy_new_finish">
+<description>
+Finishes an operation started with example_cat_proxy_new().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_cat_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unwatch_name() to stop watching the name.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_watch_name_on_connection">
+<function name="example_cat_proxy_new_for_bus">
<description>
-Like g_bus_watch_name() but takes a #GDBusConnection instead of a
-#GBusType.
+Like example_cat_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_cat_proxy_new_for_bus_finish() to get the result of the operation.
+
+See example_cat_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> The name (well-known or unique) to watch.
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="name_appeared_handler">
-<parameter_description> Handler to invoke when @name is known to exist or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="name_vanished_handler">
-<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to handlers.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function for freeing @user_data or %NULL.
+</parameters>
+<return></return>
+</function>
+
+<function name="example_cat_proxy_new_for_bus_finish">
+<description>
+Finishes an operation started with example_cat_proxy_new_for_bus().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_cat_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unwatch_name() to stop watching the name.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_watch_name_on_connection_with_closures">
+<function name="example_cat_proxy_new_for_bus_sync">
<description>
-Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
-easier binding in other languages.
+Like example_cat_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See example_cat_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> The name (well-known or unique) to watch.
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="name_appeared_closure">
-<parameter_description> #GClosure to invoke when @name is known
-to exist or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="name_vanished_closure">
-<parameter_description> #GClosure to invoke when @name is known
-to not exist or %NULL.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unwatch_name() to stop watching the name.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_bus_watch_name_with_closures">
+<function name="example_cat_proxy_new_sync">
<description>
-Version of g_bus_watch_name() using closures instead of callbacks for
-easier binding in other languages.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See example_cat_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> The type of bus to watch a name on.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> The name (well-known or unique) to watch.
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="name_appeared_closure">
-<parameter_description> #GClosure to invoke when @name is known
-to exist or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="name_vanished_closure">
-<parameter_description> #GClosure to invoke when @name is known
-to not exist or %NULL.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> An identifier (never 0) that an be used with
-g_bus_unwatch_name() to stop watching the name.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_cancellable_cancel">
+<function name="example_cat_skeleton_new">
<description>
-Will set @cancellable to cancelled, and will emit the
-#GCancellable::cancelled signal. (However, see the warning about
-race conditions in the documentation for that signal if you are
-planning to connect to it.)
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link>.
-This function is thread-safe. In other words, you can safely call
-it from a thread other than the one running the operation that was
-passed the @cancellable.
-The convention within gio is that cancelling an asynchronous
-operation causes it to complete asynchronously. That is, if you
-cancel the operation from the same thread in which it is running,
-then the operation's #GAsyncReadyCallback will not be invoked until
-the application returns to the main loop.
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="example_object_get_animal">
+<description>
+Gets the #ExampleAnimal instance for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link> on @object, if any.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
+<parameter name="object">
+<parameter_description> A #ExampleObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #ExampleAnimal that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
+
+</return>
</function>
-<function name="g_cancellable_connect">
+<function name="example_object_get_cat">
<description>
-Convenience function to connect to the #GCancellable::cancelled
-signal. Also handles the race condition that may happen
-if the cancellable is cancelled right before connecting.
+Gets the #ExampleCat instance for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link> on @object, if any.
- callback is called at most once, either directly at the
-time of the connect if @cancellable is already cancelled,
-or when @cancellable is cancelled in some thread.
- data_destroy_func will be called when the handler is
-disconnected, or immediately if the cancellable is already
-cancelled.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #ExampleObject.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #ExampleCat that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
+</return>
+</function>
-See #GCancellable::cancelled for details on how to use this.
+<function name="example_object_manager_client_get_proxy_type">
+<description>
+A #GDBusProxyTypeFunc that maps @interface_name to the generated #GDBusObjectProxy<!-- -->- and #GDBusProxy<!-- -->-derived types.
-Since: 2.22
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> The #GCallback to connect.
+<parameter name="object_path">
+<parameter_description> The object path of the remote object (unused).
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> Data to pass to @callback.
+<parameter name="interface_name">
+<parameter_description> Interface name of the remote object or %NULL to get the object proxy #GType.
</parameter_description>
</parameter>
-<parameter name="data_destroy_func">
-<parameter_description> Free function for @data or %NULL.
+<parameter name="user_data">
+<parameter_description> User data (unused).
</parameter_description>
</parameter>
</parameters>
-<return> The id of the signal handler or 0 if @cancellable has already
-been cancelled.
-
+<return> A #GDBusProxy<!-- -->-derived #GType if @interface_name is not %NULL, otherwise the #GType for #ExampleObjectProxy.
</return>
</function>
-<function name="g_cancellable_disconnect">
+<function name="example_object_manager_client_new">
<description>
-Disconnects a handler from a cancellable instance similar to
-g_signal_handler_disconnect(). Additionally, in the event that a
-signal handler is currently running, this call will block until the
-handler has finished. Calling this function from a
-#GCancellable::cancelled signal handler will therefore result in a
-deadlock.
+Asynchronously creates #GDBusObjectManagerClient using example_object_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details.
-This avoids a race condition where a thread cancels at the
-same time as the cancellable operation is finished and the
-signal handler is removed. See #GCancellable::cancelled for
-details on how to use this.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_object_manager_client_new_finish() to get the result of the operation.
-If @cancellable is %NULL or @handler_id is %0 this function does
-nothing.
-
-Since: 2.22
+See example_object_manager_client_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="handler_id">
-<parameter_description> Handler id of the handler to be disconnected, or %0.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_cancellable_get_current">
+<function name="example_object_manager_client_new_finish">
<description>
-Gets the top cancellable from the stack.
+Finishes an operation started with example_object_manager_client_new().
</description>
<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_object_manager_client_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GCancellable from the top of the stack, or %NULL
-if the stack is empty.
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_cancellable_get_fd">
+<function name="example_object_manager_client_new_for_bus">
<description>
-Gets the file descriptor for a cancellable job. This can be used to
-implement cancellable operations on Unix systems. The returned fd will
-turn readable when @cancellable is cancelled.
-
-You are not supposed to read from the fd yourself, just check for
-readable status. Reading to unset the readable status is done
-with g_cancellable_reset().
-
-After a successful return from this function, you should use
-g_cancellable_release_fd() to free up resources allocated for
-the returned file descriptor.
+Like example_object_manager_client_new() but takes a #GBusType instead of a #GDBusConnection.
-See also g_cancellable_make_pollfd().
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call example_object_manager_client_new_for_bus_finish() to get the result of the operation.
+See example_object_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable.
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A valid file descriptor. %-1 if the file descriptor
-is not supported, or on errors.
-</return>
+<return></return>
</function>
-<function name="g_cancellable_is_cancelled">
+<function name="example_object_manager_client_new_for_bus_finish">
<description>
-Checks if a cancellable job has been cancelled.
+Finishes an operation started with example_object_manager_client_new_for_bus().
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable or NULL.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to example_object_manager_client_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @cancellable is cancelled,
-FALSE if called with %NULL or if item is not cancelled.
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_cancellable_make_pollfd">
+<function name="example_object_manager_client_new_for_bus_sync">
<description>
-Creates a #GPollFD corresponding to @cancellable; this can be passed
-to g_poll() and used to poll for cancellation. This is useful both
-for unix systems without a native poll and for portability to
-windows.
-
-When this function returns %TRUE, you should use
-g_cancellable_release_fd() to free up resources allocated for the
- pollfd After a %FALSE return, do not call g_cancellable_release_fd().
+Like example_object_manager_client_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-If this function returns %FALSE, either no @cancellable was given or
-resource limits prevent this function from allocating the necessary
-structures for polling. (On Linux, you will likely have reached
-the maximum number of file descriptors.) The suggested way to handle
-these cases is to ignore the @cancellable.
+The calling thread is blocked until a reply is received.
-You are not supposed to read from the fd yourself, just check for
-readable status. Reading to unset the readable status is done
-with g_cancellable_reset().
+See example_object_manager_client_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.22
</description>
<parameters>
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="pollfd">
-<parameter_description> a pointer to a #GPollFD
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @pollfd was successfully initialized, %FALSE on
-failure to prepare the cancellable.
-
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_cancellable_new">
+<function name="example_object_manager_client_new_sync">
<description>
-Creates a new #GCancellable object.
-
-Applications that want to start one or more operations
-that should be cancellable should create a #GCancellable
-and pass it to the operations.
-
-One #GCancellable can be used in multiple consecutive
-operations, but not in multiple concurrent operations.
+Synchronously creates #GDBusObjectManagerClient using example_object_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details.
+The calling thread is blocked until a reply is received.
-</description>
-<parameters>
-</parameters>
-<return> a #GCancellable.
-</return>
-</function>
+See example_object_manager_client_new() for the asynchronous version of this constructor.
-<function name="g_cancellable_pop_current">
-<description>
-Pops @cancellable off the cancellable stack (verifying that @cancellable
-is on the top of the stack).
</description>
<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable object
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed object manager client or %NULL if @error is set.
+</return>
</function>
-<function name="g_cancellable_push_current">
+<function name="example_object_peek_animal">
<description>
-Pushes @cancellable onto the cancellable stack. The current
-cancellable can then be recieved using g_cancellable_get_current().
+Like example_object_get_animal() but doesn't increase the reference count on the returned object.
-This is useful when implementing cancellable operations in
-code that does not allow you to pass down the cancellable object.
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
-This is typically called automatically by e.g. #GFile operations,
-so you rarely have to call this yourself.
+Since: 2.30
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object
+<parameter name="object">
+<parameter_description> A #ExampleObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #ExampleAnimal or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+
+</return>
</function>
-<function name="g_cancellable_release_fd">
+<function name="example_object_peek_cat">
<description>
-Releases a resources previously allocated by g_cancellable_get_fd()
-or g_cancellable_make_pollfd().
+Like example_object_get_cat() but doesn't increase the reference count on the returned object.
-For compatibility reasons with older releases, calling this function
-is not strictly required, the resources will be automatically freed
-when the @cancellable is finalized. However, the @cancellable will
-block scarce file descriptors until it is finalized if this function
-is not called. This can cause the application to run out of file
-descriptors when many #GCancellables are used at the same time.
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
-Since: 2.22
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable
+<parameter name="object">
+<parameter_description> A #ExampleObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #ExampleCat or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_cancellable_reset">
+<function name="example_object_proxy_new">
<description>
-Resets @cancellable to its uncancelled state.
+Creates a new proxy object.
+
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The proxy object.
+</return>
</function>
-<function name="g_cancellable_set_error_if_cancelled">
+<function name="example_object_skeleton_new">
<description>
-If the @cancellable is cancelled, sets the error to notify
-that the operation was cancelled.
+Creates a new skeleton object.
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable object.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError to append error state to.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @cancellable was cancelled, %FALSE if it was not.
+<return> The skeleton object.
</return>
</function>
-<function name="g_cancellable_source_new">
+<function name="example_object_skeleton_set_animal">
<description>
-Creates a source that triggers if @cancellable is cancelled and
-calls its callback of type #GCancellableSourceFunc. This is
-primarily useful for attaching to another (non-cancellable) source
-with g_source_add_child_source() to add cancellability to it.
-
-For convenience, you can call this with a %NULL #GCancellable,
-in which case the source will never trigger.
+Sets the #ExampleAnimal instance for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</link> on @object.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="object">
+<parameter_description> A #ExampleObjectSkeleton.
+</parameter_description>
+</parameter>
+<parameter name="interface_">
+<parameter_description> A #ExampleAnimal or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GSource.
-
-</return>
+<return></return>
</function>
-<function name="g_charset_converter_get_num_fallbacks">
+<function name="example_object_skeleton_set_cat">
<description>
-Gets the number of fallbacks that @converter has applied so far.
-
-Since: 2.24
+Sets the #ExampleCat instance for the D-Bus interface <link linkend="gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</link> on @object.
</description>
<parameters>
-<parameter name="converter">
-<parameter_description> a #GCharsetConverter
+<parameter name="object">
+<parameter_description> A #ExampleObjectSkeleton.
+</parameter_description>
+</parameter>
+<parameter name="interface_">
+<parameter_description> A #ExampleCat or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
-<return> the number of fallbacks that @converter has applied
-
-</return>
+<return></return>
</function>
-<function name="g_charset_converter_get_use_fallback">
+<function name="fen_add">
<description>
-Gets the #GCharsetConverter:use-fallback property.
-
-Since: 2.24
+Won't hold a ref, we have a timout callback to clean unused node_t.
+If there is no value for a key, add it and return it; else return the old
+one.
</description>
<parameters>
-<parameter name="converter">
-<parameter_description> a #GCharsetConverter
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if fallbacks are used by @converter
+<return></return>
+</function>
-</return>
+<function name="fen_init">
+<description>
+FEN subsystem initializing.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
</function>
-<function name="g_charset_converter_new">
+<function name="foo_igen_authorize_call_check_authorized">
<description>
-Creates a new #GCharsetConverter.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckAuthorized">CheckAuthorized()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_authorize_call_check_authorized_finish() to get the result of the operation.
-Since: 2.24
+See foo_igen_authorize_call_check_authorized_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="to_charset">
-<parameter_description> destination charset
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
</parameter_description>
</parameter>
-<parameter name="from_charset">
-<parameter_description> source charset
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GCharsetConverter or %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_charset_converter_set_use_fallback">
+<function name="foo_igen_authorize_call_check_authorized_finish">
<description>
-Sets the #GCharsetConverter:use-fallback property.
+Finishes an operation started with foo_igen_authorize_call_check_authorized().
-Since: 2.24
</description>
<parameters>
-<parameter name="converter">
-<parameter_description> a #GCharsetConverter
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
</parameter_description>
</parameter>
-<parameter name="use_fallback">
-<parameter_description> %TRUE to use fallbacks
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_authorize_call_check_authorized().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
</function>
-<function name="g_content_type_can_be_executable">
+<function name="foo_igen_authorize_call_check_authorized_sync">
<description>
-Checks if a content type can be executable. Note that for instance
-things like text files can be executables (i.e. scripts and batch files).
+Synchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckAuthorized">CheckAuthorized()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_authorize_call_check_authorized() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file type corresponds to a type that
-can be executable, %FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_content_type_equals">
+<function name="foo_igen_authorize_call_check_not_authorized">
<description>
-Compares two content types for equality.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorized">CheckNotAuthorized()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_authorize_call_check_not_authorized_finish() to get the result of the operation.
+See foo_igen_authorize_call_check_not_authorized_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="type1">
-<parameter_description> a content type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
</parameter_description>
</parameter>
-<parameter name="type2">
-<parameter_description> a content type string
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the two strings are identical or equivalent,
-%FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_content_type_from_mime_type">
+<function name="foo_igen_authorize_call_check_not_authorized_finish">
<description>
-Tries to find a content type based on the mime type name.
+Finishes an operation started with foo_igen_authorize_call_check_not_authorized().
-Since: 2.18
</description>
<parameters>
-<parameter name="mime_type">
-<parameter_description> a mime type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_authorize_call_check_not_authorized().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Newly allocated string with content type
-or %NULL. Free with g_free()
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_content_type_get_description">
+<function name="foo_igen_authorize_call_check_not_authorized_from_object">
<description>
-Gets the human readable description of the content type.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorizedFromObject">CheckNotAuthorizedFromObject()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_authorize_call_check_not_authorized_from_object_finish() to get the result of the operation.
+See foo_igen_authorize_call_check_not_authorized_from_object_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a short description of the content type @type. Free the
-returned string with g_free()
-</return>
+<return></return>
</function>
-<function name="g_content_type_get_icon">
+<function name="foo_igen_authorize_call_check_not_authorized_from_object_finish">
<description>
-Gets the icon for a content type.
+Finishes an operation started with foo_igen_authorize_call_check_not_authorized_from_object().
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_authorize_call_check_not_authorized_from_object().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #GIcon corresponding to the content type. Free the returned
-object with g_object_unref()
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_content_type_get_mime_type">
+<function name="foo_igen_authorize_call_check_not_authorized_from_object_sync">
<description>
-Gets the mime type for the content type, if one is registered.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorizedFromObject">CheckNotAuthorizedFromObject()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_authorize_call_check_not_authorized_from_object() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the registered mime type for the given @type,
-or %NULL if unknown.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_content_type_guess">
+<function name="foo_igen_authorize_call_check_not_authorized_sync">
<description>
-Guesses the content type based on example data. If the function is
-uncertain, @result_uncertain will be set to %TRUE. Either @filename
-or @data may be %NULL, in which case the guess will be based solely
-on the other argument.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorized">CheckNotAuthorized()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_authorize_call_check_not_authorized() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> a string, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a stream of data, or %NULL
+<parameter name="proxy">
+<parameter_description> A #FooiGenAuthorizeProxy.
</parameter_description>
</parameter>
-<parameter name="data_size">
-<parameter_description> the size of @data
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="result_uncertain">
-<parameter_description> return location for the certainty
-of the result, or %NULL
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a string indicating a guessed content type for the
-given data. Free with g_free()
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_content_type_guess_for_tree">
+<function name="foo_igen_authorize_complete_check_authorized">
<description>
-Tries to guess the type of the tree with root @root, by
-looking at the files it contains. The result is an array
-of content types, with the best guess coming first.
-
-The types returned all have the form x-content/foo, e.g.
-x-content/audio-cdda (for audio CDs) or x-content/image-dcf
-(for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
-specification for more on x-content types.
-
-This function is useful in the implementation of
-g_mount_guess_content_type().
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Authorize.CheckAuthorized">CheckAuthorized()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.18
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="root">
-<parameter_description> the root of the tree to guess a type for
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> an %NULL-terminated
-array of zero or more content types, or %NULL. Free with g_strfreev()
-
-</return>
+<return></return>
</function>
-<function name="g_content_type_is_a">
+<function name="foo_igen_authorize_complete_check_not_authorized">
<description>
-Determines if @type is a subset of @supertype.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorized">CheckNotAuthorized()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
</parameter_description>
</parameter>
-<parameter name="supertype">
-<parameter_description> a content type string
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @type is a kind of @supertype,
-%FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_content_type_is_unknown">
+<function name="foo_igen_authorize_complete_check_not_authorized_from_object">
<description>
-Checks if the content type is the generic "unknown" type.
-On UNIX this is the "application/octet-stream" mimetype,
-while on win32 it is "*".
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Authorize.CheckNotAuthorizedFromObject">CheckNotAuthorizedFromObject()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="type">
-<parameter_description> a content type string
+<parameter name="object">
+<parameter_description> A #FooiGenAuthorize.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the type is the unknown type.
-</return>
+<return></return>
</function>
-<function name="g_content_types_get_registered">
+<function name="foo_igen_authorize_interface_info">
<description>
-Gets a list of strings containing all the registered content types
-known to the system. The list and its data should be freed using
-<programlisting>
-g_list_foreach (list, g_free, NULL);
-g_list_free (list);
-</programlisting>
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link> D-Bus interface.
</description>
<parameters>
</parameters>
-<return> #GList of the registered content types
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_converter_convert">
+<function name="foo_igen_authorize_override_properties">
<description>
-This is the main operation used when converting data. It is to be called
-multiple times in a loop, and each time it will do some work, i.e.
-producing some output (in @outbuf) or consuming some input (from @inbuf) or
-both. If its not possible to do any work an error is returned.
-
-Note that a single call may not consume all input (or any input at all).
-Also a call may produce output even if given no input, due to state stored
-in the converter producing output.
-
-If any data was either produced or consumed, and then an error happens, then
-only the successful conversion is reported and the error is returned on the
-next call.
-
-A full conversion loop involves calling this method repeatedly, each time
-giving it new input and space output space. When there is no more input
-data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
-The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
-each time until all data is consumed and all output is produced, then
-%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
-may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
-in a decompression converter where the end of data is detectable from the
-data (and there might even be other data after the end of the compressed data).
-
-When some data has successfully been converted @bytes_read and is set to
-the number of bytes read from @inbuf, and @bytes_written is set to indicate
-how many bytes was written to @outbuf. If there are more data to output
-or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then
-G_CONVERTER_CONVERTED is returned, and if no more data is to be output
-then G_CONVERTER_FINISHED is returned.
-
-On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
-Some errors need special handling:
-
-%G_IO_ERROR_NO_SPACE is returned if there is not enough space
-to write the resulting converted data, the application should
-call the function again with a larger @outbuf to continue.
-
-%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
-input to fully determine what the conversion should produce,
-and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
-example with an incomplete multibyte sequence when converting text,
-or when a regexp matches up to the end of the input (and may match
-further input). It may also happen when @inbuf_size is zero and
-there is no more data to produce.
-
-When this happens the application should read more input and then
-call the function again. If further input shows that there is no
-more data call the function again with the same data but with
-the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
-to finish as e.g. in the regexp match case (or, to fail again with
-%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
-input is actually partial).
-
-After g_converter_convert() has returned %G_CONVERTER_FINISHED the
-converter object is in an invalid state where its not allowed
-to call g_converter_convert() anymore. At this time you can only
-free the object or call g_converter_reset() to reset it to the
-initial state.
-
-If the flag %G_CONVERTER_FLUSH is set then conversion is modified
-to try to write out all internal state to the output. The application
-has to call the function multiple times with the flag set, and when
-the availible input has been consumed and all internal state has
-been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
-really at the end) is returned instead of %G_CONVERTER_CONVERTED.
-This is somewhat similar to what happens at the end of the input stream,
-but done in the middle of the data.
-
-This has different meanings for different conversions. For instance
-in a compression converter it would mean that we flush all the
-compression state into output such that if you uncompress the
-compressed data you get back all the input data. Doing this may
-make the final file larger due to padding though. Another example
-is a regexp conversion, where if you at the end of the flushed data
-have a match, but there is also a potential longer match. In the
-non-flushed case we would ask for more input, but when flushing we
-treat this as the end of input and do the match.
-
-Flushing is not always possible (like if a charset converter flushes
-at a partial multibyte sequence). Converters are supposed to try
-to produce as much output as possible and then return an error
-(typically %G_IO_ERROR_PARTIAL_INPUT).
+Overrides all #GObject properties in the #FooiGenAuthorize interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.24
</description>
<parameters>
-<parameter name="converter">
-<parameter_description> a #GConverter.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="inbuf">
-<parameter_description> the buffer
-containing the data to convert.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
-<parameter name="inbuf_size">
-<parameter_description> the number of bytes in @inbuf
+</parameters>
+<return> The last property id.
+</return>
+</function>
+
+<function name="foo_igen_authorize_proxy_new">
+<description>
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link>. See g_dbus_proxy_new() for more details.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_authorize_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_authorize_proxy_new_sync() for the synchronous, blocking version of this constructor.
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="outbuf">
-<parameter_description> a buffer to write converted data in.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="outbuf_size">
-<parameter_description> the number of bytes in @outbuf, must be at least one
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a #GConvertFlags controlling the conversion details
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="bytes_read">
-<parameter_description> will be set to the number of bytes read from @inbuf on success
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="bytes_written">
-<parameter_description> will be set to the number of bytes written to @outbuf on success
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #GConverterResult, %G_CONVERTER_ERROR on error.
-
-</return>
+<return></return>
</function>
-<function name="g_converter_input_stream_get_converter">
+<function name="foo_igen_authorize_proxy_new_finish">
<description>
-Gets the #GConverter that is used by @converter_stream.
+Finishes an operation started with foo_igen_authorize_proxy_new().
-Since: 2.24
</description>
<parameters>
-<parameter name="converter_stream">
-<parameter_description> a #GConverterInputStream
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_authorize_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the converter of the converter input stream
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_converter_input_stream_new">
+<function name="foo_igen_authorize_proxy_new_for_bus">
<description>
-Creates a new converter input stream for the @base_stream.
+Like foo_igen_authorize_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_authorize_proxy_new_for_bus_finish() to get the result of the operation.
+
+See foo_igen_authorize_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GInputStream
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="converter">
-<parameter_description> a #GConverter
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInputStream.
-</return>
+<return></return>
</function>
-<function name="g_converter_output_stream_get_converter">
+<function name="foo_igen_authorize_proxy_new_for_bus_finish">
<description>
-Gets the #GConverter that is used by @converter_stream.
+Finishes an operation started with foo_igen_authorize_proxy_new_for_bus().
-Since: 2.24
</description>
<parameters>
-<parameter name="converter_stream">
-<parameter_description> a #GConverterOutputStream
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_authorize_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the converter of the converter output stream
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_converter_output_stream_new">
+<function name="foo_igen_authorize_proxy_new_for_bus_sync">
<description>
-Creates a new converter output stream for the @base_stream.
+Like foo_igen_authorize_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_authorize_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="converter">
-<parameter_description> a #GConverter
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GOutputStream.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_converter_reset">
+<function name="foo_igen_authorize_proxy_new_sync">
<description>
-Resets all internal state in the converter, making it behave
-as if it was just created. If the converter has any internal
-state that would produce output then that output is lost.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link>. See g_dbus_proxy_new_sync() for more details.
-Since: 2.24
+The calling thread is blocked until a reply is received.
-</description>
-<parameters>
-<parameter name="converter">
-<parameter_description> a #GConverter.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_credentials_get_native">
-<description>
-Gets a pointer to native credentials of type @native_type from
- credentials
-
-It is a programming error (which will cause an warning to be
-logged) to use this method if there is no #GCredentials support for
-the OS or if @native_type isn't supported by the OS.
+See foo_igen_authorize_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials.
-</parameter_description>
-</parameter>
-<parameter name="native_type">
-<parameter_description> The type of native credentials to get.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-</parameters>
-<return> The pointer to native credentials or %NULL if the
-operation there is no #GCredentials support for the OS or if
- native_type isn't supported by the OS. Do not free the returned
-data, it is owned by @credentials.
-
-</return>
-</function>
-
-<function name="g_credentials_get_unix_user">
-<description>
-Tries to get the UNIX user 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 user.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-</parameters>
-<return> The UNIX user identifier or -1 if @error is set.
-
-</return>
-</function>
-
-<function name="g_credentials_is_same_user">
-<description>
-Checks if @credentials and @other_credentials is the same user.
-
-This operation can fail if #GCredentials is not supported on the
-the OS.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="other_credentials">
-<parameter_description> A #GCredentials.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @credentials and @other_credentials has the same
-user, %FALSE otherwise or if @error is set.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_credentials_new">
+<function name="foo_igen_authorize_skeleton_new">
<description>
-Creates a new #GCredentials object with credentials matching the
-the current process.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link>.
-Since: 2.26
</description>
<parameters>
</parameters>
-<return> A #GCredentials. Free with g_object_unref().
-
+<return> The skeleton object.
</return>
</function>
-<function name="g_credentials_set_native">
+<function name="foo_igen_bar_call_hello_world">
<description>
-Copies the native credentials of type @native_type from @native
-into @credentials.
-
-It is a programming error (which will cause an warning to be
-logged) to use this method if there is no #GCredentials support for
-the OS or if @native_type isn't supported by the OS.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.HelloWorld">HelloWorld()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_hello_world_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_bar_call_hello_world_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="native_type">
-<parameter_description> The type of native credentials to set.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="native">
-<parameter_description> A pointer to native credentials.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_credentials_set_unix_user">
+<function name="foo_igen_bar_call_hello_world_finish">
<description>
-Tries to set the UNIX user identifier on @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 user.
+Finishes an operation started with foo_igen_bar_call_hello_world().
-Since: 2.26
</description>
<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="uid">
-<parameter_description> The UNIX user identifier to set.
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_hello_world().
</parameter_description>
</parameter>
<parameter name="error">
@@ -4424,1386 +4896,1406 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @uid was set, %FALSE if error is set.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_credentials_to_string">
+<function name="foo_igen_bar_call_hello_world_sync">
<description>
-Creates a human-readable textual representation of @credentials
-that can be used in logging and debug messages. The format of the
-returned string may change in future GLib release.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.HelloWorld">HelloWorld()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_call_hello_world() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="credentials">
-<parameter_description> A #GCredentials object.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-</parameters>
-<return> A string that should be freed with g_free().
-
-</return>
-</function>
-
-<function name="g_data_input_stream_get_byte_order">
-<description>
-Gets the byte order for the data input stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-</parameters>
-<return> the @stream's current #GDataStreamByteOrder.
-</return>
-</function>
-
-<function name="g_data_input_stream_get_newline_type">
-<description>
-Gets the current newline type for the @stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #GDataStreamNewlineType for the given @stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_new">
+<function name="foo_igen_bar_call_property_cancellation">
<description>
-Creates a new data input stream for the @base_stream.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.PropertyCancellation">PropertyCancellation()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_property_cancellation_finish() to get the result of the operation.
+See foo_igen_bar_call_property_cancellation_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDataInputStream.
-</return>
+<return></return>
</function>
-<function name="g_data_input_stream_read_byte">
+<function name="foo_igen_bar_call_property_cancellation_finish">
<description>
-Reads an unsigned 8-bit/1-byte value from @stream.
+Finishes an operation started with foo_igen_bar_call_property_cancellation().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_property_cancellation().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 8-bit/1-byte value read from the @stream or %0
-if an error occurred.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_int16">
+<function name="foo_igen_bar_call_property_cancellation_sync">
<description>
-Reads a 16-bit/2-byte value from @stream.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.PropertyCancellation">PropertyCancellation()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
+See foo_igen_bar_call_property_cancellation() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a signed 16-bit/2-byte value read from @stream or %0 if
-an error occurred.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_int32">
+<function name="foo_igen_bar_call_request_multi_property_mods">
<description>
-Reads a signed 32-bit/4-byte value from @stream.
-
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
-
-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.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.RequestMultiPropertyMods">RequestMultiPropertyMods()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_request_multi_property_mods_finish() to get the result of the operation.
+See foo_igen_bar_call_request_multi_property_mods_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a signed 32-bit/4-byte value read from the @stream or %0 if
-an error occurred.
-</return>
+<return></return>
</function>
-<function name="g_data_input_stream_read_int64">
+<function name="foo_igen_bar_call_request_multi_property_mods_finish">
<description>
-Reads a 64-bit/8-byte value from @stream.
-
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
-
-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.
+Finishes an operation started with foo_igen_bar_call_request_multi_property_mods().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_request_multi_property_mods().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a signed 64-bit/8-byte value read from @stream or %0 if
-an error occurred.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_line">
+<function name="foo_igen_bar_call_request_multi_property_mods_sync">
<description>
-Reads a line from the data input stream.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.RequestMultiPropertyMods">RequestMultiPropertyMods()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-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.
+See foo_igen_bar_call_request_multi_property_mods() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a string with the line that was read in
-(without the newlines). Set @length to a #gsize to get the
-length of the read line. On an error, it will return %NULL and
- error will be set. If there's no content to read, it will
-still return %NULL, but @error won't be set.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_line_async">
+<function name="foo_igen_bar_call_request_signal_emission">
<description>
-The asynchronous version of g_data_input_stream_read_line(). It is
-an error to have two outstanding calls to this function.
-
-When the operation is finished, @callback will be called. You
-can then call g_data_input_stream_read_line_finish() to get
-the result of the operation.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.RequestSignalEmission">RequestSignalEmission()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_request_signal_emission_finish() to get the result of the operation.
-Since: 2.20
+See foo_igen_bar_call_request_signal_emission_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="arg_which_one">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_data_input_stream_read_line_finish">
+<function name="foo_igen_bar_call_request_signal_emission_finish">
<description>
-Finish an asynchronous call started by
-g_data_input_stream_read_line_async().
+Finishes an operation started with foo_igen_bar_call_request_signal_emission().
-Since: 2.20
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> the #GAsyncResult that was provided to the callback.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_request_signal_emission().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a string with the line that was read in
-(without the newlines). Set @length to a #gsize to get the
-length of the read line. On an error, it will return %NULL and
- error will be set. If there's no content to read, it will
-still return %NULL, but @error won't be set.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_uint16">
+<function name="foo_igen_bar_call_request_signal_emission_sync">
<description>
-Reads an unsigned 16-bit/2-byte value from @stream.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.RequestSignalEmission">RequestSignalEmission()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
+See foo_igen_bar_call_request_signal_emission() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_which_one">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 16-bit/2-byte value read from the @stream or %0 if
-an error occurred.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_uint32">
+<function name="foo_igen_bar_call_test_non_primitive_types">
<description>
-Reads an unsigned 32-bit/4-byte value from @stream.
-
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
-
-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.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.TestNonPrimitiveTypes">TestNonPrimitiveTypes()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_test_non_primitive_types_finish() to get the result of the operation.
+See foo_igen_bar_call_test_non_primitive_types_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_dict_s_to_s">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_dict_s_to_pairs">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_a_struct">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_strings">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_objpaths">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_signatures">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_bytestrings">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 32-bit/4-byte value read from the @stream or %0 if
-an error occurred.
-</return>
+<return></return>
</function>
-<function name="g_data_input_stream_read_uint64">
+<function name="foo_igen_bar_call_test_non_primitive_types_finish">
<description>
-Reads an unsigned 64-bit/8-byte value from @stream.
-
-In order to get the correct byte order for this read operation,
-see g_data_input_stream_get_byte_order().
-
-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.
+Finishes an operation started with foo_igen_bar_call_test_non_primitive_types().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="out_result">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_test_non_primitive_types().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 64-bit/8-byte read from @stream or %0 if
-an error occurred.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_until">
+<function name="foo_igen_bar_call_test_non_primitive_types_sync">
<description>
-Reads a string from the data input stream, up to the first
-occurrence of any of the stop characters.
-
-Note that, in contrast to g_data_input_stream_read_until_async(),
-this function consumes the stop character that it finds.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.TestNonPrimitiveTypes">TestNonPrimitiveTypes()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-Don't use this function in new code. Its functionality is
-inconsistent with g_data_input_stream_read_until_async(). Both
-functions will be marked as deprecated in a future release. Use
-g_data_input_stream_read_upto() instead, but note that that function
-does not consume the stop character.
+See foo_igen_bar_call_test_non_primitive_types() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="stop_chars">
-<parameter_description> characters to terminate the read.
+<parameter name="arg_dict_s_to_s">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in.
+<parameter name="arg_dict_s_to_pairs">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_a_struct">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_strings">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_objpaths">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_signatures">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_array_of_bytestrings">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_result">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a string with the data that was read
-before encountering any of the stop characters. Set @length to
-a #gsize to get the length of the string. This function will
-return %NULL on an error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_until_async">
+<function name="foo_igen_bar_call_test_primitive_types">
<description>
-The asynchronous version of g_data_input_stream_read_until().
-It is an error to have two outstanding calls to this function.
-
-Note that, in contrast to g_data_input_stream_read_until(),
-this function does not consume the stop character that it finds. You
-must read it for yourself.
-
-When the operation is finished, @callback will be called. You
-can then call g_data_input_stream_read_until_finish() to get
-the result of the operation.
-
-Don't use this function in new code. Its functionality is
-inconsistent with g_data_input_stream_read_until(). Both functions
-will be marked as deprecated in a future release. Use
-g_data_input_stream_read_upto_async() instead.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.TestPrimitiveTypes">TestPrimitiveTypes()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_test_primitive_types_finish() to get the result of the operation.
-Since: 2.20
+See foo_igen_bar_call_test_primitive_types_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="stop_chars">
-<parameter_description> characters to terminate the read.
+<parameter name="arg_val_byte">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="arg_val_boolean">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int16">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint16">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int32">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint32">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_int64">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_uint64">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_double">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_string">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_objpath">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_signature">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_val_bytestring">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_data_input_stream_read_until_finish">
+<function name="foo_igen_bar_call_test_primitive_types_finish">
<description>
-Finish an asynchronous call started by
-g_data_input_stream_read_until_async().
-
-Since: 2.20
+Finishes an operation started with foo_igen_bar_call_test_primitive_types().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the #GAsyncResult that was provided to the callback.
+<parameter name="out_ret_byte">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in.
+<parameter name="out_ret_boolean">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter name="out_ret_int16">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> a string with the data that was read
-before encountering any of the stop characters. Set @length to
-a #gsize to get the length of the string. This function will
-return %NULL on an error.
-</return>
-</function>
-
-<function name="g_data_input_stream_read_upto">
-<description>
-Reads a string from the data input stream, up to the first
-occurrence of any of the stop characters.
-
-In contrast to g_data_input_stream_read_until(), this function
-does <emphasis>not</emphasis> consume the stop character. You have
-to use g_data_input_stream_read_byte() to get it before calling
-g_data_input_stream_read_upto() again.
-
-Note that @stop_chars may contain '\0' if @stop_chars_len is
-specified.
-
-Since: 2.24
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataInputStream
+<parameter name="out_ret_uint16">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="stop_chars">
-<parameter_description> characters to terminate the read
+<parameter name="out_ret_int32">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="stop_chars_len">
-<parameter_description> length of @stop_chars. May be -1 if @stop_chars is
-nul-terminated
+<parameter name="out_ret_uint32">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in
+<parameter name="out_ret_int64">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter name="out_ret_uint64">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_ret_double">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_ret_string">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_ret_objpath">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_ret_signature">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_ret_bytestring">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_test_primitive_types().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a string with the data that was read
-before encountering any of the stop characters. Set @length to
-a #gsize to get the length of the string. This function will
-return %NULL on an error
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_input_stream_read_upto_async">
+<function name="foo_igen_bar_call_test_primitive_types_sync">
<description>
-The asynchronous version of g_data_input_stream_read_upto().
-It is an error to have two outstanding calls to this function.
-
-In contrast to g_data_input_stream_read_until(), this function
-does <emphasis>not</emphasis> consume the stop character. You have
-to use g_data_input_stream_read_byte() to get it before calling
-g_data_input_stream_read_upto() again.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.TestPrimitiveTypes">TestPrimitiveTypes()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-Note that @stop_chars may contain '\0' if @stop_chars_len is
-specified.
-
-When the operation is finished, @callback will be called. You
-can then call g_data_input_stream_read_upto_finish() to get
-the result of the operation.
+See foo_igen_bar_call_test_primitive_types() for the asynchronous version of this method.
-Since: 2.24
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataInputStream
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="stop_chars">
-<parameter_description> characters to terminate the read
+<parameter name="arg_val_byte">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="stop_chars_len">
-<parameter_description> length of @stop_chars. May be -1 if @stop_chars is
-nul-terminated
+<parameter name="arg_val_boolean">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="arg_val_int16">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter name="arg_val_uint16">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter name="arg_val_int32">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="arg_val_uint32">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_data_input_stream_read_upto_finish">
-<description>
-Finish an asynchronous call started by
-g_data_input_stream_read_upto_async().
-
-Note that this function does <emphasis>not</emphasis> consume the
-stop character. You have to use g_data_input_stream_read_byte() to
-get it before calling g_data_input_stream_read_upto_async() again.
-
-Since: 2.24
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataInputStream
+<parameter name="arg_val_int64">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the #GAsyncResult that was provided to the callback
+<parameter name="arg_val_uint64">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a #gsize to get the length of the data read in
+<parameter name="arg_val_double">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting
+<parameter name="arg_val_string">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-</parameters>
-<return> a string with the data that was read
-before encountering any of the stop characters. Set @length to
-a #gsize to get the length of the string. This function will
-return %NULL on an error.
-
-</return>
-</function>
-
-<function name="g_data_input_stream_set_byte_order">
-<description>
-This function sets the byte order for the given @stream. All subsequent
-reads from the @stream will be read in the given @order.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a given #GDataInputStream.
+<parameter name="arg_val_objpath">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="order">
-<parameter_description> a #GDataStreamByteOrder to set.
+<parameter name="arg_val_signature">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_data_input_stream_set_newline_type">
-<description>
-Sets the newline type for the @stream.
-
-Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read
-chunk ends in "CR" we must read an additional byte to know if this is "CR" or
-"CR LF", and this might block if there is no more data availible.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataInputStream.
+<parameter name="arg_val_bytestring">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> the type of new line return as #GDataStreamNewlineType.
+<parameter name="out_ret_byte">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_data_output_stream_get_byte_order">
-<description>
-Gets the byte order for the stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="out_ret_boolean">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> the #GDataStreamByteOrder for the @stream.
-</return>
-</function>
-
-<function name="g_data_output_stream_new">
-<description>
-Creates a new data output stream for @base_stream.
-
-
-</description>
-<parameters>
-<parameter name="base_stream">
-<parameter_description> a #GOutputStream.
+<parameter name="out_ret_int16">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> #GDataOutputStream.
-</return>
-</function>
-
-<function name="g_data_output_stream_put_byte">
-<description>
-Puts a byte into the output stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="out_ret_uint16">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #guchar.
+<parameter name="out_ret_int32">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="out_ret_uint32">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="out_ret_int64">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
-</function>
-
-<function name="g_data_output_stream_put_int16">
-<description>
-Puts a signed 16-bit integer into the output stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="out_ret_uint64">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #gint16.
+<parameter name="out_ret_double">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="out_ret_string">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="out_ret_objpath">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
-</function>
-
-<function name="g_data_output_stream_put_int32">
-<description>
-Puts a signed 32-bit integer into the output stream.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="out_ret_signature">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #gint32.
+<parameter name="out_ret_bytestring">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_output_stream_put_int64">
+<function name="foo_igen_bar_call_unimplemented_method">
<description>
-Puts a signed 64-bit integer into the stream.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar.UnimplementedMethod">UnimplementedMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_call_unimplemented_method_finish() to get the result of the operation.
+See foo_igen_bar_call_unimplemented_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #gint64.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
+<return></return>
</function>
-<function name="g_data_output_stream_put_string">
+<function name="foo_igen_bar_call_unimplemented_method_finish">
<description>
-Puts a string into the output stream.
+Finishes an operation started with foo_igen_bar_call_unimplemented_method().
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="str">
-<parameter_description> a string.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_call_unimplemented_method().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @string was successfully added to the @stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_output_stream_put_uint16">
+<function name="foo_igen_bar_call_unimplemented_method_sync">
<description>
-Puts an unsigned 16-bit integer into the output stream.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar.UnimplementedMethod">UnimplementedMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_call_unimplemented_method() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a #guint16.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_data_output_stream_put_uint32">
+<function name="foo_igen_bar_complete_hello_world">
<description>
-Puts an unsigned 32-bit integer into the stream.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.HelloWorld">HelloWorld()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> a #guint32.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="response">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
+<return></return>
</function>
-<function name="g_data_output_stream_put_uint64">
+<function name="foo_igen_bar_complete_property_cancellation">
<description>
-Puts an unsigned 64-bit integer into the stream.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.PropertyCancellation">PropertyCancellation()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> a #guint64.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_bar_complete_request_multi_property_mods">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.RequestMultiPropertyMods">RequestMultiPropertyMods()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+
+This method will free @invocation, you cannot use it afterwards.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @data was successfully added to the @stream.
-</return>
+<return></return>
</function>
-<function name="g_data_output_stream_set_byte_order">
+<function name="foo_igen_bar_complete_request_signal_emission">
<description>
-Sets the byte order of the data output stream to @order.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.RequestSignalEmission">RequestSignalEmission()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GDataOutputStream.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="order">
-<parameter_description> a %GDataStreamByteOrder.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_address_get_for_bus_sync">
+<function name="foo_igen_bar_complete_test_non_primitive_types">
<description>
-Synchronously looks up the D-Bus address for the well-known message
-bus instance specified by @bus_type. This may involve using various
-platform specific mechanisms.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.TestNonPrimitiveTypes">TestNonPrimitiveTypes()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> A #GBusType.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="result">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
-<return> A valid D-Bus address string for @bus_type or %NULL if @error is set.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_address_get_stream">
+<function name="foo_igen_bar_complete_test_primitive_types">
<description>
-Asynchronously connects to an endpoint specified by @address and
-sets up the connection so it is in a state to run the client-side
-of the D-Bus authentication conversation.
-
-When the operation is finished, @callback will be invoked. You can
-then call g_dbus_address_get_stream_finish() to get the result of
-the operation.
-
-This is an asynchronous failable function. See
-g_dbus_address_get_stream_sync() for the synchronous version.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.TestPrimitiveTypes">TestPrimitiveTypes()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> A valid D-Bus address.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+<parameter name="ret_byte">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> Data to pass to @callback.
+<parameter name="ret_boolean">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_int16">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_uint16">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_int32">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_uint32">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_int64">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_uint64">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_double">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_string">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_objpath">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_signature">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="ret_bytestring">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_address_get_stream_finish">
+<function name="foo_igen_bar_complete_unimplemented_method">
<description>
-Finishes an operation started with g_dbus_address_get_stream().
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar.UnimplementedMethod">UnimplementedMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().
-</parameter_description>
-</parameter>
-<parameter name="out_guid">
-<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> A #GIOStream or %NULL if @error is set.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_address_get_stream_sync">
+<function name="foo_igen_bar_dup_aay">
<description>
-Synchronously connects to an endpoint specified by @address and
-sets up the connection so it is in a state to run the client-side
-of the D-Bus authentication conversation.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.aay">"aay"</link> D-Bus property.
-This is a synchronous failable function. See
-g_dbus_address_get_stream() for the asynchronous version.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> A valid D-Bus address.
-</parameter_description>
-</parameter>
-<parameter name="out_guid">
-<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GIOStream or %NULL if @error is set.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_strfreev().
</return>
</function>
-<function name="g_dbus_annotation_info_lookup">
+<function name="foo_igen_bar_dup_ag">
<description>
-Looks up the value of an annotation.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.ag">"ag"</link> D-Bus property.
-This cost of this function is O(n) in number of annotations.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="annotations">
-<parameter_description> A %NULL-terminated array of annotations or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> The name of the annotation to look up.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> The value or %NULL if not found. Do not free, it is owned by @annotations.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_annotation_info_ref">
+<function name="foo_igen_bar_dup_ao">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.ao">"ao"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_strfreev().
</return>
</function>
-<function name="g_dbus_annotation_info_unref">
+<function name="foo_igen_bar_dup_as">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.as">"as"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusAnnotationInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_strfreev().
+</return>
</function>
-<function name="g_dbus_arg_info_ref">
+<function name="foo_igen_bar_dup_ay">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.ay">"ay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusArgInfo
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_dbus_arg_info_unref">
+<function name="foo_igen_bar_dup_finally_normal_name">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.FinallyNormalName">"FinallyNormalName"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusArgInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
</function>
-<function name="g_dbus_auth_observer_authorize_authenticated_peer">
+<function name="foo_igen_bar_dup_g">
<description>
-Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.g">"g"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="stream">
-<parameter_description> A #GIOStream for the #GDBusConnection.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_o">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.o">"o"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="credentials">
-<parameter_description> Credentials received from the peer or %NULL.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_readonly_property">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.ReadonlyProperty">"ReadonlyProperty"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the peer is authorized, %FALSE if not.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_dbus_auth_observer_new">
+<function name="foo_igen_bar_dup_s">
<description>
-Creates a new #GDBusAuthObserver object.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.s">"s"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
</parameters>
-<return> A #GDBusAuthObserver. Free with g_object_unref().
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_ag">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_ag">"unset_ag"</link> D-Bus property.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_connection_add_filter">
+<function name="foo_igen_bar_dup_unset_ao">
<description>
-Adds a message filter. Filters are handlers that are run on all
-incoming and outgoing messages, prior to standard dispatch. Filters
-are run in the order that they were added. The same handler can be
-added as a filter more than once, in which case it will be run more
-than once. Filters added during a filter callback won't be run on
-the message being processed. Filter functions are allowed to modify
-and even drop messages - see the #GDBusMessageFilterResult
-enumeration for details.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_ao">"unset_ao"</link> D-Bus property.
-Note that filters are run in a dedicated message handling thread so
-they can't block and, generally, can't do anything but signal a
-worker thread. Also note that filters are rarely needed - use API
-such as g_dbus_connection_send_message_with_reply(),
-g_dbus_connection_signal_subscribe() or
-g_dbus_connection_call() instead.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-If a filter consumes an incoming message the message is not
-dispatched anywhere else - not even the standard dispatch machinery
-(that API such as g_dbus_connection_signal_subscribe() and
-g_dbus_connection_send_message_with_reply() relies on) will see the
-message. Similary, if a filter consumes an outgoing message, the
-message will not be sent to the other peer.
-Since: 2.26
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_strfreev().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_as">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_as">"unset_as"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="filter_function">
-<parameter_description> A filter function.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_strfreev().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_ay">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_ay">"unset_ay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> User data to pass to @filter_function.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_g">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_g">"unset_g"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function to free @user_data with when filter
-is removed or %NULL.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_o">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_o">"unset_o"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A filter identifier that can be used with
-g_dbus_connection_remove_filter().
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_dup_unset_s">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_s">"unset_s"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_dbus_connection_call">
+<function name="foo_igen_bar_dup_unset_struct">
<description>
-Asynchronously invokes the @method_name method on the
- interface_name D-Bus interface on the remote object at
- object_path owned by @bus_name.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.unset_struct">"unset_struct"</link> D-Bus property.
-If @connection is closed then the operation will fail with
-%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
-fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value
-not compatible with the D-Bus protocol, the operation fails with
-%G_IO_ERROR_INVALID_ARGUMENT.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-If @reply_type is non-%NULL then the reply will be checked for having this type and an
-error will be raised if it does not match. Said another way, if you give a @reply_type
-then any non-%NULL return value will be of this type.
-If the @parameters #GVariant is floating, it is consumed. This allows
-convenient 'inline' use of g_variant_new(), e.g.:
-|[
-g_dbus_connection_call (connection,
-"org.freedesktop.StringThings",
-"/org/freedesktop/StringThings",
-"org.freedesktop.StringThings",
-"TwoStrings",
-g_variant_new ("(ss)",
-"Thing One",
-"Thing Two"),
-NULL,
-G_DBUS_CALL_FLAGS_NONE,
--1,
-NULL,
-(GAsyncReadyCallback) two_strings_done,
-NULL);
-]|
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
+</return>
+</function>
-This is an asynchronous method. When the operation is finished, @callback will be invoked
-in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
-of the thread you are calling this method from. You can then call
-g_dbus_connection_call_finish() to get the result of the operation.
-See g_dbus_connection_call_sync() for the synchronous version of this
-function.
+<function name="foo_igen_bar_dup_writeonly_property">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-Bar.WriteonlyProperty">"WriteonlyProperty"</link> D-Bus property.
+
+Since this D-Bus property is not readable, it is only meaningful to use this function on the service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="bus_name">
-<parameter_description> A unique or well-known bus name or %NULL if @connection is not a message bus connection.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_bar_emit_another_signal">
+<description>
+Emits the <link linkend="gdbus-signal-org-project-Bar.AnotherSignal">"AnotherSignal"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="object_path">
-<parameter_description> Path of remote object.
+<parameter name="arg_word">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="interface_name">
-<parameter_description> D-Bus interface to invoke method on.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_bar_emit_test_signal">
+<description>
+Emits the <link linkend="gdbus-signal-org-project-Bar.TestSignal">"TestSignal"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="method_name">
-<parameter_description> The name of the method to invoke.
+<parameter name="arg_val_int32">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with parameters for the method or %NULL if not passing parameters.
+<parameter name="arg_array_of_strings">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="reply_type">
-<parameter_description> The expected type of the reply, or %NULL.
+<parameter name="arg_array_of_bytestrings">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GDBusCallFlags enumeration.
+<parameter name="arg_dict_s_to_pairs">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds, -1 to use the default
-timeout or %G_MAXINT for no timeout.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_bar_frobnicator_call_random_method">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bar-Frobnicator.RandomMethod">RandomMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_frobnicator_call_random_method_finish() to get the result of the operation.
+
+See foo_igen_bar_frobnicator_call_random_method_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarFrobnicatorProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -5811,32 +6303,30 @@ timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
-care about the result of the method invocation.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_connection_call_finish">
+<function name="foo_igen_bar_frobnicator_call_random_method_finish">
<description>
-Finishes an operation started with g_dbus_connection_call().
+Finishes an operation started with foo_igen_bar_frobnicator_call_random_method().
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarFrobnicatorProxy.
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_frobnicator_call_random_method().
</parameter_description>
</parameter>
<parameter name="error">
@@ -5844,90 +6334,21 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if @error is set. Otherwise a #GVariant tuple with
-return values. Free with g_variant_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_connection_call_sync">
+<function name="foo_igen_bar_frobnicator_call_random_method_sync">
<description>
-Synchronously invokes the @method_name method on the
- interface_name D-Bus interface on the remote object at
- object_path owned by @bus_name.
-
-If @connection is closed then the operation will fail with
-%G_IO_ERROR_CLOSED. If @cancellable is canceled, the
-operation will fail with %G_IO_ERROR_CANCELLED. If @parameters
-contains a value not compatible with the D-Bus protocol, the operation
-fails with %G_IO_ERROR_INVALID_ARGUMENT.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bar-Frobnicator.RandomMethod">RandomMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-If @reply_type is non-%NULL then the reply will be checked for having
-this type and an error will be raised if it does not match. Said
-another way, if you give a @reply_type then any non-%NULL return
-value will be of this type.
-
-If the @parameters #GVariant is floating, it is consumed.
-This allows convenient 'inline' use of g_variant_new(), e.g.:
-|[
-g_dbus_connection_call_sync (connection,
-"org.freedesktop.StringThings",
-"/org/freedesktop/StringThings",
-"org.freedesktop.StringThings",
-"TwoStrings",
-g_variant_new ("(ss)",
-"Thing One",
-"Thing Two"),
-NULL,
-G_DBUS_CALL_FLAGS_NONE,
--1,
-NULL,
-&error);
-]|
-
-The calling thread is blocked until a reply is received. See
-g_dbus_connection_call() for the asynchronous version of
-this method.
+See foo_igen_bar_frobnicator_call_random_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="bus_name">
-<parameter_description> A unique or well-known bus name.
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> Path of remote object.
-</parameter_description>
-</parameter>
-<parameter name="interface_name">
-<parameter_description> D-Bus interface to invoke method on.
-</parameter_description>
-</parameter>
-<parameter name="method_name">
-<parameter_description> The name of the method to invoke.
-</parameter_description>
-</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with parameters for the method or %NULL if not passing parameters.
-</parameter_description>
-</parameter>
-<parameter name="reply_type">
-<parameter_description> The expected type of the reply, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GDBusCallFlags enumeration.
-</parameter_description>
-</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds, -1 to use the default
-timeout or %G_MAXINT for no timeout.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBarFrobnicatorProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -5939,128 +6360,71 @@ timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if @error is set. Otherwise a #GVariant tuple with
-return values. Free with g_variant_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_connection_close">
+<function name="foo_igen_bar_frobnicator_complete_random_method">
<description>
-Closes @connection. Note that this never causes the process to
-exit (this might only happen if the other end of a shared message
-bus connection disconnects, see #GDBusConnection:exit-on-close).
-
-Once the connection is closed, operations such as sending a message
-will return with the error %G_IO_ERROR_CLOSED. Closing a connection
-will not automatically flush the connection so queued messages may
-be lost. Use g_dbus_connection_flush() if you need such guarantees.
-
-If @connection is already closed, this method fails with
-%G_IO_ERROR_CLOSED.
-
-When @connection has been closed, the #GDBusConnection::closed
-signal is emitted in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread that @connection was constructed in.
-
-This is an asynchronous method. When the operation is finished,
- callback will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this method from. You can
-then call g_dbus_connection_close_finish() to get the result of the
-operation. See g_dbus_connection_close_sync() for the synchronous
-version.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bar-Frobnicator.RandomMethod">RandomMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
-care about the result.
+<parameter name="object">
+<parameter_description> A #FooiGenBarFrobnicator.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_connection_close_finish">
+<function name="foo_igen_bar_frobnicator_interface_info">
<description>
-Finishes an operation started with g_dbus_connection_close().
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link> D-Bus interface.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_close().
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if the operation succeeded, %FALSE if @error is set.
-
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_dbus_connection_close_sync">
+<function name="foo_igen_bar_frobnicator_override_properties">
<description>
-Synchronously closees @connection. The calling thread is blocked
-until this is done. See g_dbus_connection_close() for the
-asynchronous version of this method and more details about what it
-does.
+Overrides all #GObject properties in the #FooiGenBarFrobnicator interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation succeeded, %FALSE if @error is set.
-
+<return> The last property id.
</return>
</function>
-<function name="g_dbus_connection_emit_signal">
+<function name="foo_igen_bar_frobnicator_proxy_new">
<description>
-Emits a signal.
-
-If the parameters GVariant is floating, it is consumed.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link>. See g_dbus_proxy_new() for more details.
-This can only fail if @parameters is not compatible with the D-Bus protocol.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_frobnicator_proxy_new_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_bar_frobnicator_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
@@ -6068,60 +6432,79 @@ Since: 2.26
<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="destination_bus_name">
-<parameter_description> The unique bus name for the destination for the signal or %NULL to emit to all listeners.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
<parameter name="object_path">
-<parameter_description> Path of remote object.
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="interface_name">
-<parameter_description> D-Bus interface to emit a signal on.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="signal_name">
-<parameter_description> The name of the signal to emit.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_bar_frobnicator_proxy_new_finish">
+<description>
+Finishes an operation started with foo_igen_bar_frobnicator_proxy_new().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_frobnicator_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE unless @error is set.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_connection_flush">
+<function name="foo_igen_bar_frobnicator_proxy_new_for_bus">
<description>
-Asynchronously flushes @connection, that is, writes all queued
-outgoing message to the transport and then flushes the transport
-(using g_output_stream_flush_async()). This is useful in programs
-that wants to emit a D-Bus signal and then exit
-immediately. Without flushing the connection, there is no guarantee
-that the message has been sent to the networking buffers in the OS
-kernel.
+Like foo_igen_bar_frobnicator_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-This is an asynchronous method. When the operation is finished,
- callback will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this method from. You can
-then call g_dbus_connection_flush_finish() to get the result of the
-operation. See g_dbus_connection_flush_sync() for the synchronous
-version.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_frobnicator_proxy_new_for_bus_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_bar_frobnicator_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -6129,57 +6512,62 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
-care about the result.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_connection_flush_finish">
+<function name="foo_igen_bar_frobnicator_proxy_new_for_bus_finish">
<description>
-Finishes an operation started with g_dbus_connection_flush().
+Finishes an operation started with foo_igen_bar_frobnicator_proxy_new_for_bus().
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_flush().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_frobnicator_proxy_new_for_bus().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation succeeded, %FALSE if @error is set.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_connection_flush_sync">
+<function name="foo_igen_bar_frobnicator_proxy_new_for_bus_sync">
<description>
-Synchronously flushes @connection. The calling thread is blocked
-until this is done. See g_dbus_connection_flush() for the
-asynchronous version of this method and more details about what it
-does.
+Like foo_igen_bar_frobnicator_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_frobnicator_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -6187,20 +6575,22 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation succeeded, %FALSE if @error is set.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_connection_get_capabilities">
+<function name="foo_igen_bar_frobnicator_proxy_new_sync">
<description>
-Gets the capabilities negotiated with the remote peer
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_frobnicator_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
@@ -6208,749 +6598,662 @@ Since: 2.26
<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
+</parameter_description>
+</parameter>
</parameters>
-<return> Zero or more flags from the #GDBusCapabilityFlags enumeration.
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="foo_igen_bar_frobnicator_skeleton_new">
+<description>
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link>.
+
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
</return>
</function>
-<function name="g_dbus_connection_get_exit_on_close">
+<function name="foo_igen_bar_get_aay">
<description>
-Gets whether the process is terminated when @connection is
-closed by the remote peer. See
-#GDBusConnection:exit-on-close for more details.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.aay">"aay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_aay() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> Whether the process is terminated when @connection is
-closed by the remote peer.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_get_guid">
+<function name="foo_igen_bar_get_ag">
<description>
-The GUID of the peer performing the role of server when
-authenticating. See #GDBusConnection:guid for more details.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.ag">"ag"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_ag() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> The GUID. Do not free this string, it is owned by
- connection
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_get_peer_credentials">
+<function name="foo_igen_bar_get_ao">
<description>
-Gets the credentials of the authenticated peer. This will always
-return %NULL unless @connection acted as a server
-(e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
-when set up and the client passed credentials as part of the
-authentication process.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.ao">"ao"</link> D-Bus property.
-In a message bus setup, the message bus is always the server and
-each application is a client. So this method will always return
-%NULL for message bus clients.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_ao() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GCredentials or %NULL if not available. Do not free
-this object, it is owned by @connection.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_get_stream">
+<function name="foo_igen_bar_get_as">
<description>
-Gets the underlying stream used for IO.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.as">"as"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_as() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GDBusConnection
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> the stream used for IO
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_get_unique_name">
+<function name="foo_igen_bar_get_ay">
<description>
-Gets the unique name of @connection as assigned by the message
-bus. This can also be used to figure out if @connection is a
-message bus connection.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.ay">"ay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_ay() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> The unique name or %NULL if @connection is not a message
-bus connection. Do not free this string, it is owned by
- connection
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_is_closed">
+<function name="foo_igen_bar_get_b">
<description>
-Gets whether @connection is closed.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.b">"b"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the connection is closed, %FALSE otherwise.
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_new">
+<function name="foo_igen_bar_get_d">
<description>
-Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
-with the end represented by @stream.
-
-If @observer is not %NULL it may be used to control the
-authentication process.
-
-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.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.d">"d"</link> D-Bus property.
-This is a asynchronous failable constructor. See
-g_dbus_connection_new_sync() for the synchronous
-version.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GIOStream.
-</parameter_description>
-</parameter>
-<parameter name="guid">
-<parameter_description> The GUID to use if a authenticating as a server or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags describing how to make the connection.
-</parameter_description>
-</parameter>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value.
+</return>
</function>
-<function name="g_dbus_connection_new_finish">
+<function name="foo_igen_bar_get_finally_normal_name">
<description>
-Finishes an operation started with g_dbus_connection_new().
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.FinallyNormalName">"FinallyNormalName"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_finally_normal_name() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_new_for_address">
+<function name="foo_igen_bar_get_g">
<description>
-Asynchronously connects and sets up a D-Bus client connection for
-exchanging D-Bus messages with an endpoint specified by @address
-which must be in the D-Bus address format.
-
-This constructor can only be used to initiate client-side
-connections - use g_dbus_connection_new() if you need to act as the
-server. In particular, @flags cannot contain the
-%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
-%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.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.g">"g"</link> D-Bus property.
-If @observer is not %NULL it may be used to control the
-authentication process.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-This is a asynchronous failable constructor. See
-g_dbus_connection_new_for_address_sync() for the synchronous
-version.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_g() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> A D-Bus address.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags describing how to make the connection.
-</parameter_description>
-</parameter>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
</function>
-<function name="g_dbus_connection_new_for_address_finish">
+<function name="foo_igen_bar_get_i">
<description>
-Finishes an operation started with g_dbus_connection_new_for_address().
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.i">"i"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_new_for_address_sync">
+<function name="foo_igen_bar_get_n">
<description>
-Synchronously connects and sets up a D-Bus client connection for
-exchanging D-Bus messages with an endpoint specified by @address
-which must be in the D-Bus address format.
-
-This constructor can only be used to initiate client-side
-connections - use g_dbus_connection_new_sync() if you need to act
-as the server. In particular, @flags cannot contain the
-%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
-%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
-
-This is a synchronous failable constructor. See
-g_dbus_connection_new_for_address() for the asynchronous version.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.n">"n"</link> D-Bus property.
-If @observer is not %NULL it may be used to control the
-authentication process.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> A D-Bus address.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags describing how to make the connection.
-</parameter_description>
-</parameter>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_new_sync">
+<function name="foo_igen_bar_get_o">
<description>
-Synchronously sets up a D-Bus connection for exchanging D-Bus messages
-with the end represented by @stream.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.o">"o"</link> D-Bus property.
-If @observer is not %NULL it may be used to control the
-authentication process.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-This is a synchronous failable constructor. See
-g_dbus_connection_new() for the asynchronous version.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_o() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GIOStream.
-</parameter_description>
-</parameter>
-<parameter name="guid">
-<parameter_description> The GUID to use if a authenticating as a server or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags describing how to make the connection.
-</parameter_description>
-</parameter>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_q">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.q">"q"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_register_object">
+<function name="foo_igen_bar_get_readonly_property">
<description>
-Registers callbacks for exported objects at @object_path with the
-D-Bus interface that is described in @interface_info.
-
-Calls to functions in @vtable (and @user_data_free_func) will
-happen in the <link linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this method from.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.ReadonlyProperty">"ReadonlyProperty"</link> D-Bus property.
-Note that all #GVariant values passed to functions in @vtable will match
-the signature given in @interface_info - if a remote caller passes
-incorrect values, the <literal>org.freedesktop.DBus.Error.InvalidArgs</literal>
-is returned to the remote caller.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-Additionally, if the remote caller attempts to invoke methods or
-access properties not mentioned in @interface_info the
-<literal>org.freedesktop.DBus.Error.UnknownMethod</literal> resp.
-<literal>org.freedesktop.DBus.Error.InvalidArgs</literal> errors
-are returned to the caller.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_readonly_property() if on another thread.</warning>
-It is considered a programming error if the
-#GDBusInterfaceGetPropertyFunc function in @vtable returns a
-#GVariant of incorrect type.
-If an existing callback is already registered at @object_path and
- interface_name, then @error is set to #G_IO_ERROR_EXISTS.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
-GDBus automatically implements the standard D-Bus interfaces
-org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
-and org.freedesktop.Peer, so you don't have to implement those for
-the objects you export. You <emphasis>can</emphasis> implement
-org.freedesktop.DBus.Properties yourself, e.g. to handle getting
-and setting of properties asynchronously.
+<function name="foo_igen_bar_get_s">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.s">"s"</link> D-Bus property.
-Note that the reference count on @interface_info will be
-incremented by 1 (unless allocated statically, e.g. if the
-reference count is -1, see g_dbus_interface_info_ref()) for as long
-as the object is exported. Also note that @vtable will be copied.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-See <xref linkend="gdbus-server"/> for an example of how to use this method.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_s() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> The object path to register at.
-</parameter_description>
-</parameter>
-<parameter name="interface_info">
-<parameter_description> Introspection data for the interface.
-</parameter_description>
-</parameter>
-<parameter name="vtable">
-<parameter_description> A #GDBusInterfaceVTable to call into or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> Data to pass to functions in @vtable.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function to call when the object path is unregistered.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_t">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.t">"t"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_u">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.u">"u"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> 0 if @error is set, otherwise a registration id (never 0)
-that can be used with g_dbus_connection_unregister_object() .
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_register_subtree">
+<function name="foo_igen_bar_get_unset_ag">
<description>
-Registers a whole subtree of <quote>dynamic</quote> objects.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_ag">"unset_ag"</link> D-Bus property.
-The @enumerate and @introspection functions in @vtable are used to
-convey, to remote callers, what nodes exist in the subtree rooted
-by @object_path.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-When handling remote calls into any node in the subtree, first the
- enumerate function is used to check if the node exists. If the node exists
-or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
-the @introspection function is used to check if the node supports the
-requested method. If so, the @dispatch function is used to determine
-where to dispatch the call. The collected #GDBusInterfaceVTable and
-#gpointer will be used to call into the interface vtable for processing
-the request.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_ag() if on another thread.</warning>
-All calls into user-provided code will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this method from.
-If an existing subtree is already registered at @object_path or
-then @error is set to #G_IO_ERROR_EXISTS.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
-Note that it is valid to register regular objects (using
-g_dbus_connection_register_object()) in a subtree registered with
-g_dbus_connection_register_subtree() - if so, the subtree handler
-is tried as the last resort. One way to think about a subtree
-handler is to consider it a <quote>fallback handler</quote>
-for object paths not registered via g_dbus_connection_register_object()
-or other bindings.
+<function name="foo_igen_bar_get_unset_ao">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_ao">"unset_ao"</link> D-Bus property.
-Note that @vtable will be copied so you cannot change it after
-registration.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-See <xref linkend="gdbus-subtree-server"/> for an example of how to use this method.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_ao() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> The object path to register the subtree at.
-</parameter_description>
-</parameter>
-<parameter name="vtable">
-<parameter_description> A #GDBusSubtreeVTable to enumerate, introspect and dispatch nodes in the subtree.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags used to fine tune the behavior of the subtree.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> Data to pass to functions in @vtable.
-</parameter_description>
-</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function to call when the subtree is unregistered.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> 0 if @error is set, otherwise a subtree registration id (never 0)
-that can be used with g_dbus_connection_unregister_subtree() .
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_remove_filter">
+<function name="foo_igen_bar_get_unset_as">
<description>
-Removes a filter.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_as">"unset_as"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_as() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GDBusConnection
-</parameter_description>
-</parameter>
-<parameter name="filter_id">
-<parameter_description> an identifier obtained from g_dbus_connection_add_filter()
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
</function>
-<function name="g_dbus_connection_send_message">
+<function name="foo_igen_bar_get_unset_ay">
<description>
-Asynchronously sends @message to the peer represented by @connection.
-
-Unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
-will be assigned by @connection and set on @message via
-g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
-serial number used will be written to this location prior to
-submitting the message to the underlying transport.
-
-If @connection is closed then the operation will fail with
-%G_IO_ERROR_CLOSED. If @message is not well-formed,
-the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_ay">"unset_ay"</link> D-Bus property.
-See <xref linkend="gdbus-server"/> and <xref
-linkend="gdbus-unix-fd-client"/> for an example of how to use this
-low-level API to send and receive UNIX file descriptors.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Note that @message must be unlocked, unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_ay() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="message">
-<parameter_description> A #GDBusMessage
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags affecting how the message is sent.
-</parameter_description>
-</parameter>
-<parameter name="out_serial">
-<parameter_description> Return location for serial number assigned to @message when sending it or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the message was well-formed and queued for
-transmission, %FALSE if @error is set.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_connection_send_message_with_reply">
+<function name="foo_igen_bar_get_unset_d">
<description>
-Asynchronously sends @message to the peer represented by @connection.
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_d">"unset_d"</link> D-Bus property.
-Unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
-will be assigned by @connection and set on @message via
-g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
-serial number used will be written to this location prior to
-submitting the message to the underlying transport.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-If @connection is closed then the operation will fail with
-%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
-fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
-the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
-This is an asynchronous method. When the operation is finished, @callback will be invoked
-in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
-of the thread you are calling this method from. You can then call
-g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
-See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value.
+</return>
+</function>
-Note that @message must be unlocked, unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+<function name="foo_igen_bar_get_unset_g">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_g">"unset_g"</link> D-Bus property.
-See <xref linkend="gdbus-server"/> and <xref
-linkend="gdbus-unix-fd-client"/> for an example of how to use this
-low-level API to send and receive UNIX file descriptors.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_g() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags affecting how the message is sent.
-</parameter_description>
-</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds, -1 to use the default
-timeout or %G_MAXINT for no timeout.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="out_serial">
-<parameter_description> Return location for serial number assigned to @message when sending it or %NULL.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_unset_i">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_i">"unset_i"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_unset_o">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_o">"unset_o"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_o() if on another thread.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
-care about the result.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_unset_s">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_s">"unset_s"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_s() if on another thread.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_unset_struct">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.unset_struct">"unset_struct"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_unset_struct() if on another thread.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
</function>
-<function name="g_dbus_connection_send_message_with_reply_finish">
+<function name="foo_igen_bar_get_writeonly_property">
<description>
-Finishes an operation started with g_dbus_connection_send_message_with_reply().
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.WriteonlyProperty">"WriteonlyProperty"</link> D-Bus property.
-Note that @error is only set if a local in-process error
-occured. That is to say that the returned #GDBusMessage object may
-be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
-g_dbus_message_to_gerror() to transcode this to a #GError.
+Since this D-Bus property is not readable, it is only meaningful to use this function on the service-side.
-See <xref linkend="gdbus-server"/> and <xref
-linkend="gdbus-unix-fd-client"/> for an example of how to use this
-low-level API to send and receive UNIX file descriptors.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bar_dup_writeonly_property() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GDBusConnection
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_send_message_with_reply().
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_x">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.x">"x"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="foo_igen_bar_get_y">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-Bar.y">"y"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
</parameters>
-<return> A locked #GDBusMessage or %NULL if @error is set.
-
+<return> The property value.
</return>
</function>
-<function name="g_dbus_connection_send_message_with_reply_sync">
+<function name="foo_igen_bar_interface_info">
<description>
-Synchronously sends @message to the peer represented by @connection
-and blocks the calling thread until a reply is received or the
-timeout is reached. See g_dbus_connection_send_message_with_reply()
-for the asynchronous version of this method.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link> D-Bus interface.
-Unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
-will be assigned by @connection and set on @message via
-g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
-serial number used will be written to this location prior to
-submitting the message to the underlying transport.
-If @connection is closed then the operation will fail with
-%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
-fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
-the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
-Note that @error is only set if a local in-process error
-occured. That is to say that the returned #GDBusMessage object may
-be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
-g_dbus_message_to_gerror() to transcode this to a #GError.
+<function name="foo_igen_bar_override_properties">
+<description>
+Overrides all #GObject properties in the #FooiGenBar interface for a concrete class.
+The properties are overridden in the order they are defined.
-See <xref linkend="gdbus-server"/> and <xref
-linkend="gdbus-unix-fd-client"/> for an example of how to use this
-low-level API to send and receive UNIX file descriptors.
-Note that @message must be unlocked, unless @flags contain the
-%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+</description>
+<parameters>
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The last property id.
+</return>
+</function>
-Since: 2.26
+<function name="foo_igen_bar_proxy_new">
+<description>
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link>. See g_dbus_proxy_new() for more details.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_bar_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
@@ -6958,172 +7261,165 @@ Since: 2.26
<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
<parameter name="flags">
-<parameter_description> Flags affecting how the message is sent.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds, -1 to use the default
-timeout or %G_MAXINT for no timeout.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="out_serial">
-<parameter_description> Return location for serial number assigned to @message when sending it or %NULL.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A locked #GDBusMessage that is the reply to @message or %NULL if @error is set.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_connection_set_exit_on_close">
+<function name="foo_igen_bar_proxy_new_finish">
<description>
-Sets whether the process should be terminated when @connection is
-closed by the remote peer. See #GDBusConnection:exit-on-close for
-more details.
+Finishes an operation started with foo_igen_bar_proxy_new().
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_proxy_new().
</parameter_description>
</parameter>
-<parameter name="exit_on_close">
-<parameter_description> Whether the process should be terminated
-when @connection is closed by the remote peer.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_connection_signal_subscribe">
+<function name="foo_igen_bar_proxy_new_for_bus">
<description>
-Subscribes to signals on @connection and invokes @callback with a
-whenever the signal is received. Note that @callback
-will be invoked in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread you are calling this method from.
-
-If @connection is not a message bus connection, @sender must be
-%NULL.
+Like foo_igen_bar_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-If @sender is a well-known name note that @callback is invoked with
-the unique name for the owner of @sender, not the well-known name
-as one would expect. This is because the message bus rewrites the
-name. As such, to avoid certain race conditions, users should be
-tracking the name owner of the well-known name and use that when
-processing the received signal.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bar_proxy_new_for_bus_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_bar_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="sender">
-<parameter_description> Sender name to match on (unique or well-known name) or %NULL to listen from all senders.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="interface_name">
-<parameter_description> D-Bus interface name to match on or %NULL to match on all interfaces.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="member">
-<parameter_description> D-Bus signal name to match on or %NULL to match on all signals.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
<parameter name="object_path">
-<parameter_description> Object path to match on or %NULL to match on all object paths.
-</parameter_description>
-</parameter>
-<parameter name="arg0">
-<parameter_description> Contents of first string argument to match on or %NULL to match on all kinds of arguments.
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags describing how to subscribe to the signal (currently unused).
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> Callback to invoke when there is a signal matching the requested data.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="user_data_free_func">
-<parameter_description> Function to free @user_data with when subscription is removed or %NULL.
-</parameter_description>
-</parameter>
</parameters>
-<return> A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_connection_signal_unsubscribe">
+<function name="foo_igen_bar_proxy_new_for_bus_finish">
<description>
-Unsubscribes from signals.
+Finishes an operation started with foo_igen_bar_proxy_new_for_bus().
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bar_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="subscription_id">
-<parameter_description> A subscription id obtained from g_dbus_connection_signal_subscribe().
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_connection_start_message_processing">
+<function name="foo_igen_bar_proxy_new_for_bus_sync">
<description>
-If @connection was created with
-%G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
-starts processing messages. Does nothing on if @connection wasn't
-created with this flag or if the method has already been called.
+Like foo_igen_bar_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_connection_unregister_object">
+<function name="foo_igen_bar_proxy_new_sync">
<description>
-Unregisters an object.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bar_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
@@ -7131,1370 +7427,1294 @@ Since: 2.26
<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="registration_id">
-<parameter_description> A registration id obtained from g_dbus_connection_register_object().
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the object was unregistered, %FALSE otherwise.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_connection_unregister_subtree">
+<function name="foo_igen_bar_set_aay">
<description>
-Unregisters a subtree.
+Sets the <link linkend="gdbus-property-org-project-Bar.aay">"aay"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="registration_id">
-<parameter_description> A subtree registration id obtained from g_dbus_connection_register_subtree().
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the subtree was unregistered, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_encode_gerror">
+<function name="foo_igen_bar_set_ag">
<description>
-Creates a D-Bus error name to use for @error. If @error matches
-a registered error (cf. g_dbus_error_register_error()), the corresponding
-D-Bus error name will be returned.
-
-Otherwise the a name of the form
-<literal>org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE</literal>
-will be used. This allows other GDBus applications to map the error
-on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
-
-This function is typically only used in object mappings to put a
-#GError on the wire. Regular applications should not use it.
+Sets the <link linkend="gdbus-property-org-project-Bar.ag">"ag"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A #GError.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A D-Bus error name (never %NULL). Free with g_free().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_get_remote_error">
+<function name="foo_igen_bar_set_ao">
<description>
-Gets the D-Bus error name used for @error, if any.
-
-This function is guaranteed to return a D-Bus error name for all
-#GError<!-- -->s returned from functions handling remote method
-calls (e.g. g_dbus_connection_call_finish()) unless
-g_dbus_error_strip_remote_error() has been used on @error.
+Sets the <link linkend="gdbus-property-org-project-Bar.ao">"ao"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A #GError.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_is_remote_error">
+<function name="foo_igen_bar_set_as">
<description>
-Checks if @error represents an error received via D-Bus from a remote peer. If so,
-use g_dbus_error_get_remote_error() to get the name of the error.
+Sets the <link linkend="gdbus-property-org-project-Bar.as">"as"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A #GError.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @error represents an error from a remote peer,
-%FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_new_for_dbus_error">
+<function name="foo_igen_bar_set_ay">
<description>
-Creates a #GError based on the contents of @dbus_error_name and
- dbus_error_message
-
-Errors registered with g_dbus_error_register_error() will be looked
-up using @dbus_error_name and if a match is found, the error domain
-and code is used. Applications can use g_dbus_error_get_remote_error()
-to recover @dbus_error_name.
-
-If a match against a registered error is not found and the D-Bus
-error name is in a form as returned by g_dbus_error_encode_gerror()
-the error domain and code encoded in the name is used to
-create the #GError. Also, @dbus_error_name is added to the error message
-such that it can be recovered with g_dbus_error_get_remote_error().
-
-Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
-in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
-added to the error message such that it can be recovered with
-g_dbus_error_get_remote_error().
-
-In all three cases, @dbus_error_name can always be recovered from the
-returned #GError using the g_dbus_error_get_remote_error() function
-(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
-
-This function is typically only used in object mappings to prepare
-#GError instances for applications. Regular applications should not use
-it.
+Sets the <link linkend="gdbus-property-org-project-Bar.ay">"ay"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="dbus_error_name">
-<parameter_description> D-Bus error name.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="dbus_error_message">
-<parameter_description> D-Bus error message.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> An allocated #GError. Free with g_error_free().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_register_error">
+<function name="foo_igen_bar_set_b">
<description>
-Creates an association to map between @dbus_error_name and
-#GError<!-- -->s specified by @error_domain and @error_code.
-
-This is typically done in the routine that returns the #GQuark for
-an error domain.
+Sets the <link linkend="gdbus-property-org-project-Bar.b">"b"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error_domain">
-<parameter_description> A #GQuark for a error domain.
-</parameter_description>
-</parameter>
-<parameter name="error_code">
-<parameter_description> An error code.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="dbus_error_name">
-<parameter_description> A D-Bus error name.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the association was created, %FALSE if it already
-exists.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_register_error_domain">
+<function name="foo_igen_bar_set_d">
<description>
-Helper function for associating a #GError error domain with D-Bus error names.
+Sets the <link linkend="gdbus-property-org-project-Bar.d">"d"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error_domain_quark_name">
-<parameter_description> The error domain name.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="quark_volatile">
-<parameter_description> A pointer where to store the #GQuark.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
-<parameter name="entries">
-<parameter_description> A pointer to @num_entries #GDBusErrorEntry struct items.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_bar_set_finally_normal_name">
+<description>
+Sets the <link linkend="gdbus-property-org-project-Bar.FinallyNormalName">"FinallyNormalName"</link> D-Bus property to @value.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="num_entries">
-<parameter_description> Number of items to register.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_error_set_dbus_error">
+<function name="foo_igen_bar_set_g">
<description>
-Does nothing if @error is %NULL. Otherwise sets * error to
-a new #GError created with g_dbus_error_new_for_dbus_error()
-with @dbus_error_message prepend with @format (unless %NULL).
+Sets the <link linkend="gdbus-property-org-project-Bar.g">"g"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A pointer to a #GError or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="dbus_error_name">
-<parameter_description> D-Bus error name.
-</parameter_description>
-</parameter>
-<parameter name="dbus_error_message">
-<parameter_description> D-Bus error message.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> Arguments for @format.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_error_set_dbus_error_valist">
+<function name="foo_igen_bar_set_i">
<description>
-Like g_dbus_error_set_dbus_error() but intended for language bindings.
+Sets the <link linkend="gdbus-property-org-project-Bar.i">"i"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A pointer to a #GError or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="dbus_error_name">
-<parameter_description> D-Bus error name.
-</parameter_description>
-</parameter>
-<parameter name="dbus_error_message">
-<parameter_description> D-Bus error message.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> Arguments for @format.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_error_strip_remote_error">
+<function name="foo_igen_bar_set_n">
<description>
-Looks for extra information in the error message used to recover
-the D-Bus error name and strips it if found. If stripped, the
-message field in @error will correspond exactly to what was
-received on the wire.
-
-This is typically used when presenting errors to the end user.
+Sets the <link linkend="gdbus-property-org-project-Bar.n">"n"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> A #GError.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if information was stripped, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_error_unregister_error">
+<function name="foo_igen_bar_set_o">
<description>
-Destroys an association previously set up with g_dbus_error_register_error().
+Sets the <link linkend="gdbus-property-org-project-Bar.o">"o"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="error_domain">
-<parameter_description> A #GQuark for a error domain.
-</parameter_description>
-</parameter>
-<parameter name="error_code">
-<parameter_description> An error code.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="dbus_error_name">
-<parameter_description> A D-Bus error name.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the association was destroyed, %FALSE if it wasn't found.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_generate_guid">
+<function name="foo_igen_bar_set_q">
<description>
-Generate a D-Bus GUID that can be used with
-e.g. g_dbus_connection_new().
-
-See the D-Bus specification regarding what strings are valid D-Bus
-GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
+Sets the <link linkend="gdbus-property-org-project-Bar.q">"q"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
</parameters>
-<return> A valid D-Bus GUID. Free with g_free().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_interface_info_generate_xml">
+<function name="foo_igen_bar_set_readonly_property">
<description>
-Appends an XML representation of @info (and its children) to @string_builder.
-
-This function is typically used for generating introspection XML
-documents at run-time for handling the
-<literal>org.freedesktop.DBus.Introspectable.Introspect</literal>
-method.
+Sets the <link linkend="gdbus-property-org-project-Bar.ReadonlyProperty">"ReadonlyProperty"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo
-</parameter_description>
-</parameter>
-<parameter name="indent">
-<parameter_description> Indentation level.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="string_builder">
-<parameter_description> A #GString to to append XML data to.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_interface_info_lookup_method">
+<function name="foo_igen_bar_set_s">
<description>
-Looks up information about a method.
+Sets the <link linkend="gdbus-property-org-project-Bar.s">"s"</link> D-Bus property to @value.
-This cost of this function is O(n) in number of methods.
-
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> A D-Bus method name (typically in CamelCase)
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_interface_info_lookup_property">
+<function name="foo_igen_bar_set_t">
<description>
-Looks up information about a property.
-
-This cost of this function is O(n) in number of properties.
+Sets the <link linkend="gdbus-property-org-project-Bar.t">"t"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> A D-Bus property name (typically in CamelCase).
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_interface_info_lookup_signal">
+<function name="foo_igen_bar_set_u">
<description>
-Looks up information about a signal.
+Sets the <link linkend="gdbus-property-org-project-Bar.u">"u"</link> D-Bus property to @value.
-This cost of this function is O(n) in number of signals.
-
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> A D-Bus signal name (typically in CamelCase)
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_interface_info_ref">
+<function name="foo_igen_bar_set_unset_ag">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_ag">"unset_ag"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_interface_info_unref">
+<function name="foo_igen_bar_set_unset_ao">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_ao">"unset_ao"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_is_address">
+<function name="foo_igen_bar_set_unset_as">
<description>
-Checks if @string is a D-Bus address.
-
-This doesn't check if @string is actually supported by #GDBusServer
-or #GDBusConnection - use g_dbus_is_supported_address() to do more
-checks.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_as">"unset_as"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> A string.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @string is a valid D-Bus address, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_guid">
+<function name="foo_igen_bar_set_unset_ay">
<description>
-Checks if @string is a D-Bus GUID.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_ay">"unset_ay"</link> D-Bus property to @value.
-See the D-Bus specification regarding what strings are valid D-Bus
-GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
-
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> The string to check.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @string is a guid, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_interface_name">
+<function name="foo_igen_bar_set_unset_d">
<description>
-Checks if @string is a valid D-Bus interface name.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_d">"unset_d"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> The string to check.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if valid, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_member_name">
+<function name="foo_igen_bar_set_unset_g">
<description>
-Checks if @string is a valid D-Bus member (e.g. signal or method) name.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_g">"unset_g"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> The string to check.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if valid, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_name">
+<function name="foo_igen_bar_set_unset_i">
<description>
-Checks if @string is a valid D-Bus bus name (either unique or well-known).
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_i">"unset_i"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> The string to check.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if valid, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_supported_address">
+<function name="foo_igen_bar_set_unset_o">
<description>
-Like g_dbus_is_address() but also checks if the library suppors the
-transports in @string and that key/value pairs for each transport
-are valid.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_o">"unset_o"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> A string.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @string is a valid D-Bus address that is
-supported by this library, %FALSE if @error is set.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_is_unique_name">
+<function name="foo_igen_bar_set_unset_s">
<description>
-Checks if @string is a valid D-Bus unique bus name.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_s">"unset_s"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="string">
-<parameter_description> The string to check.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if valid, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_bytes_needed">
+<function name="foo_igen_bar_set_unset_struct">
<description>
-Utility function to calculate how many bytes are needed to
-completely deserialize the D-Bus message stored at @blob.
+Sets the <link linkend="gdbus-property-org-project-Bar.unset_struct">"unset_struct"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="blob">
-<parameter_description> A blob represent a binary D-Bus message.
-</parameter_description>
-</parameter>
-<parameter name="blob_len">
-<parameter_description> The length of @blob (must be at least 16).
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes needed or -1 if @error is set (e.g. if
- blob contains invalid data or not enough data is available to
-determine the size).
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_copy">
+<function name="foo_igen_bar_set_writeonly_property">
<description>
-Copies @message. The copy is a deep copy and the returned
-#GDBusMessage is completely identical except that it is guaranteed
-to not be locked.
-
-This operation can fail if e.g. @message contains file descriptors
-and the per-process or system-wide open files limit is reached.
+Sets the <link linkend="gdbus-property-org-project-Bar.WriteonlyProperty">"WriteonlyProperty"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A new #GDBusMessage or %NULL if @error is set. Free with
-g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_arg0">
+<function name="foo_igen_bar_set_x">
<description>
-Convenience to get the first item in the body of @message.
+Sets the <link linkend="gdbus-property-org-project-Bar.x">"x"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> The string item or %NULL if the first item in the body of
- message is not a string.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_body">
+<function name="foo_igen_bar_set_y">
<description>
-Gets the body of a message.
+Sets the <link linkend="gdbus-property-org-project-Bar.y">"y"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBar.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_byte_order">
+<function name="foo_igen_bar_skeleton_new">
<description>
-Gets the byte order of @message.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link>.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
</parameters>
-<return> The byte order.
+<return> The skeleton object.
</return>
</function>
-<function name="g_dbus_message_get_destination">
+<function name="foo_igen_bat_call_force_method">
<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-Bat.ForceMethod">ForceMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bat_call_force_method_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_bat_call_force_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBatProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_i">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_s">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_ay">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_struct">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_error_name">
+<function name="foo_igen_bat_call_force_method_finish">
<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+Finishes an operation started with foo_igen_bat_call_force_method().
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBatProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_i">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_s">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_ay">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_struct">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bat_call_force_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_message_get_flags">
+<function name="foo_igen_bat_call_force_method_sync">
<description>
-Gets the flags for @message.
+Synchronously invokes the <link linkend="gdbus-method-org-project-Bat.ForceMethod">ForceMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_bat_call_force_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="proxy">
+<parameter_description> A #FooiGenBatProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_i">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_s">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_ay">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_force_in_struct">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_i">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_s">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_ay">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_force_out_struct">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_message_get_header">
+<function name="foo_igen_bat_complete_force_method">
<description>
-Gets a header field on @message.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-Bat.ForceMethod">ForceMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-<parameter name="header_field">
-<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="force_out_i">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="force_out_s">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="force_out_ay">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="force_out_struct">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
-<return> A #GVariant with the value if the header was found, %NULL
-otherwise. Do not free, it is owned by @message.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_header_fields">
+<function name="foo_igen_bat_dup_force_ay">
<description>
-Gets an array of all header fields on @message that are set.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bat.force_ay">"force_ay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> An array of header fields terminated by
-%G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element is a
-#guchar. Free with g_free().
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_message_get_interface">
+<function name="foo_igen_bat_dup_force_i">
<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bat.force_i">"force_i"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_message_get_locked">
+<function name="foo_igen_bat_dup_force_s">
<description>
-Checks whether @message is locked. To monitor changes to this
-value, conncet to the #GObject::notify signal to listen for changes
-on the #GDBusMessage:locked property.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bat.force_s">"force_s"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @message is locked, %FALSE otherwise.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_message_get_member">
+<function name="foo_igen_bat_dup_force_struct">
<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+Gets a copy of the <link linkend="gdbus-property-org-project-Bat.force_struct">"force_struct"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_dbus_message_get_message_type">
+<function name="foo_igen_bat_emit_force_signal">
<description>
-Gets the type of @message.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-org-project-Bat.ForceSignal">"ForceSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-</parameters>
-<return> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
-
-</return>
-</function>
-
-<function name="g_dbus_message_get_num_unix_fds">
-<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="arg_force_i">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-</parameters>
-<return> The value.
-
-</return>
-</function>
-
-<function name="g_dbus_message_get_path">
-<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="arg_force_s">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-</parameters>
-<return> The value.
-
-</return>
-</function>
-
-<function name="g_dbus_message_get_reply_serial">
-<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="arg_force_ay">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-</parameters>
-<return> The value.
-
-</return>
-</function>
-
-<function name="g_dbus_message_get_sender">
-<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="arg_force_struct">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_get_serial">
+<function name="foo_igen_bat_get_force_ay">
<description>
-Gets the serial for @message.
+Gets the value of the <link linkend="gdbus-property-org-project-Bat.force_ay">"force_ay"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bat_dup_force_ay() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> A #guint32.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_message_get_signature">
+<function name="foo_igen_bat_get_force_i">
<description>
-Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+Gets the value of the <link linkend="gdbus-property-org-project-Bat.force_i">"force_i"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bat_dup_force_i() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return> The value.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_message_get_unix_fd_list">
+<function name="foo_igen_bat_get_force_s">
<description>
-Gets the UNIX file descriptors associated with @message, if any.
+Gets the value of the <link linkend="gdbus-property-org-project-Bat.force_s">"force_s"</link> D-Bus property.
-This method is only available on UNIX.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bat_dup_force_s() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return>A #GUnixFDList or %NULL if no file descriptors are
-associated. Do not free, this object is owned by @message.
-
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_dbus_message_lock">
+<function name="foo_igen_bat_get_force_struct">
<description>
-If @message is locked, does nothing. Otherwise locks the message.
+Gets the value of the <link linkend="gdbus-property-org-project-Bat.force_struct">"force_struct"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_bat_dup_force_struct() if on another thread.</warning>
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
</function>
-<function name="g_dbus_message_new">
+<function name="foo_igen_bat_interface_info">
<description>
-Creates a new empty #GDBusMessage.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link> D-Bus interface.
-Since: 2.26
</description>
<parameters>
</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_dbus_message_new_from_blob">
+<function name="foo_igen_bat_override_properties">
<description>
-Creates a new #GDBusMessage from the data stored at @blob. The byte
-order that the message was in can be retrieved using
-g_dbus_message_get_byte_order().
+Overrides all #GObject properties in the #FooiGenBat interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
</description>
<parameters>
-<parameter name="blob">
-<parameter_description> A blob represent a binary D-Bus message.
-</parameter_description>
-</parameter>
-<parameter name="blob_len">
-<parameter_description> The length of @blob.
-</parameter_description>
-</parameter>
-<parameter name="capabilities">
-<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> A new #GDBusMessage or %NULL if @error is set. Free with
-g_object_unref().
-
+<return> The last property id.
</return>
</function>
-<function name="g_dbus_message_new_method_call">
+<function name="foo_igen_bat_proxy_new">
<description>
-Creates a new #GDBusMessage for a method call.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link>. See g_dbus_proxy_new() for more details.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bat_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_bat_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
<parameter name="name">
-<parameter_description> A valid D-Bus name or %NULL.
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> A valid object path.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="interface_">
-<parameter_description> A valid D-Bus interface name or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="method">
-<parameter_description> A valid method name.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_new_method_error">
+<function name="foo_igen_bat_proxy_new_finish">
<description>
-Creates a new #GDBusMessage that is an error reply to @method_call_message.
+Finishes an operation started with foo_igen_bat_proxy_new().
-Since: 2.26
</description>
<parameters>
-<parameter name="method_call_message">
-<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
-create a reply message to.
-</parameter_description>
-</parameter>
-<parameter name="error_name">
-<parameter_description> A valid D-Bus error name.
-</parameter_description>
-</parameter>
-<parameter name="error_message_format">
-<parameter_description> The D-Bus error message in a printf() format.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bat_proxy_new().
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> Arguments for @error_message_format.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_message_new_method_error_literal">
+<function name="foo_igen_bat_proxy_new_for_bus">
<description>
-Creates a new #GDBusMessage that is an error reply to @method_call_message.
+Like foo_igen_bat_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_bat_proxy_new_for_bus_finish() to get the result of the operation.
+
+See foo_igen_bat_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="method_call_message">
-<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
-create a reply message to.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="error_name">
-<parameter_description> A valid D-Bus error name.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="error_message">
-<parameter_description> The D-Bus error message.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
-</return>
-</function>
-
-<function name="g_dbus_message_new_method_error_valist">
-<description>
-Like g_dbus_message_new_method_error() but intended for language bindings.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="method_call_message">
-<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
-create a reply message to.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="error_name">
-<parameter_description> A valid D-Bus error name.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error_message_format">
-<parameter_description> The D-Bus error message in a printf() format.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> Arguments for @error_message_format.
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_message_new_method_reply">
+<function name="foo_igen_bat_proxy_new_for_bus_finish">
<description>
-Creates a new #GDBusMessage that is a reply to @method_call_message.
+Finishes an operation started with foo_igen_bat_proxy_new_for_bus().
-Since: 2.26
</description>
<parameters>
-<parameter name="method_call_message">
-<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
-create a reply message to.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_bat_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> #GDBusMessage. Free with g_object_unref().
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_message_new_signal">
+<function name="foo_igen_bat_proxy_new_for_bus_sync">
<description>
-Creates a new #GDBusMessage for a signal emission.
+Like foo_igen_bat_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bat_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="path">
-<parameter_description> A valid object path.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="interface_">
-<parameter_description> A valid D-Bus interface name.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="signal">
-<parameter_description> A valid signal name.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMessage. Free with g_object_unref().
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_message_print">
+<function name="foo_igen_bat_proxy_new_sync">
<description>
-Produces a human-readable multi-line description of @message.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link>. See g_dbus_proxy_new_sync() for more details.
-The contents of the description has no ABI guarantees, the contents
-and formatting is subject to change at any time. Typical output
-looks something like this:
-<programlisting>
-Type: method-call
-Flags: none
-Version: 0
-Serial: 4
-Headers:
-path -> objectpath '/org/gtk/GDBus/TestObject'
-interface -> 'org.gtk.GDBus.TestInterface'
-member -> 'GimmeStdout'
-destination -> ':1.146'
-Body: ()
-UNIX File Descriptors:
-(none)
-</programlisting>
-or
-<programlisting>
-Type: method-return
-Flags: no-reply-expected
-Version: 0
-Serial: 477
-Headers:
-reply-serial -> uint32 4
-destination -> ':1.159'
-sender -> ':1.146'
-num-unix-fds -> uint32 1
-Body: ()
-UNIX File Descriptors:
-fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
-</programlisting>
+The calling thread is blocked until a reply is received.
+
+See foo_igen_bat_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="indent">
-<parameter_description> Indentation level.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A string that should be freed with g_free().
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_message_set_body">
+<function name="foo_igen_bat_set_force_ay">
<description>
-Sets the body @message. As a side-effect the
-%G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
-type string of @body (or cleared if @body is %NULL).
-
-If @body is floating, @message assumes ownership of @body.
+Sets the <link linkend="gdbus-property-org-project-Bat.force_ay">"force_ay"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-<parameter name="body">
-<parameter_description> Either %NULL or a #GVariant that is a tuple.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_message_set_byte_order">
+<function name="foo_igen_bat_set_force_i">
<description>
-Sets the byte order of @message.
+Sets the <link linkend="gdbus-property-org-project-Bat.force_i">"force_i"</link> D-Bus property to @value.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
-<parameter name="byte_order">
-<parameter_description> The byte order.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_message_set_destination">
+<function name="foo_igen_bat_set_force_s">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+Sets the <link linkend="gdbus-property-org-project-Bat.force_s">"force_s"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
<parameter name="value">
@@ -8505,16 +8725,16 @@ Since: 2.26
<return></return>
</function>
-<function name="g_dbus_message_set_error_name">
+<function name="foo_igen_bat_set_force_struct">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+Sets the <link linkend="gdbus-property-org-project-Bat.force_struct">"force_struct"</link> D-Bus property to @value.
-Since: 2.26
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="object">
+<parameter_description> A #FooiGenBat.
</parameter_description>
</parameter>
<parameter name="value">
@@ -8525,918 +8745,923 @@ Since: 2.26
<return></return>
</function>
-<function name="g_dbus_message_set_flags">
+<function name="foo_igen_bat_skeleton_new">
<description>
-Sets the flags to set on @message.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link>.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags for @message that are set (typically values from the #GDBusMessageFlags
-enumeration bitwise ORed together).
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> The skeleton object.
+</return>
</function>
-<function name="g_dbus_message_set_header">
+<function name="foo_igen_baz_interface_info">
<description>
-Sets a header field on @message.
-
-If @value is floating, @message assumes ownership of @value.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link> D-Bus interface.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
-<parameter name="header_field">
-<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> A #GVariant to set the header field or %NULL to clear the header field.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
</function>
-<function name="g_dbus_message_set_interface">
+<function name="foo_igen_baz_override_properties">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+Overrides all #GObject properties in the #FooiGenBaz interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+</return>
</function>
-<function name="g_dbus_message_set_member">
+<function name="foo_igen_baz_proxy_new">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link>. See g_dbus_proxy_new() for more details.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_baz_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_baz_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_message_set_message_type">
+<function name="foo_igen_baz_proxy_new_finish">
<description>
-Sets @message to be of @type.
+Finishes an operation started with foo_igen_baz_proxy_new().
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_baz_proxy_new().
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_message_set_num_unix_fds">
+<function name="foo_igen_baz_proxy_new_for_bus">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
+Like foo_igen_baz_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_baz_proxy_new_for_bus_finish() to get the result of the operation.
+
+See foo_igen_baz_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_message_set_path">
+<function name="foo_igen_baz_proxy_new_for_bus_finish">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+Finishes an operation started with foo_igen_baz_proxy_new_for_bus().
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_baz_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_message_set_reply_serial">
+<function name="foo_igen_baz_proxy_new_for_bus_sync">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+Like foo_igen_baz_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_baz_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_dbus_message_set_sender">
-<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_message_set_serial">
+<function name="foo_igen_baz_proxy_new_sync">
<description>
-Sets the serial for @message.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_baz_proxy_new() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="serial">
-<parameter_description> A #guint32.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_message_set_signature">
+<function name="foo_igen_baz_skeleton_new">
<description>
-Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link>.
-Since: 2.26
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> The value to set.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> The skeleton object.
+</return>
</function>
-<function name="g_dbus_message_set_unix_fd_list">
+<function name="foo_igen_changing_interface_v10_call_added_method_in10">
<description>
-Sets the UNIX file descriptors associated with @message. As a
-side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
-field is set to the number of fds in @fd_list (or cleared if
- fd_list is %NULL).
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.AddedMethodIn10">AddedMethodIn10()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_call_added_method_in10_finish() to get the result of the operation.
-This method is only available on UNIX.
+See foo_igen_changing_interface_v10_call_added_method_in10_sync() for the synchronous, blocking version of this method.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
</parameter_description>
</parameter>
-<parameter name="fd_list">
-<parameter_description> A #GUnixFDList or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_message_to_blob">
+<function name="foo_igen_changing_interface_v10_call_added_method_in10_finish">
<description>
-Serializes @message to a blob. The byte order returned by
-g_dbus_message_get_byte_order() will be used.
+Finishes an operation started with foo_igen_changing_interface_v10_call_added_method_in10().
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
-</parameter_description>
-</parameter>
-<parameter name="out_size">
-<parameter_description> Return location for size of generated blob.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
</parameter_description>
</parameter>
-<parameter name="capabilities">
-<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_call_added_method_in10().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A pointer to a valid binary D-Bus message of @out_size bytes
-generated by @message or %NULL if @error is set. Free with g_free().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_message_to_gerror">
+<function name="foo_igen_changing_interface_v10_call_added_method_in10_sync">
<description>
-If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
-nothing and returns %FALSE.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.AddedMethodIn10">AddedMethodIn10()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-Otherwise this method encodes the error in @message as a #GError
-using g_dbus_error_set_dbus_error() using the information in the
-%G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as
-well as the first string item in @message's body.
+See foo_igen_changing_interface_v10_call_added_method_in10() for the asynchronous version of this method.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="message">
-<parameter_description> A #GDBusMessage.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> The #GError to set.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @error was set, %FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_info_ref">
+<function name="foo_igen_changing_interface_v10_call_bar_method">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.BarMethod">BarMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_call_bar_method_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v10_call_bar_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusMethodInfo
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_method_info_unref">
+<function name="foo_igen_changing_interface_v10_call_bar_method_finish">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Finishes an operation started with foo_igen_changing_interface_v10_call_bar_method().
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusMethodInfo.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_call_bar_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
</function>
-<function name="g_dbus_method_invocation_get_connection">
+<function name="foo_igen_changing_interface_v10_call_bar_method_sync">
<description>
-Gets the #GDBusConnection the method was invoked on.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.BarMethod">BarMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v10_call_bar_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return>A #GDBusConnection. Do not free, it is owned by @invocation.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_get_interface_name">
+<function name="foo_igen_changing_interface_v10_call_baz_method">
<description>
-Gets the name of the D-Bus interface the method was invoked on.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.BazMethod">BazMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_call_baz_method_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v10_call_baz_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A string. Do not free, it is owned by @invocation.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_method_invocation_get_message">
+<function name="foo_igen_changing_interface_v10_call_baz_method_finish">
<description>
-Gets the #GDBusMessage for the method invocation. This is useful if
-you need to use low-level protocol features, such as UNIX file
-descriptor passing, that cannot be properly expressed in the
-#GVariant API.
-
-See <xref linkend="gdbus-server"/> and <xref
-linkend="gdbus-unix-fd-client"/> for an example of how to use this
-low-level API to send and receive UNIX file descriptors.
+Finishes an operation started with foo_igen_changing_interface_v10_call_baz_method().
-Since: 2.26
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_call_baz_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #GDBusMessage. Do not free, it is owned by @invocation.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_get_method_info">
+<function name="foo_igen_changing_interface_v10_call_baz_method_sync">
<description>
-Gets information about the method call, if any.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.BazMethod">BazMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v10_call_baz_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_get_method_name">
+<function name="foo_igen_changing_interface_v10_call_foo_method">
<description>
-Gets the name of the method that was invoked.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.FooMethod">FooMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_call_foo_method_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v10_call_foo_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A string. Do not free, it is owned by @invocation.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_method_invocation_get_object_path">
+<function name="foo_igen_changing_interface_v10_call_foo_method_finish">
<description>
-Gets the object path the method was invoked on.
+Finishes an operation started with foo_igen_changing_interface_v10_call_foo_method().
-Since: 2.26
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_call_foo_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A string. Do not free, it is owned by @invocation.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_get_parameters">
+<function name="foo_igen_changing_interface_v10_call_foo_method_sync">
<description>
-Gets the parameters of the method invocation.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.FooMethod">FooMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v10_call_foo_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A #GVariant. Do not free, it is owned by @invocation.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_get_sender">
+<function name="foo_igen_changing_interface_v10_call_new_method_in2">
<description>
-Gets the bus name that invoked the method.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.NewMethodIn2">NewMethodIn2()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_call_new_method_in2_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v10_call_new_method_in2_sync() for the synchronous, blocking version of this method.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A string. Do not free, it is owned by @invocation.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_method_invocation_get_user_data">
+<function name="foo_igen_changing_interface_v10_call_new_method_in2_finish">
<description>
-Gets the @user_data #gpointer passed to g_dbus_connection_register_object().
+Finishes an operation started with foo_igen_changing_interface_v10_call_new_method_in2().
-Since: 2.26
+Since: 2.0
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_call_new_method_in2().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A #gpointer.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_method_invocation_return_dbus_error">
+<function name="foo_igen_changing_interface_v10_call_new_method_in2_sync">
<description>
-Finishes handling a D-Bus method call by returning an error.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV10.NewMethodIn2">NewMethodIn2()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-This method will free @invocation, you cannot use it afterwards.
+See foo_igen_changing_interface_v10_call_new_method_in2() for the asynchronous version of this method.
-Since: 2.26
+Since: 2.0
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV10Proxy.
</parameter_description>
</parameter>
-<parameter name="error_name">
-<parameter_description> A valid D-Bus error name.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error_message">
-<parameter_description> A valid D-Bus error message.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+
+</return>
</function>
-<function name="g_dbus_method_invocation_return_error">
+<function name="foo_igen_changing_interface_v10_complete_added_method_in10">
<description>
-Finishes handling a D-Bus method call by returning an error.
-
-See g_dbus_error_encode_gerror() for details about what error name
-will be returned on the wire. In a nutshell, if the given error is
-registered using g_dbus_error_register_error() the name given
-during registration is used. Otherwise, a name of the form
-<literal>org.gtk.GDBus.UnmappedGError.Quark...</literal> is
-used. This provides transparent mapping of #GError between
-applications using GDBus.
-
-If you are writing an application intended to be portable,
-<emphasis>always</emphasis> register errors with g_dbus_error_register_error()
-or use g_dbus_method_invocation_return_dbus_error().
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV10.AddedMethodIn10">AddedMethodIn10()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
This method will free @invocation, you cannot use it afterwards.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> A #GQuark for the #GError error domain.
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> The error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> Parameters for @format.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_method_invocation_return_error_literal">
+<function name="foo_igen_changing_interface_v10_complete_bar_method">
<description>
-Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV10.BarMethod">BarMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
This method will free @invocation, you cannot use it afterwards.
-Since: 2.26
-
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> A #GQuark for the #GError error domain.
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> The error code.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="message">
-<parameter_description> The error message.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_method_invocation_return_error_valist">
+<function name="foo_igen_changing_interface_v10_complete_baz_method">
<description>
-Like g_dbus_method_invocation_return_error() but intended for
-language bindings.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV10.BazMethod">BazMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
This method will free @invocation, you cannot use it afterwards.
-Since: 2.26
-
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> A #GQuark for the #GError error domain.
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> The error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="var_args">
-<parameter_description> #va_list of parameters for @format.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_method_invocation_return_gerror">
+<function name="foo_igen_changing_interface_v10_complete_foo_method">
<description>
-Like g_dbus_method_invocation_return_error() but takes a #GError
-instead of the error domain, error code and message.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV10.FooMethod">FooMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
This method will free @invocation, you cannot use it afterwards.
-Since: 2.26
-
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> A #GError.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_method_invocation_return_value">
+<function name="foo_igen_changing_interface_v10_complete_new_method_in2">
<description>
-Finishes handling a D-Bus method call by returning @parameters.
-If the @parameters GVariant is floating, it is consumed.
-
-It is an error if @parameters is not of the right format.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV10.NewMethodIn2">NewMethodIn2()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
This method will free @invocation, you cannot use it afterwards.
-Since: 2.26
+Since: 2.0
</description>
<parameters>
-<parameter name="invocation">
-<parameter_description> A #GDBusMethodInvocation.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_node_info_generate_xml">
+<function name="foo_igen_changing_interface_v10_emit_added_signal_in10">
<description>
-Appends an XML representation of @info (and its children) to @string_builder.
-
-This function is typically used for generating introspection XML documents at run-time for
-handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method.
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV10.AddedSignalIn10">"AddedSignalIn10"</link> D-Bus signal.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo.
-</parameter_description>
-</parameter>
-<parameter name="indent">
-<parameter_description> Indentation level.
-</parameter_description>
-</parameter>
-<parameter name="string_builder">
-<parameter_description> A #GString to to append XML data to.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_node_info_lookup_interface">
+<function name="foo_igen_changing_interface_v10_emit_bar_signal">
<description>
-Looks up information about an interface.
-
-This cost of this function is O(n) in number of interfaces.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV10.BarSignal">"BarSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> A D-Bus interface name.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_node_info_new_for_xml">
+<function name="foo_igen_changing_interface_v10_emit_baz_signal">
<description>
-Parses @xml_data and returns a #GDBusNodeInfo representing the data.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV10.BazSignal">"BazSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="xml_data">
-<parameter_description> Valid D-Bus introspection XML.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusNodeInfo structure or %NULL if @error is set. Free
-with g_dbus_node_info_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_node_info_ref">
+<function name="foo_igen_changing_interface_v10_emit_foo_signal">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV10.FooSignal">"FooSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_node_info_unref">
+<function name="foo_igen_changing_interface_v10_emit_new_signal_in2">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV10.NewSignalIn2">"NewSignalIn2"</link> D-Bus signal.
-Since: 2.26
+Since: 2.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusNodeInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV10.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_property_info_ref">
+<function name="foo_igen_changing_interface_v10_interface_info">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Gets a machine-readable description of the <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> D-Bus interface.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusPropertyInfo
-</parameter_description>
-</parameter>
</parameters>
-<return> The same @info.
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_dbus_property_info_unref">
+<function name="foo_igen_changing_interface_v10_override_properties">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Overrides all #GObject properties in the #FooiGenChangingInterfaceV10 interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusPropertyInfo.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+
+</return>
</function>
-<function name="g_dbus_proxy_call">
+<function name="foo_igen_changing_interface_v10_proxy_new">
<description>
-Asynchronously invokes the @method_name method on @proxy.
-
-If @method_name contains any dots, then @name is split into interface and
-method name parts. This allows using @proxy for invoking methods on
-other interfaces.
-
-If the #GDBusConnection associated with @proxy is closed then
-the operation will fail with %G_IO_ERROR_CLOSED. If
- cancellable is canceled, the operation will fail with
-%G_IO_ERROR_CANCELLED. If @parameters contains a value not
-compatible with the D-Bus protocol, the operation fails with
-%G_IO_ERROR_INVALID_ARGUMENT.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link>. See g_dbus_proxy_new() for more details.
-If the @parameters #GVariant is floating, it is consumed. This allows
-convenient 'inline' use of g_variant_new(), e.g.:
-|[
-g_dbus_proxy_call (proxy,
-"TwoStrings",
-g_variant_new ("(ss)",
-"Thing One",
-"Thing Two"),
-G_DBUS_CALL_FLAGS_NONE,
--1,
-NULL,
-(GAsyncReadyCallback) two_strings_done,
-&data);
-]|
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_proxy_new_finish() to get the result of the operation.
-This is an asynchronous method. When the operation is finished,
- callback will be invoked in the
-<link linkend="g-main-context-push-thread-default">thread-default
-main loop</link> of the thread you are calling this method from.
-You can then call g_dbus_proxy_call_finish() to get the result of
-the operation. See g_dbus_proxy_call_sync() for the synchronous
-version of this method.
+See foo_igen_changing_interface_v10_proxy_new_sync() for the synchronous, blocking version of this constructor.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
-<parameter name="method_name">
-<parameter_description> Name of method to invoke.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GDBusCallFlags enumeration.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
-"infinite") or -1 to use the proxy default timeout.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -9444,373 +9669,296 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
-care about the result of the method invocation.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> The data to pass to @callback.
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_proxy_call_finish">
+<function name="foo_igen_changing_interface_v10_proxy_new_finish">
<description>
-Finishes an operation started with g_dbus_proxy_call().
+Finishes an operation started with foo_igen_changing_interface_v10_proxy_new().
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if @error is set. Otherwise a #GVariant tuple with
-return values. Free with g_variant_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_call_sync">
+<function name="foo_igen_changing_interface_v10_proxy_new_for_bus">
<description>
-Synchronously invokes the @method_name method on @proxy.
-
-If @method_name contains any dots, then @name is split into interface and
-method name parts. This allows using @proxy for invoking methods on
-other interfaces.
-
-If the #GDBusConnection associated with @proxy is disconnected then
-the operation will fail with %G_IO_ERROR_CLOSED. If
- cancellable is canceled, the operation will fail with
-%G_IO_ERROR_CANCELLED. If @parameters contains a value not
-compatible with the D-Bus protocol, the operation fails with
-%G_IO_ERROR_INVALID_ARGUMENT.
+Like foo_igen_changing_interface_v10_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-If the @parameters #GVariant is floating, it is consumed. This allows
-convenient 'inline' use of g_variant_new(), e.g.:
-|[
-g_dbus_proxy_call_sync (proxy,
-"TwoStrings",
-g_variant_new ("(ss)",
-"Thing One",
-"Thing Two"),
-G_DBUS_CALL_FLAGS_NONE,
--1,
-NULL,
-&error);
-]|
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v10_proxy_new_for_bus_finish() to get the result of the operation.
-The calling thread is blocked until a reply is received. See
-g_dbus_proxy_call() for the asynchronous version of this
-method.
+See foo_igen_changing_interface_v10_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
-<parameter name="method_name">
-<parameter_description> Name of method to invoke.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="parameters">
-<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags from the #GDBusCallFlags enumeration.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="timeout_msec">
-<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
-"infinite") or -1 to use the proxy default timeout.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if @error is set. Otherwise a #GVariant tuple with
-return values. Free with g_variant_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_proxy_get_cached_property">
+<function name="foo_igen_changing_interface_v10_proxy_new_for_bus_finish">
<description>
-Looks up the value for a property from the cache. This call does no
-blocking IO.
-
-If @proxy has an expected interface (see
-#GDBusProxy:g-interface-info), then @property_name (for existence)
-is checked against it.
+Finishes an operation started with foo_igen_changing_interface_v10_proxy_new_for_bus().
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v10_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="property_name">
-<parameter_description> Property name.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A reference to the #GVariant instance that holds the value
-for @property_name or %NULL if the value is not in the cache. The
-returned reference must be freed with g_variant_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_get_cached_property_names">
+<function name="foo_igen_changing_interface_v10_proxy_new_for_bus_sync">
<description>
-Gets the names of all cached properties on @proxy.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
-</parameters>
-<return> A %NULL-terminated array of strings or %NULL if @proxy has
-no cached properties. Free the returned array with g_strfreev().
+Like foo_igen_changing_interface_v10_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-</return>
-</function>
+The calling thread is blocked until a reply is received.
-<function name="g_dbus_proxy_get_connection">
-<description>
-Gets the connection @proxy is for.
+See foo_igen_changing_interface_v10_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-</parameters>
-<return> A #GDBusConnection owned by @proxy. Do not free.
-
-</return>
-</function>
-
-<function name="g_dbus_proxy_get_default_timeout">
-<description>
-Gets the timeout to use if -1 (specifying default timeout) is
-passed as @timeout_msec in the g_dbus_proxy_call() and
-g_dbus_proxy_call_sync() functions.
-
-See the #GDBusProxy:g-default-timeout property for more details.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-</parameters>
-<return> Timeout to use for @proxy.
-
-</return>
-</function>
-
-<function name="g_dbus_proxy_get_flags">
-<description>
-Gets the flags that @proxy was constructed with.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> Flags from the #GDBusProxyFlags enumeration.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_get_interface_info">
+<function name="foo_igen_changing_interface_v10_proxy_new_sync">
<description>
-Returns the #GDBusInterfaceInfo, if any, specifying the minimal
-interface that @proxy conforms to.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link>. See g_dbus_proxy_new_sync() for more details.
-See the #GDBusProxy:g-interface-info property for more details.
+The calling thread is blocked until a reply is received.
-Since: 2.26
+See foo_igen_changing_interface_v10_proxy_new() for the asynchronous version of this constructor.
+
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusInterfaceInfo or %NULL. Do not unref the returned
-object, it is owned by @proxy.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_get_interface_name">
+<function name="foo_igen_changing_interface_v10_skeleton_new">
<description>
-Gets the D-Bus interface name @proxy is for.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link>.
-Since: 2.26
+Since: 10.0
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
</parameters>
-<return> A string owned by @proxy. Do not free.
+<return> The skeleton object.
</return>
</function>
-<function name="g_dbus_proxy_get_name">
+<function name="foo_igen_changing_interface_v1_call_bar_method">
<description>
-Gets the name that @proxy was constructed for.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.BarMethod">BarMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v1_call_bar_method_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v1_call_bar_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A string owned by @proxy. Do not free.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_proxy_get_name_owner">
+<function name="foo_igen_changing_interface_v1_call_bar_method_finish">
<description>
-The unique name that owns the name that @proxy is for or %NULL if
-no-one currently owns that name. You may connect to the
-#GObject::notify signal to track changes to the
-#GDBusProxy:g-name-owner property.
+Finishes an operation started with foo_igen_changing_interface_v1_call_bar_method().
-Since: 2.26
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v1_call_bar_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> The name owner or %NULL if no name owner exists. Free with g_free().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_get_object_path">
+<function name="foo_igen_changing_interface_v1_call_bar_method_sync">
<description>
-Gets the object path @proxy is for.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.BarMethod">BarMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v1_call_bar_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A string owned by @proxy. Do not free.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_new">
+<function name="foo_igen_changing_interface_v1_call_baz_method">
<description>
-Creates a proxy for accessing @interface_name on the remote object
-at @object_path owned by @name at @connection and asynchronously
-loads D-Bus properties unless the
-%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to
-the #GDBusProxy::g-properties-changed signal to get notified about
-property changes.
-
-If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
-match rules for signals. Connect to the #GDBusProxy::g-signal signal
-to handle signals from the remote object.
-
-If @name is a well-known name and the
-%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
-owner currently exists, the message bus will be requested to launch
-a name owner for the name.
-
-This is a failable asynchronous constructor - when the proxy is
-ready, @callback will be invoked and you can use
-g_dbus_proxy_new_finish() to get the result.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.BazMethod">BazMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v1_call_baz_method_finish() to get the result of the operation.
-See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
-
-See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
-
-Since: 2.26
+See foo_igen_changing_interface_v1_call_baz_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags used when constructing the proxy.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> An object path.
-</parameter_description>
-</parameter>
-<parameter name="interface_name">
-<parameter_description> A D-Bus interface name.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -9818,7 +9966,7 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> Callback function to invoke when the proxy is ready.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -9829,16 +9977,19 @@ Since: 2.26
<return></return>
</function>
-<function name="g_dbus_proxy_new_finish">
+<function name="foo_igen_changing_interface_v1_call_baz_method_finish">
<description>
-Finishes creating a #GDBusProxy.
+Finishes an operation started with foo_igen_changing_interface_v1_call_baz_method().
-Since: 2.26
</description>
<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
+</parameter_description>
+</parameter>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v1_call_baz_method().
</parameter_description>
</parameter>
<parameter name="error">
@@ -9846,43 +9997,48 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_new_for_bus">
+<function name="foo_igen_changing_interface_v1_call_baz_method_sync">
<description>
-Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.BazMethod">BazMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+See foo_igen_changing_interface_v1_call_baz_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> A #GBusType.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags used when constructing the proxy.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> A bus name (well-known or unique).
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="object_path">
-<parameter_description> An object path.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
-<parameter name="interface_name">
-<parameter_description> A D-Bus interface name.
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="foo_igen_changing_interface_v1_call_foo_method">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.FooMethod">FooMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v1_call_foo_method_finish() to get the result of the operation.
+
+See foo_igen_changing_interface_v1_call_foo_method_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -9890,7 +10046,7 @@ Since: 2.26
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> Callback function to invoke when the proxy is ready.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -9901,16 +10057,19 @@ Since: 2.26
<return></return>
</function>
-<function name="g_dbus_proxy_new_for_bus_finish">
+<function name="foo_igen_changing_interface_v1_call_foo_method_finish">
<description>
-Finishes creating a #GDBusProxy.
+Finishes an operation started with foo_igen_changing_interface_v1_call_foo_method().
-Since: 2.26
</description>
<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
+</parameter_description>
+</parameter>
<parameter name="res">
-<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus().
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v1_call_foo_method().
</parameter_description>
</parameter>
<parameter name="error">
@@ -9918,43 +10077,21 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_new_for_bus_sync">
+<function name="foo_igen_changing_interface_v1_call_foo_method_sync">
<description>
-Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV1.FooMethod">FooMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+See foo_igen_changing_interface_v1_call_foo_method() for the asynchronous version of this method.
-Since: 2.26
</description>
<parameters>
-<parameter name="bus_type">
-<parameter_description> A #GBusType.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Flags used when constructing the proxy.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> A bus name (well-known or unique).
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> An object path.
-</parameter_description>
-</parameter>
-<parameter name="interface_name">
-<parameter_description> A D-Bus interface name.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV1Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -9966,9481 +10103,9038 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_dbus_proxy_new_sync">
+<function name="foo_igen_changing_interface_v1_complete_bar_method">
<description>
-Creates a proxy for accessing @interface_name on the remote object
-at @object_path owned by @name at @connection and synchronously
-loads D-Bus properties unless the
-%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used.
-
-If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
-match rules for signals. Connect to the #GDBusProxy::g-signal signal
-to handle signals from the remote object.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV1.BarMethod">BarMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-If @name is a well-known name and the
-%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
-owner currently exists, the message bus will be requested to launch
-a name owner for the name.
+This method will free @invocation, you cannot use it afterwards.
-This is a synchronous failable constructor. See g_dbus_proxy_new()
-and g_dbus_proxy_new_finish() for the asynchronous version.
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+<function name="foo_igen_changing_interface_v1_complete_baz_method">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV1.BazMethod">BazMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> A #GDBusConnection.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> Flags used when constructing the proxy.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
-</parameter_description>
-</parameter>
-<parameter name="object_path">
-<parameter_description> An object path.
-</parameter_description>
-</parameter>
-<parameter name="interface_name">
-<parameter_description> A D-Bus interface name.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> A #GCancellable or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> Return location for error or %NULL.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_proxy_set_cached_property">
+<function name="foo_igen_changing_interface_v1_complete_foo_method">
<description>
-If @value is not %NULL, sets the cached value for the property with
-name @property_name to the value in @value.
-
-If @value is %NULL, then the cached value is removed from the
-property cache.
-
-If @proxy has an expected interface (see
-#GDBusProxy:g-interface-info), then @property_name (for existence)
-and @value (for the type) is checked against it.
-
-If the @value #GVariant is floating, it is consumed. This allows
-convenient 'inline' use of g_variant_new(), e.g.
-|[
-g_dbus_proxy_set_cached_property (proxy,
-"SomeProperty",
-g_variant_new ("(si)",
-"A String",
-42));
-]|
-
-Normally you will not need to use this method since @proxy is
-tracking changes using the
-<literal>org.freedesktop.DBus.Properties.PropertiesChanged</literal>
-D-Bus signal. However, for performance reasons an object may decide
-to not use this signal for some properties and instead use a
-proprietary out-of-band mechanism to transmit changes.
-
-As a concrete example, consider an object with a property
-<literal>ChatroomParticipants</literal> which is an array of
-strings. Instead of transmitting the same (long) array every time
-the property changes, it is more efficient to only transmit the
-delta using e.g. signals <literal>ChatroomParticipantJoined(String
-name)</literal> and <literal>ChatroomParticipantParted(String
-name)</literal>.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV1.FooMethod">FooMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.26
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy
-</parameter_description>
-</parameter>
-<parameter name="property_name">
-<parameter_description> Property name.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> Value for the property or %NULL to remove it from the cache.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_proxy_set_default_timeout">
+<function name="foo_igen_changing_interface_v1_emit_bar_signal">
<description>
-Sets the timeout to use if -1 (specifying default timeout) is
-passed as @timeout_msec in the g_dbus_proxy_call() and
-g_dbus_proxy_call_sync() functions.
-
-See the #GDBusProxy:g-default-timeout property for more details.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV1.BarSignal">"BarSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy.
-</parameter_description>
-</parameter>
-<parameter name="timeout_msec">
-<parameter_description> Timeout in milliseconds.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_proxy_set_interface_info">
+<function name="foo_igen_changing_interface_v1_emit_baz_signal">
<description>
-Ensure that interactions with @proxy conform to the given
-interface. For example, when completing a method call, if the type
-signature of the message isn't what's expected, the given #GError
-is set. Signals that have a type signature mismatch are simply
-dropped.
-
-See the #GDBusProxy:g-interface-info property for more details.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV1.BazSignal">"BazSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> A #GDBusProxy
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> Minimum interface this proxy conforms to or %NULL to unset.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_server_get_client_address">
+<function name="foo_igen_changing_interface_v1_emit_foo_signal">
<description>
-Gets a D-Bus address string that can be used by clients to connect
-to @server.
-
-Since: 2.26
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV1.FooSignal">"FooSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV1.
</parameter_description>
</parameter>
</parameters>
-<return> A D-Bus address string. Do not free, the string is owned
-by @server.
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_server_get_flags">
+<function name="foo_igen_changing_interface_v1_interface_info">
<description>
-Gets the flags for @server.
+Gets a machine-readable description of the <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link> D-Bus interface.
-Since: 2.26
</description>
<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
-</parameter_description>
-</parameter>
</parameters>
-<return> A set of flags from the #GDBusServerFlags enumeration.
-
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_dbus_server_get_guid">
+<function name="foo_igen_changing_interface_v1_override_properties">
<description>
-Gets the GUID for @server.
+Overrides all #GObject properties in the #FooiGenChangingInterfaceV1 interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.26
</description>
<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-</parameters>
-<return> A D-Bus GUID. Do not free this string, it is owned by @server.
-
-</return>
-</function>
-
-<function name="g_dbus_server_is_active">
-<description>
-Gets whether @server is active.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if server is active, %FALSE otherwise.
-
+<return> The last property id.
</return>
</function>
-<function name="g_dbus_server_new_sync">
+<function name="foo_igen_changing_interface_v1_proxy_new">
<description>
-Creates a new D-Bus server that listens on the first address in
- address that works.
-
-Once constructed, you can use g_dbus_server_get_client_address() to
-get a D-Bus address string that clients can use to connect.
-
-Connect to the #GDBusServer::new-connection signal to handle
-incoming connections.
-
-The returned #GDBusServer isn't active - you have to start it with
-g_dbus_server_start().
-
-See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can
-be used.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link>. See g_dbus_proxy_new() for more details.
-This is a synchronous failable constructor. See
-g_dbus_server_new() for the asynchronous version.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v1_proxy_new_finish() to get the result of the operation.
-Since: 2.26
+See foo_igen_changing_interface_v1_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="address">
-<parameter_description> A D-Bus address.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> Flags from the #GDBusServerFlags enumeration.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="guid">
-<parameter_description> A D-Bus GUID.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="observer">
-<parameter_description> A #GDBusAuthObserver or %NULL.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for server or %NULL.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> A #GDBusServer or %NULL if @error is set. Free with
-g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_dbus_server_start">
+<function name="foo_igen_changing_interface_v1_proxy_new_finish">
<description>
-Starts @server.
+Finishes an operation started with foo_igen_changing_interface_v1_proxy_new().
-Since: 2.26
</description>
<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v1_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_dbus_server_stop">
+<function name="foo_igen_changing_interface_v1_proxy_new_for_bus">
<description>
-Stops @server.
+Like foo_igen_changing_interface_v1_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-Since: 2.26
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v1_proxy_new_for_bus_finish() to get the result of the operation.
+
+See foo_igen_changing_interface_v1_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="server">
-<parameter_description> A #GDBusServer.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_dbus_signal_info_ref">
+<function name="foo_igen_changing_interface_v1_proxy_new_for_bus_finish">
<description>
-If @info is statically allocated does nothing. Otherwise increases
-the reference count.
+Finishes an operation started with foo_igen_changing_interface_v1_proxy_new_for_bus().
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusSignalInfo
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v1_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> The same @info.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_dbus_signal_info_unref">
+<function name="foo_igen_changing_interface_v1_proxy_new_for_bus_sync">
<description>
-If @info is statically allocated, does nothing. Otherwise decreases
-the reference count of @info. When its reference count drops to 0,
-the memory used is freed.
+Like foo_igen_changing_interface_v1_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v1_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.26
</description>
<parameters>
-<parameter name="info">
-<parameter_description> A #GDBusSignalInfo.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_desktop_app_info_get_filename">
+<function name="foo_igen_changing_interface_v1_proxy_new_sync">
<description>
-When @info was created from a known filename, return it. In some
-situations such as the #GDesktopAppInfo returned from
-g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v1_proxy_new() for the asynchronous version of this constructor.
-Since: 2.24
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GDesktopAppInfo
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> The full path to the file for @info, or %NULL if not known.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_desktop_app_info_get_is_hidden">
+<function name="foo_igen_changing_interface_v1_skeleton_new">
<description>
-A desktop file is hidden if the Hidden key in it is
-set to True.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link>.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GDesktopAppInfo.
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if hidden, %FALSE otherwise.
+<return> The skeleton object.
</return>
</function>
-<function name="g_desktop_app_info_launch_uris_as_manager">
+<function name="foo_igen_changing_interface_v2_call_bar_method">
<description>
-This function performs the equivalent of g_app_info_launch_uris(),
-but is intended primarily for operating system components that
-launch applications. Ordinary applications should use
-g_app_info_launch_uris().
-
-In contrast to g_app_info_launch_uris(), all processes created will
-always be run directly as children as if by the UNIX fork()/exec()
-calls.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.BarMethod">BarMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_call_bar_method_finish() to get the result of the operation.
-This guarantee allows additional control over the exact environment
-of the child processes, which is provided via a setup function
- setup, as well as the process identifier of each child process via
- pid_callback See g_spawn_async() for more information about the
-semantics of the @setup function.
+See foo_igen_changing_interface_v2_call_bar_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="appinfo">
-<parameter_description> a #GDesktopAppInfo
-</parameter_description>
-</parameter>
-<parameter name="uris">
-<parameter_description> List of URIs
-</parameter_description>
-</parameter>
-<parameter name="launch_context">
-<parameter_description> a #GAppLaunchContext
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
-<parameter name="spawn_flags">
-<parameter_description> #GSpawnFlags, used for each process
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_setup">
-<parameter_description> a #GSpawnChildSetupFunc, used once for
-each process.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_setup_data">
-<parameter_description> User data for @user_setup
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="pid_callback">
-<parameter_description> Callback for child processes
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_changing_interface_v2_call_bar_method_finish">
+<description>
+Finishes an operation started with foo_igen_changing_interface_v2_call_bar_method().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
-<parameter name="pid_callback_data">
-<parameter_description> User data for @callback
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_call_bar_method().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
</function>
-<function name="g_desktop_app_info_lookup_get_default_for_uri_scheme">
+<function name="foo_igen_changing_interface_v2_call_bar_method_sync">
<description>
-Gets the default application for launching applications
-using this URI scheme for a particular GDesktopAppInfoLookup
-implementation.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.BarMethod">BarMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-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().
+See foo_igen_changing_interface_v2_call_bar_method() for the asynchronous version of this method.
-Deprecated: The #GDesktopAppInfoLookup interface is deprecated and unused by gio.
</description>
<parameters>
-<parameter name="lookup">
-<parameter_description> a #GDesktopAppInfoLookup
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
-<parameter name="uri_scheme">
-<parameter_description> a string containing a URI scheme.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #GAppInfo for given @uri_scheme or %NULL on error.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_desktop_app_info_new">
+<function name="foo_igen_changing_interface_v2_call_baz_method">
<description>
-Creates a new #GDesktopAppInfo based on a desktop file id.
-
-A desktop file id is the basename of the desktop file, including the
-.desktop extension. GIO is looking for a desktop file with this name
-in the <filename>applications</filename> subdirectories of the XDG data
-directories (i.e. the directories specified in the
-<envar>XDG_DATA_HOME</envar> and <envar>XDG_DATA_DIRS</envar> environment
-variables). GIO also supports the prefix-to-subdirectory mapping that is
-described in the <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Menu Spec</ulink>
-(i.e. a desktop id of kde-foo.desktop will match
-<filename>/usr/share/applications/kde/foo.desktop</filename>).
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.BazMethod">BazMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_call_baz_method_finish() to get the result of the operation.
+See foo_igen_changing_interface_v2_call_baz_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="desktop_id">
-<parameter_description> the desktop file id
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDesktopAppInfo, or %NULL if no desktop file with that id
-</return>
+<return></return>
</function>
-<function name="g_desktop_app_info_new_from_filename">
+<function name="foo_igen_changing_interface_v2_call_baz_method_finish">
<description>
-Creates a new #GDesktopAppInfo.
+Finishes an operation started with foo_igen_changing_interface_v2_call_baz_method().
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> the path of a desktop file, in the GLib filename encoding
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_call_baz_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDesktopAppInfo or %NULL on error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_desktop_app_info_new_from_keyfile">
+<function name="foo_igen_changing_interface_v2_call_baz_method_sync">
<description>
-Creates a new #GDesktopAppInfo.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.BazMethod">BazMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v2_call_baz_method() for the asynchronous version of this method.
-Since: 2.18
</description>
<parameters>
-<parameter name="key_file">
-<parameter_description> an opened #GKeyFile
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDesktopAppInfo or %NULL on error.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_desktop_app_info_set_desktop_env">
+<function name="foo_igen_changing_interface_v2_call_foo_method">
<description>
-Sets the name of the desktop that the application is running in.
-This is used by g_app_info_should_show() to evaluate the
-<literal>OnlyShowIn</literal> and <literal>NotShowIn</literal>
-desktop entry fields.
-
-The <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Desktop
-Menu specification</ulink> recognizes the following:
-<simplelist>
-<member>GNOME</member>
-<member>KDE</member>
-<member>ROX</member>
-<member>XFCE</member>
-<member>Old</member>
-</simplelist>
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.FooMethod">FooMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_call_foo_method_finish() to get the result of the operation.
-Should be called only once; subsequent calls are ignored.
+See foo_igen_changing_interface_v2_call_foo_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="desktop_env">
-<parameter_description> a string specifying what desktop this is
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_drive_can_eject">
+<function name="foo_igen_changing_interface_v2_call_foo_method_finish">
<description>
-Checks if a drive can be ejected.
+Finishes an operation started with foo_igen_changing_interface_v2_call_foo_method().
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_call_foo_method().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @drive can be ejected, %FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_drive_can_poll_for_media">
+<function name="foo_igen_changing_interface_v2_call_foo_method_sync">
<description>
-Checks if a drive can be polled for media changes.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.FooMethod">FooMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v2_call_foo_method() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @drive can be polled for media changes,
-%FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_drive_can_start">
+<function name="foo_igen_changing_interface_v2_call_new_method_in2">
<description>
-Checks if a drive can be started.
+Asynchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.NewMethodIn2">NewMethodIn2()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_call_new_method_in2_finish() to get the result of the operation.
-Since: 2.22
+See foo_igen_changing_interface_v2_call_new_method_in2_sync() for the synchronous, blocking version of this method.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the @drive can be started, %FALSE otherwise.
-
-</return>
-</function>
-
-<function name="g_drive_can_start_degraded">
-<description>
-Checks if a drive can be started degraded.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
-
-</return>
-</function>
-
-<function name="g_drive_can_stop">
-<description>
-Checks if a drive can be stopped.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the @drive can be stopped, %FALSE otherwise.
-
-</return>
-</function>
-
-<function name="g_drive_eject">
-<description>
-Asynchronously ejects a drive.
-
-When the operation is finished, @callback will be called.
-You can then call g_drive_eject_finish() to obtain the
-result of the operation.
-
-Deprecated: 2.22: Use g_drive_eject_with_operation() instead.
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for eject
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to @callback
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_drive_eject_finish">
+<function name="foo_igen_changing_interface_v2_call_new_method_in2_finish">
<description>
-Finishes ejecting a drive.
+Finishes an operation started with foo_igen_changing_interface_v2_call_new_method_in2().
-Deprecated: 2.22: Use g_drive_eject_with_operation_finish() instead.
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_call_new_method_in2().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive has been ejected successfully,
-%FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_drive_eject_with_operation">
+<function name="foo_igen_changing_interface_v2_call_new_method_in2_sync">
<description>
-Ejects a drive. This is an asynchronous operation, and is
-finished by calling g_drive_eject_with_operation_finish() with the @drive
-and #GAsyncResult data returned in the @callback.
+Synchronously invokes the <link linkend="gdbus-method-ChangingInterfaceV2.NewMethodIn2">NewMethodIn2()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-Since: 2.22
+See foo_igen_changing_interface_v2_call_new_method_in2() for the asynchronous version of this method.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for eject
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
+<parameter name="proxy">
+<parameter_description> A #FooiGenChangingInterfaceV2Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+
+</return>
</function>
-<function name="g_drive_eject_with_operation_finish">
+<function name="foo_igen_changing_interface_v2_complete_bar_method">
<description>
-Finishes ejecting a drive. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV2.BarMethod">BarMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-Since: 2.22
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive was successfully ejected. %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_drive_enumerate_identifiers">
+<function name="foo_igen_changing_interface_v2_complete_baz_method">
<description>
-Gets the kinds of identifiers that @drive has.
-Use g_drive_get_identifer() to obtain the identifiers
-themselves.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV2.BazMethod">BazMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
-</parameters>
-<return> a %NULL-terminated
-array of strings containing kinds of identifiers. Use g_strfreev()
-to free.
-</return>
-</function>
-
-<function name="g_drive_get_icon">
-<description>
-Gets the icon for @drive.
-
-
-</description>
-<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> #GIcon for the @drive.
-Free the returned object with g_object_unref().
-</return>
+<return></return>
</function>
-<function name="g_drive_get_identifier">
+<function name="foo_igen_changing_interface_v2_complete_foo_method">
<description>
-Gets the identifier of the given kind for @drive.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV2.FooMethod">FooMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
-<parameter name="kind">
-<parameter_description> the kind of identifier to return
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string containing the
-requested identfier, or %NULL if the #GDrive
-doesn't have this kind of identifier.
-</return>
+<return></return>
</function>
-<function name="g_drive_get_name">
+<function name="foo_igen_changing_interface_v2_complete_new_method_in2">
<description>
-Gets the name of @drive.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-ChangingInterfaceV2.NewMethodIn2">NewMethodIn2()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+
+This method will free @invocation, you cannot use it afterwards.
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing @drive's name. The returned
-string should be freed when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_drive_get_start_stop_type">
+<function name="foo_igen_changing_interface_v2_emit_bar_signal">
<description>
-Gets a hint about how a drive can be started/stopped.
-
-Since: 2.22
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV2.BarSignal">"BarSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> A value from the #GDriveStartStopType enumeration.
-
-</return>
+<return></return>
</function>
-<function name="g_drive_get_volumes">
+<function name="foo_igen_changing_interface_v2_emit_baz_signal">
<description>
-Get a list of mountable volumes for @drive.
-
-The returned list should be freed with g_list_free(), after
-its elements have been unreffed with g_object_unref().
-
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV2.BazSignal">"BazSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> #GList containing any #GVolume objects on the given @drive.
-</return>
+<return></return>
</function>
-<function name="g_drive_has_media">
+<function name="foo_igen_changing_interface_v2_emit_foo_signal">
<description>
-Checks if the @drive has media. Note that the OS may not be polling
-the drive for media changes; see g_drive_is_media_check_automatic()
-for more details.
-
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV2.FooSignal">"FooSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @drive has media, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_drive_has_volumes">
+<function name="foo_igen_changing_interface_v2_emit_new_signal_in2">
<description>
-Check if @drive has any mountable volumes.
+Emits the <link linkend="gdbus-signal-ChangingInterfaceV2.NewSignalIn2">"NewSignalIn2"</link> D-Bus signal.
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="object">
+<parameter_description> A #FooiGenChangingInterfaceV2.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @drive contains volumes, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_drive_is_media_check_automatic">
+<function name="foo_igen_changing_interface_v2_interface_info">
<description>
-Checks if @drive is capabable of automatically detecting media changes.
+Gets a machine-readable description of the <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> D-Bus interface.
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if the @drive is capabable of automatically detecting
-media changes, %FALSE otherwise.
+<return> A #GDBusInterfaceInfo. Do not free.
+
</return>
</function>
-<function name="g_drive_is_media_removable">
+<function name="foo_igen_changing_interface_v2_override_properties">
<description>
-Checks if the @drive supports removable media.
+Overrides all #GObject properties in the #FooiGenChangingInterfaceV2 interface for a concrete class.
+The properties are overridden in the order they are defined.
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @drive supports removable media, %FALSE otherwise.
+<return> The last property id.
+
</return>
</function>
-<function name="g_drive_poll_for_media">
+<function name="foo_igen_changing_interface_v2_proxy_new">
<description>
-Asynchronously polls @drive to see if media has been inserted or removed.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link>. See g_dbus_proxy_new() for more details.
-When the operation is finished, @callback will be called.
-You can then call g_drive_poll_for_media_finish() to obtain the
-result of the operation.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_changing_interface_v2_proxy_new_sync() for the synchronous, blocking version of this constructor.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to @callback
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_drive_poll_for_media_finish">
+<function name="foo_igen_changing_interface_v2_proxy_new_finish">
<description>
-Finishes an operation started with g_drive_poll_for_media() on a drive.
+Finishes an operation started with foo_igen_changing_interface_v2_proxy_new().
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive has been poll_for_mediaed successfully,
-%FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
+
</return>
</function>
-<function name="g_drive_start">
+<function name="foo_igen_changing_interface_v2_proxy_new_for_bus">
<description>
-Asynchronously starts a drive.
+Like foo_igen_changing_interface_v2_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-When the operation is finished, @callback will be called.
-You can then call g_drive_start_finish() to obtain the
-result of the operation.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_changing_interface_v2_proxy_new_for_bus_finish() to get the result of the operation.
-Since: 2.22
+See foo_igen_changing_interface_v2_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the start operation.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to @callback
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_drive_start_finish">
+<function name="foo_igen_changing_interface_v2_proxy_new_for_bus_finish">
<description>
-Finishes starting a drive.
+Finishes an operation started with foo_igen_changing_interface_v2_proxy_new_for_bus().
-Since: 2.22
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_changing_interface_v2_proxy_new_for_bus().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive has been started successfully,
-%FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_drive_stop">
+<function name="foo_igen_changing_interface_v2_proxy_new_for_bus_sync">
<description>
-Asynchronously stops a drive.
+Like foo_igen_changing_interface_v2_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-When the operation is finished, @callback will be called.
-You can then call g_drive_stop_finish() to obtain the
-result of the operation.
+The calling thread is blocked until a reply is received.
-Since: 2.22
+See foo_igen_changing_interface_v2_proxy_new_for_bus() for the asynchronous version of this constructor.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for stopping.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to @callback
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+
+</return>
</function>
-<function name="g_drive_stop_finish">
+<function name="foo_igen_changing_interface_v2_proxy_new_sync">
<description>
-Finishes stopping a drive.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link>. See g_dbus_proxy_new_sync() for more details.
-Since: 2.22
+The calling thread is blocked until a reply is received.
+
+See foo_igen_changing_interface_v2_proxy_new() for the asynchronous version of this constructor.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="drive">
-<parameter_description> a #GDrive.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the drive has been stopped successfully,
-%FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_emblem_get_icon">
+<function name="foo_igen_changing_interface_v2_skeleton_new">
<description>
-Gives back the icon from @emblem.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link>.
-Since: 2.18
+Since: 2.0
</description>
<parameters>
-<parameter name="emblem">
-<parameter_description> a #GEmblem from which the icon should be extracted.
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GIcon. The returned object belongs to
-the emblem and should not be modified or freed.
+<return> The skeleton object.
</return>
</function>
-<function name="g_emblem_get_origin">
+<function name="foo_igen_com_acme_coyote_call_attack">
<description>
-Gets the origin of the emblem.
+Asynchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Attack">Attack()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_com_acme_coyote_call_attack_finish() to get the result of the operation.
-Since: 2.18
+See foo_igen_com_acme_coyote_call_attack_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="emblem">
-<parameter_description> a #GEmblem
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> the origin of the emblem
-
-</return>
+<return></return>
</function>
-<function name="g_emblem_new">
+<function name="foo_igen_com_acme_coyote_call_attack_finish">
<description>
-Creates a new emblem for @icon.
+Finishes an operation started with foo_igen_com_acme_coyote_call_attack().
-Since: 2.18
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a GIcon containing the icon.
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_com_acme_coyote_call_attack().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GEmblem.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_emblem_new_with_origin">
+<function name="foo_igen_com_acme_coyote_call_attack_sync">
<description>
-Creates a new emblem for @icon.
+Synchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Attack">Attack()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_com_acme_coyote_call_attack() for the asynchronous version of this method.
-Since: 2.18
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a GIcon containing the icon.
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
</parameter_description>
</parameter>
-<parameter name="origin">
-<parameter_description> a GEmblemOrigin enum defining the emblem's origin
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GEmblem.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_emblemed_icon_add_emblem">
+<function name="foo_igen_com_acme_coyote_call_run">
<description>
-Adds @emblem to the #GList of #GEmblem <!-- -->s.
+Asynchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Run">Run()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_com_acme_coyote_call_run_finish() to get the result of the operation.
-Since: 2.18
+See foo_igen_com_acme_coyote_call_run_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
</parameter_description>
</parameter>
-<parameter name="emblem">
-<parameter_description> a #GEmblem
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_emblemed_icon_clear_emblems">
+<function name="foo_igen_com_acme_coyote_call_run_finish">
<description>
-Removes all the emblems from @icon.
+Finishes an operation started with foo_igen_com_acme_coyote_call_run().
-Since: 2.28
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_com_acme_coyote_call_run().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
</function>
-<function name="g_emblemed_icon_get_emblems">
+<function name="foo_igen_com_acme_coyote_call_run_sync">
<description>
-Gets the list of emblems for the @icon.
+Synchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Run">Run()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_com_acme_coyote_call_run() for the asynchronous version of this method.
-Since: 2.18
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of
-#GEmblem <!-- -->s that is owned by @emblemed
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_emblemed_icon_get_icon">
+<function name="foo_igen_com_acme_coyote_call_sleep">
<description>
-Gets the main icon for @emblemed.
+Asynchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Sleep">Sleep()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_com_acme_coyote_call_sleep_finish() to get the result of the operation.
-Since: 2.18
+See foo_igen_com_acme_coyote_call_sleep_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="emblemed">
-<parameter_description> a #GEmblemedIcon
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
</parameter_description>
</parameter>
-</parameters>
-<return> a #GIcon that is owned by @emblemed
-
-</return>
-</function>
-
-<function name="g_emblemed_icon_new">
-<description>
-Creates a new emblemed icon for @icon with the emblem @emblem.
-
-Since: 2.18
-
-</description>
-<parameters>
-<parameter name="icon">
-<parameter_description> a #GIcon
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="emblem">
-<parameter_description> a #GEmblem, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GIcon
-
-</return>
+<return></return>
</function>
-<function name="g_file_append_to">
+<function name="foo_igen_com_acme_coyote_call_sleep_finish">
<description>
-Gets an output stream for appending data to the file. If
-the file doesn't already exist it is created.
-
-By default files created are generally readable by everyone,
-but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
-will be made readable only to the current user, to the level that
-is supported on the target filesystem.
-
-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.
-
-Some file systems don't allow all file names, and may
-return an %G_IO_ERROR_INVALID_FILENAME error.
-If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be
-returned. Other errors are possible too, and depend on what kind of
-filesystem the file is on.
+Finishes an operation started with foo_igen_com_acme_coyote_call_sleep().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_com_acme_coyote_call_sleep().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileOutputStream, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_append_to_async">
+<function name="foo_igen_com_acme_coyote_call_sleep_sync">
<description>
-Asynchronously opens @file for appending.
+Synchronously invokes the <link linkend="gdbus-method-com-acme-Coyote.Sleep">Sleep()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-For more details, see g_file_append_to() which is
-the synchronous version of this call.
+See foo_igen_com_acme_coyote_call_sleep() for the asynchronous version of this method.
-When the operation is finished, @callback will be called. You can then call
-g_file_append_to_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="proxy">
+<parameter_description> A #FooiGenComAcmeCoyoteProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_file_append_to_finish">
-<description>
-Finishes an asynchronous file append operation started with
-g_file_append_to_async().
-
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> #GAsyncResult
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a valid #GFileOutputStream or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_attribute_info_list_add">
+<function name="foo_igen_com_acme_coyote_complete_attack">
<description>
-Adds a new attribute with @name to the @list, setting
-its @type and @flags.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-com-acme-Coyote.Attack">Attack()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList.
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the attribute to add.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> the #GFileAttributeType for the attribute.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> #GFileAttributeInfoFlags for the attribute.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_attribute_info_list_dup">
+<function name="foo_igen_com_acme_coyote_complete_run">
<description>
-Makes a duplicate of a file attribute info list.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-com-acme-Coyote.Run">Run()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList to duplicate.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a copy of the given @list.
-</return>
+<return></return>
</function>
-<function name="g_file_attribute_info_list_lookup">
+<function name="foo_igen_com_acme_coyote_complete_sleep">
<description>
-Gets the file attribute with the name @name from @list.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-com-acme-Coyote.Sleep">Sleep()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name of the attribute to lookup.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeInfo for the @name, or %NULL if an
-attribute isn't found.
-</return>
+<return></return>
</function>
-<function name="g_file_attribute_info_list_new">
+<function name="foo_igen_com_acme_coyote_dup_mood">
<description>
-Creates a new file attribute info list.
-
-
-</description>
-<parameters>
-</parameters>
-<return> a #GFileAttributeInfoList.
-</return>
-</function>
+Gets a copy of the <link linkend="gdbus-property-com-acme-Coyote.Mood">"Mood"</link> D-Bus property.
-<function name="g_file_attribute_info_list_ref">
-<description>
-References a file attribute info list.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> a #GFileAttributeInfoList to reference.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileAttributeInfoList or %NULL on error.
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_attribute_info_list_unref">
+<function name="foo_igen_com_acme_coyote_emit_surprised">
<description>
-Removes a reference from the given @list. If the reference count
-falls to zero, the @list is deleted.
+Emits the <link linkend="gdbus-signal-com-acme-Coyote.Surprised">"Surprised"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="list">
-<parameter_description> The #GFileAttributeInfoList to unreference.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_attribute_matcher_enumerate_namespace">
+<function name="foo_igen_com_acme_coyote_get_mood">
<description>
-Checks if the matcher will match all of the keys in a given namespace.
-This will always return %TRUE if a wildcard character is in use (e.g. if
-matcher was created with "standard::*" and @ns is "standard", or if matcher was created
-using "*" and namespace is anything.)
+Gets the value of the <link linkend="gdbus-property-com-acme-Coyote.Mood">"Mood"</link> D-Bus property.
-TODO: this is awkwardly worded.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_com_acme_coyote_dup_mood() if on another thread.</warning>
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
-</parameter_description>
-</parameter>
-<parameter name="ns">
-<parameter_description> a string containing a file attribute namespace.
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the matcher matches all of the entries
-in the given @ns, %FALSE otherwise.
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_file_attribute_matcher_enumerate_next">
+<function name="foo_igen_com_acme_coyote_interface_info">
<description>
-Gets the next matched attribute from a #GFileAttributeMatcher.
+Gets a machine-readable description of the <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link> D-Bus interface.
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
-</parameter_description>
-</parameter>
</parameters>
-<return> a string containing the next attribute or %NULL if
-no more attribute exist.
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_file_attribute_matcher_matches">
+<function name="foo_igen_com_acme_coyote_override_properties">
<description>
-Checks if an attribute will be matched by an attribute matcher. If
-the matcher was created with the "*" matching string, this function
-will always return %TRUE.
+Overrides all #GObject properties in the #FooiGenComAcmeCoyote interface for a concrete class.
+The properties are overridden in the order they are defined.
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @attribute matches @matcher. %FALSE otherwise.
+<return> The last property id.
</return>
</function>
-<function name="g_file_attribute_matcher_matches_only">
+<function name="foo_igen_com_acme_coyote_proxy_new">
<description>
-Checks if a attribute matcher only matches a given attribute. Always
-returns %FALSE if "*" was used when creating the matcher.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link>. See g_dbus_proxy_new() for more details.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_com_acme_coyote_proxy_new_finish() to get the result of the operation.
+See foo_igen_com_acme_coyote_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the matcher only matches @attribute. %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_attribute_matcher_new">
+<function name="foo_igen_com_acme_coyote_proxy_new_finish">
<description>
-Creates a new file attribute matcher, which matches attributes
-against a given string. #GFileAttributeMatcher<!-- -->s are reference
-counted structures, and are created with a reference count of 1. If
-the number of references falls to 0, the #GFileAttributeMatcher is
-automatically destroyed.
-
-The @attribute string should be formatted with specific keys separated
-from namespaces with a double colon. Several "namespace::key" strings may be
-concatenated with a single comma (e.g. "standard::type,standard::is-hidden").
-The wildcard "*" may be used to match all keys and namespaces, or
-"namespace::*" will match all keys in a given namespace.
-
-Examples of strings to use:
-<table>
-<title>File Attribute Matcher strings and results</title>
-<tgroup cols='2' align='left'><thead>
-<row><entry> Matcher String </entry><entry> Matches </entry></row></thead>
-<tbody>
-<row><entry>"*"</entry><entry>matches all attributes.</entry></row>
-<row><entry>"standard::is-hidden"</entry><entry>matches only the key is-hidden in the standard namespace.</entry></row>
-<row><entry>"standard::type,unix::*"</entry><entry>matches the type key in the standard namespace and
-all keys in the unix namespace.</entry></row>
-</tbody></tgroup>
-</table>
+Finishes an operation started with foo_igen_com_acme_coyote_proxy_new().
</description>
<parameters>
-<parameter name="attributes">
-<parameter_description> an attribute string to match.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_com_acme_coyote_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeMatcher.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_attribute_matcher_ref">
+<function name="foo_igen_com_acme_coyote_proxy_new_for_bus">
<description>
-References a file attribute matcher.
+Like foo_igen_com_acme_coyote_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_com_acme_coyote_proxy_new_for_bus_finish() to get the result of the operation.
+
+See foo_igen_com_acme_coyote_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeMatcher.
-</return>
+<return></return>
</function>
-<function name="g_file_attribute_matcher_unref">
+<function name="foo_igen_com_acme_coyote_proxy_new_for_bus_finish">
<description>
-Unreferences @matcher. If the reference count falls below 1,
-the @matcher is automatically freed.
+Finishes an operation started with foo_igen_com_acme_coyote_proxy_new_for_bus().
</description>
<parameters>
-<parameter name="matcher">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_com_acme_coyote_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_file_copy">
+<function name="foo_igen_com_acme_coyote_proxy_new_for_bus_sync">
<description>
-Copies the file @source to the location specified by @destination.
-Can not handle recursive copies of directories.
-
-If the flag #G_FILE_COPY_OVERWRITE is specified an already
-existing @destination file is overwritten.
-
-If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
-will be copied as symlinks, otherwise the target of the
- source symlink will be copied.
-
-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 @progress_callback is not %NULL, then the operation can be monitored by
-setting this to a #GFileProgressCallback function. @progress_callback_data
-will be passed to this function. It is guaranteed that this callback will
-be called after all data has been transferred with the total number of bytes
-copied during the operation.
-
-If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
-error is returned, independent on the status of the @destination.
-
-If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
-error G_IO_ERROR_EXISTS is returned.
+Like foo_igen_com_acme_coyote_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
-error is returned. If trying to overwrite a directory with a directory the
-G_IO_ERROR_WOULD_MERGE error is returned.
-
-If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
-specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
-is returned.
+The calling thread is blocked until a reply is received.
-If you are interested in copying the #GFile object itself (not the on-disk
-file), see g_file_dup().
+See foo_igen_com_acme_coyote_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="source">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="destination">
-<parameter_description> destination #GFile
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> set of #GFileCopyFlags
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="progress_callback">
-<parameter_description> function to callback with progress information
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="progress_callback_data">
-<parameter_description> user data to pass to @progress_callback
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError to set on error, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_copy_async">
+<function name="foo_igen_com_acme_coyote_proxy_new_sync">
<description>
-Copies the file @source to the location specified by @destination
-asynchronously. For details of the behaviour, see g_file_copy().
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link>. See g_dbus_proxy_new_sync() for more details.
-If @progress_callback is not %NULL, then that function that will be called
-just like in g_file_copy(), however the callback will run in the main loop,
-not in the thread that is doing the I/O operation.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_com_acme_coyote_proxy_new() for the asynchronous version of this constructor.
-When the operation is finished, @callback will be called. You can then call
-g_file_copy_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="source">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="destination">
-<parameter_description> destination #GFile
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> set of #GFileCopyFlags
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="progress_callback">
-<parameter_description> function to callback with progress information
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="progress_callback_data">
-<parameter_description> user data to pass to @progress_callback
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameters>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="foo_igen_com_acme_coyote_set_mood">
+<description>
+Sets the <link linkend="gdbus-property-com-acme-Coyote.Mood">"Mood"</link> D-Bus property to @value.
+
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenComAcmeCoyote.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_copy_attributes">
+<function name="foo_igen_com_acme_coyote_skeleton_new">
<description>
-Copies the file attributes from @source to @destination.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link>.
-Normally only a subset of the file attributes are copied,
-those that are copies in a normal file copy operation
-(which for instance does not include e.g. owner). However
-if #G_FILE_COPY_ALL_METADATA is specified in @flags, then
-all the metadata that is possible to copy is copied. This
-is useful when implementing move by copy + delete source.
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="foo_igen_fdpassing_call_hello_fd">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-FDPassing.HelloFD">HelloFD()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_fdpassing_call_hello_fd_finish() to get the result of the operation.
+
+See foo_igen_fdpassing_call_hello_fd_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="source">
-<parameter_description> a #GFile with attributes.
+<parameter name="proxy">
+<parameter_description> A #FooiGenFDPassingProxy.
</parameter_description>
</parameter>
-<parameter name="destination">
-<parameter_description> a #GFile to copy attributes to.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCopyFlags.
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the attributes were copied successfully, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_copy_finish">
+<function name="foo_igen_fdpassing_call_hello_fd_finish">
<description>
-Finishes copying the file started with
-g_file_copy_async().
+Finishes an operation started with foo_igen_fdpassing_call_hello_fd().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenFDPassingProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_fdpassing_call_hello_fd().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a %TRUE on success, %FALSE on error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_create">
+<function name="foo_igen_fdpassing_call_hello_fd_sync">
<description>
-Creates a new file and returns an output stream for writing to it.
-The file must not already exist.
-
-By default files created are generally readable by everyone,
-but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
-will be made readable only to the current user, to the level that
-is supported on the target filesystem.
-
-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.
+Synchronously invokes the <link linkend="gdbus-method-FDPassing.HelloFD">HelloFD()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-If a file or directory with this name already exists the G_IO_ERROR_EXISTS
-error will be returned.
-Some file systems don't allow all file names, and may
-return an G_IO_ERROR_INVALID_FILENAME error, and if the name
-is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
-Other errors are possible too, and depend on what kind of
-filesystem the file is on.
+See foo_igen_fdpassing_call_hello_fd() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenFDPassingProxy.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileOutputStream for the newly created file, or
-%NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_create_async">
+<function name="foo_igen_fdpassing_complete_hello_fd">
<description>
-Asynchronously creates a new file and returns an output stream for writing to it.
-The file must not already exist.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-FDPassing.HelloFD">HelloFD()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-For more details, see g_file_create() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_create_finish() to get the result of the operation.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="object">
+<parameter_description> A #FooiGenFDPassing.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="response">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_create_finish">
+<function name="foo_igen_fdpassing_interface_info">
<description>
-Finishes an asynchronous file create operation started with
-g_file_create_async().
+Gets a machine-readable description of the <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link> D-Bus interface.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GFileOutputStream or %NULL on error.
-Free the returned object with g_object_unref().
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_file_create_readwrite">
+<function name="foo_igen_fdpassing_override_properties">
<description>
-Creates a new file and returns a stream for reading and writing to it.
-The file must not already exist.
-
-By default files created are generally readable by everyone,
-but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
-will be made readable only to the current user, to the level that
-is supported on the target filesystem.
-
-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 a file or directory with this name already exists the %G_IO_ERROR_EXISTS
-error will be returned. Some file systems don't allow all file names,
-and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name
-is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors
-are possible too, and depend on what kind of filesystem the file is on.
-
-Note that in many non-local file cases read and write streams are not
-supported, so make sure you really need to do read and write streaming,
-rather than just opening for reading or writing.
+Overrides all #GObject properties in the #FooiGenFDPassing interface for a concrete class.
+The properties are overridden in the order they are defined.
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream for the newly created file, or %NULL on error.
-Free the returned object with g_object_unref().
-
+<return> The last property id.
</return>
</function>
-<function name="g_file_create_readwrite_async">
+<function name="foo_igen_fdpassing_proxy_new">
<description>
-Asynchronously creates a new file and returns a stream for reading and
-writing to it. The file must not already exist.
-
-For more details, see g_file_create_readwrite() which is
-the synchronous version of this call.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link>. See g_dbus_proxy_new() for more details.
-When the operation is finished, @callback will be called. You can then
-call g_file_create_readwrite_finish() to get the result of the operation.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_fdpassing_proxy_new_finish() to get the result of the operation.
-Since: 2.22
+See foo_igen_fdpassing_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_create_readwrite_finish">
+<function name="foo_igen_fdpassing_proxy_new_finish">
<description>
-Finishes an asynchronous file create operation started with
-g_file_create_readwrite_async().
+Finishes an operation started with foo_igen_fdpassing_proxy_new().
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_fdpassing_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream or %NULL on error.
-Free the returned object with g_object_unref().
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_delete">
+<function name="foo_igen_fdpassing_proxy_new_for_bus">
<description>
-Deletes a file. If the @file is a directory, it will only be deleted if it
-is empty.
+Like foo_igen_fdpassing_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-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.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_fdpassing_proxy_new_for_bus_finish() to get the result of the operation.
-Virtual: delete_file
+See foo_igen_fdpassing_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file was deleted. %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_descriptor_based_get_fd">
+<function name="foo_igen_fdpassing_proxy_new_for_bus_finish">
<description>
-Gets the underlying file descriptor.
+Finishes an operation started with foo_igen_fdpassing_proxy_new_for_bus().
-Since: 2.24
</description>
<parameters>
-<parameter name="fd_based">
-<parameter_description> a #GFileDescriptorBased.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_fdpassing_proxy_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> The file descriptor
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_dup">
+<function name="foo_igen_fdpassing_proxy_new_for_bus_sync">
<description>
-Duplicates a #GFile handle. This operation does not duplicate
-the actual file or directory represented by the #GFile; see
-g_file_copy() if attempting to copy a file.
+Like foo_igen_fdpassing_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-This call does no blocking i/o.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_fdpassing_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile that is a duplicate of the given #GFile.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_eject_mountable">
+<function name="foo_igen_fdpassing_proxy_new_sync">
<description>
-Starts an asynchronous eject on a mountable.
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_eject_mountable_finish().
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link>. See g_dbus_proxy_new_sync() for more details.
-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.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_fdpassing_proxy_new() for the asynchronous version of this constructor.
-Deprecated: 2.22: Use g_file_eject_mountable_with_operation() instead.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_file_eject_mountable_finish">
+<function name="foo_igen_fdpassing_skeleton_new">
<description>
-Finishes an asynchronous eject operation started by
-g_file_eject_mountable().
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link>.
-Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() instead.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if the @file was ejected successfully. %FALSE
-otherwise.
-
+<return> The skeleton object.
</return>
</function>
-<function name="g_file_eject_mountable_with_operation">
+<function name="foo_igen_inline_docs_call_foo_method">
<description>
-Starts an asynchronous eject on a mountable.
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_eject_mountable_with_operation_finish().
-
-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.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-InlineDocs.FooMethod">FooMethod()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_inline_docs_call_foo_method_finish() to get the result of the operation.
-Since: 2.22
+See foo_igen_inline_docs_call_foo_method_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_eject_mountable_with_operation_finish">
+<function name="foo_igen_inline_docs_call_foo_method_finish">
<description>
-Finishes an asynchronous eject operation started by
-g_file_eject_mountable_with_operation().
+Finishes an operation started with foo_igen_inline_docs_call_foo_method().
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_inline_docs_call_foo_method().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @file was ejected successfully. %FALSE
-otherwise.
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_enumerate_children">
+<function name="foo_igen_inline_docs_call_foo_method_sync">
<description>
-Gets the requested information about the files in a directory. The result
-is a #GFileEnumerator object that will give out #GFileInfo objects for
-all the files in the directory.
-
-The @attributes value is a string that specifies the file attributes that
-should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attributes should
-be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
-means all attributes, and a wildcard like "standard::*" means all attributes in the standard
-namespace. An example attribute query be "standard::*,owner::user".
-The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
-
-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.
+Synchronously invokes the <link linkend="gdbus-method-org-project-InlineDocs.FooMethod">FooMethod()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-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 error will be returned.
-Other errors are possible too.
+See foo_igen_inline_docs_call_foo_method() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
</parameter_description>
</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A #GFileEnumerator if successful, %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_enumerate_children_async">
+<function name="foo_igen_inline_docs_call_method2">
<description>
-Asynchronously gets the requested information about the files in a directory. The result
-is a #GFileEnumerator object that will give out #GFileInfo objects for
-all the files in the directory.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-InlineDocs.Method2">Method2()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_inline_docs_call_method2_finish() to get the result of the operation.
-For more details, see g_file_enumerate_children() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_enumerate_children_finish() to get the result of the operation.
+See foo_igen_inline_docs_call_method2_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the
-request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_enumerate_children_finish">
+<function name="foo_igen_inline_docs_call_method2_finish">
<description>
-Finishes an async enumerate children operation.
-See g_file_enumerate_children_async().
+Finishes an operation started with foo_igen_inline_docs_call_method2().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_inline_docs_call_method2().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileEnumerator or %NULL if an error occurred.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_enumerator_close">
+<function name="foo_igen_inline_docs_call_method2_sync">
<description>
-Releases all resources used by this enumerator, making the
-enumerator return %G_IO_ERROR_CLOSED on all calls.
+Synchronously invokes the <link linkend="gdbus-method-org-project-InlineDocs.Method2">Method2()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-This will be automatically called when the last reference
-is dropped, but you might want to call this function to make
-sure resources are released as early as possible.
+See foo_igen_inline_docs_call_method2() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="proxy">
+<parameter_description> A #FooiGenInlineDocsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_greeting">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_response">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #TRUE on success or #FALSE on error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_enumerator_close_async">
+<function name="foo_igen_inline_docs_complete_foo_method">
<description>
-Asynchronously closes the file enumerator.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-InlineDocs.FooMethod">FooMethod()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-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 in
-g_file_enumerator_close_finish().
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="response">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_enumerator_close_finish">
+<function name="foo_igen_inline_docs_complete_method2">
<description>
-Finishes closing a file enumerator, started from g_file_enumerator_close_async().
-
-If the file enumerator was already closed when g_file_enumerator_close_async()
-was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
-return %FALSE. If the file enumerator had pending operation when the close
-operation was started, then this function will report %G_IO_ERROR_PENDING, and
-return %FALSE. If @cancellable was not %NULL, then the operation may have been
-cancelled by triggering the cancellable object from another thread. If the operation
-was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
-returned.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-InlineDocs.Method2">Method2()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="response">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the close operation has finished successfully.
-</return>
+<return></return>
</function>
-<function name="g_file_enumerator_get_container">
+<function name="foo_igen_inline_docs_dup_baz_property">
<description>
-Get the #GFile container which is being enumerated.
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.BazProperty">"BazProperty"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-Since: 2.18
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> the #GFile which is being enumerated.
-
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_enumerator_has_pending">
+<function name="foo_igen_inline_docs_dup_fancy_property">
<description>
-Checks if the file enumerator has pending operations.
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.FancyProperty">"FancyProperty"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @enumerator has pending operations.
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_enumerator_is_closed">
+<function name="foo_igen_inline_docs_dup_property2">
<description>
-Checks if the file enumerator has been closed.
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.Property2">"Property2"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @enumerator is closed.
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_enumerator_next_file">
+<function name="foo_igen_inline_docs_dup_property3">
<description>
-Returns information for the next file in the enumerated object.
-Will block until the information is available. The #GFileInfo
-returned from this function will contain attributes that match the
-attribute string that was passed when the #GFileEnumerator was created.
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.Property3">"Property3"</link> D-Bus property.
-On error, returns %NULL and sets @error to the error. If the
-enumerator is at the end, %NULL will be returned and @error will
-be unset.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> A #GFileInfo or %NULL on error or end of enumerator.
-Free the returned object with g_object_unref() when no longer needed.
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_enumerator_next_files_async">
+<function name="foo_igen_inline_docs_dup_property4">
<description>
-Request information for a number of files from the enumerator asynchronously.
-When all i/o for the operation is finished the @callback will be called with
-the requested information.
-
-The callback can be called with less than @num_files files in case of error
-or at the end of the enumerator. In case of a partial error the callback will
-be called with any succeeding items and no error, and on the next request the
-error will be reported. If a request is cancelled the callback will be called
-with %G_IO_ERROR_CANCELLED.
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.Property4">"Property4"</link> D-Bus property.
-During an async request no other sync and async calls are allowed, and will
-result in %G_IO_ERROR_PENDING errors.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-Any outstanding i/o request with higher priority (lower numerical value) will
-be executed before an outstanding request with lower priority. Default
-priority is %G_PRIORITY_DEFAULT.
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="num_files">
-<parameter_description> the number of file info objects to request
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_dup_property5">
+<description>
+Gets a copy of the <link linkend="gdbus-property-org-project-InlineDocs.Property5">"Property5"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="gioscheduler">io priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_emit_bar_signal">
+<description>
+Emits the <link linkend="gdbus-signal-org-project-InlineDocs.BarSignal">"BarSignal"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="arg_blah">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="arg_boo">
+<parameter_description> Argument to pass with the signal.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_enumerator_next_files_finish">
+<function name="foo_igen_inline_docs_get_baz_property">
<description>
-Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.BazProperty">"BazProperty"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_baz_property() if on another thread.</warning>
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GFileInfo<!---->s. You must free the list with
-g_list_free() and unref the infos with g_object_unref() when you're
-done with them.
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_file_enumerator_set_pending">
+<function name="foo_igen_inline_docs_get_fancy_property">
<description>
-Sets the file enumerator as having pending operations.
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.FancyProperty">"FancyProperty"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_fancy_property() if on another thread.</warning>
+
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GFileEnumerator.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="pending">
-<parameter_description> a boolean value.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_get_property2">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.Property2">"Property2"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_property2() if on another thread.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
</function>
-<function name="g_file_equal">
+<function name="foo_igen_inline_docs_get_property3">
<description>
-Checks equality of two given #GFile<!-- -->s. Note that two
-#GFile<!-- -->s that differ can still refer to the same
-file on the filesystem due to various forms of filename
-aliasing.
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.Property3">"Property3"</link> D-Bus property.
-This call does no blocking i/o.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_property3() if on another thread.</warning>
</description>
<parameters>
-<parameter name="file1">
-<parameter_description> the first #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="file2">
-<parameter_description> the second #GFile.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_get_property4">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.Property4">"Property4"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_property4() if on another thread.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @file1 and @file2 are equal.
-%FALSE if either is not a #GFile.
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_file_find_enclosing_mount">
+<function name="foo_igen_inline_docs_get_property5">
<description>
-Gets a #GMount for the #GFile.
+Gets the value of the <link linkend="gdbus-property-org-project-InlineDocs.Property5">"Property5"</link> D-Bus property.
-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.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-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.
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_inline_docs_dup_property5() if on another thread.</warning>
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_interface_info">
+<description>
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link> D-Bus interface.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="foo_igen_inline_docs_override_properties">
+<description>
+Overrides all #GObject properties in the #FooiGenInlineDocs interface for a concrete class.
+The properties are overridden in the order they are defined.
+
+
+</description>
+<parameters>
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> a #GMount where the @file is located or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The last property id.
</return>
</function>
-<function name="g_file_find_enclosing_mount_async">
+<function name="foo_igen_inline_docs_proxy_new">
<description>
-Asynchronously gets the mount for the file.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link>. See g_dbus_proxy_new() for more details.
-For more details, see g_file_find_enclosing_mount() which is
-the synchronous version of this call.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_inline_docs_proxy_new_finish() to get the result of the operation.
-When the operation is finished, @callback will be called. You can then call
-g_file_find_enclosing_mount_finish() to get the result of the operation.
+See foo_igen_inline_docs_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_find_enclosing_mount_finish">
+<function name="foo_igen_inline_docs_proxy_new_finish">
<description>
-Finishes an asynchronous find mount request.
-See g_file_find_enclosing_mount_async().
+Finishes an operation started with foo_igen_inline_docs_proxy_new().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_inline_docs_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> #GMount for given @file or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_get_basename">
+<function name="foo_igen_inline_docs_proxy_new_for_bus">
<description>
-Gets the base name (the last component of the path) for a given #GFile.
-
-If called for the top level of a system (such as the filesystem root
-or a uri like sftp://host/) it will return a single directory separator
-(and on Windows, possibly a drive letter).
-
-The base name is a byte string (*not* UTF-8). It has no defined encoding
-or rules other than it may not contain zero bytes. If you want to use
-filenames in a user interface you should use the display name that you
-can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
-attribute with g_file_query_info().
+Like foo_igen_inline_docs_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-This call does no blocking i/o.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_inline_docs_proxy_new_for_bus_finish() to get the result of the operation.
+See foo_igen_inline_docs_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> string containing the #GFile's base name, or %NULL
-if given #GFile is invalid. The returned string should be
-freed with g_free() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_get_child">
+<function name="foo_igen_inline_docs_proxy_new_for_bus_finish">
<description>
-Gets a child of @file with basename equal to @name.
-
-Note that the file with that specific name might not exist, but
-you can still have a #GFile that points to it. You can use this
-for instance to create that file.
-
-This call does no blocking i/o.
+Finishes an operation started with foo_igen_inline_docs_proxy_new_for_bus().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_inline_docs_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> string containing the child's basename.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile to a child specified by @name.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_get_child_for_display_name">
+<function name="foo_igen_inline_docs_proxy_new_for_bus_sync">
<description>
-Gets the child of @file for a given @display_name (i.e. a UTF8
-version of the name). If this function fails, it returns %NULL and @error will be
-set. This is very useful when constructing a GFile for a new file
-and the user entered the filename in the user interface, for instance
-when you select a directory and type a filename in the file selector.
+Like foo_igen_inline_docs_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-This call does no blocking i/o.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_inline_docs_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="display_name">
-<parameter_description> string to a possible child.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile to the specified child, or
-%NULL if the display name couldn't be converted.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_get_parent">
+<function name="foo_igen_inline_docs_proxy_new_sync">
<description>
-Gets the parent directory for the @file.
-If the @file represents the root directory of the
-file system, then %NULL will be returned.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link>. See g_dbus_proxy_new_sync() for more details.
-This call does no blocking i/o.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_inline_docs_proxy_new() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile structure to the parent of the given
-#GFile or %NULL if there is no parent.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_get_parse_name">
+<function name="foo_igen_inline_docs_set_baz_property">
<description>
-Gets the parse name of the @file.
-A parse name is a UTF-8 string that describes the
-file such that one can get the #GFile back using
-g_file_parse_name().
-
-This is generally used to show the #GFile as a nice
-full-pathname kind of string in a user interface,
-like in a location entry.
-
-For local files with names that can safely be converted
-to UTF8 the pathname is used, otherwise the IRI is used
-(a form of URI that allows UTF8 characters unescaped).
-
-This call does no blocking i/o.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.BazProperty">"BazProperty"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the #GFile's parse name. The returned
-string should be freed with g_free() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_get_path">
+<function name="foo_igen_inline_docs_set_fancy_property">
<description>
-Gets the local pathname for #GFile, if one exists.
-
-This call does no blocking i/o.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.FancyProperty">"FancyProperty"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> string containing the #GFile's path, or %NULL if
-no such path exists. The returned string should be
-freed with g_free() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_get_relative_path">
+<function name="foo_igen_inline_docs_set_property2">
<description>
-Gets the path for @descendant relative to @parent.
-
-This call does no blocking i/o.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.Property2">"Property2"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="parent">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="descendant">
-<parameter_description> input #GFile.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> string with the relative path from @descendant
-to @parent, or %NULL if @descendant doesn't have @parent as prefix.
-The returned string should be freed with g_free() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_get_uri">
+<function name="foo_igen_inline_docs_set_property3">
<description>
-Gets the URI for the @file.
-
-This call does no blocking i/o.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.Property3">"Property3"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the #GFile's URI.
-The returned string should be freed with g_free() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_get_uri_scheme">
+<function name="foo_igen_inline_docs_set_property4">
<description>
-Gets the URI scheme for a #GFile.
-RFC 3986 decodes the scheme as:
-<programlisting>
-URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
-</programlisting>
-Common schemes include "file", "http", "ftp", etc.
-
-This call does no blocking i/o.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.Property4">"Property4"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the URI scheme for the given
-#GFile. The returned string should be freed with g_free()
-when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_file_has_parent">
+<function name="foo_igen_inline_docs_set_property5">
<description>
-Checks if @file has a parent, and optionally, if it is @parent.
-
-If @parent is %NULL then this function returns %TRUE if @file has any
-parent at all. If @parent is non-%NULL then %TRUE is only returned
-if @file is a child of @parent.
+Sets the <link linkend="gdbus-property-org-project-InlineDocs.Property5">"Property5"</link> D-Bus property to @value.
-Since: 2.24
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
+<parameter name="object">
+<parameter_description> A #FooiGenInlineDocs.
</parameter_description>
</parameter>
-<parameter name="parent">
-<parameter_description> the parent to check for, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @file is a child of @parent (or any parent in the
-case that @parent is %NULL).
-
-</return>
+<return></return>
</function>
-<function name="g_file_has_prefix">
+<function name="foo_igen_inline_docs_skeleton_new">
<description>
-Checks whether @file has the prefix specified by @prefix. In other word,
-if the names of inital elements of @file<!-- -->s pathname match @prefix.
-Only full pathname elements are matched, so a path like /foo is not
-considered a prefix of /foobar, only of /foo/bar.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link>.
-This call does no i/o, as it works purely on names. As such it can
-sometimes return %FALSE even if @file is inside a @prefix (from a
-filesystem point of view), because the prefix of @file is an alias
-of @prefix.
-
-Virtual: prefix_matches
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="prefix">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if the @files's parent, grandparent, etc is @prefix.
-%FALSE otherwise.
+<return> The skeleton object.
</return>
</function>
-<function name="g_file_has_uri_scheme">
+<function name="foo_igen_method_threads_call_get_self">
<description>
-Checks to see if a #GFile has a given URI scheme.
-
-This call does no blocking i/o.
+Asynchronously invokes the <link linkend="gdbus-method-org-project-MethodThreads.GetSelf">GetSelf()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_method_threads_call_get_self_finish() to get the result of the operation.
+See foo_igen_method_threads_call_get_self_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenMethodThreadsProxy.
</parameter_description>
</parameter>
-<parameter name="uri_scheme">
-<parameter_description> a string containing a URI scheme.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if #GFile's backend supports the
-given URI scheme, %FALSE if URI scheme is %NULL,
-not supported, or #GFile is invalid.
-</return>
+<return></return>
</function>
-<function name="g_file_hash">
+<function name="foo_igen_method_threads_call_get_self_finish">
<description>
-Creates a hash value for a #GFile.
-
-This call does no blocking i/o.
+Finishes an operation started with foo_igen_method_threads_call_get_self().
-Virtual: hash
</description>
<parameters>
-<parameter name="file">
-<parameter_description> #gconstpointer to a #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenMethodThreadsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_self_pointer">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_method_threads_call_get_self().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> 0 if @file is not a valid #GFile, otherwise an
-integer that can be used as hash value for the #GFile.
-This function is intended for easily hashing a #GFile to
-add to a #GHashTable or similar data structure.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_icon_get_file">
+<function name="foo_igen_method_threads_call_get_self_sync">
<description>
-Gets the #GFile associated with the given @icon.
+Synchronously invokes the <link linkend="gdbus-method-org-project-MethodThreads.GetSelf">GetSelf()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_method_threads_call_get_self() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GIcon.
+<parameter name="proxy">
+<parameter_description> A #FooiGenMethodThreadsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_self_pointer">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile, or %NULL.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_icon_new">
+<function name="foo_igen_method_threads_complete_get_self">
<description>
-Creates a new icon for a file.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-project-MethodThreads.GetSelf">GetSelf()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenMethodThreads.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="self_pointer">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon for the given @file, or %NULL on error.
-</return>
+<return></return>
</function>
-<function name="g_file_info_clear_status">
+<function name="foo_igen_method_threads_interface_info">
<description>
-Clears the status information from @info.
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link> D-Bus interface.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
</function>
-<function name="g_file_info_copy_into">
+<function name="foo_igen_method_threads_override_properties">
<description>
-Copies all of the #GFileAttribute<!-- -->s from @src_info to @dest_info.
+Overrides all #GObject properties in the #FooiGenMethodThreads interface for a concrete class.
+The properties are overridden in the order they are defined.
+
</description>
<parameters>
-<parameter name="src_info">
-<parameter_description> source to copy attributes from.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="dest_info">
-<parameter_description> destination to copy attributes to.
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+</return>
</function>
-<function name="g_file_info_dup">
+<function name="foo_igen_method_threads_proxy_new">
<description>
-Duplicates a file info structure.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link>. See g_dbus_proxy_new() for more details.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_method_threads_proxy_new_finish() to get the result of the operation.
+See foo_igen_method_threads_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="other">
-<parameter_description> a #GFileInfo.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a duplicate #GFileInfo of @other.
-</return>
+<return></return>
</function>
-<function name="g_file_info_get_attribute_as_string">
+<function name="foo_igen_method_threads_proxy_new_finish">
<description>
-Gets the value of a attribute, formated as a string.
-This escapes things as needed to make the string valid
-utf8.
+Finishes an operation started with foo_igen_method_threads_proxy_new().
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_method_threads_proxy_new().
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a UTF-8 string associated with the given @attribute.
-When you're done with the string it must be freed with g_free().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_get_attribute_boolean">
+<function name="foo_igen_method_threads_proxy_new_for_bus">
<description>
-Gets the value of a boolean attribute. If the attribute does not
-contain a boolean value, %FALSE will be returned.
+Like foo_igen_method_threads_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_method_threads_proxy_new_for_bus_finish() to get the result of the operation.
+See foo_igen_method_threads_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> the boolean value contained within the attribute.
-</return>
+<return></return>
</function>
-<function name="g_file_info_get_attribute_byte_string">
+<function name="foo_igen_method_threads_proxy_new_for_bus_finish">
<description>
-Gets the value of a byte string attribute. If the attribute does
-not contain a byte string, %NULL will be returned.
+Finishes an operation started with foo_igen_method_threads_proxy_new_for_bus().
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_method_threads_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the contents of the @attribute value as a byte string, or
-%NULL otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_get_attribute_data">
+<function name="foo_igen_method_threads_proxy_new_for_bus_sync">
<description>
-Gets the attribute type, value and status for an attribute key.
+Like foo_igen_method_threads_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_method_threads_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> return location for the attribute type, or %NULL
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="value_pp">
-<parameter_description> return location for the attribute value, or %NULL
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="status">
-<parameter_description> return location for the attribute status, or %NULL
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @info has an attribute named @attribute,
-%FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_get_attribute_int32">
+<function name="foo_igen_method_threads_proxy_new_sync">
<description>
-Gets a signed 32-bit integer contained within the attribute. If the
-attribute does not contain a signed 32-bit integer, or is invalid,
-0 will be returned.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_method_threads_proxy_new() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a signed 32-bit integer from the attribute.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_get_attribute_int64">
+<function name="foo_igen_method_threads_skeleton_new">
<description>
-Gets a signed 64-bit integer contained within the attribute. If the
-attribute does not contain an signed 64-bit integer, or is invalid,
-0 will be returned.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link>.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
</parameters>
-<return> a signed 64-bit integer from the attribute.
+<return> The skeleton object.
</return>
</function>
-<function name="g_file_info_get_attribute_object">
+<function name="foo_igen_object_get_authorize">
<description>
-Gets the value of a #GObject attribute. If the attribute does
-not contain a #GObject, %NULL will be returned.
+Gets the #FooiGenAuthorize instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a #GObject associated with the given @attribute, or
-%NULL otherwise.
+<return> A #FooiGenAuthorize that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_status">
+<function name="foo_igen_object_get_bar">
<description>
-Gets the attribute status for an attribute key.
+Gets the #FooiGenBar instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeStatus for the given @attribute, or
-%G_FILE_ATTRIBUTE_STATUS_UNSET if the key is invalid.
-
+<return> A #FooiGenBar that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_string">
+<function name="foo_igen_object_get_bar_frobnicator">
<description>
-Gets the value of a string attribute. If the attribute does
-not contain a string, %NULL will be returned.
+Gets the #FooiGenBarFrobnicator instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> the contents of the @attribute value as a UTF-8 string, or
-%NULL otherwise.
+<return> A #FooiGenBarFrobnicator that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_stringv">
+<function name="foo_igen_object_get_bat">
<description>
-Gets the value of a stringv attribute. If the attribute does
-not contain a stringv, %NULL will be returned.
+Gets the #FooiGenBat instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link> on @object, if any.
-Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> the contents of the @attribute value as a stringv, or
-%NULL otherwise. Do not free. These returned strings are UTF-8.
-
+<return> A #FooiGenBat that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_type">
+<function name="foo_igen_object_get_baz">
<description>
-Gets the attribute type for an attribute key.
+Gets the #FooiGenBaz instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeType for the given @attribute, or
-%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set.
+<return> A #FooiGenBaz that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_uint32">
+<function name="foo_igen_object_get_changing_interface_v1">
<description>
-Gets an unsigned 32-bit integer contained within the attribute. If the
-attribute does not contain an unsigned 32-bit integer, or is invalid,
-0 will be returned.
+Gets the #FooiGenChangingInterfaceV1 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> an unsigned 32-bit integer from the attribute.
+<return> A #FooiGenChangingInterfaceV1 that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_attribute_uint64">
+<function name="foo_igen_object_get_changing_interface_v10">
<description>
-Gets a unsigned 64-bit integer contained within the attribute. If the
-attribute does not contain an unsigned 64-bit integer, or is invalid,
-0 will be returned.
+Gets the #FooiGenChangingInterfaceV10 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> on @object, if any.
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a unsigned 64-bit integer from the attribute.
+<return> A #FooiGenChangingInterfaceV10 that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
+
</return>
</function>
-<function name="g_file_info_get_content_type">
+<function name="foo_igen_object_get_changing_interface_v2">
<description>
-Gets the file's content type.
+Gets the #FooiGenChangingInterfaceV2 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> on @object, if any.
+Since: 2.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the file's content type.
+<return> A #FooiGenChangingInterfaceV2 that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
+
</return>
</function>
-<function name="g_file_info_get_display_name">
+<function name="foo_igen_object_get_com_acme_coyote">
<description>
-Gets a display name for a file.
+Gets the #FooiGenComAcmeCoyote instance for the D-Bus interface <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the display name.
+<return> A #FooiGenComAcmeCoyote that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_edit_name">
+<function name="foo_igen_object_get_fdpassing">
<description>
-Gets the edit name for a file.
+Gets the #FooiGenFDPassing instance for the D-Bus interface <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the edit name.
+<return> A #FooiGenFDPassing that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_etag">
+<function name="foo_igen_object_get_inline_docs">
<description>
-Gets the <link linkend="gfile-etag">entity tag</link> for a given
-#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
+Gets the #FooiGenInlineDocs instance for the D-Bus interface <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the value of the "etag:value" attribute.
+<return> A #FooiGenInlineDocs that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_file_type">
+<function name="foo_igen_object_get_method_threads">
<description>
-Gets a file's type (whether it is a regular file, symlink, etc).
-This is different from the file's content type, see g_file_info_get_content_type().
+Gets the #FooiGenMethodThreads instance for the D-Bus interface <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileType for the given file.
+<return> A #FooiGenMethodThreads that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_icon">
+<function name="foo_igen_object_get_oldie_interface">
<description>
-Gets the icon for a file.
+Gets the #FooiGenOldieInterface instance for the D-Bus interface <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link> on @object, if any.
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> #GIcon for the given @info.
+<return> A #FooiGenOldieInterface that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
+
</return>
</function>
-<function name="g_file_info_get_is_backup">
+<function name="foo_igen_object_get_rocket123">
<description>
-Checks if a file is a backup file.
+Gets the #FooiGenRocket123 instance for the D-Bus interface <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if file is a backup file, %FALSE otherwise.
+<return> A #FooiGenRocket123 that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_is_hidden">
+<function name="foo_igen_object_get_test_ugly_case_interface">
<description>
-Checks if a file is hidden.
+Gets the #FooiGenTesTuglyCASEInterface instance for the D-Bus interface <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file is a hidden file, %FALSE otherwise.
+<return> A #FooiGenTesTuglyCASEInterface that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_is_symlink">
+<function name="foo_igen_object_get_unknown_xml_tags">
<description>
-Checks if a file is a symlink.
+Gets the #FooiGenUnknownXmlTags instance for the D-Bus interface <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link> on @object, if any.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the given @info is a symlink.
+<return> A #FooiGenUnknownXmlTags that must be freed with g_object_unref() or %NULL if @object does not implement the interface.
</return>
</function>
-<function name="g_file_info_get_modification_time">
+<function name="foo_igen_object_manager_client_get_proxy_type">
<description>
-Gets the modification time of the current @info and sets it
-in @result.
+A #GDBusProxyTypeFunc that maps @interface_name to the generated #GDBusObjectProxy<!-- -->- and #GDBusProxy<!-- -->-derived types.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GTimeVal.
+<parameter name="object_path">
+<parameter_description> The object path of the remote object (unused).
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> Interface name of the remote object or %NULL to get the object proxy #GType.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data (unused).
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusProxy<!-- -->-derived #GType if @interface_name is not %NULL, otherwise the #GType for #FooiGenObjectProxy.
+</return>
</function>
-<function name="g_file_info_get_name">
+<function name="foo_igen_object_manager_client_new">
<description>
-Gets the name for a file.
+Asynchronously creates #GDBusObjectManagerClient using foo_igen_object_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new() for more details.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_object_manager_client_new_finish() to get the result of the operation.
+
+See foo_igen_object_manager_client_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the file name.
-</return>
+<return></return>
</function>
-<function name="g_file_info_get_size">
+<function name="foo_igen_object_manager_client_new_finish">
<description>
-Gets the file's size.
+Finishes an operation started with foo_igen_object_manager_client_new().
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_object_manager_client_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #goffset containing the file's size.
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_get_sort_order">
+<function name="foo_igen_object_manager_client_new_for_bus">
<description>
-Gets the value of the sort_order attribute from the #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+Like foo_igen_object_manager_client_new() but takes a #GBusType instead of a #GDBusConnection.
+
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_object_manager_client_new_for_bus_finish() to get the result of the operation.
+See foo_igen_object_manager_client_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #gint32 containing the value of the "standard::sort_order" attribute.
-</return>
+<return></return>
</function>
-<function name="g_file_info_get_symlink_target">
+<function name="foo_igen_object_manager_client_new_for_bus_finish">
<description>
-Gets the symlink target for a given #GFileInfo.
+Finishes an operation started with foo_igen_object_manager_client_new_for_bus().
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_object_manager_client_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the symlink target.
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_has_attribute">
+<function name="foo_igen_object_manager_client_new_for_bus_sync">
<description>
-Checks if a file info structure has an attribute named @attribute.
+Like foo_igen_object_manager_client_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_object_manager_client_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @Ginfo has an attribute named @attribute,
-%FALSE otherwise.
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_has_namespace">
+<function name="foo_igen_object_manager_client_new_sync">
<description>
-Checks if a file info structure has an attribute in the
-specified @name_space.
+Synchronously creates #GDBusObjectManagerClient using foo_igen_object_manager_client_get_proxy_type() as the #GDBusProxyTypeFunc. See g_dbus_object_manager_client_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_object_manager_client_new() for the asynchronous version of this constructor.
-Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="name_space">
-<parameter_description> a file attribute namespace.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @Ginfo has an attribute in @name_space,
-%FALSE otherwise.
-
+<return> The constructed object manager client or %NULL if @error is set.
</return>
</function>
-<function name="g_file_info_list_attributes">
+<function name="foo_igen_object_peek_authorize">
<description>
-Lists the file info structure's attributes.
+Like foo_igen_object_get_authorize() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="name_space">
-<parameter_description> a file attribute key's namespace.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> a null-terminated array of strings of all of the
-possible attribute types for the given @name_space, or
-%NULL on error.
+<return> A #FooiGenAuthorize or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
</return>
</function>
-<function name="g_file_info_new">
+<function name="foo_igen_object_peek_bar">
<description>
-Creates a new file info structure.
+Like foo_igen_object_get_bar() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
</description>
<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GFileInfo.
+<return> A #FooiGenBar or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
</return>
</function>
-<function name="g_file_info_remove_attribute">
+<function name="foo_igen_object_peek_bar_frobnicator">
<description>
-Removes all cases of @attribute from @info if it exists.
+Like foo_igen_object_get_bar_frobnicator() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+</parameters>
+<return> A #FooiGenBarFrobnicator or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
+</function>
+
+<function name="foo_igen_object_peek_bat">
+<description>
+Like foo_igen_object_get_bat() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenBat or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute">
+<function name="foo_igen_object_peek_baz">
<description>
-Sets the @attribute to contain the given value, if possible.
+Like foo_igen_object_get_baz() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a #GFileAttributeType
-</parameter_description>
-</parameter>
-<parameter name="value_p">
-<parameter_description> pointer to the value
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenBaz or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_boolean">
+<function name="foo_igen_object_peek_changing_interface_v1">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_changing_interface_v1() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> a boolean value.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenChangingInterfaceV1 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_byte_string">
+<function name="foo_igen_object_peek_changing_interface_v10">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_changing_interface_v10() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> a byte string.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenChangingInterfaceV10 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+
+</return>
</function>
-<function name="g_file_info_set_attribute_int32">
+<function name="foo_igen_object_peek_changing_interface_v2">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_changing_interface_v2() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
+Since: 2.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> a signed 32-bit integer
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenChangingInterfaceV2 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+
+</return>
</function>
-<function name="g_file_info_set_attribute_int64">
+<function name="foo_igen_object_peek_com_acme_coyote">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_com_acme_coyote() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> attribute name to set.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> int64 value to set attribute to.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenComAcmeCoyote or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_mask">
+<function name="foo_igen_object_peek_fdpassing">
<description>
-Sets @mask on @info to match specific attribute types.
+Like foo_igen_object_get_fdpassing() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="mask">
-<parameter_description> a #GFileAttributeMatcher.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenFDPassing or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_object">
+<function name="foo_igen_object_peek_inline_docs">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_inline_docs() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
-</parameter_description>
-</parameter>
-<parameter name="attr_value">
-<parameter_description> a #GObject.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenInlineDocs or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_status">
+<function name="foo_igen_object_peek_method_threads">
<description>
-Sets the attribute status for an attribute key. This is only
-needed by external code that implement g_file_set_attributes_from_info()
-or similar functions.
+Like foo_igen_object_get_method_threads() but doesn't increase the reference count on the returned object.
-The attribute must exist in @info for this to work. Otherwise %FALSE
-is returned and @info is unchanged.
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
-Since: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
-<parameter name="status">
-<parameter_description> a #GFileAttributeStatus
+</parameters>
+<return> A #FooiGenMethodThreads or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
+</function>
+
+<function name="foo_igen_object_peek_oldie_interface">
+<description>
+Like foo_igen_object_get_oldie_interface() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
+Deprecated: The D-Bus interface has been deprecated.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the status was changed, %FALSE if the key was not set.
+<return> A #FooiGenOldieInterface or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
</return>
</function>
-<function name="g_file_info_set_attribute_string">
+<function name="foo_igen_object_peek_rocket123">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_rocket123() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
-<parameter name="attr_value">
-<parameter_description> a UTF-8 string.
+</parameters>
+<return> A #FooiGenRocket123 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
+</function>
+
+<function name="foo_igen_object_peek_test_ugly_case_interface">
+<description>
+Like foo_igen_object_get_test_ugly_case_interface() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #FooiGenTesTuglyCASEInterface or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
</function>
-<function name="g_file_info_set_attribute_stringv">
+<function name="foo_igen_object_peek_unknown_xml_tags">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Like foo_igen_object_get_unknown_xml_tags() but doesn't increase the reference count on the returned object.
+
+<warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning>
-Sinze: 2.22
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObject.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key
+</parameters>
+<return> A #FooiGenUnknownXmlTags or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object.
+</return>
+</function>
+
+<function name="foo_igen_object_proxy_new">
+<description>
+Creates a new proxy object.
+
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="attr_value">
-<parameter_description> a %NULL terminated array of UTF-8 strings.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The proxy object.
+</return>
</function>
-<function name="g_file_info_set_attribute_uint32">
+<function name="foo_igen_object_skeleton_new">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Creates a new skeleton object.
+
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="foo_igen_object_skeleton_set_authorize">
+<description>
+Sets the #FooiGenAuthorize instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Authorize.top_of_page">org.project.Authorize</link> on @object.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="attr_value">
-<parameter_description> an unsigned 32-bit integer.
+<parameter name="interface_">
+<parameter_description> A #FooiGenAuthorize or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_attribute_uint64">
+<function name="foo_igen_object_skeleton_set_bar">
<description>
-Sets the @attribute to contain the given @attr_value,
-if possible.
+Sets the #FooiGenBar instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar.top_of_page">org.project.Bar</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a file attribute key.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="attr_value">
-<parameter_description> an unsigned 64-bit integer.
+<parameter name="interface_">
+<parameter_description> A #FooiGenBar or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_content_type">
+<function name="foo_igen_object_skeleton_set_bar_frobnicator">
<description>
-Sets the content type attribute for a given #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
+Sets the #FooiGenBarFrobnicator instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bar-Frobnicator.top_of_page">org.project.Bar.Frobnicator</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="content_type">
-<parameter_description> a content type. See #GContentType.
+<parameter name="interface_">
+<parameter_description> A #FooiGenBarFrobnicator or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_display_name">
+<function name="foo_igen_object_skeleton_set_bat">
<description>
-Sets the display name for the current #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.
+Sets the #FooiGenBat instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Bat.top_of_page">org.project.Bat</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="display_name">
-<parameter_description> a string containing a display name.
+<parameter name="interface_">
+<parameter_description> A #FooiGenBat or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_edit_name">
+<function name="foo_igen_object_skeleton_set_baz">
<description>
-Sets the edit name for the current file.
-See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
+Sets the #FooiGenBaz instance for the D-Bus interface <link linkend="gdbus-interface-org-project-Baz.top_of_page">org.project.Baz</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="edit_name">
-<parameter_description> a string containing an edit name.
+<parameter name="interface_">
+<parameter_description> A #FooiGenBaz or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_file_type">
+<function name="foo_igen_object_skeleton_set_changing_interface_v1">
<description>
-Sets the file type in a #GFileInfo to @type.
-See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
+Sets the #FooiGenChangingInterfaceV1 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV1.top_of_page">ChangingInterfaceV1</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> a #GFileType.
+<parameter name="interface_">
+<parameter_description> A #FooiGenChangingInterfaceV1 or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_icon">
+<function name="foo_igen_object_skeleton_set_changing_interface_v10">
<description>
-Sets the icon for a given #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_ICON.
+Sets the #FooiGenChangingInterfaceV10 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> on @object.
+
+Since: 10.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="icon">
-<parameter_description> a #GIcon.
+<parameter name="interface_">
+<parameter_description> A #FooiGenChangingInterfaceV10 or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_is_hidden">
+<function name="foo_igen_object_skeleton_set_changing_interface_v2">
<description>
-Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink.
-See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
+Sets the #FooiGenChangingInterfaceV2 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> on @object.
+
+Since: 2.0
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="is_hidden">
-<parameter_description> a #gboolean.
+<parameter name="interface_">
+<parameter_description> A #FooiGenChangingInterfaceV2 or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_is_symlink">
+<function name="foo_igen_object_skeleton_set_com_acme_coyote">
<description>
-Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
-See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
+Sets the #FooiGenComAcmeCoyote instance for the D-Bus interface <link linkend="gdbus-interface-com-acme-Coyote.top_of_page">com.acme.Coyote</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="is_symlink">
-<parameter_description> a #gboolean.
+<parameter name="interface_">
+<parameter_description> A #FooiGenComAcmeCoyote or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_modification_time">
+<function name="foo_igen_object_skeleton_set_fdpassing">
<description>
-Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
-info to the given time value.
+Sets the #FooiGenFDPassing instance for the D-Bus interface <link linkend="gdbus-interface-FDPassing.top_of_page">FDPassing</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="mtime">
-<parameter_description> a #GTimeVal.
+<parameter name="interface_">
+<parameter_description> A #FooiGenFDPassing or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_name">
+<function name="foo_igen_object_skeleton_set_inline_docs">
<description>
-Sets the name attribute for the current #GFileInfo.
-See %G_FILE_ATTRIBUTE_STANDARD_NAME.
+Sets the #FooiGenInlineDocs instance for the D-Bus interface <link linkend="gdbus-interface-org-project-InlineDocs.top_of_page">org.project.InlineDocs</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> a string containing a name.
+<parameter name="interface_">
+<parameter_description> A #FooiGenInlineDocs or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_size">
+<function name="foo_igen_object_skeleton_set_method_threads">
<description>
-Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info
-to the given size.
+Sets the #FooiGenMethodThreads instance for the D-Bus interface <link linkend="gdbus-interface-org-project-MethodThreads.top_of_page">org.project.MethodThreads</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> a #goffset containing the file's size.
+<parameter name="interface_">
+<parameter_description> A #FooiGenMethodThreads or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_sort_order">
+<function name="foo_igen_object_skeleton_set_oldie_interface">
<description>
-Sets the sort order attribute in the file info structure. See
-%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+Sets the #FooiGenOldieInterface instance for the D-Bus interface <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link> on @object.
+
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="sort_order">
-<parameter_description> a sort order integer.
+<parameter name="interface_">
+<parameter_description> A #FooiGenOldieInterface or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_set_symlink_target">
+<function name="foo_igen_object_skeleton_set_rocket123">
<description>
-Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
-to the given symlink target.
+Sets the #FooiGenRocket123 instance for the D-Bus interface <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="symlink_target">
-<parameter_description> a static string containing a path to a symlink target.
+<parameter name="interface_">
+<parameter_description> A #FooiGenRocket123 or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_info_unset_attribute_mask">
+<function name="foo_igen_object_skeleton_set_test_ugly_case_interface">
<description>
-Unsets a mask set by g_file_info_set_attribute_mask(), if one
-is set.
+Sets the #FooiGenTesTuglyCASEInterface instance for the D-Bus interface <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link> on @object.
</description>
<parameters>
-<parameter name="info">
-<parameter_description> #GFileInfo.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
+</parameter_description>
+</parameter>
+<parameter name="interface_">
+<parameter_description> A #FooiGenTesTuglyCASEInterface or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_input_stream_query_info">
+<function name="foo_igen_object_skeleton_set_unknown_xml_tags">
<description>
-Queries a file input stream the given @attributes. This function blocks
-while querying the stream. For the asynchronous (non-blocking) version
-of this function, see g_file_input_stream_query_info_async(). While the
-stream is blocked, the stream will set the pending flag internally, and
-any other operations on the stream will fail with %G_IO_ERROR_PENDING.
-
+Sets the #FooiGenUnknownXmlTags instance for the D-Bus interface <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link> on @object.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="interface_">
+<parameter_description> A #FooiGenUnknownXmlTags or %NULL to clear the interface.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo, or %NULL on error.
-</return>
+<return></return>
</function>
-<function name="g_file_input_stream_query_info_async">
+<function name="foo_igen_oldie_interface_call_foo">
<description>
-Queries the stream information asynchronously.
-When the operation is finished @callback will be called.
-You can then call g_file_input_stream_query_info_finish()
-to get the result of the operation.
-
-For the synchronous version of this function,
-see g_file_input_stream_query_info().
+Asynchronously invokes the <link linkend="gdbus-method-OldieInterface.Foo">Foo()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_oldie_interface_call_foo_finish() to get the result of the operation.
-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 set
+See foo_igen_oldie_interface_call_foo_sync() for the synchronous, blocking version of this method.
+Deprecated: The D-Bus method has been deprecated.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="proxy">
+<parameter_description> A #FooiGenOldieInterfaceProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_input_stream_query_info_finish">
+<function name="foo_igen_oldie_interface_call_foo_finish">
<description>
-Finishes an asynchronous info query operation.
+Finishes an operation started with foo_igen_oldie_interface_call_foo().
+Deprecated: The D-Bus method has been deprecated.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileInputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenOldieInterfaceProxy.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_oldie_interface_call_foo().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring,
-or %NULL to ignore.
-</parameter_description>
-</parameter>
-</parameters>
-<return> #GFileInfo.
-</return>
-</function>
-
-<function name="g_file_io_stream_get_etag">
-<description>
-Gets the entity tag for the file when it has been written.
-This must be called after the stream has been written
-and closed, as the etag can change while writing.
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileIOStream.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the entity tag for the stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_io_stream_query_info">
+<function name="foo_igen_oldie_interface_call_foo_sync">
<description>
-Queries a file io stream for the given @attributes.
-This function blocks while querying the stream. For the asynchronous
-version of this function, see g_file_io_stream_query_info_async().
-While the stream is blocked, the stream will set the pending flag
-internally, and any other operations on the stream will fail with
-%G_IO_ERROR_PENDING.
-
-Can fail if the stream was already closed (with @error being set to
-%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
-set to %G_IO_ERROR_PENDING), or if querying info is not supported for
-the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
-all cases of failure, %NULL will be returned.
+Synchronously invokes the <link linkend="gdbus-method-OldieInterface.Foo">Foo()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-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 set, and %NULL will
-be returned.
+See foo_igen_oldie_interface_call_foo() for the asynchronous version of this method.
-Since: 2.22
+Deprecated: The D-Bus method has been deprecated.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileIOStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
+<parameter name="proxy">
+<parameter_description> A #FooiGenOldieInterfaceProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo for the @stream, or %NULL on error.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_io_stream_query_info_async">
+<function name="foo_igen_oldie_interface_complete_foo">
<description>
-Asynchronously queries the @stream for a #GFileInfo. When completed,
- callback will be called with a #GAsyncResult which can be used to
-finish the operation with g_file_io_stream_query_info_finish().
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-OldieInterface.Foo">Foo()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-For the synchronous version of this function, see
-g_file_io_stream_query_info().
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Deprecated: The D-Bus method has been deprecated.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileIOStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_io_stream_query_info_finish">
+<function name="foo_igen_oldie_interface_emit_bar">
<description>
-Finalizes the asynchronous query started
-by g_file_io_stream_query_info_async().
+Emits the <link linkend="gdbus-signal-OldieInterface.Bar">"Bar"</link> D-Bus signal.
-Since: 2.22
+Deprecated: The D-Bus signal has been deprecated.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileIOStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
</parameter_description>
</parameter>
</parameters>
-<return> A #GFileInfo for the finished query.
+<return></return>
+</function>
+
+<function name="foo_igen_oldie_interface_get_bat">
+<description>
+Gets the value of the <link linkend="gdbus-property-OldieInterface.Bat">"Bat"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+Deprecated: The D-Bus property has been deprecated.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value.
</return>
</function>
-<function name="g_file_is_native">
+<function name="foo_igen_oldie_interface_interface_info">
<description>
-Checks to see if a file is native to the platform.
+Gets a machine-readable description of the <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link> D-Bus interface.
-A native file s one expressed in the platform-native filename format,
-e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
-as it might be on a locally mounted remote filesystem.
+Deprecated: The D-Bus interface has been deprecated.
-On some systems non-native files may be available using
-the native filesystem via a userspace filesystem (FUSE), in
-these cases this call will return %FALSE, but g_file_get_path()
-will still return a native path.
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
-This call does no blocking i/o.
+</return>
+</function>
+
+<function name="foo_igen_oldie_interface_override_properties">
+<description>
+Overrides all #GObject properties in the #FooiGenOldieInterface interface for a concrete class.
+The properties are overridden in the order they are defined.
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if file is native.
+<return> The last property id.
+
</return>
</function>
-<function name="g_file_load_contents">
+<function name="foo_igen_oldie_interface_proxy_new">
<description>
-Loads the content of the file into memory. The data is always
-zero-terminated, but this is not included in the resultant @length.
-The returned @content should be freed with g_free() when no longer
-needed.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link>. See g_dbus_proxy_new() for more details.
-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.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_oldie_interface_proxy_new_finish() to get the result of the operation.
+
+See foo_igen_oldie_interface_proxy_new_sync() for the synchronous, blocking version of this constructor.
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="contents">
-<parameter_description> a location to place the contents of the file.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a location to place the length of the contents of the file,
-or %NULL if the length is not needed
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="etag_out">
-<parameter_description> a location to place the current entity tag for the file,
-or %NULL if the entity tag is not needed
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_oldie_interface_proxy_new_finish">
+<description>
+Finishes an operation started with foo_igen_oldie_interface_proxy_new().
+
+Deprecated: The D-Bus interface has been deprecated.
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_oldie_interface_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @file's contents were successfully loaded.
-%FALSE if there were errors.
+<return> The constructed proxy object or %NULL if @error is set.
+
</return>
</function>
-<function name="g_file_load_contents_async">
+<function name="foo_igen_oldie_interface_proxy_new_for_bus">
<description>
-Starts an asynchronous load of the @file's contents.
+Like foo_igen_oldie_interface_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-For more details, see g_file_load_contents() which is
-the synchronous version of this call.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_oldie_interface_proxy_new_for_bus_finish() to get the result of the operation.
-When the load operation has completed, @callback will be called
-with @user data. To finish the operation, call
-g_file_load_contents_finish() with the #GAsyncResult returned by
-the @callback.
+See foo_igen_oldie_interface_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
-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.
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_load_contents_finish">
+<function name="foo_igen_oldie_interface_proxy_new_for_bus_finish">
<description>
-Finishes an asynchronous load of the @file's contents.
-The contents are placed in @contents, and @length is set to the
-size of the @contents string. The @content should be freed with
-g_free() when no longer needed. If @etag_out is present, it will be
-set to the new entity tag for the @file.
+Finishes an operation started with foo_igen_oldie_interface_proxy_new_for_bus().
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> a location to place the contents of the file.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> a location to place the length of the contents of the file,
-or %NULL if the length is not needed
-</parameter_description>
-</parameter>
-<parameter name="etag_out">
-<parameter_description> a location to place the current entity tag for the file,
-or %NULL if the entity tag is not needed
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_oldie_interface_proxy_new_for_bus().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the load was successful. If %FALSE and @error is
-present, it will be set appropriately.
+<return> The constructed proxy object or %NULL if @error is set.
+
</return>
</function>
-<function name="g_file_load_partial_contents_async">
+<function name="foo_igen_oldie_interface_proxy_new_for_bus_sync">
<description>
-Reads the partial contents of a file. A #GFileReadMoreCallback should be
-used to stop reading from the file when appropriate, else this function
-will behave exactly as g_file_load_contents_async(). This operation
-can be finished by g_file_load_partial_contents_finish().
+Like foo_igen_oldie_interface_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-Users of this function should be aware that @user_data is passed to
-both the @read_more_callback and the @callback.
+The calling thread is blocked until a reply is received.
-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.
+See foo_igen_oldie_interface_proxy_new_for_bus() for the asynchronous version of this constructor.
+
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="read_more_callback">
-<parameter_description> a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to the callback functions.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+
+</return>
</function>
-<function name="g_file_load_partial_contents_finish">
+<function name="foo_igen_oldie_interface_proxy_new_sync">
<description>
-Finishes an asynchronous partial load operation that was started
-with g_file_load_partial_contents_async(). The data is always
-zero-terminated, but this is not included in the resultant @length.
-The returned @content should be freed with g_free() when no longer
-needed.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link>. See g_dbus_proxy_new_sync() for more details.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_oldie_interface_proxy_new() for the asynchronous version of this constructor.
+
+Deprecated: The D-Bus interface has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="contents">
-<parameter_description> a location to place the contents of the file.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> a location to place the length of the contents of the file,
-or %NULL if the length is not needed
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="etag_out">
-<parameter_description> a location to place the current entity tag for the file,
-or %NULL if the entity tag is not needed
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the load was successful. If %FALSE and @error is
-present, it will be set appropriately.
+<return> The constructed proxy object or %NULL if @error is set.
+
</return>
</function>
-<function name="g_file_make_directory">
+<function name="foo_igen_oldie_interface_set_bat">
<description>
-Creates a directory. Note that this will only create a child directory of
-the immediate parent directory of the path or URI given by the #GFile. To
-recursively create directories, see g_file_make_directory_with_parents().
-This function will fail if the parent directory does not exist, setting
- error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support creating
-directories, this function will fail, setting @error to
-%G_IO_ERROR_NOT_SUPPORTED.
-
-For a local #GFile the newly created directory will have the default
-(current) ownership and permissions of the current process.
+Sets the <link linkend="gdbus-property-OldieInterface.Bat">"Bat"</link> D-Bus property to @value.
-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.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+Deprecated: The D-Bus property has been deprecated.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenOldieInterface.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful creation, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_make_directory_with_parents">
+<function name="foo_igen_oldie_interface_skeleton_new">
<description>
-Creates a directory and any parent directories that may not exist similar to
-'mkdir -p'. If the file system does not support creating directories, this
-function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-OldieInterface.top_of_page">OldieInterface</link>.
-For a local #GFile the newly created directories will have the default
-(current) ownership and permissions of the current process.
+Deprecated: The D-Bus interface has been deprecated.
-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.
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
-Since: 2.18
+</return>
+</function>
+
+<function name="foo_igen_rocket123_call_ignite_xyz">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-com-acme-Rocket.Ignite">Ignite()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_rocket123_call_ignite_xyz_finish() to get the result of the operation.
+
+See foo_igen_rocket123_call_ignite_xyz_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenRocket123Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if all directories have been successfully created, %FALSE
-otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_file_make_symbolic_link">
+<function name="foo_igen_rocket123_call_ignite_xyz_finish">
<description>
-Creates a symbolic link named @file which contains the string
- symlink_value
-
-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.
+Finishes an operation started with foo_igen_rocket123_call_ignite_xyz().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile with the name of the symlink to create
-</parameter_description>
-</parameter>
-<parameter name="symlink_value">
-<parameter_description> a string with the path for the target of the new symlink
+<parameter name="proxy">
+<parameter_description> A #FooiGenRocket123Proxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_rocket123_call_ignite_xyz().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on the creation of a new symlink, %FALSE otherwise.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_monitor">
+<function name="foo_igen_rocket123_call_ignite_xyz_sync">
<description>
-Obtains a file or directory monitor for the given file, depending
-on the type of the file.
+Synchronously invokes the <link linkend="gdbus-method-com-acme-Rocket.Ignite">Ignite()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-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.
+See foo_igen_rocket123_call_ignite_xyz() for the asynchronous version of this method.
-Since: 2.18
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileMonitorFlags
+<parameter name="proxy">
+<parameter_description> A #FooiGenRocket123Proxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_monitor_cancel">
+<function name="foo_igen_rocket123_complete_ignite_xyz">
<description>
-Cancels a file monitor.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-com-acme-Rocket.Ignite">Ignite()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if monitor was cancelled.
-</return>
+<return></return>
</function>
-<function name="g_file_monitor_directory">
+<function name="foo_igen_rocket123_dup_direction">
<description>
-Obtains a directory monitor for the given file.
-This may fail if directory monitoring is not supported.
+Gets a copy of the <link linkend="gdbus-property-com-acme-Rocket.Direction">"Direction"</link> D-Bus property.
-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.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-Virtual: monitor_dir
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileMonitorFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_variant_unref().
</return>
</function>
-<function name="g_file_monitor_emit_event">
+<function name="foo_igen_rocket123_dup_type_">
<description>
-Emits the #GFileMonitor::changed signal if a change
-has taken place. Should be called from file monitor
-implementations only.
+Gets a copy of the <link linkend="gdbus-property-com-acme-Rocket.Type">"Type"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
-The signal will be emitted from an idle handler (in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-context</link>).
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor.
-</parameter_description>
-</parameter>
-<parameter name="child">
-<parameter_description> a #GFile.
-</parameter_description>
-</parameter>
-<parameter name="other_file">
-<parameter_description> a #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
-<parameter name="event_type">
-<parameter_description> a set of #GFileMonitorEvent flags.
+</parameters>
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
+</return>
+</function>
+
+<function name="foo_igen_rocket123_emit_exploded_xyz">
+<description>
+Emits the <link linkend="gdbus-signal-com-acme-Rocket.Exploded">"Exploded"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_monitor_file">
+<function name="foo_igen_rocket123_get_direction">
<description>
-Obtains a file monitor for the given file. If no file notification
-mechanism exists, then regular polling of the file is used.
+Gets the value of the <link linkend="gdbus-property-com-acme-Rocket.Direction">"Direction"</link> D-Bus property.
-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.
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_rocket123_dup_direction() if on another thread.</warning>
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileMonitorFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL.
+</parameters>
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
+</return>
+</function>
+
+<function name="foo_igen_rocket123_get_speed_xyz">
+<description>
+Gets the value of the <link linkend="gdbus-property-com-acme-Rocket.Speed">"Speed"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileMonitor for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The property value.
</return>
</function>
-<function name="g_file_monitor_is_cancelled">
+<function name="foo_igen_rocket123_get_type_">
<description>
-Returns whether the monitor is canceled.
+Gets the value of the <link linkend="gdbus-property-com-acme-Rocket.Type">"Type"</link> D-Bus property.
+
+Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_rocket123_dup_type_() if on another thread.</warning>
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if monitor is canceled. %FALSE otherwise.
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_file_monitor_set_rate_limit">
+<function name="foo_igen_rocket123_interface_info">
<description>
-Sets the rate limit to which the @monitor will report
-consecutive change events to the same file.
+Gets a machine-readable description of the <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link> D-Bus interface.
+
</description>
<parameters>
-<parameter name="monitor">
-<parameter_description> a #GFileMonitor.
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="foo_igen_rocket123_override_properties">
+<description>
+Overrides all #GObject properties in the #FooiGenRocket123 interface for a concrete class.
+The properties are overridden in the order they are defined.
+
+
+</description>
+<parameters>
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="limit_msecs">
-<parameter_description> a non-negative integer with the limit in milliseconds
-to poll for changes
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The last property id.
+</return>
</function>
-<function name="g_file_mount_enclosing_volume">
+<function name="foo_igen_rocket123_proxy_new">
<description>
-Starts a @mount_operation, mounting the volume that contains the file @location.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link>. See g_dbus_proxy_new() for more details.
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_mount_enclosing_volume_finish().
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_rocket123_proxy_new_finish() to get the result of the operation.
-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.
+See foo_igen_rocket123_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="location">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_mount_enclosing_volume_finish">
+<function name="foo_igen_rocket123_proxy_new_finish">
<description>
-Finishes a mount operation started by g_file_mount_enclosing_volume().
+Finishes an operation started with foo_igen_rocket123_proxy_new().
</description>
<parameters>
-<parameter name="location">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_rocket123_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error
-has occurred, this function will return %FALSE and set @error
-appropriately if present.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_mount_mountable">
+<function name="foo_igen_rocket123_proxy_new_for_bus">
<description>
-Mounts a file of type G_FILE_TYPE_MOUNTABLE.
-Using @mount_operation, you can request callbacks when, for instance,
-passwords are needed during authentication.
+Like foo_igen_rocket123_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-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.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_rocket123_proxy_new_for_bus_finish() to get the result of the operation.
-When the operation is finished, @callback will be called. You can then call
-g_file_mount_mountable_finish() to get the result of the operation.
+See foo_igen_rocket123_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_mount_mountable_finish">
+<function name="foo_igen_rocket123_proxy_new_for_bus_finish">
<description>
-Finishes a mount operation. See g_file_mount_mountable() for details.
-
-Finish an asynchronous mount operation that was started
-with g_file_mount_mountable().
+Finishes an operation started with foo_igen_rocket123_proxy_new_for_bus().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_rocket123_proxy_new_for_bus().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_move">
+<function name="foo_igen_rocket123_proxy_new_for_bus_sync">
<description>
-Tries to move the file or directory @source to the location specified by @destination.
-If native move operations are supported then this is used, otherwise a copy + delete
-fallback is used. The native implementation may support moving directories (for instance
-on moves inside the same filesystem), but the fallback code does not.
-
-If the flag #G_FILE_COPY_OVERWRITE is specified an already
-existing @destination file is overwritten.
-
-If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
-will be copied as symlinks, otherwise the target of the
- source symlink will be copied.
-
-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 @progress_callback is not %NULL, then the operation can be monitored by
-setting this to a #GFileProgressCallback function. @progress_callback_data
-will be passed to this function. It is guaranteed that this callback will
-be called after all data has been transferred with the total number of bytes
-copied during the operation.
-
-If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
-error is returned, independent on the status of the @destination.
+Like foo_igen_rocket123_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
-error G_IO_ERROR_EXISTS is returned.
-
-If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
-error is returned. If trying to overwrite a directory with a directory the
-G_IO_ERROR_WOULD_MERGE error is returned.
+The calling thread is blocked until a reply is received.
-If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
-specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
-may be returned (if the native move operation isn't available).
+See foo_igen_rocket123_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="source">
-<parameter_description> #GFile pointing to the source location.
-</parameter_description>
-</parameter>
-<parameter name="destination">
-<parameter_description> #GFile pointing to the destination location.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> set of #GFileCopyFlags.
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="progress_callback">
-<parameter_description> #GFileProgressCallback function for updates.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="progress_callback_data">
-<parameter_description> gpointer to user data for the callback function.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for returning error conditions, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on successful move, %FALSE otherwise.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_new_for_commandline_arg">
+<function name="foo_igen_rocket123_proxy_new_sync">
<description>
-Creates a #GFile with the given argument from the command line. The value of
- arg can be either a URI, an absolute path or a relative path resolved
-relative to the current working directory.
-This operation never fails, but the returned object might not support any
-I/O operation if @arg points to a malformed path.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See foo_igen_rocket123_proxy_new() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="arg">
-<parameter_description> a command line string.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_new_for_path">
+<function name="foo_igen_rocket123_set_direction">
<description>
-Constructs a #GFile for a given path. This operation never
-fails, but the returned object might not support any I/O
-operation if @path is malformed.
+Sets the <link linkend="gdbus-property-com-acme-Rocket.Direction">"Direction"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="path">
-<parameter_description> a string containing a relative or absolute path. The string
-must be encoded in the glib filename encoding.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile for the given @path.
-</return>
+<return></return>
</function>
-<function name="g_file_new_for_uri">
+<function name="foo_igen_rocket123_set_speed_xyz">
<description>
-Constructs a #GFile for a given URI. This operation never
-fails, but the returned object might not support any I/O
-operation if @uri is malformed or if the uri type is
-not supported.
+Sets the <link linkend="gdbus-property-com-acme-Rocket.Speed">"Speed"</link> D-Bus property to @value.
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="uri">
-<parameter_description> a UTF8 string containing a URI.
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile for the given @uri.
-</return>
+<return></return>
</function>
-<function name="g_file_open_readwrite">
+<function name="foo_igen_rocket123_set_type_">
<description>
-Opens an existing file for reading and writing. The result is
-a #GFileIOStream that can be used to read and write the contents of the file.
-
-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 the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
-If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
-Other errors are possible too, and depend on what kind of filesystem the file is on.
-Note that in many non-local file cases read and write streams are not supported,
-so make sure you really need to do read and write streaming, rather than
-just opening for reading or writing.
+Sets the <link linkend="gdbus-property-com-acme-Rocket.Type">"Type"</link> D-Bus property to @value.
-Since: 2.22
+Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> #GFile to open
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable
+<parameter name="object">
+<parameter_description> A #FooiGenRocket123.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileIOStream or %NULL on error.
-Free the returned object with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_file_open_readwrite_async">
+<function name="foo_igen_rocket123_skeleton_new">
<description>
-Asynchronously opens @file for reading and writing.
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-com-acme-Rocket.top_of_page">com.acme.Rocket</link>.
-For more details, see g_file_open_readwrite() which is
-the synchronous version of this call.
-When the operation is finished, @callback will be called. You can then call
-g_file_open_readwrite_finish() to get the result of the operation.
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
-Since: 2.22
+<function name="foo_igen_test_ugly_case_interface_call_get_iscsi_servers">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-TestUglyCaseInterface.GetiSCSIServers">GetiSCSIServers()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_test_ugly_case_interface_call_get_iscsi_servers_finish() to get the result of the operation.
+
+See foo_igen_test_ugly_case_interface_call_get_iscsi_servers_sync() for the synchronous, blocking version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="proxy">
+<parameter_description> A #FooiGenTesTuglyCASEInterfaceProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_open_readwrite_finish">
+<function name="foo_igen_test_ugly_case_interface_call_get_iscsi_servers_finish">
<description>
-Finishes an asynchronous file read operation started with
-g_file_open_readwrite_async().
+Finishes an operation started with foo_igen_test_ugly_case_interface_call_get_iscsi_servers().
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenTesTuglyCASEInterfaceProxy.
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_test_ugly_case_interface_call_get_iscsi_servers().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream or %NULL on error.
-Free the returned object with g_object_unref().
-
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_output_stream_get_etag">
+<function name="foo_igen_test_ugly_case_interface_call_get_iscsi_servers_sync">
<description>
-Gets the entity tag for the file when it has been written.
-This must be called after the stream has been written
-and closed, as the etag can change while writing.
+Synchronously invokes the <link linkend="gdbus-method-TestUglyCaseInterface.GetiSCSIServers">GetiSCSIServers()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See foo_igen_test_ugly_case_interface_call_get_iscsi_servers() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
+<parameter name="proxy">
+<parameter_description> A #FooiGenTesTuglyCASEInterfaceProxy.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the entity tag for the stream.
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_output_stream_query_info">
+<function name="foo_igen_test_ugly_case_interface_complete_get_iscsi_servers">
<description>
-Queries a file output stream for the given @attributes.
-This function blocks while querying the stream. For the asynchronous
-version of this function, see g_file_output_stream_query_info_async().
-While the stream is blocked, the stream will set the pending flag
-internally, and any other operations on the stream will fail with
-%G_IO_ERROR_PENDING.
-
-Can fail if the stream was already closed (with @error being set to
-%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
-set to %G_IO_ERROR_PENDING), or if querying info is not supported for
-the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
-all cases of failure, %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
-was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
-be returned.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-TestUglyCaseInterface.GetiSCSIServers">GetiSCSIServers()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_test_ugly_case_interface_emit_servers_updated_now">
+<description>
+Emits the <link linkend="gdbus-signal-TestUglyCaseInterface.serversUPDATEDNOW">"serversUPDATEDNOW"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo for the @stream, or %NULL on error.
-</return>
+<return></return>
</function>
-<function name="g_file_output_stream_query_info_async">
+<function name="foo_igen_test_ugly_case_interface_get_ugly_name">
<description>
-Asynchronously queries the @stream for a #GFileInfo. When completed,
- callback will be called with a #GAsyncResult which can be used to
-finish the operation with g_file_output_stream_query_info_finish().
+Gets the value of the <link linkend="gdbus-property-TestUglyCaseInterface.UGLYNAME">"UGLYNAME"</link> D-Bus property.
-For the synchronous version of this function, see
-g_file_output_stream_query_info().
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> a file attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The property value.
+</return>
</function>
-<function name="g_file_output_stream_query_info_finish">
+<function name="foo_igen_test_ugly_case_interface_interface_info">
<description>
-Finalizes the asynchronous query started
-by g_file_output_stream_query_info_async().
+Gets a machine-readable description of the <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link> D-Bus interface.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFileOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, %NULL to ignore.
-</parameter_description>
-</parameter>
</parameters>
-<return> A #GFileInfo for the finished query.
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_file_parse_name">
+<function name="foo_igen_test_ugly_case_interface_override_properties">
<description>
-Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()).
-This operation never fails, but the returned object might not support any I/O
-operation if the @parse_name cannot be parsed.
+Overrides all #GObject properties in the #FooiGenTesTuglyCASEInterface interface for a concrete class.
+The properties are overridden in the order they are defined.
</description>
<parameters>
-<parameter name="parse_name">
-<parameter_description> a file name or path to be parsed.
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
+</parameter_description>
+</parameter>
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile.
+<return> The last property id.
</return>
</function>
-<function name="g_file_poll_mountable">
+<function name="foo_igen_test_ugly_case_interface_proxy_new">
<description>
-Polls a file of type G_FILE_TYPE_MOUNTABLE.
-
-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.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link>. See g_dbus_proxy_new() for more details.
-When the operation is finished, @callback will be called. You can then call
-g_file_mount_mountable_finish() to get the result of the operation.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_test_ugly_case_interface_proxy_new_finish() to get the result of the operation.
-Since: 2.22
+See foo_igen_test_ugly_case_interface_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_poll_mountable_finish">
+<function name="foo_igen_test_ugly_case_interface_proxy_new_finish">
<description>
-Finishes a poll operation. See g_file_poll_mountable() for details.
-
-Finish an asynchronous poll operation that was polled
-with g_file_poll_mountable().
+Finishes an operation started with foo_igen_test_ugly_case_interface_proxy_new().
-Since: 2.22
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_test_ugly_case_interface_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_query_default_handler">
+<function name="foo_igen_test_ugly_case_interface_proxy_new_for_bus">
<description>
-Returns the #GAppInfo that is registered as the default
-application to handle the file specified by @file.
+Like foo_igen_test_ugly_case_interface_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-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.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_test_ugly_case_interface_proxy_new_for_bus_finish() to get the result of the operation.
+See foo_igen_test_ugly_case_interface_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile to open.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #GAppInfo if the handle was found, %NULL if there were errors.
-When you are done with it, release it with g_object_unref()
-</return>
+<return></return>
</function>
-<function name="g_file_query_exists">
+<function name="foo_igen_test_ugly_case_interface_proxy_new_for_bus_finish">
<description>
-Utility function to check if a particular file exists. This is
-implemented using g_file_query_info() and as such does blocking I/O.
-
-Note that in many cases it is racy to first check for file existence
-and then execute something based on the outcome of that, because the
-file might have been created or removed in between the operations. The
-general approach to handling that is to not check, but just do the
-operation and handle the errors as they come.
-
-As an example of race-free checking, take the case of reading a file, and
-if it doesn't exist, creating it. There are two racy versions: read it, and
-on error create it; and: check if it exists, if not create it. These
-can both result in two processes creating the file (with perhaps a partially
-written file as the result). The correct approach is to always try to create
-the file with g_file_create() which will either atomically create the file
-or fail with a G_IO_ERROR_EXISTS error.
-
-However, in many cases an existence check is useful in a user
-interface, for instance to make a menu item sensitive/insensitive, so that
-you don't have to fool users that something is possible and then just show
-and error dialog. If you do this, you should make sure to also handle the
-errors that can happen due to races when you execute the operation.
+Finishes an operation started with foo_igen_test_ugly_case_interface_proxy_new_for_bus().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_test_ugly_case_interface_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled).
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_query_file_type">
+<function name="foo_igen_test_ugly_case_interface_proxy_new_for_bus_sync">
<description>
-Utility function to inspect the #GFileType of a file. This is
-implemented using g_file_query_info() and as such does blocking I/O.
+Like foo_igen_test_ugly_case_interface_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-The primary use case of this method is to check if a file is a regular file,
-directory, or symlink.
+The calling thread is blocked until a reply is received.
+
+See foo_igen_test_ugly_case_interface_proxy_new_for_bus() for the asynchronous version of this constructor.
-Since: 2.18
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags passed to g_file_query_info().
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file
-does not exist
-
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_query_filesystem_info">
+<function name="foo_igen_test_ugly_case_interface_proxy_new_sync">
<description>
-Similar to g_file_query_info(), but obtains information
-about the filesystem the @file is on, rather than the file itself.
-For instance the amount of space available and the type of
-the filesystem.
-
-The @attributes value is a string that specifies the file attributes that
-should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attributes should
-be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
-means all attributes, and a wildcard like "fs:*" means all attributes in the fs
-namespace. The standard namespace for filesystem attributes is "fs".
-Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
-(the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of
-bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link>. See g_dbus_proxy_new_sync() for more details.
-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.
+The calling thread is blocked until a reply is received.
-If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
-Other errors are possible too, and depend on what kind of filesystem the file is on.
+See foo_igen_test_ugly_case_interface_proxy_new() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo or %NULL if there was an error.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_query_filesystem_info_async">
+<function name="foo_igen_test_ugly_case_interface_set_ugly_name">
<description>
-Asynchronously gets the requested information about the filesystem
-that the specified @file is on. The result is a #GFileInfo object
-that contains key-value attributes (such as type or size for the
-file).
+Sets the <link linkend="gdbus-property-TestUglyCaseInterface.UGLYNAME">"UGLYNAME"</link> D-Bus property to @value.
-For more details, see g_file_query_filesystem_info() which is the
-synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can
-then call g_file_query_info_finish() to get the result of the
-operation.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="object">
+<parameter_description> A #FooiGenTesTuglyCASEInterface.
</parameter_description>
</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+</parameters>
+<return></return>
+</function>
+
+<function name="foo_igen_test_ugly_case_interface_skeleton_new">
+<description>
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-TestUglyCaseInterface.top_of_page">TestUglyCaseInterface</link>.
+
+
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="foo_igen_unknown_xml_tags_call_can_set_timezone">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-UnknownXmlTags.CanSetTimezone">CanSetTimezone()</link> D-Bus method on @proxy.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_unknown_xml_tags_call_can_set_timezone_finish() to get the result of the operation.
+
+See foo_igen_unknown_xml_tags_call_can_set_timezone_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #FooiGenUnknownXmlTagsProxy.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_query_filesystem_info_finish">
+<function name="foo_igen_unknown_xml_tags_call_can_set_timezone_finish">
<description>
-Finishes an asynchronous filesystem info query. See
-g_file_query_filesystem_info_async().
+Finishes an operation started with foo_igen_unknown_xml_tags_call_can_set_timezone().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="proxy">
+<parameter_description> A #FooiGenUnknownXmlTagsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_value">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_unknown_xml_tags_call_can_set_timezone().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInfo for given @file or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_query_info">
+<function name="foo_igen_unknown_xml_tags_call_can_set_timezone_sync">
<description>
-Gets the requested information about specified @file. The result
-is a #GFileInfo object that contains key-value attributes (such as
-the type or size of the file).
-
-The @attributes value is a string that specifies the file attributes that
-should be gathered. It is not an error if it's not possible to read a particular
-requested attribute from a file - it just won't be set. @attributes should
-be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
-means all attributes, and a wildcard like "standard::*" means all attributes in the standard
-namespace. An example attribute query be "standard::*,owner::user".
-The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
-
-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.
-
-For symlinks, normally the information about the target of the
-symlink is returned, rather than information about the symlink itself.
-However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the
-information about the symlink itself will be returned. Also, for symlinks
-that point to non-existing files the information about the symlink itself
-will be returned.
+Synchronously invokes the <link linkend="gdbus-method-UnknownXmlTags.CanSetTimezone">CanSetTimezone()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
-If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
-Other errors are possible too, and depend on what kind of filesystem the file is on.
+See foo_igen_unknown_xml_tags_call_can_set_timezone() for the asynchronous version of this method.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
+<parameter name="proxy">
+<parameter_description> A #FooiGenUnknownXmlTagsProxy.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
+<parameter name="out_value">
+<parameter_description> Return location for return parameter or %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInfo for the given @file, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> %TRUE if the call succeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_file_query_info_async">
+<function name="foo_igen_unknown_xml_tags_complete_can_set_timezone">
<description>
-Asynchronously gets the requested information about specified @file. The result
-is a #GFileInfo object that contains key-value attributes (such as type or size
-for the file).
-
-For more details, see g_file_query_info() which is
-the synchronous version of this call.
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-UnknownXmlTags.CanSetTimezone">CanSetTimezone()</link> D-Bus method. If you instead want to finish handling an invocation by returning an error, use g_dbus_method_invocation_return_error() or similar.
-When the operation is finished, @callback will be called. You can then call
-g_file_query_info_finish() to get the result of the operation.
+This method will free @invocation, you cannot use it afterwards.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attributes">
-<parameter_description> an attribute query string.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="value">
+<parameter_description> Parameter to return.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_query_info_finish">
+<function name="foo_igen_unknown_xml_tags_dup_some_property">
<description>
-Finishes an asynchronous file info query.
-See g_file_query_info_async().
+Gets a copy of the <link linkend="gdbus-property-UnknownXmlTags.SomeProperty">"SomeProperty"</link> D-Bus property.
+
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInfo for given @file or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free().
</return>
</function>
-<function name="g_file_query_settable_attributes">
+<function name="foo_igen_unknown_xml_tags_emit_some_signal">
<description>
-Obtain the list of settable attributes for the file.
-
+Emits the <link linkend="gdbus-signal-UnknownXmlTags.SomeSignal">"SomeSignal"</link> D-Bus signal.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeInfoList describing the settable attributes.
-When you are done with it, release it with g_file_attribute_info_list_unref()
-</return>
+<return></return>
</function>
-<function name="g_file_query_writable_namespaces">
+<function name="foo_igen_unknown_xml_tags_get_some_property">
<description>
-Obtain the list of attribute namespaces where new attributes
-can be created by a user. An example of this is extended
-attributes (in the "xattr" namespace).
+Gets the value of the <link linkend="gdbus-property-UnknownXmlTags.SomeProperty">"SomeProperty"</link> D-Bus property.
-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.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
+
+<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use foo_igen_unknown_xml_tags_dup_some_property() if on another thread.</warning>
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileAttributeInfoList describing the writable namespaces.
-When you are done with it, release it with g_file_attribute_info_list_unref()
+<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object.
</return>
</function>
-<function name="g_file_read">
+<function name="foo_igen_unknown_xml_tags_interface_info">
<description>
-Opens a file for reading. The result is a #GFileInputStream that
-can be used to read the contents of the file.
+Gets a machine-readable description of the <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link> D-Bus interface.
-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 the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
-If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
-Other errors are possible too, and depend on what kind of filesystem the file is on.
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="foo_igen_unknown_xml_tags_override_properties">
+<description>
+Overrides all #GObject properties in the #FooiGenUnknownXmlTags interface for a concrete class.
+The properties are overridden in the order they are defined.
-Virtual: read_fn
</description>
<parameters>
-<parameter name="file">
-<parameter_description> #GFile to read.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable
+<parameter name="klass">
+<parameter_description> The class structure for a #GObject<!-- -->-derived class.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="property_id_begin">
+<parameter_description> The property id to assign to the first overridden property.
</parameter_description>
</parameter>
</parameters>
-<return> #GFileInputStream or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The last property id.
</return>
</function>
-<function name="g_file_read_async">
+<function name="foo_igen_unknown_xml_tags_proxy_new">
<description>
-Asynchronously opens @file for reading.
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link>. See g_dbus_proxy_new() for more details.
-For more details, see g_file_read() which is
-the synchronous version of this call.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_unknown_xml_tags_proxy_new_finish() to get the result of the operation.
-When the operation is finished, @callback will be called. You can then call
-g_file_read_finish() to get the result of the operation.
+See foo_igen_unknown_xml_tags_proxy_new_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_read_finish">
+<function name="foo_igen_unknown_xml_tags_proxy_new_finish">
<description>
-Finishes an asynchronous file read operation started with
-g_file_read_async().
+Finishes an operation started with foo_igen_unknown_xml_tags_proxy_new().
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_unknown_xml_tags_proxy_new().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileInputStream or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_replace">
+<function name="foo_igen_unknown_xml_tags_proxy_new_for_bus">
<description>
-Returns an output stream for overwriting the file, possibly
-creating a backup copy of the file first. If the file doesn't exist,
-it will be created.
-
-This will try to replace the file in the safest way possible so
-that any errors during the writing will not affect an already
-existing copy of the file. For instance, for local files it
-may write to a temporary file and then atomically rename over
-the destination when the stream is closed.
-
-By default files created are generally readable by everyone,
-but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
-will be made readable only to the current user, to the level that
-is supported on the target filesystem.
-
-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 you pass in a non-#NULL @etag value, then this value is
-compared to the current entity tag of the file, and if they differ
-an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
-that the file has been changed since you last read it. You can get
-the new etag from g_file_output_stream_get_etag() after you've
-finished writing and closed the #GFileOutputStream. When you load
-a new file you can use g_file_input_stream_query_info() to get
-the etag of the file.
-
-If @make_backup is %TRUE, this function will attempt to make a backup
-of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
-error will be returned. If you want to replace anyway, try again with
- make_backup set to %FALSE.
+Like foo_igen_unknown_xml_tags_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
-and if the file is some other form of non-regular file then a
-G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
-Some file systems don't allow all file names, and may
-return an G_IO_ERROR_INVALID_FILENAME error, and if the name
-is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
-Other errors are possible too, and depend on what kind of
-filesystem the file is on.
+When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
+You can then call foo_igen_unknown_xml_tags_proxy_new_for_bus_finish() to get the result of the operation.
+See foo_igen_unknown_xml_tags_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="etag">
-<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
-current #GFile, or #NULL to ignore.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileOutputStream or %NULL on error.
-Free the returned object with g_object_unref().
-</return>
+<return></return>
</function>
-<function name="g_file_replace_async">
+<function name="foo_igen_unknown_xml_tags_proxy_new_for_bus_finish">
<description>
-Asynchronously overwrites the file, replacing the contents, possibly
-creating a backup copy of the file first.
+Finishes an operation started with foo_igen_unknown_xml_tags_proxy_new_for_bus().
-For more details, see g_file_replace() which is
-the synchronous version of this call.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_replace_finish() to get the result of the operation.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="etag">
-<parameter_description> an <link linkend="gfile-etag">entity tag</link> for the
-current #GFile, or NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to foo_igen_unknown_xml_tags_proxy_new_for_bus().
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_file_replace_contents">
+<function name="foo_igen_unknown_xml_tags_proxy_new_for_bus_sync">
<description>
-Replaces the contents of @file with @contents of @length bytes.
-
-If @etag is specified (not %NULL) any existing file must have that etag, or
-the error %G_IO_ERROR_WRONG_ETAG will be returned.
+Like foo_igen_unknown_xml_tags_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
-If @make_backup is %TRUE, this function will attempt to make a backup of @file.
-
-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.
+The calling thread is blocked until a reply is received.
-The returned @new_etag can be used to verify that the file hasn't changed the
-next time it is saved over.
+See foo_igen_unknown_xml_tags_proxy_new_for_bus() for the asynchronous version of this constructor.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> a string containing the new contents for @file.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of @contents in bytes.
-</parameter_description>
-</parameter>
-<parameter name="etag">
-<parameter_description> the old <link linkend="gfile-etag">entity tag</link>
-for the document, or %NULL
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="new_etag">
-<parameter_description> a location to a new <link linkend="gfile-etag">entity tag</link>
-for the document. This should be freed with g_free() when no longer
-needed, or %NULL
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error
-has occurred, this function will return %FALSE and set @error
-appropriately if present.
+<return> The constructed proxy object or %NULL if @error is set.
</return>
</function>
-<function name="g_file_replace_contents_async">
+<function name="foo_igen_unknown_xml_tags_proxy_new_sync">
<description>
-Starts an asynchronous replacement of @file with the given
- contents of @length bytes. @etag will replace the document's
-current entity tag.
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link>. See g_dbus_proxy_new_sync() for more details.
-When this operation has completed, @callback will be called with
- user_user data, and the operation can be finalized with
-g_file_replace_contents_finish().
+The calling thread is blocked until a reply is received.
-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.
+See foo_igen_unknown_xml_tags_proxy_new() for the asynchronous version of this constructor.
-If @make_backup is %TRUE, this function will attempt to
-make a backup of @file.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> string of contents to replace the file with.
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> the length of @contents in bytes.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="etag">
-<parameter_description> a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusProxyFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="error">
+<parameter_description> Return location for error or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The constructed proxy object or %NULL if @error is set.
+</return>
</function>
-<function name="g_file_replace_contents_finish">
+<function name="foo_igen_unknown_xml_tags_set_some_property">
<description>
-Finishes an asynchronous replace of the given @file. See
-g_file_replace_contents_async(). Sets @new_etag to the new entity
-tag for the document, if present.
+Sets the <link linkend="gdbus-property-UnknownXmlTags.SomeProperty">"SomeProperty"</link> D-Bus property to @value.
+Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="new_etag">
-<parameter_description> a location of a new <link linkend="gfile-etag">entity tag</link>
-for the document. This should be freed with g_free() when it is no
-longer needed, or %NULL
+<parameter name="object">
+<parameter_description> A #FooiGenUnknownXmlTags.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure.
-</return>
+<return></return>
</function>
-<function name="g_file_replace_finish">
+<function name="foo_igen_unknown_xml_tags_skeleton_new">
<description>
-Finishes an asynchronous file replace operation started with
-g_file_replace_async().
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-UnknownXmlTags.top_of_page">UnknownXmlTags</link>.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GFileOutputStream, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> The skeleton object.
</return>
</function>
-<function name="g_file_replace_readwrite">
+<function name="g_action_activate">
<description>
-Returns an output stream for overwriting the file in readwrite mode,
-possibly creating a backup copy of the file first. If the file doesn't
-exist, it will be created.
+Activates the action.
-For details about the behaviour, see g_file_replace() which does the same
-thing but returns an output stream only.
+ parameter must be the correct type of parameter for the action (ie:
+the parameter type given at construction time). If the parameter
+type was %NULL then @parameter must also be %NULL.
-Note that in many non-local file cases read and write streams are not
-supported, so make sure you really need to do read and write streaming,
-rather than just opening for reading or writing.
-
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile
-</parameter_description>
-</parameter>
-<parameter name="etag">
-<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
-current #GFile, or #NULL to ignore
-</parameter_description>
-</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="parameter">
+<parameter_description> the parameter to the activation
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream or %NULL on error.
-Free the returned object with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_file_replace_readwrite_async">
+<function name="g_action_change_state">
<description>
-Asynchronously overwrites the file in read-write mode, replacing the
-contents, possibly creating a backup copy of the file first.
+Request for the state of @action to be changed to @value.
-For more details, see g_file_replace_readwrite() which is
-the synchronous version of this call.
+The action must be stateful and @value must be of the correct type.
+See g_action_get_state_type().
-When the operation is finished, @callback will be called. You can then
-call g_file_replace_readwrite_finish() to get the result of the operation.
+This call merely requests a change. The action may refuse to change
+its state or may change its state to something other than @value.
+See g_action_get_state_hint().
-Since: 2.22
+If the @value GVariant is floating, it is consumed.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="etag">
-<parameter_description> an <link linkend="gfile-etag">entity tag</link> for the
-current #GFile, or NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="make_backup">
-<parameter_description> %TRUE if a backup should be created.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileCreateFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="value">
+<parameter_description> the new state
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_replace_readwrite_finish">
+<function name="g_action_get_enabled">
<description>
-Finishes an asynchronous file replace operation started with
-g_file_replace_readwrite_async().
+Checks if @action is currently enabled.
-Since: 2.22
+An action must be enabled in order to be activated or in order to
+have its state changed from outside callers.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> a #GFileIOStream, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> whether the action is enabled
</return>
</function>
-<function name="g_file_resolve_relative_path">
+<function name="g_action_get_name">
<description>
-Resolves a relative path for @file to an absolute path.
-
-This call does no blocking i/o.
+Queries the name of @action.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="relative_path">
-<parameter_description> a given relative path string.
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> #GFile to the resolved path. %NULL if @relative_path
-is %NULL or if @file is invalid.
-Free the returned object with g_object_unref().
+<return> the name of the action
+
</return>
</function>
-<function name="g_file_set_attribute">
+<function name="g_action_get_parameter_type">
<description>
-Sets an attribute in the file with attribute name @attribute to @value.
+Queries the type of the parameter that must be given when activating
+ action
-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.
+When activating the action using g_action_activate(), the #GVariant
+given to that function must be of the type returned by this function.
+
+In the case that this function returns %NULL, you must not give any
+#GVariant, but %NULL instead.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> The type of the attribute
-</parameter_description>
-</parameter>
-<parameter name="value_p">
-<parameter_description> a pointer to the value (or the pointer itself if the type is a pointer type)
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the attribute was set, %FALSE otherwise.
+<return> the parameter type
+
</return>
</function>
-<function name="g_file_set_attribute_byte_string">
+<function name="g_action_get_state">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
-If @attribute is of a different type, this operation will fail,
-returning %FALSE.
+Queries the current state of @action.
-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 the action is not stateful then %NULL will be returned. If the
+action is stateful then the type of the return value is the type
+given by g_action_get_state_type().
+
+The return value (if non-%NULL) should be freed with
+g_variant_unref() when it is no longer required.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a string containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
+<return> the current state of the action
+
</return>
</function>
-<function name="g_file_set_attribute_int32">
+<function name="g_action_get_state_hint">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
-If @attribute is of a different type, this operation will fail.
+Requests a hint about the valid range of values for the state of
+ action
-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 %NULL is returned it either means that the action is not stateful
+or that there is no hint about the valid range of values for the
+state of the action.
+
+If a #GVariant array is returned then each item in the array is a
+possible value for the state. If a #GVariant pair (ie: two-tuple) is
+returned then the tuple specifies the inclusive lower and upper bound
+of valid values for the state.
+
+In any case, the information is merely a hint. It may be possible to
+have a state value outside of the hinted range and setting a value
+within the range may fail.
+
+The return value (if non-%NULL) should be freed with
+g_variant_unref() when it is no longer required.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #gint32 containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
+<return> the state range hint
+
</return>
</function>
-<function name="g_file_set_attribute_int64">
+<function name="g_action_get_state_type">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value.
-If @attribute is of a different type, this operation will fail.
+Queries the type of the state of @action.
-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 the action is stateful (e.g. created with
+g_simple_action_new_stateful()) then this function returns the
+#GVariantType of the state. This is the type of the initial value
+given as the state. All calls to g_action_change_state() must give a
+#GVariant of this type and g_action_get_state() will return a
+#GVariant of the same type.
+If the action is not stateful (e.g. created with g_simple_action_new())
+then this function will return %NULL. In that case, g_action_get_state()
+will return %NULL and you must not call g_action_change_state().
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #guint64 containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set, %FALSE otherwise.
+<return> the state type, if the action is stateful
+
</return>
</function>
-<function name="g_file_set_attribute_string">
+<function name="g_action_group_action_added">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value.
-If @attribute is of a different type, this operation will fail.
+Emits the #GActionGroup::action-added signal on @action_group.
-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.
+This function should only be called by #GActionGroup implementations.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a string containing the attribute's value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of an action in the group
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_set_attribute_uint32">
+<function name="g_action_group_action_enabled_changed">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value.
-If @attribute is of a different type, this operation will fail.
+Emits the #GActionGroup::action-enabled-changed signal on @action_group.
-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.
+This function should only be called by #GActionGroup implementations.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #guint32 containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_name">
+<parameter_description> the name of an action in the group
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="enabled">
+<parameter_description> whether or not the action is now enabled
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_set_attribute_uint64">
+<function name="g_action_group_action_removed">
<description>
-Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value.
-If @attribute is of a different type, this operation will fail.
+Emits the #GActionGroup::action-removed signal on @action_group.
-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.
+This function should only be called by #GActionGroup implementations.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="attribute">
-<parameter_description> a string containing the attribute's name.
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a #guint64 containing the attribute's new value.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of an action in the group
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @attribute was successfully set to @value
-in the @file, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_set_attributes_async">
+<function name="g_action_group_action_state_changed">
<description>
-Asynchronously sets the attributes of @file with @info.
+Emits the #GActionGroup::action-state-changed signal on @action_group.
-For more details, see g_file_set_attributes_from_info() which is
-the synchronous version of this call.
+This function should only be called by #GActionGroup implementations.
-When the operation is finished, @callback will be called. You can then call
-g_file_set_attributes_finish() to get the result of the operation.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a #GFileQueryInfoFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
+<parameter name="action_name">
+<parameter_description> the name of an action in the group
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> a #gpointer.
+<parameter name="state">
+<parameter_description> the new state of the named action
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_set_attributes_finish">
+<function name="g_action_group_activate_action">
<description>
-Finishes setting an attribute started in g_file_set_attributes_async().
+Activate the named action within @action_group.
+
+If the action is expecting a parameter, then the correct type of
+parameter must be given as @parameter. If the action is expecting no
+parameters then @parameter must be %NULL. See
+g_action_group_get_action_parameter_type().
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
+<parameter name="action_name">
+<parameter_description> the name of the action to activate
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="parameter">
+<parameter_description> parameters to the activation
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the attributes were set correctly, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_set_attributes_from_info">
+<function name="g_action_group_change_action_state">
<description>
-Tries to set all attributes in the #GFileInfo on the target values,
-not stopping on the first error.
+Request for the state of the named action within @action_group to be
+changed to @value.
-If there is any error during this operation then @error will be set to
-the first error. Error on particular fields are flagged by setting
-the "status" field in the attribute value to
-%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
-further errors.
+The action must be stateful and @value must be of the correct type.
+See g_action_group_get_action_state_type().
-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.
+This call merely requests a change. The action may refuse to change
+its state or may change its state to something other than @value.
+See g_action_group_get_action_state_hint().
+If the @value GVariant is floating, it is consumed.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="info">
-<parameter_description> a #GFileInfo.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> #GFileQueryInfoFlags
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_name">
+<parameter_description> the name of the action to request the change on
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="value">
+<parameter_description> the new state
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if there was any error, %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_file_set_display_name">
+<function name="g_action_group_get_action_enabled">
<description>
-Renames @file to the specified display name.
-
-The display name is converted from UTF8 to the correct encoding for the target
-filesystem if possible and the @file is renamed to this.
-
-If you want to implement a rename operation in the user interface the edit name
-(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
-widget, and then the result after editing should be passed to g_file_set_display_name().
-
-On success the resulting converted filename is returned.
+Checks if the named action within @action_group is currently enabled.
-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.
+An action must be enabled in order to be activated or in order to
+have its state changed from outside callers.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="display_name">
-<parameter_description> a string.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of the action to query
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile specifying what @file was renamed to, or %NULL
-if there was an error.
-Free the returned object with g_object_unref().
+<return> whether or not the action is currently enabled
+
</return>
</function>
-<function name="g_file_set_display_name_async">
+<function name="g_action_group_get_action_parameter_type">
<description>
-Asynchronously sets the display name for a given #GFile.
-
-For more details, see g_file_set_display_name() which is
-the synchronous version of this call.
+Queries the type of the parameter that must be given when activating
+the named action within @action_group.
-When the operation is finished, @callback will be called. You can then call
-g_file_set_display_name_finish() to get the result of the operation.
+When activating the action using g_action_group_activate_action(),
+the #GVariant given to that function must be of the type returned
+by this function.
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="display_name">
-<parameter_description> a string.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+In the case that this function returns %NULL, you must not give any
+#GVariant, but %NULL instead.
-<function name="g_file_set_display_name_finish">
-<description>
-Finishes setting a display name started with
-g_file_set_display_name_async().
+The parameter type of a particular action will never change but it is
+possible for an action to be removed and for a new action to be added
+with the same name but a different parameter type.
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of the action to query
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile or %NULL on error.
-Free the returned object with g_object_unref().
+<return> the parameter type
+
</return>
</function>
-<function name="g_file_start_mountable">
+<function name="g_action_group_get_action_state">
<description>
-Starts a file of type G_FILE_TYPE_MOUNTABLE.
-Using @start_operation, you can request callbacks when, for instance,
-passwords are needed during authentication.
+Queries the current state of the named action within @action_group.
-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 the action is not stateful then %NULL will be returned. If the
+action is stateful then the type of the return value is the type
+given by g_action_group_get_action_state_type().
-When the operation is finished, @callback will be called. You can then call
-g_file_mount_mountable_finish() to get the result of the operation.
+The return value (if non-%NULL) should be freed with
+g_variant_unref() when it is no longer required.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="start_operation">
-<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="action_name">
+<parameter_description> the name of the action to query
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the current state of the action
+
+</return>
</function>
-<function name="g_file_start_mountable_finish">
+<function name="g_action_group_get_action_state_hint">
<description>
-Finishes a start operation. See g_file_start_mountable() for details.
+Requests a hint about the valid range of values for the state of the
+named action within @action_group.
-Finish an asynchronous start operation that was started
-with g_file_start_mountable().
+If %NULL is returned it either means that the action is not stateful
+or that there is no hint about the valid range of values for the
+state of the action.
-Since: 2.22
+If a #GVariant array is returned then each item in the array is a
+possible value for the state. If a #GVariant pair (ie: two-tuple) is
+returned then the tuple specifies the inclusive lower and upper bound
+of valid values for the state.
+
+In any case, the information is merely a hint. It may be possible to
+have a state value outside of the hinted range and setting a value
+within the range may fail.
+
+The return value (if non-%NULL) should be freed with
+g_variant_unref() when it is no longer required.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of the action to query
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
+<return> the state range hint
</return>
</function>
-<function name="g_file_stop_mountable">
+<function name="g_action_group_get_action_state_type">
<description>
-Stops a file of type G_FILE_TYPE_MOUNTABLE.
+Queries the type of the state of the named action within
+ action_group
-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 the action is stateful then this function returns the
+#GVariantType of the state. All calls to
+g_action_group_change_action_state() must give a #GVariant of this
+type and g_action_group_get_action_state() will return a #GVariant
+of the same type.
-When the operation is finished, @callback will be called. You can then call
-g_file_stop_mountable_finish() to get the result of the operation.
+If the action is not stateful then this function will return %NULL.
+In that case, g_action_group_get_action_state() will return %NULL
+and you must not call g_action_group_change_action_state().
-Since: 2.22
+The state type of a particular action will never change but it is
+possible for an action to be removed and for a new action to be added
+with the same name but a different state type.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="action_name">
+<parameter_description> the name of the action to query
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the state type, if the action is stateful
+
+</return>
</function>
-<function name="g_file_stop_mountable_finish">
+<function name="g_action_group_has_action">
<description>
-Finishes an stop operation, see g_file_stop_mountable() for details.
-
-Finish an asynchronous stop operation that was started
-with g_file_stop_mountable().
+Checks if the named action exists within @action_group.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of the action to check for
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
+<return> whether the named action exists
</return>
</function>
-<function name="g_file_supports_thread_contexts">
+<function name="g_action_group_list_actions">
<description>
-Checks if @file supports <link
-linkend="g-main-context-push-thread-default-context">thread-default
-contexts</link>. If this returns %FALSE, you cannot perform
-asynchronous operations on @file in a thread that has a
-thread-default context.
+Lists the actions contained within @action_group.
-Since: 2.22
+The caller is responsible for freeing the list with g_strfreev() when
+it is no longer required.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
</parameters>
-<return> Whether or not @file supports thread-default contexts.
+<return> a %NULL-terminated array of the names of the
+actions in the groupb
</return>
</function>
-<function name="g_file_trash">
+<function name="g_action_group_query_action">
<description>
-Sends @file to the "Trashcan", if possible. This is similar to
-deleting it, but the user can recover it before emptying the trashcan.
-Not all file systems support trashing, so this call can return the
-%G_IO_ERROR_NOT_SUPPORTED error.
+Queries all aspects of the named action within an @action_group.
+This function acquires the information available from
+g_action_group_has_action(), g_action_group_get_action_enabled(),
+g_action_group_get_action_parameter_type(),
+g_action_group_get_action_state_type(),
+g_action_group_get_action_state_hint() and
+g_action_group_get_state() with a single function call.
-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.
+This provides two main benefits.
+
+The first is the improvement in efficiency that comes with not having
+to perform repeated lookups of the action in order to discover
+different things about it. The second is that implementing
+#GActionGroup can now be done by only overriding this one virtual
+function.
+The interface provides a default implementation of this function that
+calls the individual functions, as required, to fetch the
+information. The interface also provides default implementations of
+those functions that call this function. All implementations,
+therefore, must override either this function or all of the others.
+
+If the action exists, %TRUE is returned and any of the requested
+fields (as indicated by having a non-%NULL reference passed in) are
+filled. If the action doesn't exist, %FALSE is returned and the
+fields may or may not have been modified.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="file">
-<parameter_description> #GFile to send to trash.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of an action in the group
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE on successful trash, %FALSE otherwise.
-</return>
-</function>
-
-<function name="g_file_unmount_mountable">
-<description>
-Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
-
-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.
-
-When the operation is finished, @callback will be called. You can then call
-g_file_unmount_mountable_finish() to get the result of the operation.
-
-Deprecated: 2.22: Use g_file_unmount_mountable_with_operation() instead.
-
-</description>
-<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="enabled">
+<parameter_description> if the action is presently enabled
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter name="parameter_type">
+<parameter_description> the parameter type, or %NULL if none needed
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="state_type">
+<parameter_description> the state type, or %NULL if stateless
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="state_hint">
+<parameter_description> the state hint, or %NULL if none
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="state">
+<parameter_description> the current state, or %NULL if stateless
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the action exists, else %FALSE
+
+</return>
</function>
-<function name="g_file_unmount_mountable_finish">
+<function name="g_action_map_add_action">
<description>
-Finishes an unmount operation, see g_file_unmount_mountable() for details.
+Adds an action to the @action_map.
-Finish an asynchronous unmount operation that was started
-with g_file_unmount_mountable().
+If the action map already contains an action with the same name
+as @action then the old action is dropped from the action map.
-Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() instead.
+The action map takes its own reference on @action.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="action_map">
+<parameter_description> a #GActionMap
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action">
+<parameter_description> a #GAction
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_file_unmount_mountable_with_operation">
+<function name="g_action_map_add_action_entries">
<description>
-Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
+A convenience function for creating multiple #GSimpleAction instances
+and adding them to a #GActionMap.
-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.
+Each action is constructed as per one #GActionEntry.
-When the operation is finished, @callback will be called. You can then call
-g_file_unmount_mountable_finish() to get the result of the operation.
+<example>
+<title>Using g_action_map_add_action_entries()</title>
+<programlisting>
+static void
+activate_quit (GSimpleAction *simple,
+GVariant *parameter,
+gpointer user_data)
+{
+exit (0);
+}
+
+static void
+activate_print_string (GSimpleAction *simple,
+GVariant *parameter,
+gpointer user_data)
+{
+g_print ("%s\n", g_variant_get_string (parameter, NULL));
+}
+
+static GActionGroup *
+create_action_group (void)
+{
+const GActionEntry entries[] = {
+{ "quit", activate_quit },
+{ "print-string", activate_print_string, "s" }
+};
+GSimpleActionGroup *group;
-Since: 2.22
+group = g_simple_action_group_new ();
+g_action_map_add_action_entries (G_ACTION_MAP (group), entries, G_N_ELEMENTS (entries), NULL);
+
+return G_ACTION_GROUP (group);
+}
+</programlisting>
+</example>
+
+Since: 2.32
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+<parameter name="action_map">
+<parameter_description> a #GActionMap
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="entries">
+<parameter_description> a pointer to the first item in an array of #GActionEntry
+structs
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+<parameter name="n_entries">
+<parameter_description> the length of @entries, or -1 if @entries is %NULL-terminated
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> the user data for signal connections
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_file_unmount_mountable_with_operation_finish">
+<function name="g_action_map_lookup_action">
<description>
-Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.
+Looks up the action with the name @action_name in @action_map.
-Finish an asynchronous unmount operation that was started
-with g_file_unmount_mountable_with_operation().
+If no such action exists, returns %NULL.
-Since: 2.22
+Since: 2.32
</description>
<parameters>
-<parameter name="file">
-<parameter_description> input #GFile.
+<parameter name="action_map">
+<parameter_description> a #GActionMap
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="action_name">
+<parameter_description> the name of an action
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation finished successfully. %FALSE
-otherwise.
+<return> a #GAction, or %NULL
</return>
</function>
-<function name="g_filename_completer_get_completion_suffix">
+<function name="g_action_map_remove_action">
<description>
-Obtains a completion for @initial_text from @completer.
+Removes the named action from the action map.
+
+If no action of this name is in the map then nothing happens.
+Since: 2.32
</description>
<parameters>
-<parameter name="completer">
-<parameter_description> the filename completer.
+<parameter name="action_map">
+<parameter_description> a #GActionMap
</parameter_description>
</parameter>
-<parameter name="initial_text">
-<parameter_description> text to be completed.
+<parameter name="action_name">
+<parameter_description> the name of the action
</parameter_description>
</parameter>
</parameters>
-<return> a completed string, or %NULL if no completion exists.
-This string is not owned by GIO, so remember to g_free() it
-when finished.
-</return>
+<return></return>
</function>
-<function name="g_filename_completer_get_completions">
+<function name="g_app_info_add_supports_type">
<description>
-Gets an array of completion strings for a given initial text.
+Adds a content type to the application information to indicate the
+application is capable of opening files with the given content type.
</description>
<parameters>
-<parameter name="completer">
-<parameter_description> the filename completer.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
-<parameter name="initial_text">
-<parameter_description> text to be completed.
+<parameter name="content_type">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> array of strings with possible completions for @initial_text.
-This array must be freed by g_strfreev() when finished.
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_filename_completer_new">
+<function name="g_app_info_can_delete">
<description>
-Creates a new filename completer.
-
-
-</description>
-<parameters>
-</parameters>
-<return> a #GFilenameCompleter.
-</return>
-</function>
+Obtains the information whether the #GAppInfo can be deleted.
+See g_app_info_delete().
-<function name="g_filename_completer_set_dirs_only">
-<description>
-If @dirs_only is %TRUE, @completer will only
-complete directory names, and not file names.
+Since: 2.20
</description>
<parameters>
-<parameter name="completer">
-<parameter_description> the filename completer.
-</parameter_description>
-</parameter>
-<parameter name="dirs_only">
-<parameter_description> a #gboolean.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @appinfo can be deleted
+
+</return>
</function>
-<function name="g_filter_input_stream_get_base_stream">
+<function name="g_app_info_can_remove_supports_type">
<description>
-Gets the base stream for the filter stream.
+Checks if a supported content type can be removed from an application.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream.
+<return> %TRUE if it is possible to remove supported
+content types from a given @appinfo, %FALSE if not.
</return>
</function>
-<function name="g_filter_input_stream_get_close_base_stream">
+<function name="g_app_info_create_from_commandline">
<description>
-Returns whether the base stream will be closed when @stream is
-closed.
+Creates a new #GAppInfo from the given information.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
+<parameter name="commandline">
+<parameter_description> the commandline to use
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if the base stream will be closed.
+<parameter name="application_name">
+<parameter_description> the application name, or %NULL to use @commandline
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags that can specify details of the created #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> new #GAppInfo for given command.
</return>
</function>
-<function name="g_filter_input_stream_set_close_base_stream">
+<function name="g_app_info_delete">
<description>
-Sets whether the base stream will be closed when @stream is closed.
+Tries to delete a #GAppInfo.
+
+On some platforms, there may be a difference between user-defined
+#GAppInfo<!-- -->s which can be deleted, and system-wide ones which
+cannot. See g_app_info_can_delete().
+
+Virtual: do_delete
+Since: 2.20
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterInputStream.
-</parameter_description>
-</parameter>
-<parameter name="close_base">
-<parameter_description> %TRUE to close the base stream.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @appinfo has been deleted
+
+</return>
</function>
-<function name="g_filter_output_stream_get_base_stream">
+<function name="g_app_info_dup">
<description>
-Gets the base stream for the filter stream.
+Creates a duplicate of a #GAppInfo.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterOutputStream.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a #GOutputStream.
+<return> a duplicate of @appinfo.
</return>
</function>
-<function name="g_filter_output_stream_get_close_base_stream">
+<function name="g_app_info_equal">
<description>
-Returns whether the base stream will be closed when @stream is
-closed.
+Checks if two #GAppInfo<!-- -->s are equal.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterOutputStream.
+<parameter name="appinfo1">
+<parameter_description> the first #GAppInfo.
+</parameter_description>
+</parameter>
+<parameter name="appinfo2">
+<parameter_description> the second #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the base stream will be closed.
+<return> %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.
</return>
</function>
-<function name="g_filter_output_stream_set_close_base_stream">
+<function name="g_app_info_get_all">
<description>
-Sets whether the base stream will be closed when @stream is closed.
+Gets a list of all of the applications currently registered
+on this system.
+
+For desktop files, this includes applications that have
+<literal>NoDisplay=true</literal> set or are excluded from
+display by means of <literal>OnlyShowIn</literal> or
+<literal>NotShowIn</literal>. See g_app_info_should_show().
+The returned list does not include applications which have
+the <literal>Hidden</literal> key set.
+
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GFilterOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="close_base">
-<parameter_description> %TRUE to close the base stream.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a newly allocated #GList of references to #GAppInfo<!---->s.
+</return>
</function>
-<function name="g_icon_equal">
+<function name="g_app_info_get_all_for_type">
<description>
-Checks if two icons are equal.
+Gets a list of all #GAppInfos for a given content type,
+including the recommended and fallback #GAppInfos. See
+g_app_info_get_recommended_for_type() and
+g_app_info_get_fallback_for_type().
</description>
<parameters>
-<parameter name="icon1">
-<parameter_description> pointer to the first #GIcon.
-</parameter_description>
-</parameter>
-<parameter name="icon2">
-<parameter_description> pointer to the second #GIcon.
+<parameter name="content_type">
+<parameter_description> the content type to find a #GAppInfo for
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @icon1 is equal to @icon2. %FALSE otherwise.
+<return> #GList of #GAppInfos
+for given @content_type or %NULL on error.
</return>
</function>
-<function name="g_icon_hash">
+<function name="g_app_info_get_commandline">
<description>
-Gets a hash for an icon.
+Gets the commandline with which the application will be
+started.
-Virtual: hash
+Since: 2.20
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> #gconstpointer to an icon object.
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return> a #guint containing a hash for the @icon, suitable for
-use in a #GHashTable or similar data structure.
+<return> a string containing the @appinfo's commandline,
+or %NULL if this information is not available
+
</return>
</function>
-<function name="g_icon_new_for_string">
+<function name="g_app_info_get_default_for_type">
<description>
-Generate a #GIcon instance from @str. This function can fail if
- str is not valid - see g_icon_to_string() for discussion.
+Gets the default #GAppInfo for a given content type.
-If your application or library provides one or more #GIcon
-implementations you need to ensure that each #GType is registered
-with the type system prior to calling g_icon_new_for_string().
-
-Since: 2.20
</description>
<parameters>
-<parameter name="str">
-<parameter_description> A string obtained via g_icon_to_string().
+<parameter name="content_type">
+<parameter_description> the content type to find a #GAppInfo for
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> Return location for error.
+<parameter name="must_support_uris">
+<parameter_description> if %TRUE, the #GAppInfo is expected to
+support URIs
</parameter_description>
</parameter>
</parameters>
-<return> An object implementing the #GIcon
-interface or %NULL if @error is set.
-
+<return> #GAppInfo for given @content_type or
+%NULL on error.
</return>
</function>
-<function name="g_icon_to_string">
+<function name="g_app_info_get_default_for_uri_scheme">
<description>
-Generates a textual representation of @icon that can be used for
-serialization such as when passing @icon to a different process or
-saving it to persistent storage. Use g_icon_new_for_string() to
-get @icon back from the returned string.
-
-The encoding of the returned string is proprietary to #GIcon except
-in the following two cases
-
-<itemizedlist>
-<listitem><para>
-If @icon is a #GFileIcon, the returned string is a native path
-(such as <literal>/path/to/my icon.png</literal>) without escaping
-if the #GFile for @icon is a native file. If the file is not
-native, the returned string is the result of g_file_get_uri()
-(such as <literal>sftp://path/to/my%%20icon.png</literal>).
-</para></listitem>
-<listitem><para>
-If @icon is a #GThemedIcon with exactly one name, the encoding is
-simply the name (such as <literal>network-server</literal>).
-</para></listitem>
-</itemizedlist>
+Gets the default application for handling URIs with
+the given URI scheme. A URI scheme is the initial part
+of the URI, up to but not including the ':', e.g. "http",
+"ftp" or "sip".
-Virtual: to_tokens
-Since: 2.20
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GIcon.
+<parameter name="uri_scheme">
+<parameter_description> a string containing a URI scheme.
</parameter_description>
</parameter>
</parameters>
-<return> An allocated NUL-terminated UTF8 string or %NULL if @icon can't
-be serialized. Use g_free() to free.
-
+<return> #GAppInfo for given @uri_scheme or %NULL on error.
</return>
</function>
-<function name="g_inet_address_get_family">
+<function name="g_app_info_get_description">
<description>
-Gets @address's family
+Gets a human-readable description of an installed application.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> @address's family
-
+<return> a string containing a description of the
+application @appinfo, or %NULL if none.
</return>
</function>
-<function name="g_inet_address_get_is_any">
+<function name="g_app_info_get_display_name">
<description>
-Tests whether @address is the "any" address for its family.
+Gets the display name of the application. The display name is often more
+descriptive to the user than the name itself.
-Since: 2.22
+Since: 2.24
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is the "any" address for its family.
+<return> the display name of the application for @appinfo, or the name if
+no display name is available.
</return>
</function>
-<function name="g_inet_address_get_is_link_local">
+<function name="g_app_info_get_executable">
<description>
-Tests whether @address is a link-local address (that is, if it
-identifies a host on a local network that is not connected to the
-Internet).
+Gets the executable's name for the installed application.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a link-local address.
-
+<return> a string containing the @appinfo's application
+binaries name
</return>
</function>
-<function name="g_inet_address_get_is_loopback">
+<function name="g_app_info_get_fallback_for_type">
<description>
-Tests whether @address is the loopback address for its family.
+Gets a list of fallback #GAppInfos for a given content type, i.e.
+those applications which claim to support the given content type
+by MIME type subclassing and not directly.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="content_type">
+<parameter_description> the content type to find a #GAppInfo for
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is the loopback address for its family.
+<return> #GList of #GAppInfos
+for given @content_type or %NULL on error.
</return>
</function>
-<function name="g_inet_address_get_is_mc_global">
+<function name="g_app_info_get_icon">
<description>
-Tests whether @address is a global multicast address.
+Gets the icon for the application.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a global multicast address.
-
+<return> the default #GIcon for @appinfo or %NULL
+if there is no default icon.
</return>
</function>
-<function name="g_inet_address_get_is_mc_link_local">
+<function name="g_app_info_get_id">
<description>
-Tests whether @address is a link-local multicast address.
+Gets the ID of an application. An id is a string that
+identifies the application. The exact format of the id is
+platform dependent. For instance, on Unix this is the
+desktop file id from the xdg menu specification.
+
+Note that the returned ID may be %NULL, depending on how
+the @appinfo has been constructed.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a link-local multicast address.
-
+<return> a string containing the application's ID.
</return>
</function>
-<function name="g_inet_address_get_is_mc_node_local">
+<function name="g_app_info_get_name">
<description>
-Tests whether @address is a node-local multicast address.
+Gets the installed name of the application.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a node-local multicast address.
-
+<return> the name of the application for @appinfo.
</return>
</function>
-<function name="g_inet_address_get_is_mc_org_local">
+<function name="g_app_info_get_recommended_for_type">
<description>
-Tests whether @address is an organization-local multicast address.
+Gets a list of recommended #GAppInfos for a given content type, i.e.
+those applications which claim to support the given content type exactly,
+and not by MIME type subclassing.
+Note that the first application of the list is the last used one, i.e.
+the last one for which g_app_info_set_as_last_used_for_type() has been
+called.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="content_type">
+<parameter_description> the content type to find a #GAppInfo for
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is an organization-local multicast address.
+<return> #GList of #GAppInfos
+for given @content_type or %NULL on error.
</return>
</function>
-<function name="g_inet_address_get_is_mc_site_local">
+<function name="g_app_info_launch">
<description>
-Tests whether @address is a site-local multicast address.
+Launches the application. Passes @files to the launched application
+as arguments, using the optional @launch_context to get information
+about the details of the launcher (like what screen it is on).
+On error, @error will be set accordingly.
+
+To launch the application without arguments pass a %NULL @files list.
+
+Note that even if the launch is successful the application launched
+can fail to start if it runs into problems during startup. There is
+no way to detect this.
+
+Some URIs can be changed when passed through a GFile (for instance
+unsupported URIs with strange formats like mailto:), so if you have
+a textual URI you want to pass in as argument, consider using
+g_app_info_launch_uris() instead.
+
+The launched application inherits the environment of the launching
+process, but it can be modified with g_app_launch_context_setenv() and
+g_app_launch_context_unsetenv().
+
+On UNIX, this function sets the <envar>GIO_LAUNCHED_DESKTOP_FILE</envar>
+environment variable with the path of the launched desktop file and
+<envar>GIO_LAUNCHED_DESKTOP_FILE_PID</envar> to the process
+id of the launched process. This can be used to ignore
+<envar>GIO_LAUNCHED_DESKTOP_FILE</envar>, should it be inherited
+by further processes. The <envar>DISPLAY</envar> and
+<envar>DESKTOP_STARTUP_ID</envar> environment variables are also
+set, based on information provided in @launch_context.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="files">
+<parameter_description> a #GList of #GFile objects
+</parameter_description>
+</parameter>
+<parameter name="launch_context">
+<parameter_description> a #GAppLaunchContext or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a site-local multicast address.
-
+<return> %TRUE on successful launch, %FALSE otherwise.
</return>
</function>
-<function name="g_inet_address_get_is_multicast">
+<function name="g_app_info_launch_default_for_uri">
<description>
-Tests whether @address is a multicast address.
+Utility function that launches the default application
+registered to handle the specified uri. Synchronous I/O
+is done on the uri to detect the type of the file if
+required.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="uri">
+<parameter_description> the uri to show
+</parameter_description>
+</parameter>
+<parameter name="launch_context">
+<parameter_description> an optional #GAppLaunchContext.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a multicast address.
-
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_inet_address_get_is_site_local">
+<function name="g_app_info_launch_uris">
<description>
-Tests whether @address is a site-local address such as 10.0.0.1
-(that is, the address identifies a host on a local network that can
-not be reached directly from the Internet, but which may have
-outgoing Internet connectivity via a NAT or firewall).
+Launches the application. This passes the @uris to the launched application
+as arguments, using the optional @launch_context to get information
+about the details of the launcher (like what screen it is on).
+On error, @error will be set accordingly.
+
+To launch the application without arguments pass a %NULL @uris list.
+
+Note that even if the launch is successful the application launched
+can fail to start if it runs into problems during startup. There is
+no way to detect this.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="uris">
+<parameter_description> a #GList containing URIs to launch.
+</parameter_description>
+</parameter>
+<parameter name="launch_context">
+<parameter_description> a #GAppLaunchContext or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @address is a site-local address.
-
+<return> %TRUE on successful launch, %FALSE otherwise.
</return>
</function>
-<function name="g_inet_address_get_native_size">
+<function name="g_app_info_remove_supports_type">
<description>
-Gets the size of the native raw binary address for @address. This
-is the size of the data that you get from g_inet_address_to_bytes().
+Removes a supported type from an application, if possible.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
+</parameter_description>
+</parameter>
+<parameter name="content_type">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes used for the native version of @address.
-
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_inet_address_new_any">
+<function name="g_app_info_reset_type_associations">
<description>
-Creates a #GInetAddress for the "any" address (unassigned/"don't
-care") for @family.
+Removes all changes to the type associations done by
+g_app_info_set_as_default_for_type(),
+g_app_info_set_as_default_for_extension(),
+g_app_info_add_supports_type() or
+g_app_info_remove_supports_type().
-Since: 2.22
+Since: 2.20
</description>
<parameters>
-<parameter name="family">
-<parameter_description> the address family
+<parameter name="content_type">
+<parameter_description> a content type
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to the "any" address
-for @family.
-
-</return>
+<return></return>
</function>
-<function name="g_inet_address_new_from_bytes">
+<function name="g_app_info_set_as_default_for_extension">
<description>
-Creates a new #GInetAddress from the given @family and @bytes.
- bytes should be 4 bytes for %G_INET_ADDRESS_IPV4 and 16 bytes for
-%G_INET_ADDRESS_IPV6.
+Sets the application as the default handler for the given file extension.
-Since: 2.22
</description>
<parameters>
-<parameter name="bytes">
-<parameter_description> raw address data
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
-<parameter name="family">
-<parameter_description> the address family of @bytes
+<parameter name="extension">
+<parameter_description> a string containing the file extension (without the dot).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to @family and @bytes.
-
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_inet_address_new_from_string">
+<function name="g_app_info_set_as_default_for_type">
<description>
-Parses @string as an IP address and creates a new #GInetAddress.
+Sets the application as the default handler for a given type.
-Since: 2.22
</description>
<parameters>
-<parameter name="string">
-<parameter_description> a string representation of an IP address
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
+</parameter_description>
+</parameter>
+<parameter name="content_type">
+<parameter_description> the content type.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to @string, or %NULL if
- string could not be parsed.
-
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_inet_address_new_loopback">
+<function name="g_app_info_set_as_last_used_for_type">
<description>
-Creates a #GInetAddress for the loopback address for @family.
+Sets the application as the last used application for a given type.
+This will make the application appear as first in the list returned
+by g_app_info_get_recommended_for_type(), regardless of the default
+application for that content type.
-Since: 2.22
</description>
<parameters>
-<parameter name="family">
-<parameter_description> the address family
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
+</parameter_description>
+</parameter>
+<parameter name="content_type">
+<parameter_description> the content type.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetAddress corresponding to the loopback address
-for @family.
-
+<return> %TRUE on success, %FALSE on error.
</return>
</function>
-<function name="g_inet_address_to_bytes">
+<function name="g_app_info_should_show">
<description>
-Gets the raw binary address data from @address.
+Checks if the application info should be shown in menus that
+list available applications.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to an internal array of the bytes in @address,
-which should not be modified, stored, or freed. The size of this
-array can be gotten with g_inet_address_get_native_size().
-
+<return> %TRUE if the @appinfo should be shown, %FALSE otherwise.
</return>
</function>
-<function name="g_inet_address_to_string">
+<function name="g_app_info_supports_files">
<description>
-Converts @address to string form.
+Checks if the application accepts files as arguments.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a representation of @address as a string, which should be
-freed after use.
-
+<return> %TRUE if the @appinfo supports files.
</return>
</function>
-<function name="g_inet_socket_address_get_address">
+<function name="g_app_info_supports_uris">
<description>
-Gets @address's #GInetAddress.
+Checks if the application supports reading files and directories from URIs.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetSocketAddress
+<parameter name="appinfo">
+<parameter_description> a #GAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> the #GInetAddress for @address, which must be
-g_object_ref()'d if it will be stored
-
+<return> %TRUE if the @appinfo supports URIs.
</return>
</function>
-<function name="g_inet_socket_address_get_port">
+<function name="g_app_launch_context_get_display">
<description>
-Gets @address's port.
+Gets the display string for the @context. This is used to ensure new
+applications are started on the same display as the launching
+application, by setting the <envar>DISPLAY</envar> environment variable.
-Since: 2.22
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetSocketAddress
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> a #GAppInfo
+</parameter_description>
+</parameter>
+<parameter name="files">
+<parameter_description> a #GList of #GFile objects
</parameter_description>
</parameter>
</parameters>
-<return> the port for @address
-
+<return> a display string for the display.
</return>
</function>
-<function name="g_inet_socket_address_new">
+<function name="g_app_launch_context_get_environment">
<description>
-Creates a new #GInetSocketAddress for @address and @port.
+Gets the complete environment variable list to be passed to
+the child process when @context is used to launch an application.
+This is a %NULL-terminated array of strings, where each string has
+the form <literal>KEY=VALUE</literal>.
-Since: 2.22
+Since: 2.32
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GInetAddress
-</parameter_description>
-</parameter>
-<parameter name="port">
-<parameter_description> a port number
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
</parameter_description>
</parameter>
</parameters>
-<return> a new #GInetSocketAddress
+<return> the
+child's environment
</return>
</function>
-<function name="g_initable_init">
+<function name="g_app_launch_context_get_startup_notify_id">
<description>
-Initializes the object implementing the interface. This must be
-done before any real use of the object after initial construction.
-
-Implementations may also support cancellation. If @cancellable is not %NULL,
-then initialization 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 @cancellable is not %NULL and
-the object doesn't support cancellable initialization the error
-%G_IO_ERROR_NOT_SUPPORTED will be returned.
-
-If this function is not called, or returns with an error then all
-operations on the object should fail, generally returning the
-error %G_IO_ERROR_NOT_INITIALIZED.
+Initiates startup notification for the application and returns the
+<envar>DESKTOP_STARTUP_ID</envar> for the launched operation,
+if supported.
-Implementations of this method must be idempotent, i.e. multiple calls
-to this function with the same argument should return the same results.
-Only the first call initializes the object, further calls return the result
-of the first call. This is so that its safe to implement the singleton
-pattern in the GObject constructor function.
+Startup notification IDs are defined in the <ulink
+url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">
+FreeDesktop.Org Startup Notifications standard</ulink>.
-Since: 2.22
</description>
<parameters>
-<parameter name="initable">
-<parameter_description> a #GInitable.
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="info">
+<parameter_description> a #GAppInfo
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="files">
+<parameter_description> a #GList of of #GFile objects
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error has occurred, this function will
-return %FALSE and set @error appropriately if present.
-
+<return> a startup notification ID for the application, or %NULL if
+not supported.
</return>
</function>
-<function name="g_initable_new">
+<function name="g_app_launch_context_launch_failed">
<description>
-Helper function for constructing #GInitiable object. This is
-similar to g_object_new() but also initializes the object
-and returns %NULL, setting an error on failure.
+Called when an application has failed to launch, so that it can cancel
+the application startup notification started in g_app_launch_context_get_startup_notify_id().
-Since: 2.22
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GInitable.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
-</parameter_description>
-</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, or %NULL if no
-properties
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> the value if the first property, followed by and other property
-value pairs, and ended by %NULL.
+<parameter name="startup_notify_id">
+<parameter_description> the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
+<return></return>
+</function>
+
+<function name="g_app_launch_context_new">
+<description>
+Creates a new application launch context. This is not normally used,
+instead you instantiate a subclass of this, such as #GdkAppLaunchContext.
+
+</description>
+<parameters>
+</parameters>
+<return> a #GAppLaunchContext.
</return>
</function>
-<function name="g_initable_new_valist">
+<function name="g_app_launch_context_setenv">
<description>
-Helper function for constructing #GInitiable object. This is
-similar to g_object_new_valist() but also initializes the object
-and returns %NULL, setting an error on failure.
+Arranges for @variable to be set to @value in the child's
+environment when @context is used to launch an application.
-Since: 2.22
+Since: 2.32
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GInitable.
-</parameter_description>
-</parameter>
-<parameter name="first_property_name">
-<parameter_description> the name of the first property, followed by
-the value, and other property value pairs, and ended by %NULL.
-</parameter_description>
-</parameter>
-<parameter name="var_args">
-<parameter_description> The var args list generated from @first_property_name.
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="variable">
+<parameter_description> the environment variable to set
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="value">
+<parameter_description> the value for to set the variable to.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
-
-</return>
+<return></return>
</function>
-<function name="g_initable_newv">
+<function name="g_app_launch_context_unsetenv">
<description>
-Helper function for constructing #GInitiable object. This is
-similar to g_object_newv() but also initializes the object
-and returns %NULL, setting an error on failure.
+Arranges for @variable to be unset in the child's environment
+when @context is used to launch an application.
-Since: 2.22
+Since: 2.32
</description>
<parameters>
-<parameter name="object_type">
-<parameter_description> a #GType supporting #GInitable.
-</parameter_description>
-</parameter>
-<parameter name="n_parameters">
-<parameter_description> the number of parameters in @parameters
-</parameter_description>
-</parameter>
-<parameter name="parameters">
-<parameter_description> the parameters to use to construct the object
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="context">
+<parameter_description> a #GAppLaunchContext
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="variable">
+<parameter_description> the environment variable to remove
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GObject, or %NULL on error
-
-</return>
+<return></return>
</function>
-<function name="g_input_stream_clear_pending">
+<function name="g_application_activate">
<description>
-Clears the pending flag on @stream.
+Activates the application.
+
+In essence, this results in the #GApplication::activate() signal being
+emitted in the primary instance.
+
+The application must be registered before calling this function.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> input stream
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_input_stream_close">
+<function name="g_application_command_line_get_arguments">
<description>
-Closes the stream, releasing resources related to it.
-
-Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
-
-Streams will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
-
-Some streams might keep the backing store of the stream (e.g. a file descriptor)
-open after the stream is closed. See the documentation for the individual
-stream for details.
+Gets the list of arguments that was passed on the command line.
-On failure the first error that happened will be reported, but the close
-operation will finish as much as possible. A stream that failed to
-close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
-is important to check and report the error to the user.
+The strings in the array may contain non-utf8 data.
-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.
-Cancelling a close will still leave the stream closed, but some streams
-can use a faster close that doesn't block to e.g. check errors.
+The return value is %NULL-terminated and should be freed using
+g_strfreev().
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="argc">
+<parameter_description> the length of the arguments array, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure
+<return> the string array
+containing the arguments (the argv)
+
</return>
</function>
-<function name="g_input_stream_close_async">
+<function name="g_application_command_line_get_cwd">
<description>
-Requests an asynchronous closes of the stream, releasing resources related to it.
-When the operation is finished @callback will be called.
-You can then call g_input_stream_close_finish() to get the result of the
-operation.
+Gets the working directory of the command line invocation.
+The string may contain non-utf8 data.
-For behaviour details see g_input_stream_close().
+It is possible that the remote application did not send a working
+directory, so this may be %NULL.
-The asyncronous methods have a default fallback that uses threads to implement
-asynchronicity, so they are optional for inheriting classes. However, if you
-override one you must override all.
+The return value should not be modified or freed and is valid for as
+long as @cmdline exists.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional cancellable object
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the current directory, or %NULL
+
+</return>
</function>
-<function name="g_input_stream_close_finish">
+<function name="g_application_command_line_get_environ">
<description>
-Finishes closing a stream asynchronously, started from g_input_stream_close_async().
+Gets the contents of the 'environ' variable of the command line
+invocation, as would be returned by g_get_environ(), ie as a
+%NULL-terminated list of strings in the form 'NAME=VALUE'.
+The strings may contain non-utf8 data.
+
+The remote application usually does not send an environment. Use
+%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
+set it is possible that the environment is still not available (due
+to invocation messages from other applications).
+
+The return value should not be modified or freed and is valid for as
+long as @cmdline exists.
+
+See g_application_command_line_getenv() if you are only interested
+in the value of a single environment variable.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stream was closed successfully.
+<return> the environment
+strings, or %NULL if they were not sent
+
</return>
</function>
-<function name="g_input_stream_has_pending">
+<function name="g_application_command_line_get_exit_status">
<description>
-Checks if an input stream has pending actions.
+Gets the exit status of @cmdline. See
+g_application_command_line_set_exit_status() for more information.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> input stream.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream has pending actions.
+<return> the exit status
+
</return>
</function>
-<function name="g_input_stream_is_closed">
+<function name="g_application_command_line_get_is_remote">
<description>
-Checks if an input stream is closed.
+Determines if @cmdline represents a remote invocation.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> input stream.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stream is closed.
+<return> %TRUE if the invocation was remote
+
</return>
</function>
-<function name="g_input_stream_read">
+<function name="g_application_command_line_get_platform_data">
<description>
-Tries to read @count bytes from the stream into the buffer starting at
- buffer Will block during this read.
-
-If count is zero returns zero and does nothing. A value of @count
-larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-
-On success, the number of bytes read into the buffer is returned.
-It is not an error if this is not the same as the requested size, as it
-can happen e.g. near the end of a file. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
+Gets the platform data associated with the invocation of @cmdline.
-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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
+This is a #GVariant dictionary containing information about the
+context in which the invocation occurred. It typically contains
+information like the current working directory and the startup
+notification ID.
-On error -1 is returned and @error is set accordingly.
+For local invocation, it will be %NULL.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="cmdline">
+<parameter_description> #GApplicationCommandLine
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> the platform data, or %NULL
+
</return>
</function>
-<function name="g_input_stream_read_all">
+<function name="g_application_command_line_getenv">
<description>
-Tries to read @count bytes from the stream into the buffer starting at
- buffer Will block during this read.
-
-This function is similar to g_input_stream_read(), except it tries to
-read as many bytes as requested, only stopping on an error or end of stream.
+Gets the value of a particular environment variable of the command
+line invocation, as would be returned by g_getenv(). The strings may
+contain non-utf8 data.
-On a successful read of @count bytes, or if we reached the end of the
-stream, %TRUE is returned, and @bytes_read is set to the number of bytes
-read into @buffer.
+The remote application usually does not send an environment. Use
+%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
+set it is possible that the environment is still not available (due
+to invocation messages from other applications).
-If there is an error during the operation %FALSE is returned and @error
-is set to indicate the error status, @bytes_read is updated to contain
-the number of bytes read into @buffer before the error occurred.
+The return value should not be modified or freed and is valid for as
+long as @cmdline exists.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes that was read from the stream
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="name">
+<parameter_description> the environment variable to get
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE if there was an error
+<return> the value of the variable, or %NULL if unset or unsent
+
</return>
</function>
-<function name="g_input_stream_read_async">
+<function name="g_application_command_line_print">
<description>
-Request an asynchronous read of @count bytes from the stream into the buffer
-starting at @buffer. When the operation is finished @callback will be called.
-You can then call g_input_stream_read_finish() to get the result of the
-operation.
-
-During an async request no other sync and async calls are allowed on @stream, and will
-result in %G_IO_ERROR_PENDING errors.
-
-A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-
-On success, the number of bytes read into the buffer will be passed to the
-callback. It is not an error if this is not the same as the requested size, as it
-can happen e.g. near the end of a file, but generally we try to read
-as many bytes as requested. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
+Formats a message and prints it using the stdout print handler in the
+invoking process.
-Any outstanding i/o request with higher priority (lower numerical value) will
-be executed before an outstanding request with lower priority. Default
-priority is %G_PRIORITY_DEFAULT.
+If @cmdline is a local invocation then this is exactly equivalent to
+g_print(). If @cmdline is remote then this is equivalent to calling
+g_print() in the invoking process.
-The asyncronous methods have a default fallback that uses threads to implement
-asynchronicity, so they are optional for inheriting classes. However, if you
-override one you must override all.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least count bytes long).
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be read from the stream
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter name="format">
+<parameter_description> a printf-style format string
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="Varargs">
+<parameter_description> arguments, as per @format
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_input_stream_read_finish">
+<function name="g_application_command_line_printerr">
<description>
-Finishes an asynchronous stream read operation.
+Formats a message and prints it using the stderr print handler in the
+invoking process.
+
+If @cmdline is a local invocation then this is exactly equivalent to
+g_printerr(). If @cmdline is remote then this is equivalent to
+calling g_printerr() in the invoking process.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="format">
+<parameter_description> a printf-style format string
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="Varargs">
+<parameter_description> arguments, as per @format
</parameter_description>
</parameter>
</parameters>
-<return> number of bytes read in, or -1 on error.
-</return>
+<return></return>
</function>
-<function name="g_input_stream_set_pending">
+<function name="g_application_command_line_set_exit_status">
<description>
-Sets @stream to have actions pending. If the pending flag is
-already set or @stream is closed, it will return %FALSE and set
- error
+Sets the exit status that will be used when the invoking process
+exits.
+
+The return value of the #GApplication::command-line signal is
+passed to this function when the handler returns. This is the usual
+way of setting the exit status.
+
+In the event that you want the remote invocation to continue running
+and want to decide on the exit status in the future, you can use this
+call. For the case of a remote invocation, the remote process will
+typically exit when the last reference is dropped on @cmdline. The
+exit status of the remote process will be equal to the last value
+that was set with this function.
+
+In the case that the commandline invocation is local, the situation
+is slightly more complicated. If the commandline invocation results
+in the mainloop running (ie: because the use-count of the application
+increased to a non-zero value) then the application is considered to
+have been 'successful' in a certain sense, and the exit status is
+always zero. If the application use count is zero, though, the exit
+status of the local #GApplicationCommandLine is used.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> input stream
+<parameter name="cmdline">
+<parameter_description> a #GApplicationCommandLine
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="exit_status">
+<parameter_description> the exit status
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if pending was previously unset and is now set.
-</return>
+<return></return>
</function>
-<function name="g_input_stream_skip">
+<function name="g_application_get_application_id">
<description>
-Tries to skip @count bytes from the stream. Will block during the operation.
-
-This is identical to g_input_stream_read(), from a behaviour standpoint,
-but the bytes that are skipped are not returned to the user. Some
-streams have an implementation that is more efficient than reading the data.
-
-This function is optional for inherited classes, as the default implementation
-emulates it using read.
-
-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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
+Gets the unique identifier for @application.
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be skipped from the stream
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes skipped, or -1 on error
+<return> the identifier for @application, owned by @application
+
</return>
</function>
-<function name="g_input_stream_skip_async">
+<function name="g_application_get_default">
<description>
-Request an asynchronous skip of @count bytes from the stream.
-When the operation is finished @callback will be called.
-You can then call g_input_stream_skip_finish() to get the result
-of the operation.
-
-During an async request no other sync and async calls are allowed,
-and will result in %G_IO_ERROR_PENDING errors.
-
-A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+Returns the default #GApplication instance for this process.
-On success, the number of bytes skipped will be passed to the callback.
-It is not an error if this is not the same as the requested size, as it
-can happen e.g. near the end of a file, but generally we try to skip
-as many bytes as requested. Zero is returned on end of file
-(or if @count is zero), but never otherwise.
+Normally there is only one #GApplication per process and it becomes
+the default when it is created. You can exercise more control over
+this by using g_application_set_default().
-Any outstanding i/o request with higher priority (lower numerical value)
-will be executed before an outstanding request with lower priority.
-Default priority is %G_PRIORITY_DEFAULT.
+If there is no default application then %NULL is returned.
-The asynchronous methods have a default fallback that uses threads to
-implement asynchronicity, so they are optional for inheriting classes.
-However, if you override one, you must override all.
+Since: 2.32
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes that will be skipped from the stream
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> the default application for this process, or %NULL
+
+</return>
</function>
-<function name="g_input_stream_skip_finish">
+<function name="g_application_get_flags">
<description>
-Finishes a stream skip operation.
+Gets the flags for @application.
+See #GApplicationFlags.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> the size of the bytes skipped, or %-1 on error.
+<return> the flags for @application
+
</return>
</function>
-<function name="g_io_error_from_errno">
+<function name="g_application_get_inactivity_timeout">
<description>
-Converts errno.h error codes into GIO error codes.
+Gets the current inactivity timeout for the application.
+
+This is the amount of time (in milliseconds) after the last call to
+g_application_release() before the application stops running.
+Since: 2.28
</description>
<parameters>
-<parameter name="err_no">
-<parameter_description> Error number as defined in errno.h.
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> #GIOErrorEnum value for the given errno.h error number.
+<return> the timeout, in milliseconds
+
</return>
</function>
-<function name="g_io_error_from_win32_error">
+<function name="g_application_get_is_registered">
<description>
-Converts some common error codes into GIO error codes. The
-fallback value G_IO_ERROR_FAILED is returned for error codes not
-handled.
+Checks if @application is registered.
-Since: 2.26
+An application is registered if g_application_register() has been
+successfully called.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="error_code">
-<parameter_description> Windows error number.
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> #GIOErrorEnum value for the given error number.
+<return> %TRUE if @application is registered
</return>
</function>
-<function name="g_io_error_quark">
+<function name="g_application_get_is_remote">
<description>
-Gets the GIO Error Quark.
+Checks if @application is remote.
+
+If @application is remote then it means that another instance of
+application already exists (the 'primary' instance). Calls to
+perform actions on @application will result in the actions being
+performed by the primary instance.
+
+The value of this property cannot be accessed before
+g_application_register() has been called. See
+g_application_get_is_registered().
+Since: 2.28
</description>
<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GQuark.
+<return> %TRUE if @application is remote
+
</return>
</function>
-<function name="g_io_extension_get_name">
+<function name="g_application_hold">
<description>
-Gets the name under which @extension was registered.
+Increases the use count of @application.
-Note that the same type may be registered as extension
-for multiple extension points, under different names.
+Use this function to indicate that the application has a reason to
+continue to run. For example, g_application_hold() is called by GTK+
+when a toplevel window is on the screen.
+To cancel the hold, call g_application_release().
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> the name of @extension.
-</return>
+<return></return>
</function>
-<function name="g_io_extension_get_priority">
+<function name="g_application_id_is_valid">
<description>
-Gets the priority with which @extension was registered.
+Checks if @application_id is a valid application identifier.
+
+A valid ID is required for calls to g_application_new() and
+g_application_set_application_id().
+
+For convenience, the restrictions on application identifiers are
+reproduced here:
+<itemizedlist>
+<listitem>Application identifiers must contain only the ASCII characters "[A-Z][a-z][0-9]_-." and must not begin with a digit.</listitem>
+<listitem>Application identifiers must contain at least one '.' (period) character (and thus at least three elements).</listitem>
+<listitem>Application identifiers must not begin or end with a '.' (period) character.</listitem>
+<listitem>Application identifiers must not contain consecutive '.' (period) characters.</listitem>
+<listitem>Application identifiers must not exceed 255 characters.</listitem>
+</itemizedlist>
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="application_id">
+<parameter_description> a potential application identifier
</parameter_description>
</parameter>
</parameters>
-<return> the priority of @extension
+<return> %TRUE if @application_id is valid
</return>
</function>
-<function name="g_io_extension_get_type">
+<function name="g_application_new">
<description>
-Gets the type associated with @extension.
+Creates a new #GApplication instance.
+
+This function calls g_type_init() for you.
+
+The application id must be valid. See g_application_id_is_valid().
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="application_id">
+<parameter_description> the application id
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the application flags
</parameter_description>
</parameter>
</parameters>
-<return> the type of @extension
+<return> a new #GApplication instance
</return>
</function>
-<function name="g_io_extension_point_get_extension_by_name">
+<function name="g_application_open">
<description>
-Finds a #GIOExtension for an extension point by name.
+Opens the given files.
+In essence, this results in the #GApplication::open signal being emitted
+in the primary instance.
+
+ n_files must be greater than zero.
+
+ hint is simply passed through to the ::open signal. It is
+intended to be used by applications that have multiple modes for
+opening files (eg: "view" vs "edit", etc). Unless you have a need
+for this functionality, you should use "".
+
+The application must be registered before calling this function
+and it must have the %G_APPLICATION_HANDLES_OPEN flag set.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name of the extension to get
+<parameter name="files">
+<parameter_description> an array of #GFiles to open
+</parameter_description>
+</parameter>
+<parameter name="n_files">
+<parameter_description> the length of the @files array
+</parameter_description>
+</parameter>
+<parameter name="hint">
+<parameter_description> a hint (or ""), but never %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the #GIOExtension for @extension_point that has the
-given name, or %NULL if there is no extension with that name
-</return>
+<return></return>
</function>
-<function name="g_io_extension_point_get_extensions">
+<function name="g_application_register">
<description>
-Gets a list of all extensions that implement this extension point.
-The list is sorted by priority, beginning with the highest priority.
+Attempts registration of the application.
+
+This is the point at which the application discovers if it is the
+primary instance or merely acting as a remote for an already-existing
+primary instance. This is implemented by attempting to acquire the
+application identifier as a unique bus name on the session bus using
+GDBus.
+
+Due to the internal architecture of GDBus, method calls can be
+dispatched at any time (even if a main loop is not running). For
+this reason, you must ensure that any object paths that you wish to
+register are registered before calling this function.
+
+If the application has already been registered then %TRUE is
+returned with no work performed.
+
+The #GApplication::startup signal is emitted if registration succeeds
+and @application is the primary instance.
+
+In the event of an error (such as @cancellable being cancelled, or a
+failure to connect to the session bus), %FALSE is returned and @error
+is set appropriately.
+
+Note: the return value of this function is not an indicator that this
+instance is or is not the primary instance of the application. See
+g_application_get_is_remote() for that.
+Since: 2.28
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a NULL #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of
-#GIOExtension<!-- -->s. The list is owned by GIO and should not be
-modified.
+<return> %TRUE if registration succeeded
+
</return>
</function>
-<function name="g_io_extension_point_get_required_type">
+<function name="g_application_release">
<description>
-Gets the required type for @extension_point.
+Decrease the use count of @application.
+
+When the use count reaches zero, the application will stop running.
+Never call this function except to cancel the effect of a previous
+call to g_application_hold().
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
</parameters>
-<return> the #GType that all implementations must have,
-or #G_TYPE_INVALID if the extension point has no required type
-</return>
+<return></return>
</function>
-<function name="g_io_extension_point_implement">
+<function name="g_application_run">
<description>
-Registers @type as extension for the extension point with name
- extension_point_name
+Runs the application.
-If @type has already been registered as an extension for this
-extension point, the existing #GIOExtension object is returned.
+This function is intended to be run from main() and its return value
+is intended to be returned by main(). Although you are expected to pass
+the @argc, @argv parameters from main() to this function, it is possible
+to pass %NULL if @argv is not available or commandline handling is not
+required.
+
+First, the local_command_line() virtual function is invoked.
+This function always runs on the local instance. It gets passed a pointer
+to a %NULL-terminated copy of @argv and is expected to remove the arguments
+that it handled (shifting up remaining arguments). See
+<xref linkend="gapplication-example-cmdline2"/> for an example of
+parsing @argv manually. Alternatively, you may use the #GOptionContext API,
+after setting <literal>argc = g_strv_length (argv);</literal>.
+
+The last argument to local_command_line() is a pointer to the @status
+variable which can used to set the exit status that is returned from
+g_application_run().
+
+If local_command_line() returns %TRUE, the command line is expected
+to be completely handled, including possibly registering as the primary
+instance, calling g_application_activate() or g_application_open(), etc.
+
+If local_command_line() returns %FALSE then the application is registered
+and the #GApplication::command-line signal is emitted in the primary
+instance (which may or may not be this instance). The signal handler
+gets passed a #GApplicationCommandline object that (among other things)
+contains the remaining commandline arguments that have not been handled
+by local_command_line().
+
+If the application has the %G_APPLICATION_HANDLES_COMMAND_LINE
+flag set then the default implementation of local_command_line()
+always returns %FALSE immediately, resulting in the commandline
+always being handled in the primary instance.
+
+Otherwise, the default implementation of local_command_line() tries
+to do a couple of things that are probably reasonable for most
+applications. First, g_application_register() is called to attempt
+to register the application. If that works, then the command line
+arguments are inspected. If no commandline arguments are given, then
+g_application_activate() is called. If commandline arguments are
+given and the %G_APPLICATION_HANDLES_OPEN flag is set then they
+are assumed to be filenames and g_application_open() is called.
+
+If you need to handle commandline arguments that are not filenames,
+and you don't mind commandline handling to happen in the primary
+instance, you should set %G_APPLICATION_HANDLED_COMMAND_LINE and
+process the commandline arguments in your #GApplication::command-line
+signal handler, either manually or using the #GOptionContext API.
+
+If you are interested in doing more complicated local handling of the
+commandline then you should implement your own #GApplication subclass
+and override local_command_line(). In this case, you most likely want
+to return %TRUE from your local_command_line() implementation to
+suppress the default handling. See
+<xref linkend="gapplication-example-cmdline2"/> for an example.
+If, after the above is done, the use count of the application is zero
+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).
+
+Since: 2.28
</description>
<parameters>
-<parameter name="extension_point_name">
-<parameter_description> the name of the extension point
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> the #GType to register as extension
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="extension_name">
-<parameter_description> the name for the extension
+<parameter name="argc">
+<parameter_description> the argc from main() (or 0 if @argv is %NULL)
</parameter_description>
</parameter>
-<parameter name="priority">
-<parameter_description> the priority for the extension
+<parameter name="argv">
+<parameter_description> the argv from main(), or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GIOExtension object for #GType
+<return> the exit status
+
</return>
</function>
-<function name="g_io_extension_point_lookup">
+<function name="g_application_set_action_group">
<description>
-Looks up an existing extension point.
+This used to be how actions were associated with a #GApplication.
+Now there is #GActionMap for that.
+
+Since: 2.28
+Deprecated:2.32:Use the #GActionMap interface instead. Never ever
+mix use of this API with use of #GActionMap on the same @application
+or things will go very badly wrong. This function is known to
+introduce buggy behaviour (ie: signals not emitted on changes to the
+action group), so you should really use #GActionMap instead.
</description>
<parameters>
-<parameter name="name">
-<parameter_description> the name of the extension point
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="action_group">
+<parameter_description> a #GActionGroup, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the #GIOExtensionPoint, or %NULL if there is no
-registered extension point with the given name
-</return>
+<return></return>
</function>
-<function name="g_io_extension_point_register">
+<function name="g_application_set_application_id">
<description>
-Registers an extension point.
+Sets the unique identifier for @application.
+The application id can only be modified if @application has not yet
+been registered.
-</description>
-<parameters>
-<parameter name="name">
-<parameter_description> The name of the extension point
-</parameter_description>
-</parameter>
-</parameters>
-<return> the new #GIOExtensionPoint. This object is owned by GIO
-and should not be freed
-</return>
-</function>
+The application id must be valid. See g_application_id_is_valid().
-<function name="g_io_extension_point_set_required_type">
-<description>
-Sets the required type for @extension_point to @type.
-All implementations must henceforth have this type.
+Since: 2.28
</description>
<parameters>
-<parameter name="extension_point">
-<parameter_description> a #GIOExtensionPoint
+<parameter name="application">
+<parameter_description> a #GApplication
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> the #GType to require
+<parameter name="application_id">
+<parameter_description> the identifier for @application
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_extension_ref_class">
+<function name="g_application_set_default">
<description>
-Gets a reference to the class for the type that is
-associated with @extension.
+Sets or unsets the default application for the process, as returned
+by g_application_get_default().
+This function does not take its own reference on @application. If
+ application is destroyed then the default application will revert
+back to %NULL.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="extension">
-<parameter_description> a #GIOExtension
+<parameter name="application">
+<parameter_description> the application to set as default, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the #GTypeClass for the type of @extension
-</return>
+<return></return>
</function>
-<function name="g_io_module_new">
+<function name="g_application_set_flags">
<description>
-Creates a new GIOModule that will load the specific
-shared library when in use.
+Sets the flags for @application.
+
+The flags can only be modified if @application has not yet been
+registered.
+
+See #GApplicationFlags.
+Since: 2.28
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> filename of the shared library module.
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the flags for @application
</parameter_description>
</parameter>
</parameters>
-<return> a #GIOModule from given @filename,
-or %NULL on error.
-</return>
+<return></return>
</function>
-<function name="g_io_modules_load_all_in_directory">
+<function name="g_application_set_inactivity_timeout">
<description>
-Loads all the modules in the specified directory.
+Sets the current inactivity timeout for the application.
-If don't require all modules to be initialized (and thus registering
-all gtypes) then you can use g_io_modules_scan_all_in_directory()
-which allows delayed/lazy loading of modules.
+This is the amount of time (in milliseconds) after the last call to
+g_application_release() before the application stops running.
+
+This call has no side effects of its own. The value set here is only
+used for next time g_application_release() drops the use count to
+zero. Any timeouts currently in progress are not impacted.
+Since: 2.28
</description>
<parameters>
-<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to load.
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+<parameter name="inactivity_timeout">
+<parameter_description> the timeout, in milliseconds
</parameter_description>
</parameter>
</parameters>
-<return> a list of #GIOModules loaded
-from the directory,
-All the modules are loaded into memory, if you want to
-unload them (enabling on-demand loading) you must call
-g_type_module_unuse() on all the modules. Free the list
-with g_list_free().
-</return>
+<return></return>
</function>
-<function name="g_io_modules_scan_all_in_directory">
+<function name="g_async_initable_init_async">
<description>
-Scans all the modules in the specified directory, ensuring that
-any extension point implemented by a module is registered.
+Starts asynchronous initialization of the object implementing the
+interface. This must be done before any real use of the object after
+initial construction. If the object also implements #GInitable you can
+optionally call g_initable_init() instead.
-This may not actually load and initialize all the types in each
-module, some modules may be lazily loaded and initialized when
-an extension point it implementes is used with e.g.
-g_io_extension_point_get_extensions() or
-g_io_extension_point_get_extension_by_name().
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_init_finish() to get the result of the
+initialization.
-If you need to guarantee that all types are loaded in all the modules,
-use g_io_modules_load_all_in_directory().
+Implementations may also support cancellation. If @cancellable is not
+%NULL, then initialization 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 @cancellable is not %NULL, and
+the object doesn't support cancellable initialization, the error
+%G_IO_ERROR_NOT_SUPPORTED will be returned.
-Since: 2.24
+As with #GInitable, if the object is not initialized, or initialization
+returns with an error, then all operations on the object except
+g_object_ref() and g_object_unref() are considered to be invalid, and
+have undefined behaviour. They will often fail with g_critical() or
+g_warning(), but this must not be relied on.
+
+Implementations of this method must be idempotent: i.e. multiple calls
+to this function with the same argument should return the same results.
+Only the first call initializes the object; further calls return the result
+of the first call. This is so that it's safe to implement the singleton
+pattern in the GObject constructor function.
+
+For classes that also support the #GInitable interface, the default
+implementation of this method will run the g_initable_init() function
+in a thread, so if you want to support asynchronous initialization via
+threads, just implement the #GAsyncInitable interface without overriding
+any interface methods.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to scan.
+<parameter name="initable">
+<parameter_description> a #GAsyncInitable.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_scheduler_cancel_all_jobs">
+<function name="g_async_initable_init_finish">
<description>
-Cancels all cancellable I/O jobs.
+Finishes asynchronous initialization and returns the result.
+See g_async_initable_init_async().
-A job is cancellable if a #GCancellable was passed into
-g_io_scheduler_push_job().
+Since: 2.22
</description>
<parameters>
+<parameter name="initable">
+<parameter_description> a #GAsyncInitable.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
</parameters>
-<return></return>
+<return> %TRUE if successful. If an error has occurred, this function
+will return %FALSE and set @error appropriately if present.
+
+</return>
</function>
-<function name="g_io_scheduler_job_send_to_mainloop">
+<function name="g_async_initable_new_async">
<description>
-Used from an I/O job to send a callback to be run in the thread
-that the job was started from, waiting for the result (and thus
-blocking the I/O job).
+Helper function for constructing #GAsyncInitable object. This is
+similar to g_object_new() but also initializes the object asynchronously.
+
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_new_finish() to get the new object and check
+for any errors.
+Since: 2.22
</description>
<parameters>
-<parameter name="job">
-<parameter_description> a #GIOSchedulerJob
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GAsyncInitable.
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> a #GSourceFunc callback that will be called in the original thread
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> data to pass to @func
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, or %NULL if no
+properties
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the value of the first property, followed by other property
+value pairs, and ended by %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> The return value of @func
+<return></return>
+</function>
+
+<function name="g_async_initable_new_finish">
+<description>
+Finishes the async construction for the various g_async_initable_new
+calls, returning the created object or %NULL on error.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="initable">
+<parameter_description> the #GAsyncInitable from the callback
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> the #GAsyncResult from the callback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for errors, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GObject, or %NULL on error.
+Free with g_object_unref().
+
</return>
</function>
-<function name="g_io_scheduler_job_send_to_mainloop_async">
+<function name="g_async_initable_new_valist_async">
<description>
-Used from an I/O job to send a callback to be run asynchronously in
-the thread that the job was started from. The callback will be run
-when the main loop is available, but at that time the I/O job might
-have finished. The return value from the callback is ignored.
+Helper function for constructing #GAsyncInitable object. This is
+similar to g_object_new_valist() but also initializes the object
+asynchronously.
-Note that if you are passing the @user_data from g_io_scheduler_push_job()
-on to this function you have to ensure that it is not freed before
- func is called, either by passing %NULL as @notify to
-g_io_scheduler_push_job() or by using refcounting for @user_data.
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_new_finish() to get the new object and check
+for any errors.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="job">
-<parameter_description> a #GIOSchedulerJob
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GAsyncInitable.
</parameter_description>
</parameter>
-<parameter name="func">
-<parameter_description> a #GSourceFunc callback that will be called in the original thread
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, followed by
+the value, and other property value pairs, and ended by %NULL.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data to pass to @func
+<parameter name="var_args">
+<parameter_description> The var args list generated from @first_property_name.
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_scheduler_push_job">
+<function name="g_async_initable_newv_async">
<description>
-Schedules the I/O job to run.
+Helper function for constructing #GAsyncInitable object. This is
+similar to g_object_newv() but also initializes the object asynchronously.
- notify will be called on @user_data after @job_func has returned,
-regardless whether the job was cancelled or has run to completion.
+When the initialization is finished, @callback will be called. You can
+then call g_async_initable_new_finish() to get the new object and check
+for any errors.
-If @cancellable is not %NULL, it can be used to cancel the I/O job
-by calling g_cancellable_cancel() or by calling
-g_io_scheduler_cancel_all_jobs().
+Since: 2.22
</description>
<parameters>
-<parameter name="job_func">
-<parameter_description> a #GIOSchedulerJobFunc.
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GAsyncInitable.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data to pass to @job_func
+<parameter name="n_parameters">
+<parameter_description> the number of parameters in @parameters
</parameter_description>
</parameter>
-<parameter name="notify">
-<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+<parameter name="parameters">
+<parameter_description> the parameters to use to construct the object
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the <link linkend="gioscheduler">I/O priority</link>
-of the request.
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the operation.
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the initialization is
+finished
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_stream_clear_pending">
+<function name="g_async_result_get_source_object">
<description>
-Clears the pending flag on @stream.
+Gets the source object from a #GAsyncResult.
-Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="res">
+<parameter_description> a #GAsyncResult
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new reference to the source object for the @res,
+or %NULL if there is none.
+</return>
</function>
-<function name="g_io_stream_close">
+<function name="g_async_result_get_user_data">
<description>
-Closes the stream, releasing resources related to it. This will also
-closes the individual input and output streams, if they are not already
-closed.
+Gets the user data from a #GAsyncResult.
-Once the stream is closed, all other operations will return
-%G_IO_ERROR_CLOSED. Closing a stream multiple times will not
-return an error.
-Closing a stream will automatically flush any outstanding buffers
-in the stream.
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the user data for @res.
+</return>
+</function>
-Streams will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
+<function name="g_buffered_input_stream_fill">
+<description>
+Tries to read @count bytes from the stream into the buffer.
+Will block during this read.
-Some streams might keep the backing store of the stream (e.g. a file
-descriptor) open after the stream is closed. See the documentation for
-the individual stream for details.
+If @count is zero, returns zero and does nothing. A value of @count
+larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
-On failure the first error that happened will be reported, but the
-close operation will finish as much as possible. A stream that failed
-to close will still return %G_IO_ERROR_CLOSED for all operations.
-Still, it is important to check and report the error to the user,
-otherwise there might be a loss of data as all data might not be written.
+On success, the number of bytes read into the buffer is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. near the end of a file. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
-If @cancellable is not NULL, then the operation can be cancelled by
+If @count is -1 then the attempted read size is equal to the number of
+bytes that are required to fill the buffer.
+
+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.
-Cancelling a close will still leave the stream closed, but some streams
-can use a faster close that doesn't block to e.g. check errors.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
-The default implementation of this method just calls close on the
-individual input/output streams.
+On error -1 is returned and @error is set accordingly.
+
+For the asynchronous, non-blocking, version of this function, see
+g_buffered_input_stream_fill_async().
-Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GBufferedInputStream
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -19448,66 +19142,64 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure
-
+<return> the number of bytes read into @stream's buffer, up to @count,
+or -1 on error.
</return>
</function>
-<function name="g_io_stream_close_async">
+<function name="g_buffered_input_stream_fill_async">
<description>
-Requests an asynchronous close of the stream, releasing resources
-related to it. When the operation is finished @callback will be
-called. You can then call g_io_stream_close_finish() to get
-the result of the operation.
-
-For behaviour details see g_io_stream_close().
-
-The asynchronous methods have a default fallback that uses threads
-to implement asynchronicity, so they are optional for inheriting
-classes. However, if you override one you must override all.
+Reads data into @stream's buffer asynchronously, up to @count size.
+ io_priority can be used to prioritize reads. For the synchronous
+version of this function, see g_buffered_input_stream_fill().
-Since: 2.22
+If @count is -1 then the attempted read size is equal to the number
+of bytes that are required to fill the buffer.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GBufferedInputStream
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the io priority of the request
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional cancellable object
+<parameter_description> optional #GCancellable object
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter_description> a #GAsyncReadyCallback
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> a #gpointer
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_io_stream_close_finish">
+<function name="g_buffered_input_stream_fill_finish">
<description>
-Closes a stream.
+Finishes an asynchronous read.
-Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
<parameter name="result">
@@ -19515,2105 +19207,2244 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore
+<parameter_description> a #GError
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if stream was successfully closed, %FALSE otherwise.
-
+<return> a #gssize of the read stream, or %-1 on an error.
</return>
</function>
-<function name="g_io_stream_get_input_stream">
+<function name="g_buffered_input_stream_get_available">
<description>
-Gets the input stream for this object. This is used
-for reading.
+Gets the size of the available data within the stream.
-Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> #GBufferedInputStream
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream, owned by the #GIOStream.
-Do not free.
-
+<return> size of the available stream.
</return>
</function>
-<function name="g_io_stream_get_output_stream">
+<function name="g_buffered_input_stream_get_buffer_size">
<description>
-Gets the output stream for this object. This is used for
-writing.
+Gets the size of the input buffer.
-Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
</parameters>
-<return> a #GOutputStream, owned by the #GIOStream.
-Do not free.
-
+<return> the current buffer size.
</return>
</function>
-<function name="g_io_stream_has_pending">
+<function name="g_buffered_input_stream_new">
<description>
-Checks if a stream has pending actions.
+Creates a new #GInputStream from the given @base_stream, with
+a buffer set to the default size (4 kilobytes).
-Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="base_stream">
+<parameter_description> a #GInputStream
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream has pending actions.
-
+<return> a #GInputStream for the given @base_stream.
</return>
</function>
-<function name="g_io_stream_is_closed">
+<function name="g_buffered_input_stream_new_sized">
<description>
-Checks if a stream is closed.
+Creates a new #GBufferedInputStream from the given @base_stream,
+with a buffer set to @size.
-Since: 2.22
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter name="base_stream">
+<parameter_description> a #GInputStream
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stream is closed.
-
+<return> a #GInputStream.
</return>
</function>
-<function name="g_io_stream_set_pending">
+<function name="g_buffered_input_stream_peek">
<description>
-Sets @stream to have actions pending. If the pending flag is
-already set or @stream is closed, it will return %FALSE and set
- error
+Peeks in the buffer, copying data of size @count into @buffer,
+offset @offset bytes.
-Since: 2.22
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GIOStream
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore
+<parameter name="buffer">
+<parameter_description> a pointer to
+an allocated chunk of memory
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> a #gsize
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if pending was previously unset and is now set.
-
+<return> a #gsize of the number of bytes peeked, or -1 on error.
</return>
</function>
-<function name="g_io_stream_splice_async">
+<function name="g_buffered_input_stream_peek_buffer">
<description>
-Asyncronously splice the output stream of @stream1 to the input stream of
- stream2, and splice the output stream of @stream2 to the input stream of
- stream1
-
-When the operation is finished @callback will be called.
-You can then call g_io_stream_splice_finish() to get the
-result of the operation.
+Returns the buffer with the currently available bytes. The returned
+buffer must not be modified and will become invalid when reading from
+the stream or filling the buffer.
-Since: 2.28
</description>
<parameters>
-<parameter name="stream1">
-<parameter_description> a #GIOStream.
+<parameter name="stream">
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
-<parameter name="stream2">
-<parameter_description> a #GIOStream.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GIOStreamSpliceFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="count">
+<parameter_description> a #gsize to get the number of bytes available in the buffer
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return>
+read-only buffer
+</return>
</function>
-<function name="g_io_stream_splice_finish">
+<function name="g_buffered_input_stream_read_byte">
<description>
-Finishes an asynchronous io stream splice operation.
+Tries to read a single byte from the stream or the buffer. Will block
+during this read.
+
+On success, the byte read from the stream is returned. On end of stream
+-1 is returned but it's not an exceptional error and @error is not set.
+
+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 an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error -1 is returned and @error is set accordingly.
-Since: 2.28
</description>
<parameters>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="stream">
+<parameter_description> a #GBufferedInputStream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> location to store the error occurring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE otherwise.
-
+<return> the byte read from the @stream, or -1 on end of stream or error.
</return>
</function>
-<function name="g_keyfile_settings_backend_new">
+<function name="g_buffered_input_stream_set_buffer_size">
<description>
-Creates a keyfile-backed #GSettingsBackend.
-
-The filename of the keyfile to use is given by @filename.
-
-All settings read to or written from the backend must fall under the
-path given in @root_path (which must start and end with a slash and
-not contain two consecutive slashes). @root_path may be "/".
-
-If @root_group is non-%NULL then it specifies the name of the keyfile
-group used for keys that are written directly below @root_path. For
-example, if @root_path is "/apps/example/" and @root_group is
-"toplevel", then settings the key "/apps/example/enabled" to a value
-of %TRUE will cause the following to appear in the keyfile:
-
-|[
-[toplevel]
-enabled=true
-]|
-
-If @root_group is %NULL then it is not permitted to store keys
-directly below the @root_path.
-
-For keys not stored directly below @root_path (ie: in a sub-path),
-the name of the subpath (with the final slash stripped) is used as
-the name of the keyfile group. To continue the example, if
-"/apps/example/profiles/default/font-size" were set to
-12 then the following would appear in the keyfile:
-
-|[
-[profiles/default]
-font-size=12
-]|
-
-The backend will refuse writes (and return writability as being
-%FALSE) for keys outside of @root_path and, in the event that
- root_group is %NULL, also for keys directly under @root_path.
-Writes will also be refused if the backend detects that it has the
-inability to rewrite the keyfile (ie: the containing directory is not
-writable).
-
-There is no checking done for your key namespace clashing with the
-syntax of the key file format. For example, if you have '[' or ']'
-characters in your path names or '=' in your key names you may be in
-trouble.
+Sets the size of the internal buffer of @stream to @size, or to the
+size of the contents of the buffer. The buffer can never be resized
+smaller than its current contents.
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> the filename of the keyfile
-</parameter_description>
-</parameter>
-<parameter name="root_path">
-<parameter_description> the path under which all settings keys appear
+<parameter name="stream">
+<parameter_description> a #GBufferedInputStream
</parameter_description>
</parameter>
-<parameter name="root_group">
-<parameter_description> the group name corresponding to
- root_path, or %NULL
+<parameter name="size">
+<parameter_description> a #gsize
</parameter_description>
</parameter>
</parameters>
-<return> a keyfile-backed #GSettingsBackend
-</return>
+<return></return>
</function>
-<function name="g_loadable_icon_load">
+<function name="g_buffered_output_stream_get_auto_grow">
<description>
-Loads a loadable icon. For the asynchronous version of this function,
-see g_loadable_icon_load_async().
+Checks if the buffer automatically grows as data is added.
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GLoadableIcon.
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> an integer.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a location to store the type of the
-loaded icon, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="stream">
+<parameter_description> a #GBufferedOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream to read the icon from.
+<return> %TRUE if the @stream's buffer automatically grows,
+%FALSE otherwise.
</return>
</function>
-<function name="g_loadable_icon_load_async">
+<function name="g_buffered_output_stream_get_buffer_size">
<description>
-Loads an icon asynchronously. To finish this function, see
-g_loadable_icon_load_finish(). For the synchronous, blocking
-version of this function, see g_loadable_icon_load().
+Gets the size of the buffer in the @stream.
+
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GLoadableIcon.
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> an integer.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the
-request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="stream">
+<parameter_description> a #GBufferedOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the current size of the buffer.
+</return>
</function>
-<function name="g_loadable_icon_load_finish">
+<function name="g_buffered_output_stream_new">
<description>
-Finishes an asynchronous icon load started in g_loadable_icon_load_async().
+Creates a new buffered output stream for a base stream.
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GLoadableIcon.
-</parameter_description>
-</parameter>
-<parameter name="res">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a location to store the type of the loaded icon, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return> a #GInputStream to read the icon from.
+<return> a #GOutputStream for the given @base_stream.
</return>
</function>
-<function name="g_local_vfs_new">
+<function name="g_buffered_output_stream_new_sized">
<description>
-Returns a new #GVfs handle for a local vfs.
+Creates a new buffered output stream with a given buffer size.
</description>
<parameters>
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a #gsize.
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GVfs handle.
+<return> a #GOutputStream with an internal buffer set to @size.
</return>
</function>
-<function name="g_memory_input_stream_add_data">
+<function name="g_buffered_output_stream_set_auto_grow">
<description>
-Appends @data to data that can be read from the input stream
+Sets whether or not the @stream's buffer should automatically grow.
+If @auto_grow is true, then each write will just make the buffer
+larger, and you must manually flush the buffer to actually write out
+the data to the underlying stream.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GMemoryInputStream
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> input data
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
+<parameter_description> a #GBufferedOutputStream.
</parameter_description>
</parameter>
-<parameter name="destroy">
-<parameter_description> function that is called to free @data, or %NULL
+<parameter name="auto_grow">
+<parameter_description> a #gboolean.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_memory_input_stream_new">
+<function name="g_buffered_output_stream_set_buffer_size">
<description>
-Creates a new empty #GMemoryInputStream.
-
+Sets the size of the internal buffer to @size.
</description>
<parameters>
+<parameter name="stream">
+<parameter_description> a #GBufferedOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a #gsize.
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GInputStream
-</return>
+<return></return>
</function>
-<function name="g_memory_input_stream_new_from_data">
+<function name="g_bus_get">
<description>
-Creates a new #GMemoryInputStream with data in memory of a given size.
+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
+the synchronous version.
+Since: 2.26
</description>
<parameters>
-<parameter name="data">
-<parameter_description> input data
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="len">
-<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="destroy">
-<parameter_description> function that is called to free @data, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> new #GInputStream read from @data of @len bytes.
-</return>
+<return></return>
</function>
-<function name="g_memory_output_stream_get_data">
+<function name="g_bus_get_finish">
<description>
-Gets any loaded data from the @ostream.
+Finishes an operation started with g_bus_get().
-Note that the returned pointer may become invalid on the next
-write or truncate operation on the stream.
+The returned object is a singleton, that is, shared with other
+callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
+event that you need a private message bus connection, use
+g_dbus_address_get_for_bus_sync() and
+g_dbus_connection_new_for_address().
+
+Note that the returned #GDBusConnection object will (usually) have
+the #GDBusConnection:exit-on-close property set to %TRUE.
+Since: 2.26
</description>
<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get().
</parameter_description>
</parameter>
-</parameters>
-<return> pointer to the stream's data
-</return>
-</function>
-
-<function name="g_memory_output_stream_get_data_size">
-<description>
-Returns the number of bytes from the start up
-to including the last byte written in the stream
-that has not been truncated away.
-
-Since: 2.18
-
-</description>
-<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes written to the stream
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
</return>
</function>
-<function name="g_memory_output_stream_get_size">
+<function name="g_bus_get_sync">
<description>
-Gets the size of the currently allocated data area (available from
-g_memory_output_stream_get_data()). If the stream isn't
-growable (no realloc was passed to g_memory_output_stream_new()) then
-this is the maximum size of the stream and further writes
-will return %G_IO_ERROR_NO_SPACE.
+Synchronously connects to the message bus specified by @bus_type.
+Note that the returned object may shared with other callers,
+e.g. if two separate parts of a process calls this function with
+the same @bus_type, they will share the same object.
-Note that for growable streams the returned size may become invalid on
-the next write or truncate operation on the stream.
+This is a synchronous failable function. See g_bus_get() and
+g_bus_get_finish() for the asynchronous version.
-If you want the number of bytes currently written to the stream, use
-g_memory_output_stream_get_data_size().
+The returned object is a singleton, that is, shared with other
+callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
+event that you need a private message bus connection, use
+g_dbus_address_get_for_bus_sync() and
+g_dbus_connection_new_for_address().
+
+Note that the returned #GDBusConnection object will (usually) have
+the #GDBusConnection:exit-on-close property set to %TRUE.
+Since: 2.26
</description>
<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes allocated for the data buffer
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
</return>
</function>
-<function name="g_memory_output_stream_new">
+<function name="g_bus_own_name">
<description>
-Creates a new #GMemoryOutputStream.
+Starts acquiring @name on the bus specified by @bus_type and calls
+ name_acquired_handler and @name_lost_handler when the name is
+acquired respectively lost. Callbacks will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this function from.
-If @data is non-%NULL, the stream will use that for its internal storage.
-If @realloc_fn is non-%NULL, it will be used for resizing the internal
-storage when necessary. To construct a fixed-size output stream,
-pass %NULL as @realloc_fn.
+You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
+callbacks will be invoked after calling this function - there are three
+possible cases:
+<itemizedlist>
+<listitem><para>
+ name_lost_handler with a %NULL connection (if a connection to the bus can't be made).
+</para></listitem>
+<listitem><para>
+ bus_acquired_handler then @name_lost_handler (if the name can't be obtained)
+</para></listitem>
+<listitem><para>
+ bus_acquired_handler then @name_acquired_handler (if the name was obtained).
+</para></listitem>
+</itemizedlist>
+When you are done owning the name, just call g_bus_unown_name()
+with the owner id this function returns.
-|[
-/ * a stream that can grow * /
-stream = g_memory_output_stream_new (NULL, 0, realloc, free);
+If the name is acquired or lost (for example another application
+could acquire the name if you allow replacement or the application
+currently owning the name exits), the handlers are also invoked. If the
+#GDBusConnection that is used for attempting to own the name
+closes, then @name_lost_handler is invoked since it is no
+longer possible for other processes to access the process.
-/ * another stream that can grow * /
-stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
+You cannot use g_bus_own_name() several times for the same name (unless
+interleaved with calls to g_bus_unown_name()) - only the first call
+will work.
-/ * a fixed-size stream * /
-data = malloc (200);
-stream3 = g_memory_output_stream_new (data, 200, NULL, free);
-]|
+Another guarantee is that invocations of @name_acquired_handler
+and @name_lost_handler are guaranteed to alternate; that
+is, if @name_acquired_handler is invoked then you are
+guaranteed that the next time one of the handlers is invoked, it
+will be @name_lost_handler. The reverse is also true.
+If you plan on exporting objects (using e.g.
+g_dbus_connection_register_object()), note that it is generally too late
+to export the objects in @name_acquired_handler. Instead, you can do this
+in @bus_acquired_handler since you are guaranteed that this will run
+before @name is requested from the bus.
+
+This behavior makes it very simple to write applications that wants
+to own names and export objects, see <xref linkend="gdbus-owning-names"/>.
+Simply register objects to be exported in @bus_acquired_handler and
+unregister the objects (if any) in @name_lost_handler.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="data">
-<parameter_description> pointer to a chunk of memory to use, or %NULL
+<parameter name="bus_type">
+<parameter_description> The type of bus to own a name on.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the size of @data
+<parameter name="name">
+<parameter_description> The well-known name to own.
</parameter_description>
</parameter>
-<parameter name="realloc_function">
-<parameter_description> a function with realloc() semantics (like g_realloc())
-to be called when @data needs to be grown, or %NULL
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="destroy_function">
-<parameter_description> a function to be called on @data when the stream is
-finalized, or %NULL
+<parameter name="bus_acquired_handler">
+<parameter_description> Handler to invoke when connected to the bus of type @bus_type or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_handler">
+<parameter_description> Handler to invoke when @name is acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_handler">
+<parameter_description> Handler to invoke when @name is lost or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GMemoryOutputStream object.
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
</return>
</function>
-<function name="g_memory_output_stream_steal_data">
+<function name="g_bus_own_name_on_connection">
<description>
-Gets any loaded data from the @ostream. Ownership of the data
-is transferred to the caller; when no longer needed it must be
-freed using the free function set in @ostream's
-#GMemoryOutputStream:destroy-function property.
-
- ostream must be closed before calling this function.
+Like g_bus_own_name() but takes a #GDBusConnection instead of a
+#GBusType.
Since: 2.26
</description>
<parameters>
-<parameter name="ostream">
-<parameter_description> a #GMemoryOutputStream
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_handler">
+<parameter_description> Handler to invoke when @name is acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_handler">
+<parameter_description> Handler to invoke when @name is lost or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the stream's data
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
</return>
</function>
-<function name="g_memory_settings_backend_new">
+<function name="g_bus_own_name_on_connection_with_closures">
<description>
-Creates a memory-backed #GSettingsBackend.
+Version of g_bus_own_name_on_connection() using closures instead of callbacks for
+easier binding in other languages.
-This backend allows changes to settings, but does not write them
-to any backing storage, so the next time you run your application,
-the memory backend will start out with the default values again.
-
-Since: 2.28
+Since: 2.26
</description>
<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_closure">
+<parameter_description> #GClosure to invoke when @name is
+acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_closure">
+<parameter_description> #GClosure to invoke when @name is lost or
+%NULL.
+</parameter_description>
+</parameter>
</parameters>
-<return> a newly created #GSettingsBackend
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
</return>
</function>
-<function name="g_mount_can_eject">
+<function name="g_bus_own_name_with_closures">
<description>
-Checks if @mount can be eject.
+Version of g_bus_own_name() using closures instead of callbacks for
+easier binding in other languages.
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="bus_type">
+<parameter_description> The type of bus to own a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The well-known name to own.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> A set of flags from the #GBusNameOwnerFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="bus_acquired_closure">
+<parameter_description> #GClosure to invoke when connected to
+the bus of type @bus_type or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_acquired_closure">
+<parameter_description> #GClosure to invoke when @name is
+acquired or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_lost_closure">
+<parameter_description> #GClosure to invoke when @name is lost or
+%NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @mount can be ejected.
+<return> An identifier (never 0) that an be used with
+g_bus_unown_name() to stop owning the name.
+
</return>
</function>
-<function name="g_mount_can_unmount">
+<function name="g_bus_unown_name">
<description>
-Checks if @mount can be mounted.
+Stops owning a name.
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="owner_id">
+<parameter_description> An identifier obtained from g_bus_own_name()
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the @mount can be unmounted.
-</return>
+<return></return>
</function>
-<function name="g_mount_eject">
+<function name="g_bus_unwatch_name">
<description>
-Ejects a mount. This is an asynchronous operation, and is
-finished by calling g_mount_eject_finish() with the @mount
-and #GAsyncResult data returned in the @callback.
+Stops watching a name.
-Deprecated: 2.22: Use g_mount_eject_with_operation() instead.
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for eject
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="watcher_id">
+<parameter_description> An identifier obtained from g_bus_watch_name()
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_mount_eject_finish">
+<function name="g_bus_watch_name">
<description>
-Finishes ejecting a mount. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Starts watching @name on the bus specified by @bus_type and calls
+ name_appeared_handler and @name_vanished_handler when the name is
+known to have a owner respectively known to lose its
+owner. Callbacks will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this function from.
-Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
+You are guaranteed that one of the handlers will be invoked after
+calling this function. When you are done watching the name, just
+call g_bus_unwatch_name() with the watcher id this function
+returns.
+
+If the name vanishes or appears (for example the application owning
+the name could restart), the handlers are also invoked. If the
+#GDBusConnection that is used for watching the name disconnects, then
+ name_vanished_handler is invoked since it is no longer
+possible to access the name.
+
+Another guarantee is that invocations of @name_appeared_handler
+and @name_vanished_handler are guaranteed to alternate; that
+is, if @name_appeared_handler is invoked then you are
+guaranteed that the next time one of the handlers is invoked, it
+will be @name_vanished_handler. The reverse is also true.
+
+This behavior makes it very simple to write applications that wants
+to take action when a certain name exists, see <xref
+linkend="gdbus-watching-names"/>. Basically, the application
+should create object proxies in @name_appeared_handler and destroy
+them again (if any) in @name_vanished_handler.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="bus_type">
+<parameter_description> The type of bus to watch a name on.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_handler">
+<parameter_description> Handler to invoke when @name is known to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_handler">
+<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
</return>
</function>
-<function name="g_mount_eject_with_operation">
+<function name="g_bus_watch_name_on_connection">
<description>
-Ejects a mount. This is an asynchronous operation, and is
-finished by calling g_mount_eject_with_operation_finish() with the @mount
-and #GAsyncResult data returned in the @callback.
+Like g_bus_watch_name() but takes a #GDBusConnection instead of a
+#GBusType.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the unmount if required for eject
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
</parameter_description>
</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="name_appeared_handler">
+<parameter_description> Handler to invoke when @name is known to exist or %NULL.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter name="name_vanished_handler">
+<parameter_description> Handler to invoke when @name is known to not exist or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter_description> User data to pass to handlers.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function for freeing @user_data or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
+</return>
</function>
-<function name="g_mount_eject_with_operation_finish">
+<function name="g_bus_watch_name_on_connection_with_closures">
<description>
-Finishes ejecting a mount. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
+easier binding in other languages.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to not exist or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
</return>
</function>
-<function name="g_mount_get_default_location">
+<function name="g_bus_watch_name_with_closures">
<description>
-Gets the default location of @mount. The default location of the given
- mount is a path that reflects the main entry point for the user (e.g.
-the home directory, or the root of the volume).
+Version of g_bus_watch_name() using closures instead of callbacks for
+easier binding in other languages.
+Since: 2.26
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="bus_type">
+<parameter_description> The type of bus to watch a name on.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name (well-known or unique) to watch.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GBusNameWatcherFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name_appeared_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to exist or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name_vanished_closure">
+<parameter_description> #GClosure to invoke when @name is known
+to not exist or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile.
-The returned object should be unreffed with
-g_object_unref() when no longer needed.
+<return> An identifier (never 0) that an be used with
+g_bus_unwatch_name() to stop watching the name.
+
</return>
</function>
-<function name="g_mount_get_drive">
+<function name="g_cancellable_cancel">
<description>
-Gets the drive for the @mount.
+Will set @cancellable to cancelled, and will emit the
+#GCancellable::cancelled signal. (However, see the warning about
+race conditions in the documentation for that signal if you are
+planning to connect to it.)
-This is a convenience method for getting the #GVolume and then
-using that object to get the #GDrive.
+This function is thread-safe. In other words, you can safely call
+it from a thread other than the one running the operation that was
+passed the @cancellable.
+The convention within gio is that cancelling an asynchronous
+operation causes it to complete asynchronously. That is, if you
+cancel the operation from the same thread in which it is running,
+then the operation's #GAsyncReadyCallback will not be invoked until
+the application returns to the main loop.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object.
</parameter_description>
</parameter>
</parameters>
-<return> a #GDrive or %NULL if @mount is not associated with a volume or a drive.
-The returned object should be unreffed with
-g_object_unref() when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_mount_get_icon">
+<function name="g_cancellable_connect">
<description>
-Gets the icon for @mount.
+Convenience function to connect to the #GCancellable::cancelled
+signal. Also handles the race condition that may happen
+if the cancellable is cancelled right before connecting.
+
+ callback is called at most once, either directly at the
+time of the connect if @cancellable is already cancelled,
+or when @cancellable is cancelled in some thread.
+ data_destroy_func will be called when the handler is
+disconnected, or immediately if the cancellable is already
+cancelled.
+
+See #GCancellable::cancelled for details on how to use this.
+
+Since: 2.22
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> The #GCallback to connect.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Data to pass to @callback.
+</parameter_description>
+</parameter>
+<parameter name="data_destroy_func">
+<parameter_description> Free function for @data or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon.
-The returned object should be unreffed with
-g_object_unref() when no longer needed.
+<return> The id of the signal handler or 0 if @cancellable has already
+been cancelled.
+
</return>
</function>
-<function name="g_mount_get_name">
+<function name="g_cancellable_disconnect">
<description>
-Gets the name of @mount.
+Disconnects a handler from a cancellable instance similar to
+g_signal_handler_disconnect(). Additionally, in the event that a
+signal handler is currently running, this call will block until the
+handler has finished. Calling this function from a
+#GCancellable::cancelled signal handler will therefore result in a
+deadlock.
+
+This avoids a race condition where a thread cancels at the
+same time as the cancellable operation is finished and the
+signal handler is removed. See #GCancellable::cancelled for
+details on how to use this.
+
+If @cancellable is %NULL or @handler_id is %0 this function does
+nothing.
+Since: 2.22
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="handler_id">
+<parameter_description> Handler id of the handler to be disconnected, or %0.
</parameter_description>
</parameter>
</parameters>
-<return> the name for the given @mount.
-The returned string should be freed with g_free()
-when no longer needed.
-</return>
+<return></return>
</function>
-<function name="g_mount_get_root">
+<function name="g_cancellable_get_current">
<description>
-Gets the root directory on @mount.
+Gets the top cancellable from the stack.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
</parameters>
-<return> a #GFile.
-The returned object should be unreffed with
-g_object_unref() when no longer needed.
+<return> a #GCancellable from the top of the stack, or %NULL
+if the stack is empty.
</return>
</function>
-<function name="g_mount_get_uuid">
+<function name="g_cancellable_get_fd">
<description>
-Gets the UUID for the @mount. The reference is typically based on
-the file system UUID for the mount in question and should be
-considered an opaque string. Returns %NULL if there is no UUID
-available.
+Gets the file descriptor for a cancellable job. This can be used to
+implement cancellable operations on Unix systems. The returned fd will
+turn readable when @cancellable is cancelled.
+
+You are not supposed to read from the fd yourself, just check for
+readable status. Reading to unset the readable status is done
+with g_cancellable_reset().
+
+After a successful return from this function, you should use
+g_cancellable_release_fd() to free up resources allocated for
+the returned file descriptor.
+
+See also g_cancellable_make_pollfd().
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable.
</parameter_description>
</parameter>
</parameters>
-<return> the UUID for @mount or %NULL if no UUID can be computed.
-The returned string should be freed with g_free()
-when no longer needed.
+<return> A valid file descriptor. %-1 if the file descriptor
+is not supported, or on errors.
</return>
</function>
-<function name="g_mount_get_volume">
+<function name="g_cancellable_is_cancelled">
<description>
-Gets the volume for the @mount.
+Checks if a cancellable job has been cancelled.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GVolume or %NULL if @mount is not associated with a volume.
-The returned object should be unreffed with
-g_object_unref() when no longer needed.
+<return> %TRUE if @cancellable is cancelled,
+FALSE if called with %NULL or if item is not cancelled.
</return>
</function>
-<function name="g_mount_guess_content_type">
+<function name="g_cancellable_make_pollfd">
<description>
-Tries to guess the type of content stored on @mount. Returns one or
-more textual identifiers of well-known content types (typically
-prefixed with "x-content/"), e.g. x-content/image-dcf for camera
-memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
-specification for more on x-content types.
+Creates a #GPollFD corresponding to @cancellable; this can be passed
+to g_poll() and used to poll for cancellation. This is useful both
+for unix systems without a native poll and for portability to
+windows.
-This is an asynchronous operation (see
-g_mount_guess_content_type_sync() for the synchronous version), and
-is finished by calling g_mount_guess_content_type_finish() with the
- mount and #GAsyncResult data returned in the @callback.
+When this function returns %TRUE, you should use
+g_cancellable_release_fd() to free up resources allocated for the
+ pollfd After a %FALSE return, do not call g_cancellable_release_fd().
-Since: 2.18
+If this function returns %FALSE, either no @cancellable was given or
+resource limits prevent this function from allocating the necessary
+structures for polling. (On Linux, you will likely have reached
+the maximum number of file descriptors.) The suggested way to handle
+these cases is to ignore the @cancellable.
+
+You are not supposed to read from the fd yourself, just check for
+readable status. Reading to unset the readable status is done
+with g_cancellable_reset().
+
+Since: 2.22
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount
-</parameter_description>
-</parameter>
-<parameter name="force_rescan">
-<parameter_description> Whether to force a rescan of the content.
-Otherwise a cached result will be used if available
-</parameter_description>
-</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter_description> a #GCancellable or %NULL
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback
+<parameter name="pollfd">
+<parameter_description> a pointer to a #GPollFD
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @pollfd was successfully initialized, %FALSE on
+failure to prepare the cancellable.
+
+</return>
</function>
-<function name="g_mount_guess_content_type_finish">
+<function name="g_cancellable_new">
<description>
-Finishes guessing content types of @mount. If any errors occured
-during the operation, @error will be set to contain the errors and
-%FALSE will be returned. In particular, you may get an
-%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
-guessing.
+Creates a new #GCancellable object.
+
+Applications that want to start one or more operations
+that should be cancellable should create a #GCancellable
+and pass it to the operations.
+
+One #GCancellable can be used in multiple consecutive
+operations or in multiple concurrent operations.
-Since: 2.18
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore
-</parameter_description>
-</parameter>
</parameters>
-<return> a %NULL-terminated array of content types or %NULL on error.
-Caller should free this array with g_strfreev() when done with it.
-
+<return> a #GCancellable.
</return>
</function>
-<function name="g_mount_guess_content_type_sync">
+<function name="g_cancellable_pop_current">
<description>
-Tries to guess the type of content stored on @mount. Returns one or
-more textual identifiers of well-known content types (typically
-prefixed with "x-content/"), e.g. x-content/image-dcf for camera
-memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
-specification for more on x-content types.
-
-This is an synchronous operation and as such may block doing IO;
-see g_mount_guess_content_type() for the asynchronous version.
-
-Since: 2.18
+Pops @cancellable off the cancellable stack (verifying that @cancellable
+is on the top of the stack).
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount
-</parameter_description>
-</parameter>
-<parameter name="force_rescan">
-<parameter_description> Whether to force a rescan of the content.
-Otherwise a cached result will be used if available
-</parameter_description>
-</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore
+<parameter_description> a #GCancellable object
</parameter_description>
</parameter>
</parameters>
-<return> a %NULL-terminated array of content types or %NULL on error.
-Caller should free this array with g_strfreev() when done with it.
-
-</return>
+<return></return>
</function>
-<function name="g_mount_is_shadowed">
+<function name="g_cancellable_push_current">
<description>
-Determines if @mount is shadowed. Applications or libraries should
-avoid displaying @mount in the user interface if it is shadowed.
-
-A mount is said to be shadowed if there exists one or more user
-visible objects (currently #GMount objects) with a root that is
-inside the root of @mount.
-
-One application of shadow mounts is when exposing a single file
-system that is used to address several logical volumes. In this
-situation, a #GVolumeMonitor implementation would create two
-#GVolume objects (for example, one for the camera functionality of
-the device and one for a SD card reader on the device) with
-activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal>
-and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the
-underlying mount (with root
-<literal>gphoto2://[usb:001,002]/</literal>) is mounted, said
-#GVolumeMonitor implementation would create two #GMount objects
-(each with their root matching the corresponding volume activation
-root) that would shadow the original mount.
+Pushes @cancellable onto the cancellable stack. The current
+cancellable can then be received using g_cancellable_get_current().
-The proxy monitor in GVfs 2.26 and later, automatically creates and
-manage shadow mounts (and shadows the underlying mount) if the
-activation root on a #GVolume is set.
+This is useful when implementing cancellable operations in
+code that does not allow you to pass down the cancellable object.
-Since: 2.20
+This is typically called automatically by e.g. #GFile operations,
+so you rarely have to call this yourself.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> A #GMount.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @mount is shadowed.
-
-</return>
+<return></return>
</function>
-<function name="g_mount_operation_get_anonymous">
+<function name="g_cancellable_release_fd">
<description>
-Check to see whether the mount operation is being used
-for an anonymous user.
+Releases a resources previously allocated by g_cancellable_get_fd()
+or g_cancellable_make_pollfd().
+
+For compatibility reasons with older releases, calling this function
+is not strictly required, the resources will be automatically freed
+when the @cancellable is finalized. However, the @cancellable will
+block scarce file descriptors until it is finalized if this function
+is not called. This can cause the application to run out of file
+descriptors when many #GCancellables are used at the same time.
+Since: 2.22
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if mount operation is anonymous.
-</return>
+<return></return>
</function>
-<function name="g_mount_operation_get_choice">
+<function name="g_cancellable_reset">
<description>
-Gets a choice from the mount operation.
+Resets @cancellable to its uncancelled state.
+If cancellable is currently in use by any cancellable operation
+then the behavior of this function is undefined.
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable object.
</parameter_description>
</parameter>
</parameters>
-<return> an integer containing an index of the user's choice from
-the choice's list, or %0.
-</return>
+<return></return>
</function>
-<function name="g_mount_operation_get_domain">
+<function name="g_cancellable_set_error_if_cancelled">
<description>
-Gets the domain of the mount operation.
+If the @cancellable is cancelled, sets the error to notify
+that the operation was cancelled.
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError to append error state to
</parameter_description>
</parameter>
</parameters>
-<return> a string set to the domain.
+<return> %TRUE if @cancellable was cancelled, %FALSE if it was not
</return>
</function>
-<function name="g_mount_operation_get_password">
+<function name="g_cancellable_source_new">
<description>
-Gets a password from the mount operation.
+Creates a source that triggers if @cancellable is cancelled and
+calls its callback of type #GCancellableSourceFunc. This is
+primarily useful for attaching to another (non-cancellable) source
+with g_source_add_child_source() to add cancellability to it.
+For convenience, you can call this with a %NULL #GCancellable,
+in which case the source will never trigger.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the password within @op.
+<return> the new #GSource.
+
</return>
</function>
-<function name="g_mount_operation_get_password_save">
+<function name="g_charset_converter_get_num_fallbacks">
<description>
-Gets the state of saving passwords for the mount operation.
+Gets the number of fallbacks that @converter has applied so far.
+Since: 2.24
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
</parameter_description>
</parameter>
</parameters>
-<return> a #GPasswordSave flag.
+<return> the number of fallbacks that @converter has applied
+
</return>
</function>
-<function name="g_mount_operation_get_username">
+<function name="g_charset_converter_get_use_fallback">
<description>
-Get the user name from the mount operation.
+Gets the #GCharsetConverter:use-fallback property.
+Since: 2.24
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the user name.
-</return>
-</function>
-
-<function name="g_mount_operation_new">
-<description>
-Creates a new mount operation.
-
+<return> %TRUE if fallbacks are used by @converter
-</description>
-<parameters>
-</parameters>
-<return> a #GMountOperation.
</return>
</function>
-<function name="g_mount_operation_reply">
+<function name="g_charset_converter_new">
<description>
-Emits the #GMountOperation::reply signal.
-
-</description>
-<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GMountOperationResult
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+Creates a new #GCharsetConverter.
-<function name="g_mount_operation_set_anonymous">
-<description>
-Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
+Since: 2.24
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
-</parameter_description>
-</parameter>
-<parameter name="anonymous">
-<parameter_description> boolean value.
+<parameter name="to_charset">
+<parameter_description> destination charset
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_mount_operation_set_choice">
-<description>
-Sets a default choice for the mount operation.
-
-</description>
-<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="from_charset">
+<parameter_description> source charset
</parameter_description>
</parameter>
-<parameter name="choice">
-<parameter_description> an integer.
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GCharsetConverter or %NULL on error.
+
+</return>
</function>
-<function name="g_mount_operation_set_domain">
+<function name="g_charset_converter_set_use_fallback">
<description>
-Sets the mount operation's domain.
+Sets the #GCharsetConverter:use-fallback property.
+
+Since: 2.24
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="converter">
+<parameter_description> a #GCharsetConverter
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> the domain to set.
+<parameter name="use_fallback">
+<parameter_description> %TRUE to use fallbacks
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_mount_operation_set_password">
+<function name="g_content_type_can_be_executable">
<description>
-Sets the mount operation's password to @password.
+Checks if a content type can be executable. Note that for instance
+things like text files can be executables (i.e. scripts and batch files).
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
-</parameter_description>
-</parameter>
-<parameter name="password">
-<parameter_description> password to set.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the file type corresponds to a type that
+can be executable, %FALSE otherwise.
+</return>
</function>
-<function name="g_mount_operation_set_password_save">
+<function name="g_content_type_equals">
<description>
-Sets the state of saving passwords for the mount operation.
+Compares two content types for equality.
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
+<parameter name="type1">
+<parameter_description> a content type string
</parameter_description>
</parameter>
-<parameter name="save">
-<parameter_description> a set of #GPasswordSave flags.
+<parameter name="type2">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the two strings are identical or equivalent,
+%FALSE otherwise.
+</return>
</function>
-<function name="g_mount_operation_set_username">
+<function name="g_content_type_from_mime_type">
<description>
-Sets the user name within @op to @username.
+Tries to find a content type based on the mime type name.
+
+Since: 2.18
</description>
<parameters>
-<parameter name="op">
-<parameter_description> a #GMountOperation.
-</parameter_description>
-</parameter>
-<parameter name="username">
-<parameter_description> input username.
+<parameter name="mime_type">
+<parameter_description> a mime type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> Newly allocated string with content type
+or %NULL. Free with g_free()
+
+</return>
</function>
-<function name="g_mount_remount">
+<function name="g_content_type_get_description">
<description>
-Remounts a mount. This is an asynchronous operation, and is
-finished by calling g_mount_remount_finish() with the @mount
-and #GAsyncResults data returned in the @callback.
+Gets the human readable description of the content type.
-Remounting is useful when some setting affecting the operation
-of the volume has been changed, as these may need a remount to
-take affect. While this is semantically equivalent with unmounting
-and then remounting not all backends might need to actually be
-unmounted.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a short description of the content type @type. Free the
+returned string with g_free()
+</return>
</function>
-<function name="g_mount_remount_finish">
+<function name="g_content_type_get_icon">
<description>
-Finishes remounting a mount. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Gets the icon for a content type.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the mount was successfully remounted. %FALSE otherwise.
+<return> #GIcon corresponding to the content type. Free the returned
+object with g_object_unref()
</return>
</function>
-<function name="g_mount_shadow">
+<function name="g_content_type_get_mime_type">
<description>
-Increments the shadow count on @mount. Usually used by
-#GVolumeMonitor implementations when creating a shadow mount for
- mount, see g_mount_is_shadowed() for more information. The caller
-will need to emit the #GMount::changed signal on @mount manually.
+Gets the mime type for the content type, if one is registered.
-Since: 2.20
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> A #GMount.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the registered mime type for the given @type,
+or %NULL if unknown.
+</return>
</function>
-<function name="g_mount_unmount">
+<function name="g_content_type_guess">
<description>
-Unmounts a mount. This is an asynchronous operation, and is
-finished by calling g_mount_unmount_finish() with the @mount
-and #GAsyncResult data returned in the @callback.
+Guesses the content type based on example data. If the function is
+uncertain, @result_uncertain will be set to %TRUE. Either @filename
+or @data may be %NULL, in which case the guess will be based solely
+on the other argument.
-Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
+<parameter name="filename">
+<parameter_description> a string, or %NULL
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="data">
+<parameter_description> a stream of data, or %NULL
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter name="data_size">
+<parameter_description> the size of @data
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="result_uncertain">
+<parameter_description> return location for the certainty
+of the result, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a string indicating a guessed content type for the
+given data. Free with g_free()
+</return>
</function>
-<function name="g_mount_unmount_finish">
+<function name="g_content_type_guess_for_tree">
<description>
-Finishes unmounting a mount. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Tries to guess the type of the tree with root @root, by
+looking at the files it contains. The result is an array
+of content types, with the best guess coming first.
-Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
+The types returned all have the form x-content/foo, e.g.
+x-content/audio-cdda (for audio CDs) or x-content/image-dcf
+(for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
+specification for more on x-content types.
+
+This function is useful in the implementation of
+g_mount_guess_content_type().
+
+Since: 2.18
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="root">
+<parameter_description> the root of the tree to guess a type for
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
+<return> an %NULL-terminated
+array of zero or more content types. Free with g_strfreev()
</return>
</function>
-<function name="g_mount_unmount_with_operation">
+<function name="g_content_type_is_a">
<description>
-Unmounts a mount. This is an asynchronous operation, and is
-finished by calling g_mount_unmount_with_operation_finish() with the @mount
-and #GAsyncResult data returned in the @callback.
+Determines if @type is a subset of @supertype.
-Since: 2.22
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> flags affecting the operation
-</parameter_description>
-</parameter>
-<parameter name="mount_operation">
-<parameter_description> a #GMountOperation or %NULL to avoid
-user interaction.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback, or %NULL.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="supertype">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @type is a kind of @supertype,
+%FALSE otherwise.
+</return>
</function>
-<function name="g_mount_unmount_with_operation_finish">
+<function name="g_content_type_is_unknown">
<description>
-Finishes unmounting a mount. If any errors occurred during the operation,
- error will be set to contain the errors and %FALSE will be returned.
+Checks if the content type is the generic "unknown" type.
+On UNIX this is the "application/octet-stream" mimetype,
+while on win32 it is "*".
-Since: 2.22
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> a #GMount.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="type">
+<parameter_description> a content type string
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
-
+<return> %TRUE if the type is the unknown type.
</return>
</function>
-<function name="g_mount_unshadow">
+<function name="g_content_types_get_registered">
<description>
-Decrements the shadow count on @mount. Usually used by
-#GVolumeMonitor implementations when destroying a shadow mount for
- mount, see g_mount_is_shadowed() for more information. The caller
-will need to emit the #GMount::changed signal on @mount manually.
+Gets a list of strings containing all the registered content types
+known to the system. The list and its data should be freed using
+<programlisting>
+g_list_free_full (list, g_free);
+</programlisting>
-Since: 2.20
</description>
<parameters>
-<parameter name="mount">
-<parameter_description> A #GMount.
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> #GList of the registered content types
+</return>
</function>
-<function name="g_network_address_get_hostname">
+<function name="g_converter_convert">
<description>
-Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
-depending on what @addr was created with.
+This is the main operation used when converting data. It is to be called
+multiple times in a loop, and each time it will do some work, i.e.
+producing some output (in @outbuf) or consuming some input (from @inbuf) or
+both. If its not possible to do any work an error is returned.
-Since: 2.22
+Note that a single call may not consume all input (or any input at all).
+Also a call may produce output even if given no input, due to state stored
+in the converter producing output.
+
+If any data was either produced or consumed, and then an error happens, then
+only the successful conversion is reported and the error is returned on the
+next call.
+
+A full conversion loop involves calling this method repeatedly, each time
+giving it new input and space output space. When there is no more input
+data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
+The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
+each time until all data is consumed and all output is produced, then
+%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
+may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
+in a decompression converter where the end of data is detectable from the
+data (and there might even be other data after the end of the compressed data).
+
+When some data has successfully been converted @bytes_read and is set to
+the number of bytes read from @inbuf, and @bytes_written is set to indicate
+how many bytes was written to @outbuf. If there are more data to output
+or consume (i.e. unless the %G_CONVERTER_INPUT_AT_END is specified) then
+%G_CONVERTER_CONVERTED is returned, and if no more data is to be output
+then %G_CONVERTER_FINISHED is returned.
+
+On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
+Some errors need special handling:
+
+%G_IO_ERROR_NO_SPACE is returned if there is not enough space
+to write the resulting converted data, the application should
+call the function again with a larger @outbuf to continue.
+
+%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
+input to fully determine what the conversion should produce,
+and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
+example with an incomplete multibyte sequence when converting text,
+or when a regexp matches up to the end of the input (and may match
+further input). It may also happen when @inbuf_size is zero and
+there is no more data to produce.
+
+When this happens the application should read more input and then
+call the function again. If further input shows that there is no
+more data call the function again with the same data but with
+the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
+to finish as e.g. in the regexp match case (or, to fail again with
+%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
+input is actually partial).
+
+After g_converter_convert() has returned %G_CONVERTER_FINISHED the
+converter object is in an invalid state where its not allowed
+to call g_converter_convert() anymore. At this time you can only
+free the object or call g_converter_reset() to reset it to the
+initial state.
+
+If the flag %G_CONVERTER_FLUSH is set then conversion is modified
+to try to write out all internal state to the output. The application
+has to call the function multiple times with the flag set, and when
+the available input has been consumed and all internal state has
+been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
+really at the end) is returned instead of %G_CONVERTER_CONVERTED.
+This is somewhat similar to what happens at the end of the input stream,
+but done in the middle of the data.
+
+This has different meanings for different conversions. For instance
+in a compression converter it would mean that we flush all the
+compression state into output such that if you uncompress the
+compressed data you get back all the input data. Doing this may
+make the final file larger due to padding though. Another example
+is a regexp conversion, where if you at the end of the flushed data
+have a match, but there is also a potential longer match. In the
+non-flushed case we would ask for more input, but when flushing we
+treat this as the end of input and do the match.
+
+Flushing is not always possible (like if a charset converter flushes
+at a partial multibyte sequence). Converters are supposed to try
+to produce as much output as possible and then return an error
+(typically %G_IO_ERROR_PARTIAL_INPUT).
+
+Since: 2.24
</description>
<parameters>
-<parameter name="addr">
-<parameter_description> a #GNetworkAddress
+<parameter name="converter">
+<parameter_description> a #GConverter.
+</parameter_description>
+</parameter>
+<parameter name="inbuf">
+<parameter_description> the buffer
+containing the data to convert.
+</parameter_description>
+</parameter>
+<parameter name="inbuf_size">
+<parameter_description> the number of bytes in @inbuf
+</parameter_description>
+</parameter>
+<parameter name="outbuf">
+<parameter_description> a buffer to write converted data in.
+</parameter_description>
+</parameter>
+<parameter name="outbuf_size">
+<parameter_description> the number of bytes in @outbuf, must be at least one
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GConvertFlags controlling the conversion details
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> will be set to the number of bytes read from @inbuf on success
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> will be set to the number of bytes written to @outbuf on success
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
</parameter_description>
</parameter>
</parameters>
-<return> @addr's hostname
+<return> a #GConverterResult, %G_CONVERTER_ERROR on error.
</return>
</function>
-<function name="g_network_address_get_port">
+<function name="g_converter_input_stream_get_converter">
<description>
-Gets @addr's port number
+Gets the #GConverter that is used by @converter_stream.
-Since: 2.22
+Since: 2.24
</description>
<parameters>
-<parameter name="addr">
-<parameter_description> a #GNetworkAddress
+<parameter name="converter_stream">
+<parameter_description> a #GConverterInputStream
</parameter_description>
</parameter>
</parameters>
-<return> @addr's port (which may be 0)
+<return> the converter of the converter input stream
</return>
</function>
-<function name="g_network_address_get_scheme">
+<function name="g_converter_input_stream_new">
<description>
-Gets @addr's scheme
+Creates a new converter input stream for the @base_stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="addr">
-<parameter_description> a #GNetworkAddress
+<parameter name="base_stream">
+<parameter_description> a #GInputStream
+</parameter_description>
+</parameter>
+<parameter name="converter">
+<parameter_description> a #GConverter
</parameter_description>
</parameter>
</parameters>
-<return> @addr's scheme (%NULL if not built from URI)
-
+<return> a new #GInputStream.
</return>
</function>
-<function name="g_network_address_new">
+<function name="g_converter_output_stream_get_converter">
<description>
-Creates a new #GSocketConnectable for connecting to the given
- hostname and @port.
+Gets the #GConverter that is used by @converter_stream.
-Since: 2.22
+Since: 2.24
</description>
<parameters>
-<parameter name="hostname">
-<parameter_description> the hostname
-</parameter_description>
-</parameter>
-<parameter name="port">
-<parameter_description> the port
+<parameter name="converter_stream">
+<parameter_description> a #GConverterOutputStream
</parameter_description>
</parameter>
</parameters>
-<return> the new #GNetworkAddress
+<return> the converter of the converter output stream
</return>
</function>
-<function name="g_network_address_parse">
+<function name="g_converter_output_stream_new">
<description>
-Creates a new #GSocketConnectable for connecting to the given
- hostname and @port. May fail and return %NULL in case
-parsing @host_and_port fails.
-
- host_and_port may be in any of a number of recognised formats; an IPv6
-address, an IPv4 address, or a domain name (in which case a DNS
-lookup is performed). Quoting with [] is supported for all address
-types. A port override may be specified in the usual way with a
-colon. Ports may be given as decimal numbers or symbolic names (in
-which case an /etc/services lookup is performed).
-
-If no port is specified in @host_and_port then @default_port will be
-used as the port number to connect to.
-
-In general, @host_and_port is expected to be provided by the user
-(allowing them to give the hostname, and a port overide if necessary)
-and @default_port is expected to be provided by the application.
+Creates a new converter output stream for the @base_stream.
-Since: 2.22
</description>
<parameters>
-<parameter name="host_and_port">
-<parameter_description> the hostname and optionally a port
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream
</parameter_description>
</parameter>
-<parameter name="default_port">
-<parameter_description> the default port if not in @host_and_port
+<parameter name="converter">
+<parameter_description> a #GConverter
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a #GError, or %NULL
+</parameters>
+<return> a new #GOutputStream.
+</return>
+</function>
+
+<function name="g_converter_reset">
+<description>
+Resets all internal state in the converter, making it behave
+as if it was just created. If the converter has any internal
+state that would produce output then that output is lost.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="converter">
+<parameter_description> a #GConverter.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GNetworkAddress, or %NULL on error
-
-</return>
+<return></return>
</function>
-<function name="g_network_address_parse_uri">
+<function name="g_credentials_get_native">
<description>
-Creates a new #GSocketConnectable for connecting to the given
- uri May fail and return %NULL in case parsing @uri fails.
+Gets a pointer to native credentials of type @native_type from
+ credentials
-Using this rather than g_network_address_new() or
-g_network_address_parse_host() allows #GSocketClient to determine
-when to use application-specific proxy protocols.
+It is a programming error (which will cause an warning to be
+logged) to use this method if there is no #GCredentials support for
+the OS or if @native_type isn't supported by the OS.
Since: 2.26
</description>
<parameters>
-<parameter name="uri">
-<parameter_description> the hostname and optionally a port
-</parameter_description>
-</parameter>
-<parameter name="default_port">
-<parameter_description> The default port if none is found in the URI
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a #GError, or %NULL
+<parameter name="native_type">
+<parameter_description> The type of native credentials to get.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GNetworkAddress, or %NULL on error
+<return> The pointer to native credentials or %NULL if the
+operation there is no #GCredentials support for the OS or if
+ native_type isn't supported by the OS. Do not free the returned
+data, it is owned by @credentials.
</return>
</function>
-<function name="g_network_service_get_domain">
+<function name="g_credentials_get_unix_user">
<description>
-Gets the domain that @srv serves. This might be either UTF-8 or
-ASCII-encoded, depending on what @srv was created with.
+Tries to get the UNIX user identifier from @credentials. This
+method is only available on UNIX platforms.
-Since: 2.22
+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 user.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
+<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> @srv's domain name
+<return> The UNIX user identifier or -1 if @error is set.
</return>
</function>
-<function name="g_network_service_get_protocol">
+<function name="g_credentials_is_same_user">
<description>
-Gets @srv's protocol name (eg, "tcp").
+Checks if @credentials and @other_credentials is the same user.
-Since: 2.22
+This operation can fail if #GCredentials is not supported on the
+the OS.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="other_credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> @srv's protocol name
+<return> %TRUE if @credentials and @other_credentials has the same
+user, %FALSE otherwise or if @error is set.
</return>
</function>
-<function name="g_network_service_get_scheme">
+<function name="g_credentials_new">
<description>
-Get's the URI scheme used to resolve proxies. By default, the service name
-is used as scheme.
+Creates a new #GCredentials object with credentials matching the
+the current process.
Since: 2.26
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
-</parameter_description>
-</parameter>
</parameters>
-<return> @srv's scheme name
+<return> A #GCredentials. Free with g_object_unref().
</return>
</function>
-<function name="g_network_service_get_service">
+<function name="g_credentials_set_native">
<description>
-Gets @srv's service name (eg, "ldap").
+Copies the native credentials of type @native_type from @native
+into @credentials.
-Since: 2.22
+It is a programming error (which will cause an warning to be
+logged) to use this method if there is no #GCredentials support for
+the OS or if @native_type isn't supported by the OS.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
+</parameter_description>
+</parameter>
+<parameter name="native_type">
+<parameter_description> The type of native credentials to set.
+</parameter_description>
+</parameter>
+<parameter name="native">
+<parameter_description> A pointer to native credentials.
</parameter_description>
</parameter>
</parameters>
-<return> @srv's service name
-
-</return>
+<return></return>
</function>
-<function name="g_network_service_new">
+<function name="g_credentials_set_unix_user">
<description>
-Creates a new #GNetworkService representing the given @service,
- protocol, and @domain. This will initially be unresolved; use the
-#GSocketConnectable interface to resolve it.
+Tries to set the UNIX user identifier on @credentials. This method
+is only available on UNIX platforms.
-Since: 2.22
+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 user.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="service">
-<parameter_description> the service type to look up (eg, "ldap")
+<parameter name="credentials">
+<parameter_description> A #GCredentials.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> the networking protocol to use for @service (eg, "tcp")
+<parameter name="uid">
+<parameter_description> The UNIX user identifier to set.
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> the DNS domain to look up the service in
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GNetworkService
+<return> %TRUE if @uid was set, %FALSE if error is set.
</return>
</function>
-<function name="g_network_service_set_scheme">
+<function name="g_credentials_to_string">
<description>
-Set's the URI scheme used to resolve proxies. By default, the service name
-is used as scheme.
+Creates a human-readable textual representation of @credentials
+that can be used in logging and debug messages. The format of the
+returned string may change in future GLib release.
Since: 2.26
</description>
<parameters>
-<parameter name="srv">
-<parameter_description> a #GNetworkService
-</parameter_description>
-</parameter>
-<parameter name="scheme">
-<parameter_description> a URI scheme
+<parameter name="credentials">
+<parameter_description> A #GCredentials object.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A string that should be freed with g_free().
+
+</return>
</function>
-<function name="g_null_settings_backend_new">
+<function name="g_data_input_stream_get_byte_order">
<description>
-Creates a readonly #GSettingsBackend.
-
-This backend does not allow changes to settings, so all settings
-will always have their default values.
+Gets the byte order for the data input stream.
-Since: 2.28
</description>
<parameters>
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
</parameters>
-<return> a newly created #GSettingsBackend
-
+<return> the @stream's current #GDataStreamByteOrder.
</return>
</function>
-<function name="g_output_stream_clear_pending">
+<function name="g_data_input_stream_get_newline_type">
<description>
-Clears the pending flag on @stream.
+Gets the current newline type for the @stream.
+
</description>
<parameters>
<parameter name="stream">
-<parameter_description> output stream
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> #GDataStreamNewlineType for the given @stream.
+</return>
</function>
-<function name="g_output_stream_close">
+<function name="g_data_input_stream_new">
<description>
-Closes the stream, releasing resources related to it.
-
-Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
-Closing a stream multiple times will not return an error.
-
-Closing a stream will automatically flush any outstanding buffers in the
-stream.
-
-Streams will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
-
-Some streams might keep the backing store of the stream (e.g. a file descriptor)
-open after the stream is closed. See the documentation for the individual
-stream for details.
-
-On failure the first error that happened will be reported, but the close
-operation will finish as much as possible. A stream that failed to
-close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
-is important to check and report the error to the user, otherwise
-there might be a loss of data as all data might not be written.
-
-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.
-Cancelling a close will still leave the stream closed, but there some streams
-can use a faster close that doesn't block to e.g. check errors. On
-cancellation (as with any error) there is no guarantee that all written
-data will reach the target.
+Creates a new data input stream for the @base_stream.
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> A #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional cancellable object
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter name="base_stream">
+<parameter_description> a #GInputStream.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure
+<return> a new #GDataInputStream.
</return>
</function>
-<function name="g_output_stream_close_async">
+<function name="g_data_input_stream_read_byte">
<description>
-Requests an asynchronous close of the stream, releasing resources
-related to it. When the operation is finished @callback will be
-called. You can then call g_output_stream_close_finish() to get
-the result of the operation.
-
-For behaviour details see g_output_stream_close().
+Reads an unsigned 8-bit/1-byte value from @stream.
-The asyncronous methods have a default fallback that uses threads
-to implement asynchronicity, so they are optional for inheriting
-classes. However, if you override one you must override all.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> A #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional cancellable object
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> an unsigned 8-bit/1-byte value read from the @stream or %0
+if an error occurred.
+</return>
</function>
-<function name="g_output_stream_close_finish">
+<function name="g_data_input_stream_read_int16">
<description>
-Closes an output stream.
+Reads a 16-bit/2-byte value from @stream.
+
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if stream was successfully closed, %FALSE otherwise.
+<return> a signed 16-bit/2-byte value read from @stream or %0 if
+an error occurred.
</return>
</function>
-<function name="g_output_stream_flush">
+<function name="g_data_input_stream_read_int32">
<description>
-Flushed any outstanding buffers in the stream. Will block during
-the operation. Closing the stream will implicitly cause a flush.
+Reads a signed 32-bit/4-byte value from @stream.
-This function is optional for inherited classes.
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
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.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional cancellable object
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error
+<return> a signed 32-bit/4-byte value read from the @stream or %0 if
+an error occurred.
</return>
</function>
-<function name="g_output_stream_flush_async">
+<function name="g_data_input_stream_read_int64">
<description>
-Flushes a stream asynchronously.
-For behaviour details see g_output_stream_flush().
+Reads a 64-bit/8-byte value from @stream.
+
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
+
+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.
-When the operation is finished @callback will be
-called. You can then call g_output_stream_flush_finish() to get the
-result of the operation.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="cancellable">
<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a signed 64-bit/8-byte value read from @stream or %0 if
+an error occurred.
+</return>
</function>
-<function name="g_output_stream_flush_finish">
+<function name="g_data_input_stream_read_line">
<description>
-Finishes flushing an output stream.
+Reads a line from the data input stream. Note that no encoding
+checks or conversion is performed; the input is not guaranteed to
+be UTF-8, and may in fact have embedded NUL characters.
+
+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.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a GAsyncResult.
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if flush operation suceeded, %FALSE otherwise.
+<return> a
+NUL terminated byte array with the line that was read in (without
+the newlines). Set @length to a #gsize to get the length of the
+read line. On an error, it will return %NULL and @error will be
+set. If there's no content to read, it will still return %NULL,
+but @error won't be set.
</return>
</function>
-<function name="g_output_stream_has_pending">
+<function name="g_data_input_stream_read_line_async">
<description>
-Checks if an ouput stream has pending actions.
+The asynchronous version of g_data_input_stream_read_line(). It is
+an error to have two outstanding calls to this function.
+
+When the operation is finished, @callback will be called. You
+can then call g_data_input_stream_read_line_finish() to get
+the result of the operation.
+Since: 2.20
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if @stream has pending actions.
-</return>
-</function>
-
-<function name="g_output_stream_is_closed">
-<description>
-Checks if an output stream has already been closed.
-
-
-</description>
-<parameters>
-<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is closed. %FALSE otherwise.
-</return>
+<return></return>
</function>
-<function name="g_output_stream_is_closing">
+<function name="g_data_input_stream_read_line_finish">
<description>
-Checks if an output stream is being closed. This can be
-used inside e.g. a flush implementation to see if the
-flush (or other i/o operation) is called from within
-the closing operation.
+Finish an asynchronous call started by
+g_data_input_stream_read_line_async(). Note the warning about
+string encoding in g_data_input_stream_read_line() applies here as
+well.
-Since: 2.24
+Since: 2.20
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult that was provided to the callback.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is being closed. %FALSE otherwise.
+<return> a
+NUL-terminated byte array with the line that was read in
+(without the newlines). Set @length to a #gsize to get the
+length of the read line. On an error, it will return %NULL and
+ error will be set. If there's no content to read, it will
+still return %NULL, but @error won't be set.
</return>
</function>
-<function name="g_output_stream_set_pending">
+<function name="g_data_input_stream_read_line_finish_utf8">
<description>
-Sets @stream to have actions pending. If the pending flag is
-already set or @stream is closed, it will return %FALSE and set
- error
+Finish an asynchronous call started by
+g_data_input_stream_read_line_async().
+Since: 2.30
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult that was provided to the callback.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if pending was previously unset and is now set.
+<return> a string with the line that was read in
+(without the newlines). Set @length to a #gsize to get the length
+of the read line. On an error, it will return %NULL and @error
+will be set. For UTF-8 conversion errors, the set error domain is
+%G_CONVERT_ERROR. If there's no content to read, it will still
+return %NULL, but @error won't be set.
+
</return>
</function>
-<function name="g_output_stream_splice">
+<function name="g_data_input_stream_read_line_utf8">
<description>
-Splices an input stream into an output stream.
+Reads a UTF-8 encoded line from the data input stream.
+
+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.
+Since: 2.30
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="source">
-<parameter_description> a #GInputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GOutputStreamSpliceFlags.
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -21621,169 +21452,139 @@ Splices an input stream into an output stream.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize containing the size of the data spliced, or
--1 if an error occurred.
+<return> a NUL terminated UTF-8 string with the
+line that was read in (without the newlines). Set @length to a
+#gsize to get the length of the read line. On an error, it will
+return %NULL and @error will be set. For UTF-8 conversion errors,
+the set error domain is %G_CONVERT_ERROR. If there's no content to
+read, it will still return %NULL, but @error won't be set.
+
</return>
</function>
-<function name="g_output_stream_splice_async">
+<function name="g_data_input_stream_read_uint16">
<description>
-Splices a stream asynchronously.
-When the operation is finished @callback will be called.
-You can then call g_output_stream_splice_finish() to get the
-result of the operation.
+Reads an unsigned 16-bit/2-byte value from @stream.
+
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
-For the synchronous, blocking version of this function, see
-g_output_stream_splice().
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="source">
-<parameter_description> a #GInputStream.
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a set of #GOutputStreamSpliceFlags.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="error">
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> an unsigned 16-bit/2-byte value read from the @stream or %0 if
+an error occurred.
+</return>
</function>
-<function name="g_output_stream_splice_finish">
+<function name="g_data_input_stream_read_uint32">
<description>
-Finishes an asynchronous stream splice operation.
+Reads an unsigned 32-bit/4-byte value from @stream.
+
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
+
+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.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize of the number of bytes spliced.
+<return> an unsigned 32-bit/4-byte value read from the @stream or %0 if
+an error occurred.
</return>
</function>
-<function name="g_output_stream_write">
+<function name="g_data_input_stream_read_uint64">
<description>
-Tries to write @count bytes from @buffer into the stream. Will block
-during the operation.
-
-If count is 0, returns 0 and does nothing. A value of @count
-larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+Reads an unsigned 64-bit/8-byte value from @stream.
-On success, the number of bytes written to the stream is returned.
-It is not an error if this is not the same as the requested size, as it
-can happen e.g. on a partial I/O error, or if there is not enough
-storage in the stream. All writes block until at least one byte
-is written or an error occurs; 0 is never returned (unless
- count is 0).
+In order to get the correct byte order for this read operation,
+see g_data_input_stream_get_byte_order().
-If @cancellable is not NULL, then the operation can be cancelled by
+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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
-
-On error -1 is returned and @error is set accordingly.
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to write.
-</parameter_description>
-</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes to write
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional cancellable object
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written, or -1 on error
+<return> an unsigned 64-bit/8-byte read from @stream or %0 if
+an error occurred.
</return>
</function>
-<function name="g_output_stream_write_all">
+<function name="g_data_input_stream_read_until">
<description>
-Tries to write @count bytes from @buffer into the stream. Will block
-during the operation.
-
-This function is similar to g_output_stream_write(), except it tries to
-write as many bytes as requested, only stopping on an error.
+Reads a string from the data input stream, up to the first
+occurrence of any of the stop characters.
-On a successful write of @count bytes, %TRUE is returned, and @bytes_written
-is set to @count.
+Note that, in contrast to g_data_input_stream_read_until_async(),
+this function consumes the stop character that it finds.
-If there is an error during the operation FALSE is returned and @error
-is set to indicate the error status, @bytes_written is updated to contain
-the number of bytes written into the stream before the error occurred.
+Don't use this function in new code. Its functionality is
+inconsistent with g_data_input_stream_read_until_async(). Both
+functions will be marked as deprecated in a future release. Use
+g_data_input_stream_read_upto() instead, but note that that function
+does not consume the stop character.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to write.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes to write
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read.
</parameter_description>
</parameter>
-<parameter name="bytes_written">
-<parameter_description> location to store the number of bytes that was
-written to the stream
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -21791,63 +21592,50 @@ written to the stream
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE if there was an error
+<return> a string with the data that was read
+before encountering any of the stop characters. Set @length to
+a #gsize to get the length of the string. This function will
+return %NULL on an error.
</return>
</function>
-<function name="g_output_stream_write_async">
+<function name="g_data_input_stream_read_until_async">
<description>
-Request an asynchronous write of @count bytes from @buffer into
-the stream. When the operation is finished @callback will be called.
-You can then call g_output_stream_write_finish() to get the result of the
-operation.
-
-During an async request no other sync and async calls are allowed,
-and will result in %G_IO_ERROR_PENDING errors.
-
-A value of @count larger than %G_MAXSSIZE will cause a
-%G_IO_ERROR_INVALID_ARGUMENT error.
-
-On success, the number of bytes written will be passed to the
- callback It is not an error if this is not the same as the
-requested size, as it can happen e.g. on a partial I/O error,
-but generally we try to write as many bytes as requested.
+The asynchronous version of g_data_input_stream_read_until().
+It is an error to have two outstanding calls to this function.
-You are guaranteed that this method will never fail with
-%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
-method will just wait until this changes.
+Note that, in contrast to g_data_input_stream_read_until(),
+this function does not consume the stop character that it finds. You
+must read it for yourself.
-Any outstanding I/O request with higher priority (lower numerical
-value) will be executed before an outstanding request with lower
-priority. Default priority is %G_PRIORITY_DEFAULT.
+When the operation is finished, @callback will be called. You
+can then call g_data_input_stream_read_until_finish() to get
+the result of the operation.
-The asyncronous methods have a default fallback that uses threads
-to implement asynchronicity, so they are optional for inheriting
-classes. However, if you override one you must override all.
+Don't use this function in new code. Its functionality is
+inconsistent with g_data_input_stream_read_until(). Both functions
+will be marked as deprecated in a future release. Use
+g_data_input_stream_read_upto_async() instead.
-For the synchronous, blocking version of this function, see
-g_output_stream_write().
+Since: 2.20
</description>
<parameters>
<parameter name="stream">
-<parameter_description> A #GOutputStream.
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to write.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
-<parameter name="count">
-<parameter_description> the number of bytes to write
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read.
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the io priority of the request.
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
<parameter name="cancellable">
@@ -21855,7109 +21643,30481 @@ g_output_stream_write().
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call when the request is satisfied
+<parameter_description> callback to call when the request is satisfied.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter_description> the data to pass to callback function.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_output_stream_write_finish">
+<function name="g_data_input_stream_read_until_finish">
<description>
-Finishes a stream write operation.
+Finish an asynchronous call started by
+g_data_input_stream_read_until_async().
+
+Since: 2.20
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GOutputStream.
+<parameter_description> a given #GDataInputStream.
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter_description> the #GAsyncResult that was provided to the callback.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> #GError for error reporting.
</parameter_description>
</parameter>
</parameters>
-<return> a #gssize containing the number of bytes written to the stream.
+<return> a string with the data that was read
+before encountering any of the stop characters. Set @length to
+a #gsize to get the length of the string. This function will
+return %NULL on an error.
</return>
</function>
-<function name="g_permission_acquire">
+<function name="g_data_input_stream_read_upto">
<description>
-Attempts to acquire the permission represented by @permission.
-
-The precise method by which this happens depends on the permission
-and the underlying authentication mechanism. A simple example is
-that a dialog may appear asking the user to enter their password.
-
-You should check with g_permission_get_can_acquire() before calling
-this function.
+Reads a string from the data input stream, up to the first
+occurrence of any of the stop characters.
-If the permission is acquired then %TRUE is returned. Otherwise,
-%FALSE is returned and @error is set appropriately.
+In contrast to g_data_input_stream_read_until(), this function
+does <emphasis>not</emphasis> consume the stop character. You have
+to use g_data_input_stream_read_byte() to get it before calling
+g_data_input_stream_read_upto() again.
-This call is blocking, likely for a very long time (in the case that
-user interaction is required). See g_permission_acquire_async() for
-the non-blocking version.
+Note that @stop_chars may contain '\0' if @stop_chars_len is
+specified.
Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataInputStream
+</parameter_description>
+</parameter>
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read
+</parameter_description>
+</parameter>
+<parameter name="stop_chars_len">
+<parameter_description> length of @stop_chars. May be -1 if @stop_chars is
+nul-terminated
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a pointer to a %NULL #GError, or %NULL
+<parameter_description> #GError for error reporting
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the permission was successfully acquired
+<return> a string with the data that was read
+before encountering any of the stop characters. Set @length to
+a #gsize to get the length of the string. This function will
+return %NULL on an error
+
</return>
</function>
-<function name="g_permission_acquire_async">
+<function name="g_data_input_stream_read_upto_async">
<description>
-Attempts to acquire the permission represented by @permission.
+The asynchronous version of g_data_input_stream_read_upto().
+It is an error to have two outstanding calls to this function.
-This is the first half of the asynchronous version of
-g_permission_acquire().
+In contrast to g_data_input_stream_read_until(), this function
+does <emphasis>not</emphasis> consume the stop character. You have
+to use g_data_input_stream_read_byte() to get it before calling
+g_data_input_stream_read_upto() again.
+
+Note that @stop_chars may contain '\0' if @stop_chars_len is
+specified.
+
+When the operation is finished, @callback will be called. You
+can then call g_data_input_stream_read_upto_finish() to get
+the result of the operation.
Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataInputStream
+</parameter_description>
+</parameter>
+<parameter name="stop_chars">
+<parameter_description> characters to terminate the read
+</parameter_description>
+</parameter>
+<parameter name="stop_chars_len">
+<parameter_description> length of @stop_chars. May be -1 if @stop_chars is
+nul-terminated
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> the #GAsyncReadyCallback to call when done
+<parameter_description> callback to call when the request is satisfied
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> the user data to pass to @callback
+<parameter_description> the data to pass to callback function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_permission_acquire_finish">
+<function name="g_data_input_stream_read_upto_finish">
<description>
-Collects the result of attempting to acquire the permission
-represented by @permission.
+Finish an asynchronous call started by
+g_data_input_stream_read_upto_async().
-This is the second half of the asynchronous version of
-g_permission_acquire().
+Note that this function does <emphasis>not</emphasis> consume the
+stop character. You have to use g_data_input_stream_read_byte() to
+get it before calling g_data_input_stream_read_upto_async() again.
-Since: 2.26
+Since: 2.24
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataInputStream
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+<parameter_description> the #GAsyncResult that was provided to the callback
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a #gsize to get the length of the data read in
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a pointer to a %NULL #GError, or %NULL
+<parameter_description> #GError for error reporting
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the permission was successfully acquired
+<return> a string with the data that was read
+before encountering any of the stop characters. Set @length to
+a #gsize to get the length of the string. This function will
+return %NULL on an error.
+
</return>
</function>
-<function name="g_permission_get_allowed">
+<function name="g_data_input_stream_set_byte_order">
<description>
-Gets the value of the 'allowed' property. This property is %TRUE if
-the caller currently has permission to perform the action that
- permission represents the permission to perform.
+This function sets the byte order for the given @stream. All subsequent
+reads from the @stream will be read in the given @order.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a given #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="order">
+<parameter_description> a #GDataStreamByteOrder to set.
</parameter_description>
</parameter>
</parameters>
-<return> the value of the 'allowed' property
-</return>
+<return></return>
</function>
-<function name="g_permission_get_can_acquire">
+<function name="g_data_input_stream_set_newline_type">
<description>
-Gets the value of the 'can-acquire' property. This property is %TRUE
-if it is generally possible to acquire the permission by calling
-g_permission_acquire().
+Sets the newline type for the @stream.
+
+Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read
+chunk ends in "CR" we must read an additional byte to know if this is "CR" or
+"CR LF", and this might block if there is no more data available.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataInputStream.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the type of new line return as #GDataStreamNewlineType.
</parameter_description>
</parameter>
</parameters>
-<return> the value of the 'can-acquire' property
-</return>
+<return></return>
</function>
-<function name="g_permission_get_can_release">
+<function name="g_data_output_stream_get_byte_order">
<description>
-Gets the value of the 'can-release' property. This property is %TRUE
-if it is generally possible to release the permission by calling
-g_permission_release().
+Gets the byte order for the stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return> the value of the 'can-release' property
+<return> the #GDataStreamByteOrder for the @stream.
</return>
</function>
-<function name="g_permission_impl_update">
+<function name="g_data_output_stream_new">
<description>
-This function is called by the #GPermission implementation to update
-the properties of the permission. You should never call this
-function except from a #GPermission implementation.
-
-GObject notify signals are generated, as appropriate.
+Creates a new data output stream for @base_stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
-</parameter_description>
-</parameter>
-<parameter name="allowed">
-<parameter_description> the new value for the 'allowed' property
-</parameter_description>
-</parameter>
-<parameter name="can_acquire">
-<parameter_description> the new value for the 'can-acquire' property
-</parameter_description>
-</parameter>
-<parameter name="can_release">
-<parameter_description> the new value for the 'can-release' property
+<parameter name="base_stream">
+<parameter_description> a #GOutputStream.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> #GDataOutputStream.
+</return>
</function>
-<function name="g_permission_release">
+<function name="g_data_output_stream_put_byte">
<description>
-Attempts to release the permission represented by @permission.
-
-The precise method by which this happens depends on the permission
-and the underlying authentication mechanism. In most cases the
-permission will be dropped immediately without further action.
-
-You should check with g_permission_get_can_release() before calling
-this function.
-
-If the permission is released then %TRUE is returned. Otherwise,
-%FALSE is returned and @error is set appropriately.
-
-This call is blocking, likely for a very long time (in the case that
-user interaction is required). See g_permission_release_async() for
-the non-blocking version.
+Puts a byte into the output stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guchar.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a pointer to a %NULL #GError, or %NULL
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the permission was successfully released
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_permission_release_async">
+<function name="g_data_output_stream_put_int16">
<description>
-Attempts to release the permission represented by @permission.
-
-This is the first half of the asynchronous version of
-g_permission_release().
+Puts a signed 16-bit integer into the output stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="data">
+<parameter_description> a #gint16.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> the #GAsyncReadyCallback to call when done
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the user data to pass to @callback
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @data was successfully added to the @stream.
+</return>
</function>
-<function name="g_permission_release_finish">
+<function name="g_data_output_stream_put_int32">
<description>
-Collects the result of attempting to release the permission
-represented by @permission.
-
-This is the second half of the asynchronous version of
-g_permission_release().
+Puts a signed 32-bit integer into the output stream.
-Since: 2.26
</description>
<parameters>
-<parameter name="permission">
-<parameter_description> a #GPermission instance
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+<parameter name="data">
+<parameter_description> a #gint32.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a pointer to a %NULL #GError, or %NULL
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the permission was successfully released
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_poll_file_monitor_new">
+<function name="g_data_output_stream_put_int64">
<description>
-Polls @file for changes.
+Puts a signed 64-bit integer into the stream.
</description>
<parameters>
-<parameter name="file">
-<parameter_description> a #GFile.
+<parameter name="stream">
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #gint64.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFileMonitor for the given #GFile.
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_pollable_input_stream_can_poll">
+<function name="g_data_output_stream_put_string">
<description>
-Checks if @stream is actually pollable. Some classes may implement
-#GPollableInputStream but have only certain instances of that class
-be pollable. If this method returns %FALSE, then the behavior of
-other #GPollableInputStream methods is undefined.
-
-For any given stream, the value returned by this method is constant;
-a stream cannot switch from pollable to non-pollable or vice versa.
+Puts a string into the output stream.
-Since: 2.28
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GPollableInputStream.
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is pollable, %FALSE if not.
-
+<return> %TRUE if @string was successfully added to the @stream.
</return>
</function>
-<function name="g_pollable_input_stream_create_source">
+<function name="g_data_output_stream_put_uint16">
<description>
-Creates a #GSource that triggers when @stream can be read, or
- cancellable is triggered or an error occurs. The callback on the
-source is of the #GPollableSourceFunc type.
-
-As with g_pollable_input_stream_is_readable(), it is possible that
-the stream may not actually be readable even after the source
-triggers, so you should use g_pollable_input_stream_read_nonblocking()
-rather than g_input_stream_read() from the callback.
+Puts an unsigned 16-bit integer into the output stream.
-Since: 2.28
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GPollableInputStream.
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guint16.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSource
-
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_pollable_input_stream_is_readable">
+<function name="g_data_output_stream_put_uint32">
<description>
-Checks if @stream can be read.
-
-Note that some stream types may not be able to implement this 100%
-reliably, and it is possible that a call to g_input_stream_read()
-after this returns %TRUE would still block. To guarantee
-non-blocking behavior, you should always use
-g_pollable_input_stream_read_nonblocking(), which will return a
-%G_IO_ERROR_WOULD_BLOCK error rather than blocking.
+Puts an unsigned 32-bit integer into the stream.
-Since: 2.28
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GPollableInputStream.
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> a #guint32.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is readable, %FALSE if not. If an error
-has occurred on @stream, this will result in
-g_pollable_input_stream_is_readable() returning %TRUE, and the
-next attempt to read will return the error.
-
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_pollable_input_stream_read_nonblocking">
+<function name="g_data_output_stream_put_uint64">
<description>
-Attempts to read up to @size bytes from @stream into @buffer, as
-with g_input_stream_read(). If @stream is not currently readable,
-this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
-use g_pollable_input_stream_create_source() to create a #GSource
-that will be triggered when @stream is readable.
-
-Note that since this method never blocks, you cannot actually
-use @cancellable to cancel it. However, it will return an error
-if @cancellable has already been cancelled when you call, which
-may happen if you call this method after a source triggers due
-to having been cancelled.
+Puts an unsigned 64-bit integer into the stream.
-Virtual: read_nonblocking
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GPollableInputStream
-</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 #GDataOutputStream.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to read
+<parameter name="data">
+<parameter_description> a #guint64.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> optional #GCancellable object, %NULL to ignore.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> a #GError, %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes read, or -1 on error (including
-%G_IO_ERROR_WOULD_BLOCK).
+<return> %TRUE if @data was successfully added to the @stream.
</return>
</function>
-<function name="g_pollable_output_stream_can_poll">
+<function name="g_data_output_stream_set_byte_order">
<description>
-Checks if @stream is actually pollable. Some classes may implement
-#GPollableOutputStream but have only certain instances of that
-class be pollable. If this method returns %FALSE, then the behavior
-of other #GPollableOutputStream methods is undefined.
-
-For any given stream, the value returned by this method is constant;
-a stream cannot switch from pollable to non-pollable or vice versa.
-
-Since: 2.28
+Sets the byte order of the data output stream to @order.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GPollableOutputStream.
+<parameter_description> a #GDataOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="order">
+<parameter_description> a %GDataStreamByteOrder.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is pollable, %FALSE if not.
-
-</return>
+<return></return>
</function>
-<function name="g_pollable_output_stream_create_source">
+<function name="g_dbus_action_group_get">
<description>
-Creates a #GSource that triggers when @stream can be written, or
- cancellable is triggered or an error occurs. The callback on the
-source is of the #GPollableSourceFunc type.
+Obtains a #GDBusActionGroup for the action group which is exported at
+the given @bus_name and @object_path.
-As with g_pollable_output_stream_is_writable(), it is possible that
-the stream may not actually be writable even after the source
-triggers, so you should use g_pollable_output_stream_write_nonblocking()
-rather than g_output_stream_write() from the callback.
+The thread default main context is taken at the time of this call.
+All signals on the menu model (and any linked models) are reported
+with respect to this context. All calls on the returned menu model
+(and linked models) must also originate from this same context, with
+the thread default main context unchanged.
-Since: 2.28
+This call is non-blocking. The returned action group may or may not
+already be filled in. The correct thing to do is connect the signals
+for the action group to monitor for changes and then to call
+g_action_group_list_actions() to get the initial list.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GPollableOutputStream.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="bus_name">
+<parameter_description> the bus name which exports the action group
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> the object path at which the action group is exported
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSource
+<return> a #GDBusActionGroup
</return>
</function>
-<function name="g_pollable_output_stream_is_writable">
+<function name="g_dbus_address_get_for_bus_sync">
<description>
-Checks if @stream can be written.
-
-Note that some stream types may not be able to implement this 100%
-reliably, and it is possible that a call to g_output_stream_write()
-after this returns %TRUE would still block. To guarantee
-non-blocking behavior, you should always use
-g_pollable_output_stream_write_nonblocking(), which will return a
-%G_IO_ERROR_WOULD_BLOCK error rather than blocking.
+Synchronously looks up the D-Bus address for the well-known message
+bus instance specified by @bus_type. This may involve using various
+platform specific mechanisms.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GPollableOutputStream.
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @stream is writable, %FALSE if not. If an error
-has occurred on @stream, this will result in
-g_pollable_output_stream_is_writable() returning %TRUE, and the
-next attempt to write will return the error.
+<return> A valid D-Bus address string for @bus_type or %NULL if @error is set.
</return>
</function>
-<function name="g_pollable_output_stream_write_nonblocking">
+<function name="g_dbus_address_get_stream">
<description>
-Attempts to write up to @size bytes from @buffer to @stream, as
-with g_output_stream_write(). If @stream is not currently writable,
-this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
-use g_pollable_output_stream_create_source() to create a #GSource
-that will be triggered when @stream is writable.
+Asynchronously connects to an endpoint specified by @address and
+sets up the connection so it is in a state to run the client-side
+of the D-Bus authentication conversation.
-Note that since this method never blocks, you cannot actually
-use @cancellable to cancel it. However, it will return an error
-if @cancellable has already been cancelled when you call, which
-may happen if you call this method after a source triggers due
-to having been cancelled.
+When the operation is finished, @callback will be invoked. You can
+then call g_dbus_address_get_stream_finish() to get the result of
+the operation.
-Virtual: write_nonblocking
+This is an asynchronous failable function. See
+g_dbus_address_get_stream_sync() for the synchronous version.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="stream">
-<parameter_description> a #GPollableOutputStream
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to write
-data from
+<parameter name="address">
+<parameter_description> A valid D-Bus address.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to write
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="user_data">
+<parameter_description> Data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes written, or -1 on error (including
-%G_IO_ERROR_WOULD_BLOCK).
-</return>
+<return></return>
</function>
-<function name="g_pollable_source_new">
+<function name="g_dbus_address_get_stream_finish">
<description>
-Utility method for #GPollableInputStream and #GPollableOutputStream
-implementations. Creates a new #GSource that expects a callback of
-type #GPollableSourceFunc. The new source does not actually do
-anything on its own; use g_source_add_child_source() to add other
-sources to it to cause it to trigger.
+Finishes an operation started with g_dbus_address_get_stream().
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="pollable_stream">
-<parameter_description> the stream associated with the new source
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().
+</parameter_description>
+</parameter>
+<parameter name="out_guid">
+<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GSource.
+<return> A #GIOStream or %NULL if @error is set.
</return>
</function>
-<function name="g_proxy_address_get_destination_hostname">
+<function name="g_dbus_address_get_stream_sync">
<description>
-Gets @proxy's destination hostname.
+Synchronously connects to an endpoint specified by @address and
+sets up the connection so it is in a state to run the client-side
+of the D-Bus authentication conversation.
+
+This is a synchronous failable function. See
+g_dbus_address_get_stream() for the asynchronous version.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxyAddress
+<parameter name="address">
+<parameter_description> A valid D-Bus address.
+</parameter_description>
+</parameter>
+<parameter name="out_guid">
+<parameter_description> %NULL or return location to store the GUID extracted from @address, if any.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> the @proxy's destination hostname
+<return> A #GIOStream or %NULL if @error is set.
</return>
</function>
-<function name="g_proxy_address_get_destination_port">
+<function name="g_dbus_annotation_info_lookup">
<description>
-Gets @proxy's destination port.
+Looks up the value of an annotation.
+
+This cost of this function is O(n) in number of annotations.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxyAddress
+<parameter name="annotations">
+<parameter_description> A %NULL-terminated array of annotations or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The name of the annotation to look up.
</parameter_description>
</parameter>
</parameters>
-<return> the @proxy's destination port
+<return> The value or %NULL if not found. Do not free, it is owned by @annotations.
</return>
</function>
-<function name="g_proxy_address_get_password">
+<function name="g_dbus_annotation_info_ref">
<description>
-Gets @proxy's password.
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxyAddress
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
</parameter_description>
</parameter>
</parameters>
-<return> the @proxy's password
+<return> The same @info.
</return>
</function>
-<function name="g_proxy_address_get_protocol">
+<function name="g_dbus_annotation_info_unref">
<description>
-Gets @proxy's protocol.
-
-Since: 2.26
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxyAddress
+<parameter name="info">
+<parameter_description> A #GDBusAnnotationInfo.
</parameter_description>
</parameter>
</parameters>
-<return> the @proxy's protocol
-
-</return>
+<return></return>
</function>
-<function name="g_proxy_address_get_username">
+<function name="g_dbus_arg_info_ref">
<description>
-Gets @proxy's username.
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxyAddress
+<parameter name="info">
+<parameter_description> A #GDBusArgInfo
</parameter_description>
</parameter>
</parameters>
-<return> the @proxy's username
+<return> The same @info.
</return>
</function>
-<function name="g_proxy_address_new">
+<function name="g_dbus_arg_info_unref">
<description>
-Creates a new #GProxyAddress for @inetaddr with @protocol that should
-tunnel through @dest_hostname and @dest_port.
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
Since: 2.26
</description>
<parameters>
-<parameter name="inetaddr">
-<parameter_description> The proxy server #GInetAddress.
-</parameter_description>
-</parameter>
-<parameter name="port">
-<parameter_description> The proxy server port.
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> The proxy protocol to support, in lower case (e.g. socks, http).
-</parameter_description>
-</parameter>
-<parameter name="dest_hostname">
-<parameter_description> The destination hostname the the proxy should tunnel to.
+<parameter name="info">
+<parameter_description> A #GDBusArgInfo.
</parameter_description>
</parameter>
-<parameter name="dest_port">
-<parameter_description> The destination port to tunnel to.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_auth_observer_authorize_authenticated_peer">
+<description>
+Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver.
</parameter_description>
</parameter>
-<parameter name="username">
-<parameter_description> The username to authenticate to the proxy server
-(or %NULL).
+<parameter name="stream">
+<parameter_description> A #GIOStream for the #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="password">
-<parameter_description> The password to authenticate to the proxy server
-(or %NULL).
+<parameter name="credentials">
+<parameter_description> Credentials received from the peer or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GProxyAddress
+<return> %TRUE if the peer is authorized, %FALSE if not.
</return>
</function>
-<function name="g_proxy_connect">
+<function name="g_dbus_auth_observer_new">
<description>
-Given @connection to communicate with a proxy (eg, a
-#GSocketConnection that is connected to the proxy server), this
-does the necessary handshake to connect to @proxy_address, and if
-required, wraps the #GIOStream to handle proxy payload.
+Creates a new #GDBusAuthObserver object.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusAuthObserver. Free with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_dbus_connection_add_filter">
+<description>
+Adds a message filter. Filters are handlers that are run on all
+incoming and outgoing messages, prior to standard dispatch. Filters
+are run in the order that they were added. The same handler can be
+added as a filter more than once, in which case it will be run more
+than once. Filters added during a filter callback won't be run on
+the message being processed. Filter functions are allowed to modify
+and even drop messages.
+
+Note that filters are run in a dedicated message handling thread so
+they can't block and, generally, can't do anything but signal a
+worker thread. Also note that filters are rarely needed - use API
+such as g_dbus_connection_send_message_with_reply(),
+g_dbus_connection_signal_subscribe() or g_dbus_connection_call() instead.
+
+If a filter consumes an incoming message the message is not
+dispatched anywhere else - not even the standard dispatch machinery
+(that API such as g_dbus_connection_signal_subscribe() and
+g_dbus_connection_send_message_with_reply() relies on) will see the
+message. Similary, if a filter consumes an outgoing message, the
+message will not be sent to the other peer.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxy
-</parameter_description>
-</parameter>
<parameter name="connection">
-<parameter_description> a #GIOStream
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="proxy_address">
-<parameter_description> a #GProxyAddress
+<parameter name="filter_function">
+<parameter_description> A filter function.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable
+<parameter name="user_data">
+<parameter_description> User data to pass to @filter_function.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return #GError
+<parameter name="user_data_free_func">
+<parameter_description> Function to free @user_data with when filter
+is removed or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GIOStream that will replace @connection. This might
-be the same as @connection, in which case a reference
-will be added.
+<return> A filter identifier that can be used with
+g_dbus_connection_remove_filter().
</return>
</function>
-<function name="g_proxy_connect_async">
+<function name="g_dbus_connection_call">
<description>
-Asynchronous version of g_proxy_connect().
+Asynchronously invokes the @method_name method on the
+ interface_name D-Bus interface on the remote object at
+ object_path owned by @bus_name.
+
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value
+not compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
+
+If @reply_type is non-%NULL then the reply will be checked for having this type and an
+error will be raised if it does not match. Said another way, if you give a @reply_type
+then any non-%NULL return value will be of this type.
+
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_connection_call (connection,
+"org.freedesktop.StringThings",
+"/org/freedesktop/StringThings",
+"org.freedesktop.StringThings",
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+NULL,
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+(GAsyncReadyCallback) two_strings_done,
+NULL);
+]|
+
+This is an asynchronous method. When the operation is finished, @callback will be invoked
+in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+of the thread you are calling this method from. You can then call
+g_dbus_connection_call_finish() to get the result of the operation.
+See g_dbus_connection_call_sync() for the synchronous version of this
+function.
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxy
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="connection">
-<parameter_description> a #GIOStream
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name or %NULL if
+ connection is not a message bus connection.
</parameter_description>
</parameter>
-<parameter name="proxy_address">
-<parameter_description> a #GProxyAddress
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter_description> A #GAsyncReadyCallback to call when the request is
+satisfied or %NULL if you don't care about the result of the
+method invocation.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> callback data
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_proxy_connect_finish">
+<function name="g_dbus_connection_call_finish">
<description>
-See g_proxy_connect().
+Finishes an operation started with g_dbus_connection_call().
Since: 2.26
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxy
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncRetult
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return #GError
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GIOStream.
-
-</return>
-</function>
-
-<function name="g_proxy_get_default_for_protocol">
-<description>
-Lookup "gio-proxy" extension point for a proxy implementation that supports
-specified protocol.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="protocol">
-<parameter_description> the proxy protocol name (e.g. http, socks, etc)
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> return a #GProxy or NULL if protocol
-is not supported.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_proxy_resolver_get_default">
+<function name="g_dbus_connection_call_sync">
<description>
-Gets the default #GProxyResolver for the system.
+Synchronously invokes the @method_name method on the
+ interface_name D-Bus interface on the remote object at
+ object_path owned by @bus_name.
-Since: 2.26
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the
+operation will fail with %G_IO_ERROR_CANCELLED. If @parameters
+contains a value not compatible with the D-Bus protocol, the operation
+fails with %G_IO_ERROR_INVALID_ARGUMENT.
-</description>
-<parameters>
-</parameters>
-<return> the default #GProxyResolver.
+If @reply_type is non-%NULL then the reply will be checked for having
+this type and an error will be raised if it does not match. Said
+another way, if you give a @reply_type then any non-%NULL return
+value will be of this type.
-</return>
-</function>
+If the @parameters #GVariant is floating, it is consumed.
+This allows convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_connection_call_sync (connection,
+"org.freedesktop.StringThings",
+"/org/freedesktop/StringThings",
+"org.freedesktop.StringThings",
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+NULL,
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+&error);
+]|
-<function name="g_proxy_resolver_is_supported">
-<description>
-Checks if @resolver can be used on this system. (This is used
-internally; g_proxy_resolver_get_default() will only return a proxy
-resolver that returns %TRUE for this method.)
+The calling thread is blocked until a reply is received. See
+g_dbus_connection_call() for the asynchronous version of
+this method.
Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GProxyResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-</parameters>
-<return> %TRUE if @resolver is supported.
-
-</return>
-</function>
-
-<function name="g_proxy_resolver_lookup">
-<description>
-Looks into the system proxy configuration to determine what proxy,
-if any, to use to connect to @uri. The returned proxy URIs are of the
-form <literal><protocol>://[user[:password] ]host:port</literal>
-or <literal>direct://</literal>, where <protocol> could be
-http, rtsp, socks or other proxying protocol.
-
-If you don't know what network protocol is being used on the
-socket, you should use <literal>none</literal> as the URI protocol.
-In this case, the resolver might still return a generic proxy type
-(such as SOCKS), but would not return protocol-specific proxy types
-(such as http).
-
-<literal>direct://</literal> is used when no proxy is needed.
-Direct connection should not be attempted unless it is part of the
-returned array of proxies.
-
-Since: 2.26
-
-</description>
-<parameters>
-<parameter name="resolver">
-<parameter_description> a #GProxyResolver
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name.
</parameter_description>
</parameter>
-<parameter name="uri">
-<parameter_description> a URI representing the destination to connect to
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A
-NULL-terminated array of proxy URIs. Must be freed
-with g_strfreev().
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_proxy_resolver_lookup_async">
+<function name="g_dbus_connection_call_with_unix_fd_list">
<description>
-Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
-details.
+Like g_dbus_connection_call() but also takes a #GUnixFDList object.
-Since: 2.26
+This method is only available on UNIX.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GProxyResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="uri">
-<parameter_description> a URI representing the destination to connect to
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name or %NULL if
+ connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter_description> A #GAsyncReadyCallback to call when the request is
+satisfied or %NULL if you don't * care about the result of the
+method invocation.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_proxy_resolver_lookup_finish">
+<function name="g_dbus_connection_call_with_unix_fd_list_finish">
<description>
-Call this function to obtain the array of proxy URIs when
-g_proxy_resolver_lookup_async() is complete. See
-g_proxy_resolver_lookup() for more details.
+Finishes an operation started with g_dbus_connection_call_with_unix_fd_list().
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GProxyResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the result passed to your #GAsyncReadyCallback
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call_with_unix_fd_list().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> A
-NULL-terminated array of proxy URIs. Must be freed
-with g_strfreev().
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_proxy_supports_hostname">
+<function name="g_dbus_connection_call_with_unix_fd_list_sync">
<description>
-Some proxy protocols expect to be passed a hostname, which they
-will resolve to an IP address themselves. Others, like SOCKS4, do
-not allow this. This function will return %FALSE if @proxy is
-implementing such a protocol. When %FALSE is returned, the caller
-should resolve the destination hostname first, and then pass a
-#GProxyAddress containing the stringified IP address to
-g_proxy_connect() or g_proxy_connect_async().
+Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects.
-Since: 2.26
+This method is only available on UNIX.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="proxy">
-<parameter_description> a #GProxy
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="bus_name">
+<parameter_description> A unique or well-known bus name.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Path of remote object.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to invoke method on.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> The name of the method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the method
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="reply_type">
+<parameter_description> The expected type of the reply, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if hostname resolution is supported.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_resolver_error_quark">
+<function name="g_dbus_connection_close">
<description>
-Gets the #GResolver Error Quark.
+Closes @connection. Note that this never causes the process to
+exit (this might only happen if the other end of a shared message
+bus connection disconnects, see #GDBusConnection:exit-on-close).
-Since: 2.22
+Once the connection is closed, operations such as sending a message
+will return with the error %G_IO_ERROR_CLOSED. Closing a connection
+will not automatically flush the connection so queued messages may
+be lost. Use g_dbus_connection_flush() if you need such guarantees.
-</description>
-<parameters>
-</parameters>
-<return> a #GQuark.
+If @connection is already closed, this method fails with
+%G_IO_ERROR_CLOSED.
-</return>
-</function>
+When @connection has been closed, the #GDBusConnection::closed
+signal is emitted in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread that @connection was constructed in.
-<function name="g_resolver_free_addresses">
-<description>
-Frees @addresses (which should be the return value from
-g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
-(This is a convenience method; you can also simply free the results
-by hand.)
+This is an asynchronous method. When the operation is finished,
+ callback will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from. You can
+then call g_dbus_connection_close_finish() to get the result of the
+operation. See g_dbus_connection_close_sync() for the synchronous
+version.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="addresses">
-<parameter_description> a #GList of #GInetAddress
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_resolver_free_targets">
-<description>
-Frees @targets (which should be the return value from
-g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
-(This is a convenience method; you can also simply free the
-results by hand.)
-
-Since: 2.22
-
-</description>
-<parameters>
-<parameter name="targets">
-<parameter_description> a #GList of #GSrvTarget
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is
+satisfied or %NULL if you don't care about the result.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_resolver_get_default">
+<function name="g_dbus_connection_close_finish">
<description>
-Gets the default #GResolver. You should unref it when you are done
-with it. #GResolver may use its reference count as a hint about how
-many threads/processes, etc it should allocate for concurrent DNS
-resolutions.
+Finishes an operation started with g_dbus_connection_close().
-Since: 2.22
+Since: 2.26
</description>
<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_close().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
</parameters>
-<return> the default #GResolver.
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_resolver_lookup_by_address">
+<function name="g_dbus_connection_close_sync">
<description>
-Synchronously reverse-resolves @address to determine its
-associated hostname.
-
-If the DNS resolution fails, @error (if non-%NULL) will be set to
-a value from #GResolverError.
-
-If @cancellable is non-%NULL, it can be used to cancel the
-operation, in which case @error (if non-%NULL) will be set to
-%G_IO_ERROR_CANCELLED.
+Synchronously closees @connection. The calling thread is blocked
+until this is done. See g_dbus_connection_close() for the
+asynchronous version of this method and more details about what it
+does.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="address">
-<parameter_description> the address to reverse-resolve
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a hostname (either ASCII-only, or in ASCII-encoded
-form), or %NULL on error.
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_resolver_lookup_by_address_async">
+<function name="g_dbus_connection_emit_signal">
<description>
-Begins asynchronously reverse-resolving @address to determine its
-associated hostname, and eventually calls @callback, which must
-call g_resolver_lookup_by_address_finish() to get the final result.
+Emits a signal.
-Since: 2.22
+If the parameters GVariant is floating, it is consumed.
+
+This can only fail if @parameters is not compatible with the D-Bus protocol.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> the address to reverse-resolve
+<parameter name="destination_bus_name">
+<parameter_description> The unique bus name for the destination
+for the signal or %NULL to emit to all listeners.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="object_path">
+<parameter_description> Path of remote object.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter name="interface_name">
+<parameter_description> D-Bus interface to emit a signal on.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter name="signal_name">
+<parameter_description> The name of the signal to emit.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE unless @error is set.
+
+</return>
</function>
-<function name="g_resolver_lookup_by_address_finish">
+<function name="g_dbus_connection_export_action_group">
<description>
-Retrieves the result of a previous call to
-g_resolver_lookup_by_address_async().
+Exports @action_group on @connection at @object_path.
-If the DNS resolution failed, @error (if non-%NULL) will be set to
-a value from #GResolverError. If the operation was cancelled,
- error will be set to %G_IO_ERROR_CANCELLED.
+The implemented D-Bus API should be considered private. It is
+subject to change in the future.
-Since: 2.22
+A given object path can only have one action group exported on it.
+If this constraint is violated, the export will fail and 0 will be
+returned (with @error set accordingly).
+
+You can unexport the action group using
+g_dbus_connection_unexport_action_group() with the return value of
+this function.
+
+The thread default main context is taken at the time of this call.
+All incoming action activations and state change requests are
+reported from this context. Any changes on the action group that
+cause it to emit signals must also come from this same context.
+Since incoming action activations and state change requests are
+rather likely to cause changes on the action group, this effectively
+limits a given action group to being exported from only one main
+context.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the result passed to your #GAsyncReadyCallback
+<parameter name="object_path">
+<parameter_description> a D-Bus object path
+</parameter_description>
+</parameter>
+<parameter name="action_group">
+<parameter_description> a #GActionGroup
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> a pointer to a %NULL #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a hostname (either ASCII-only, or in ASCII-encoded
-form), or %NULL on error.
+<return> the ID of the export (never zero), or 0 in case of failure
</return>
</function>
-<function name="g_resolver_lookup_by_name">
+<function name="g_dbus_connection_export_menu_model">
<description>
-Synchronously resolves @hostname to determine its associated IP
-address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
-the textual form of an IP address (in which case this just becomes
-a wrapper around g_inet_address_new_from_string()).
+Exports @menu on @connection at @object_path.
-On success, g_resolver_lookup_by_name() will return a #GList of
-#GInetAddress, sorted in order of preference. (That is, you should
-attempt to connect to the first address first, then the second if
-the first fails, etc.)
-
-If the DNS resolution fails, @error (if non-%NULL) will be set to a
-value from #GResolverError.
+The implemented D-Bus API should be considered private.
+It is subject to change in the future.
-If @cancellable is non-%NULL, it can be used to cancel the
-operation, in which case @error (if non-%NULL) will be set to
-%G_IO_ERROR_CANCELLED.
+An object path can only have one action group exported on it. If this
+constraint is violated, the export will fail and 0 will be
+returned (with @error set accordingly).
-If you are planning to connect to a socket on the resolved IP
-address, it may be easier to create a #GNetworkAddress and use its
-#GSocketConnectable interface.
+You can unexport the menu model using
+g_dbus_connection_unexport_menu_model() with the return value of
+this function.
-Since: 2.22
+Since: 2.32
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="hostname">
-<parameter_description> the hostname to look up
+<parameter name="object_path">
+<parameter_description> a D-Bus object path
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="menu">
+<parameter_description> a #GMenuModel
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GList
-of #GInetAddress, or %NULL on error. You
-must unref each of the addresses and free the list when you are
-done with it. (You can use g_resolver_free_addresses() to do this.)
+<return> the ID of the export (never zero), or 0 in case of failure
</return>
</function>
-<function name="g_resolver_lookup_by_name_async">
+<function name="g_dbus_connection_flush">
<description>
-Begins asynchronously resolving @hostname to determine its
-associated IP address(es), and eventually calls @callback, which
-must call g_resolver_lookup_by_name_finish() to get the result.
-See g_resolver_lookup_by_name() for more details.
+Asynchronously flushes @connection, that is, writes all queued
+outgoing message to the transport and then flushes the transport
+(using g_output_stream_flush_async()). This is useful in programs
+that wants to emit a D-Bus signal and then exit
+immediately. Without flushing the connection, there is no guarantee
+that the message has been sent to the networking buffers in the OS
+kernel.
-Since: 2.22
+This is an asynchronous method. When the operation is finished,
+ callback will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from. You can
+then call g_dbus_connection_flush_finish() to get the result of the
+operation. See g_dbus_connection_flush_sync() for the synchronous
+version.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="hostname">
-<parameter_description> the hostname to look up the address of
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> callback to call after resolution completes
+<parameter_description> A #GAsyncReadyCallback to call when the request is
+satisfied or %NULL if you don't care about the result.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_resolver_lookup_by_name_finish">
+<function name="g_dbus_connection_flush_finish">
<description>
-Retrieves the result of a call to
-g_resolver_lookup_by_name_async().
-
-If the DNS resolution failed, @error (if non-%NULL) will be set to
-a value from #GResolverError. If the operation was cancelled,
- error will be set to %G_IO_ERROR_CANCELLED.
+Finishes an operation started with g_dbus_connection_flush().
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> the result passed to your #GAsyncReadyCallback
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_flush().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList
-of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
-for more details.
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_resolver_lookup_service">
+<function name="g_dbus_connection_flush_sync">
<description>
-Synchronously performs a DNS SRV lookup for the given @service and
- protocol in the given @domain and returns an array of #GSrvTarget.
- domain may be an ASCII-only or UTF-8 hostname. Note also that the
- service and @protocol arguments <emphasis>do not</emphasis>
-include the leading underscore that appears in the actual DNS
-entry.
-
-On success, g_resolver_lookup_service() will return a #GList of
-#GSrvTarget, sorted in order of preference. (That is, you should
-attempt to connect to the first target first, then the second if
-the first fails, etc.)
-
-If the DNS resolution fails, @error (if non-%NULL) will be set to
-a value from #GResolverError.
-
-If @cancellable is non-%NULL, it can be used to cancel the
-operation, in which case @error (if non-%NULL) will be set to
-%G_IO_ERROR_CANCELLED.
-
-If you are planning to connect to the service, it is usually easier
-to create a #GNetworkService and use its #GSocketConnectable
-interface.
+Synchronously flushes @connection. The calling thread is blocked
+until this is done. See g_dbus_connection_flush() for the
+asynchronous version of this method and more details about what it
+does.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="service">
-<parameter_description> the service type to look up (eg, "ldap")
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> the networking protocol to use for @service (eg, "tcp")
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> the DNS domain to look up the service in
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GSrvTarget,
-or %NULL on error. You must free each of the targets and the list when you are
-done with it. (You can use g_resolver_free_targets() to do this.)
+<return> %TRUE if the operation succeeded, %FALSE if @error is set.
</return>
</function>
-<function name="g_resolver_lookup_service_async">
+<function name="g_dbus_connection_get_capabilities">
<description>
-Begins asynchronously performing a DNS SRV lookup for the given
- service and @protocol in the given @domain, and eventually calls
- callback, which must call g_resolver_lookup_service_finish() to
-get the final result. See g_resolver_lookup_service() for more
-details.
+Gets the capabilities negotiated with the remote peer
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="service">
-<parameter_description> the service type to look up (eg, "ldap")
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> the networking protocol to use for @service (eg, "tcp")
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> the DNS domain to look up the service in
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call after resolution completes
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> data for @callback
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> Zero or more flags from the #GDBusCapabilityFlags enumeration.
+
+</return>
</function>
-<function name="g_resolver_lookup_service_finish">
+<function name="g_dbus_connection_get_exit_on_close">
<description>
-Retrieves the result of a previous call to
-g_resolver_lookup_service_async().
-
-If the DNS resolution failed, @error (if non-%NULL) will be set to
-a value from #GResolverError. If the operation was cancelled,
- error will be set to %G_IO_ERROR_CANCELLED.
+Gets whether the process is terminated when @connection is
+closed by the remote peer. See
+#GDBusConnection:exit-on-close for more details.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> a #GResolver
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> the result passed to your #GAsyncReadyCallback
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> a #GList of #GSrvTarget,
-or %NULL on error. See g_resolver_lookup_service() for more details.
+<return> Whether the process is terminated when @connection is
+closed by the remote peer.
</return>
</function>
-<function name="g_resolver_set_default">
+<function name="g_dbus_connection_get_guid">
<description>
-Sets @resolver to be the application's default resolver (reffing
- resolver, and unreffing the previous default resolver, if any).
-Future calls to g_resolver_get_default() will return this resolver.
-
-This can be used if an application wants to perform any sort of DNS
-caching or "pinning"; it can implement its own #GResolver that
-calls the original default resolver for DNS operations, and
-implements its own cache policies on top of that, and then set
-itself as the default resolver for all later code to use.
+The GUID of the peer performing the role of server when
+authenticating. See #GDBusConnection:guid for more details.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="resolver">
-<parameter_description> the new default #GResolver
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The GUID. Do not free this string, it is owned by
+ connection
+
+</return>
</function>
-<function name="g_seekable_can_seek">
+<function name="g_dbus_connection_get_peer_credentials">
<description>
-Tests if the stream supports the #GSeekableIface.
+Gets the credentials of the authenticated peer. This will always
+return %NULL unless @connection acted as a server
+(e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
+when set up and the client passed credentials as part of the
+authentication process.
+
+In a message bus setup, the message bus is always the server and
+each application is a client. So this method will always return
+%NULL for message bus clients.
+Since: 2.26
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @seekable can be seeked. %FALSE otherwise.
+<return> A #GCredentials or %NULL if not available. Do not free
+this object, it is owned by @connection.
+
</return>
</function>
-<function name="g_seekable_can_truncate">
+<function name="g_dbus_connection_get_stream">
<description>
-Tests if the stream can be truncated.
+Gets the underlying stream used for IO.
+While the #GDBusConnection is active, it will interact with this
+stream from a worker thread, so it is not safe to interact with
+the stream directly.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the stream can be truncated, %FALSE otherwise.
+<return> the stream used for IO
+
</return>
</function>
-<function name="g_seekable_seek">
+<function name="g_dbus_connection_get_unique_name">
<description>
-Seeks in the stream by the given @offset, modified by @type.
-
-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.
+Gets the unique name of @connection as assigned by the message
+bus. This can also be used to figure out if @connection is a
+message bus connection.
+Since: 2.26
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
-</parameter_description>
-</parameter>
-<parameter name="offset">
-<parameter_description> a #goffset.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a #GSeekType.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error
-has occurred, this function will return %FALSE and set @error
-appropriately if present.
+<return> The unique name or %NULL if @connection is not a message
+bus connection. Do not free this string, it is owned by
+ connection
+
</return>
</function>
-<function name="g_seekable_tell">
+<function name="g_dbus_connection_is_closed">
<description>
-Tells the current position within the stream.
+Gets whether @connection is closed.
+Since: 2.26
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> the offset from the beginning of the buffer.
-</return>
+<return> %TRUE if the connection is closed, %FALSE otherwise.
+
+</return>
</function>
-<function name="g_seekable_truncate">
+<function name="g_dbus_connection_new">
<description>
-Truncates a stream with a given #offset.
+Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
+with the end represented by @stream.
-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 an
-operation was partially finished when the operation was cancelled the
-partial result will be returned, without an error.
+If @stream is a #GSocketConnection, then the corresponding #GSocket
+will be put into non-blocking mode.
-Virtual: truncate_fn
+The D-Bus connection will interact with @stream from a worker thread.
+As a result, the caller should not interact with @stream after this
+method has been called, except by calling g_object_unref() on it.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
+
+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
+g_dbus_connection_new_sync() for the synchronous
+version.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="seekable">
-<parameter_description> a #GSeekable.
+<parameter name="stream">
+<parameter_description> A #GIOStream.
</parameter_description>
</parameter>
-<parameter name="offset">
-<parameter_description> a #goffset.
+<parameter name="guid">
+<parameter_description> The GUID to use if a authenticating as a server or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if successful. If an error
-has occurred, this function will return %FALSE and set @error
-appropriately if present.
-</return>
+<return></return>
</function>
-<function name="g_settings_apply">
+<function name="g_dbus_connection_new_finish">
<description>
-Applies any changes that have been made to the settings. This
-function does nothing unless @settings is in 'delay-apply' mode;
-see g_settings_delay(). In the normal case settings are always
-applied immediately.
+Finishes an operation started with g_dbus_connection_new().
+
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings instance
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
</function>
-<function name="g_settings_backend_changed">
+<function name="g_dbus_connection_new_for_address">
<description>
-Signals that a single key has possibly changed. Backend
-implementations should call this if a key has possibly changed its
-value.
+Asynchronously connects and sets up a D-Bus client connection for
+exchanging D-Bus messages with an endpoint specified by @address
+which must be in the D-Bus address format.
- key must be a valid key (ie starting with a slash, not containing
-'//', and not ending with a slash).
+This constructor can only be used to initiate client-side
+connections - use g_dbus_connection_new() if you need to act as the
+server. In particular, @flags cannot contain the
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
-The implementation must call this function during any call to
-g_settings_backend_write(), before the call returns (except in the
-case that no keys are actually changed and it cares to detect this
-fact). It may not rely on the existence of a mainloop for
-dispatching the signal later.
+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.
-The implementation may call this function at any other time it likes
-in response to other events (such as changes occuring outside of the
-program). These calls may originate from a mainloop or may originate
-in response to any other action (including from calls to
-g_settings_backend_write()).
+If @observer is not %NULL it may be used to control the
+authentication process.
-In the case that this call is in response to a call to
-g_settings_backend_write() then @origin_tag must be set to the same
-value that was passed to that call.
+This is a asynchronous failable constructor. See
+g_dbus_connection_new_for_address_sync() for the synchronous
+version.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="address">
+<parameter_description> A D-Bus address.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of the key
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_backend_changed_tree">
+<function name="g_dbus_connection_new_for_address_finish">
<description>
-This call is a convenience wrapper. It gets the list of changes from
- tree, computes the longest common prefix and calls
-g_settings_backend_changed().
+Finishes an operation started with g_dbus_connection_new_for_address().
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
-</parameter_description>
-</parameter>
-<parameter name="tree">
-<parameter_description> a #GTree containing the changes
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new().
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
</function>
-<function name="g_settings_backend_flatten_tree">
+<function name="g_dbus_connection_new_for_address_sync">
<description>
-Calculate the longest common prefix of all keys in a tree and write
-out an array of the key names relative to that prefix and,
-optionally, the value to store at each of those keys.
+Synchronously connects and sets up a D-Bus client connection for
+exchanging D-Bus messages with an endpoint specified by @address
+which must be in the D-Bus address format.
-You must free the value returned in @path, @keys and @values using
-g_free(). You should not attempt to free or unref the contents of
- keys or @values.
+This constructor can only be used to initiate client-side
+connections - use g_dbus_connection_new_sync() if you need to act
+as the server. In particular, @flags cannot contain the
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
+%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
+
+This is a synchronous failable constructor. See
+g_dbus_connection_new_for_address() for the asynchronous version.
+
+If @observer is not %NULL it may be used to control the
+authentication process.
Since: 2.26
</description>
<parameters>
-<parameter name="tree">
-<parameter_description> a #GTree containing the changes
+<parameter name="address">
+<parameter_description> A D-Bus address.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the location to save the path
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
</parameter_description>
</parameter>
-<parameter name="keys">
-<parameter_description> the
-location to save the relative keys
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver or %NULL.
</parameter_description>
</parameter>
-<parameter name="values">
-<parameter_description>
-the location to save the values, or %NULL
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="g_settings_backend_get_default">
-<description>
-Returns the default #GSettingsBackend. It is possible to override
-the default by setting the <envar>GSETTINGS_BACKEND</envar>
-environment variable to the name of a settings backend.
-
-The user gets a reference to the backend.
-
-Since: 2.28
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
-</description>
-<parameters>
-</parameters>
-<return> the default #GSettingsBackend
</return>
</function>
-<function name="g_settings_backend_keys_changed">
+<function name="g_dbus_connection_new_sync">
<description>
-Signals that a list of keys have possibly changed. Backend
-implementations should call this if keys have possibly changed their
-values.
+Synchronously sets up a D-Bus connection for exchanging D-Bus messages
+with the end represented by @stream.
- path must be a valid path (ie starting and ending with a slash and
-not containing '//'). Each string in @items must form a valid key
-name when @path is prefixed to it (ie: each item must not start or
-end with '/' and must not contain '//').
+If @stream is a #GSocketConnection, then the corresponding #GSocket
+will be put into non-blocking mode.
-The meaning of this signal is that any of the key names resulting
-from the contatenation of @path with each item in @items may have
-changed.
+The D-Bus connection will interact with @stream from a worker thread.
+As a result, the caller should not interact with @stream after this
+method has been called, except by calling g_object_unref() on it.
-The same rules for when notifications must occur apply as per
-g_settings_backend_changed(). These two calls can be used
-interchangeably if exactly one item has changed (although in that
-case g_settings_backend_changed() is definitely preferred).
+If @observer is not %NULL it may be used to control the
+authentication process.
-For efficiency reasons, the implementation should strive for @path to
-be as long as possible (ie: the longest common prefix of all of the
-keys that were changed) but this is not strictly required.
+This is a synchronous failable constructor. See
+g_dbus_connection_new() for the asynchronous version.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="stream">
+<parameter_description> A #GIOStream.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path containing the changes
+<parameter name="guid">
+<parameter_description> The GUID to use if a authenticating as a server or %NULL.
</parameter_description>
</parameter>
-<parameter name="items">
-<parameter_description> the %NULL-terminated list of changed keys
+<parameter name="flags">
+<parameter_description> Flags describing how to make the connection.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusConnection or %NULL if @error is set. Free with g_object_unref().
+
+</return>
</function>
-<function name="g_settings_backend_path_changed">
+<function name="g_dbus_connection_register_object">
<description>
-Signals that all keys below a given path may have possibly changed.
-Backend implementations should call this if an entire path of keys
-have possibly changed their values.
+Registers callbacks for exported objects at @object_path with the
+D-Bus interface that is described in @interface_info.
- path must be a valid path (ie starting and ending with a slash and
-not containing '//').
+Calls to functions in @vtable (and @user_data_free_func) will
+happen in the <link linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from.
-The meaning of this signal is that any of the key which has a name
-starting with @path may have changed.
+Note that all #GVariant values passed to functions in @vtable will match
+the signature given in @interface_info - if a remote caller passes
+incorrect values, the <literal>org.freedesktop.DBus.Error.InvalidArgs</literal>
+is returned to the remote caller.
-The same rules for when notifications must occur apply as per
-g_settings_backend_changed(). This call might be an appropriate
-reasponse to a 'reset' call but implementations are also free to
-explicitly list the keys that were affected by that call if they can
-easily do so.
+Additionally, if the remote caller attempts to invoke methods or
+access properties not mentioned in @interface_info the
+<literal>org.freedesktop.DBus.Error.UnknownMethod</literal> resp.
+<literal>org.freedesktop.DBus.Error.InvalidArgs</literal> errors
+are returned to the caller.
-For efficiency reasons, the implementation should strive for @path to
-be as long as possible (ie: the longest common prefix of all of the
-keys that were changed) but this is not strictly required. As an
-example, if this function is called with the path of "/" then every
-single key in the application will be notified of a possible change.
+It is considered a programming error if the
+#GDBusInterfaceGetPropertyFunc function in @vtable returns a
+#GVariant of incorrect type.
+
+If an existing callback is already registered at @object_path and
+ interface_name, then @error is set to #G_IO_ERROR_EXISTS.
+
+GDBus automatically implements the standard D-Bus interfaces
+org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
+and org.freedesktop.Peer, so you don't have to implement those for
+the objects you export. You <emphasis>can</emphasis> implement
+org.freedesktop.DBus.Properties yourself, e.g. to handle getting
+and setting of properties asynchronously.
+
+Note that the reference count on @interface_info will be
+incremented by 1 (unless allocated statically, e.g. if the
+reference count is -1, see g_dbus_interface_info_ref()) for as long
+as the object is exported. Also note that @vtable will be copied.
+
+See <xref linkend="gdbus-server"/> for an example of how to use this method.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path containing the changes
+<parameter name="object_path">
+<parameter_description> The object path to register at.
</parameter_description>
</parameter>
-<parameter name="origin_tag">
-<parameter_description> the origin tag
+<parameter name="interface_info">
+<parameter_description> Introspection data for the interface.
+</parameter_description>
+</parameter>
+<parameter name="vtable">
+<parameter_description> A #GDBusInterfaceVTable to call into or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> Data to pass to functions in @vtable.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to call when the object path is unregistered.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> 0 if @error is set, otherwise a registration id (never 0)
+that can be used with g_dbus_connection_unregister_object() .
+
+</return>
</function>
-<function name="g_settings_backend_path_writable_changed">
+<function name="g_dbus_connection_register_subtree">
<description>
-Signals that the writability of all keys below a given path may have
-changed.
+Registers a whole subtree of <quote>dynamic</quote> objects.
-Since GSettings performs no locking operations for itself, this call
-will always be made in response to external events.
+The @enumerate and @introspection functions in @vtable are used to
+convey, to remote callers, what nodes exist in the subtree rooted
+by @object_path.
+
+When handling remote calls into any node in the subtree, first the
+ enumerate function is used to check if the node exists. If the node exists
+or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
+the @introspection function is used to check if the node supports the
+requested method. If so, the @dispatch function is used to determine
+where to dispatch the call. The collected #GDBusInterfaceVTable and
+#gpointer will be used to call into the interface vtable for processing
+the request.
+
+All calls into user-provided code will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from.
+
+If an existing subtree is already registered at @object_path or
+then @error is set to #G_IO_ERROR_EXISTS.
+
+Note that it is valid to register regular objects (using
+g_dbus_connection_register_object()) in a subtree registered with
+g_dbus_connection_register_subtree() - if so, the subtree handler
+is tried as the last resort. One way to think about a subtree
+handler is to consider it a <quote>fallback handler</quote>
+for object paths not registered via g_dbus_connection_register_object()
+or other bindings.
+
+Note that @vtable will be copied so you cannot change it after
+registration.
+
+See <xref linkend="gdbus-subtree-server"/> for an example of how to use this method.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the name of the path
+<parameter name="object_path">
+<parameter_description> The object path to register the subtree at.
+</parameter_description>
+</parameter>
+<parameter name="vtable">
+<parameter_description> A #GDBusSubtreeVTable to enumerate, introspect and dispatch nodes in the subtree.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags used to fine tune the behavior of the subtree.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> Data to pass to functions in @vtable.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to call when the subtree is unregistered.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> 0 if @error is set, otherwise a subtree registration id (never 0)
+that can be used with g_dbus_connection_unregister_subtree() .
+
+</return>
</function>
-<function name="g_settings_backend_writable_changed">
+<function name="g_dbus_connection_remove_filter">
<description>
-Signals that the writability of a single key has possibly changed.
-
-Since GSettings performs no locking operations for itself, this call
-will always be made in response to external events.
+Removes a filter.
Since: 2.26
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> a #GSettingsBackend implementation
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of the key
+<parameter name="filter_id">
+<parameter_description> an identifier obtained from g_dbus_connection_add_filter()
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_bind">
+<function name="g_dbus_connection_send_message">
<description>
-Create a binding between the @key in the @settings object
-and the property @property of @object.
+Asynchronously sends @message to the peer represented by @connection.
-The binding uses the default GIO mapping functions to map
-between the settings and property values. These functions
-handle booleans, numeric types and string types in a
-straightforward way. Use g_settings_bind_with_mapping() if
-you need a custom mapping, or map between types that are not
-supported by the default mapping functions.
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
-Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this
-function also establishes a binding between the writability of
- key and the "sensitive" property of @object (if @object has
-a boolean property by that name). See g_settings_bind_writable()
-for more details about writable bindings.
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
-Note that the lifecycle of the binding is tied to the object,
-and that you can have only one binding per object property.
-If you bind the same property twice on the same object, the second
-binding overrides the first one.
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Note that @message must be unlocked, unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to bind
+<parameter name="message">
+<parameter_description> A #GDBusMessage
</parameter_description>
</parameter>
-<parameter name="object">
-<parameter_description> a #GObject
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the name of the property to bind
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned
+to @message when sending it or %NULL.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags for the binding
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the message was well-formed and queued for
+transmission, %FALSE if @error is set.
+
+</return>
</function>
-<function name="g_settings_bind_with_mapping">
+<function name="g_dbus_connection_send_message_with_reply">
<description>
-Create a binding between the @key in the @settings object
-and the property @property of @object.
+Asynchronously sends @message to the peer represented by @connection.
-The binding uses the provided mapping functions to map between
-settings and property values.
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
-Note that the lifecycle of the binding is tied to the object,
-and that you can have only one binding per object property.
-If you bind the same property twice on the same object, the second
-binding overrides the first one.
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+
+This is an asynchronous method. When the operation is finished, @callback will be invoked
+in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+of the thread you are calling this method from. You can then call
+g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
+See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
+
+Note that @message must be unlocked, unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to bind
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="object">
-<parameter_description> a #GObject
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the name of the property to bind
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> flags for the binding
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned
+to @message when sending it or %NULL.
</parameter_description>
</parameter>
-<parameter name="get_mapping">
-<parameter_description> a function that gets called to convert values
-from @settings to @object, or %NULL to use the default GIO mapping
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="set_mapping">
-<parameter_description> a function that gets called to convert values
-from @object to @settings, or %NULL to use the default GIO mapping
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is
+satisfied or %NULL if you don't care about the result.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> data that gets passed to @get_mapping and @set_mapping
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
-<parameter name="destroy">
-<parameter_description> #GDestroyNotify function for @user_data
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_connection_send_message_with_reply_finish">
+<description>
+Finishes an operation started with g_dbus_connection_send_message_with_reply().
+
+Note that @error is only set if a local in-process error
+occurred. That is to say that the returned #GDBusMessage object may
+be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+g_dbus_message_to_gerror() to transcode this to a #GError.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_send_message_with_reply().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A locked #GDBusMessage or %NULL if @error is set.
+
+</return>
</function>
-<function name="g_settings_bind_writable">
+<function name="g_dbus_connection_send_message_with_reply_sync">
<description>
-Create a binding between the writability of @key in the
- settings object and the property @property of @object.
-The property must be boolean; "sensitive" or "visible"
-properties of widgets are the most likely candidates.
+Synchronously sends @message to the peer represented by @connection
+and blocks the calling thread until a reply is received or the
+timeout is reached. See g_dbus_connection_send_message_with_reply()
+for the asynchronous version of this method.
-Writable bindings are always uni-directional; changes of the
-writability of the setting will be propagated to the object
-property, not the other way.
+Unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+will be assigned by @connection and set on @message via
+g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
+serial number used will be written to this location prior to
+submitting the message to the underlying transport.
-When the @inverted argument is %TRUE, the binding inverts the
-value as it passes from the setting to the object, i.e. @property
-will be set to %TRUE if the key is <emphasis>not</emphasis>
-writable.
+If @connection is closed then the operation will fail with
+%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
+fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
+the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
-Note that the lifecycle of the binding is tied to the object,
-and that you can have only one binding per object property.
-If you bind the same property twice on the same object, the second
-binding overrides the first one.
+Note that @error is only set if a local in-process error
+occurred. That is to say that the returned #GDBusMessage object may
+be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+g_dbus_message_to_gerror() to transcode this to a #GError.
+
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
+
+Note that @message must be unlocked, unless @flags contain the
+%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to bind
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="object">
-<parameter_description>a #GObject
+<parameter name="flags">
+<parameter_description> Flags affecting how the message is sent.
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the name of a boolean property to bind
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds, -1 to use the default
+timeout or %G_MAXINT for no timeout.
</parameter_description>
</parameter>
-<parameter name="inverted">
-<parameter_description> whether to 'invert' the value
+<parameter name="out_serial">
+<parameter_description> Return location for serial number assigned
+to @message when sending it or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A locked #GDBusMessage that is the reply to @message or %NULL if @error is set.
+
+</return>
</function>
-<function name="g_settings_delay">
+<function name="g_dbus_connection_set_exit_on_close">
<description>
-Changes the #GSettings object into 'delay-apply' mode. In this
-mode, changes to @settings are not immediately propagated to the
-backend, but kept locally until g_settings_apply() is called.
+Sets whether the process should be terminated when @connection is
+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.
+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.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+<parameter name="exit_on_close">
+<parameter_description> Whether the process should be terminated
+when @connection is closed by the remote peer.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_get">
+<function name="g_dbus_connection_signal_subscribe">
<description>
-Gets the value that is stored at @key in @settings.
+Subscribes to signals on @connection and invokes @callback with a
+whenever the signal is received. Note that @callback
+will be invoked in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread you are calling this method from.
-A convenience function that combines g_settings_get_value() with
-g_variant_get().
+If @connection is not a message bus connection, @sender must be
+%NULL.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or for the #GVariantType of @format to mismatch
-the type given in the schema.
+If @sender is a well-known name note that @callback is invoked with
+the unique name for the owner of @sender, not the well-known name
+as one would expect. This is because the message bus rewrites the
+name. As such, to avoid certain race conditions, users should be
+tracking the name owner of the well-known name and use that when
+processing the received signal.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="sender">
+<parameter_description> Sender name to match on (unique or well-known name)
+or %NULL to listen from all senders.
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a #GVariant format string
+<parameter name="interface_name">
+<parameter_description> D-Bus interface name to match on or %NULL to
+match on all interfaces.
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> arguments as per @format
+<parameter name="member">
+<parameter_description> D-Bus signal name to match on or %NULL to match on all signals.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Object path to match on or %NULL to match on all object paths.
+</parameter_description>
+</parameter>
+<parameter name="arg0">
+<parameter_description> Contents of first string argument to match on or %NULL
+to match on all kinds of arguments.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags describing how to subscribe to the signal (currently unused).
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> Callback to invoke when there is a signal matching the requested data.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> Function to free @user_data with when
+subscription is removed or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe().
+
+</return>
</function>
-<function name="g_settings_get_boolean">
+<function name="g_dbus_connection_signal_unsubscribe">
<description>
-Gets the value that is stored at @key in @settings.
-
-A convenience variant of g_settings_get() for booleans.
-
-It is a programmer error to give a @key that isn't specified as
-having a boolean type in the schema for @settings.
+Unsubscribes from signals.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="subscription_id">
+<parameter_description> A subscription id obtained from g_dbus_connection_signal_subscribe().
</parameter_description>
</parameter>
</parameters>
-<return> a boolean
-</return>
+<return></return>
</function>
-<function name="g_settings_get_child">
+<function name="g_dbus_connection_start_message_processing">
<description>
-Creates a 'child' settings object which has a base path of
-<replaceable>base-path</replaceable>/@name, where
-<replaceable>base-path</replaceable> is the base path of @settings.
-
-The schema for the child settings object must have been declared
-in the schema of @settings using a <tag class="starttag">child</tag> element.
+If @connection was created with
+%G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
+starts processing messages. Does nothing on if @connection wasn't
+created with this flag or if the method has already been called.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> the name of the 'child' schema
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> a 'child' settings object
-</return>
+<return></return>
</function>
-<function name="g_settings_get_double">
+<function name="g_dbus_connection_unexport_action_group">
<description>
-Gets the value that is stored at @key in @settings.
+Reverses the effect of a previous call to
+g_dbus_connection_export_action_group().
-A convenience variant of g_settings_get() for doubles.
-
-It is a programmer error to give a @key that isn't specified as
-having a 'double' type in the schema for @settings.
+It is an error to call this function with an ID that wasn't returned
+from g_dbus_connection_export_action_group() or to call it with the
+same ID more than once.
-Since: 2.26
+Since: 2.32
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="export_id">
+<parameter_description> the ID from g_dbus_connection_export_action_group()
</parameter_description>
</parameter>
</parameters>
-<return> a double
-</return>
+<return></return>
</function>
-<function name="g_settings_get_enum">
+<function name="g_dbus_connection_unexport_menu_model">
<description>
-Gets the value that is stored in @settings for @key and converts it
-to the enum value that it represents.
+Reverses the effect of a previous call to
+g_dbus_connection_export_menu_model().
-In order to use this function the type of the value must be a string
-and it must be marked in the schema file as an enumerated type.
+It is an error to call this function with an ID that wasn't returned
+from g_dbus_connection_export_menu_model() or to call it with the
+same ID more than once.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or is not marked as an enumerated type.
+Since: 2.32
-If the value stored in the configuration database is not a valid
-value for the enumerated type then this function will return the
-default value.
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+<parameter name="export_id">
+<parameter_description> the ID from g_dbus_connection_export_menu_model()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_connection_unregister_object">
+<description>
+Unregisters an object.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="registration_id">
+<parameter_description> A registration id obtained from g_dbus_connection_register_object().
</parameter_description>
</parameter>
</parameters>
-<return> the enum value
+<return> %TRUE if the object was unregistered, %FALSE otherwise.
+
</return>
</function>
-<function name="g_settings_get_flags">
+<function name="g_dbus_connection_unregister_subtree">
<description>
-Gets the value that is stored in @settings for @key and converts it
-to the flags value that it represents.
-
-In order to use this function the type of the value must be an array
-of strings and it must be marked in the schema file as an flags type.
-
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or is not marked as a flags type.
-
-If the value stored in the configuration database is not a valid
-value for the flags type then this function will return the default
-value.
+Unregisters a subtree.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="registration_id">
+<parameter_description> A subtree registration id obtained from g_dbus_connection_register_subtree().
</parameter_description>
</parameter>
</parameters>
-<return> the flags value
+<return> %TRUE if the subtree was unregistered, %FALSE otherwise.
+
</return>
</function>
-<function name="g_settings_get_has_unapplied">
+<function name="g_dbus_error_encode_gerror">
<description>
-Returns whether the #GSettings object has any unapplied
-changes. This can only be the case if it is in 'delayed-apply' mode.
+Creates a D-Bus error name to use for @error. If @error matches
+a registered error (cf. g_dbus_error_register_error()), the corresponding
+D-Bus error name will be returned.
+
+Otherwise the a name of the form
+<literal>org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE</literal>
+will be used. This allows other GDBus applications to map the error
+on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
+
+This function is typically only used in object mappings to put a
+#GError on the wire. Regular applications should not use it.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @settings has unapplied changes
+<return> A D-Bus error name (never %NULL). Free with g_free().
+
</return>
</function>
-<function name="g_settings_get_int">
+<function name="g_dbus_error_get_remote_error">
<description>
-Gets the value that is stored at @key in @settings.
-
-A convenience variant of g_settings_get() for 32-bit integers.
+Gets the D-Bus error name used for @error, if any.
-It is a programmer error to give a @key that isn't specified as
-having a int32 type in the schema for @settings.
+This function is guaranteed to return a D-Bus error name for all
+#GError<!-- -->s returned from functions handling remote method
+calls (e.g. g_dbus_connection_call_finish()) unless
+g_dbus_error_strip_remote_error() has been used on @error.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+</parameters>
+<return> An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free().
+
+</return>
+</function>
+
+<function name="g_dbus_error_is_remote_error">
+<description>
+Checks if @error represents an error received via D-Bus from a remote peer. If so,
+use g_dbus_error_get_remote_error() to get the name of the error.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return> an integer
+<return> %TRUE if @error represents an error from a remote peer,
+%FALSE otherwise.
+
</return>
</function>
-<function name="g_settings_get_mapped">
+<function name="g_dbus_error_new_for_dbus_error">
<description>
-Gets the value that is stored at @key in @settings, subject to
-application-level validation/mapping.
+Creates a #GError based on the contents of @dbus_error_name and
+ dbus_error_message
-You should use this function when the application needs to perform
-some processing on the value of the key (for example, parsing). The
- mapping function performs that processing. If the function
-indicates that the processing was unsuccessful (due to a parse error,
-for example) then the mapping is tried again with another value.
+Errors registered with g_dbus_error_register_error() will be looked
+up using @dbus_error_name and if a match is found, the error domain
+and code is used. Applications can use g_dbus_error_get_remote_error()
+to recover @dbus_error_name.
-This allows a robust 'fall back to defaults' behaviour to be
-implemented somewhat automatically.
+If a match against a registered error is not found and the D-Bus
+error name is in a form as returned by g_dbus_error_encode_gerror()
+the error domain and code encoded in the name is used to
+create the #GError. Also, @dbus_error_name is added to the error message
+such that it can be recovered with g_dbus_error_get_remote_error().
-The first value that is tried is the user's setting for the key. If
-the mapping function fails to map this value, other values may be
-tried in an unspecified order (system or site defaults, translated
-schema default values, untranslated schema default values, etc).
+Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
+in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
+added to the error message such that it can be recovered with
+g_dbus_error_get_remote_error().
-If the mapping function fails for all possible values, one additional
-attempt is made: the mapping function is called with a %NULL value.
-If the mapping function still indicates failure at this point then
-the application will be aborted.
+In all three cases, @dbus_error_name can always be recovered from the
+returned #GError using the g_dbus_error_get_remote_error() function
+(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
-The result parameter for the @mapping function is pointed to a
-#gpointer which is initially set to %NULL. The same pointer is given
-to each invocation of @mapping. The final value of that #gpointer is
-what is returned by this function. %NULL is valid; it is returned
-just as any other value would be.
+This function is typically only used in object mappings to prepare
+#GError instances for applications. Regular applications should not use
+it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
-</parameter_description>
-</parameter>
-<parameter name="mapping">
-<parameter_description> the function to map the value in the
-settings database to the value used by the application
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for @mapping
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
</parameter_description>
</parameter>
</parameters>
-<return> the result, which may be %NULL
+<return> An allocated #GError. Free with g_error_free().
+
</return>
</function>
-<function name="g_settings_get_range">
+<function name="g_dbus_error_register_error">
<description>
-Queries the range of a key.
+Creates an association to map between @dbus_error_name and
+#GError<!-- -->s specified by @error_domain and @error_code.
-This function will return a #GVariant that fully describes the range
-of values that are valid for @key.
+This is typically done in the routine that returns the #GQuark for
+an error domain.
-The type of #GVariant returned is <literal>(sv)</literal>. The
-string describes the type of range restriction in effect. The type
-and meaning of the value contained in the variant depends on the
-string.
+Since: 2.26
-If the string is <literal>'type'</literal> then the variant contains
-an empty array. The element type of that empty array is the expected
-type of value and all values of that type are valid.
-
-If the string is <literal>'enum'</literal> then the variant contains
-an array enumerating the possible values. Each item in the array is
-a possible valid value and no other values are valid.
-
-If the string is <literal>'flags'</literal> then the variant contains
-an array. Each item in the array is a value that may appear zero or
-one times in an array to be used as the value for this key. For
-example, if the variant contained the array <literal>['x',
-'y']</literal> then the valid values for the key would be
-<literal>[]</literal>, <literal>['x']</literal>,
-<literal>['y']</literal>, <literal>['x', 'y']</literal> and
-<literal>['y', 'x']</literal>.
-
-Finally, if the string is <literal>'range'</literal> then the variant
-contains a pair of like-typed values -- the minimum and maximum
-permissible values for this key.
-
-This information should not be used by normal programs. It is
-considered to be a hint for introspection purposes. Normal programs
-should already know what is permitted by their own schema. The
-format may change in any way in the future -- but particularly, new
-forms may be added to the possibilities described above.
+</description>
+<parameters>
+<parameter name="error_domain">
+<parameter_description> A #GQuark for a error domain.
+</parameter_description>
+</parameter>
+<parameter name="error_code">
+<parameter_description> An error code.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> A D-Bus error name.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the association was created, %FALSE if it already
+exists.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings.
+</return>
+</function>
-You should free the returned value with g_variant_unref() when it is
-no longer needed.
+<function name="g_dbus_error_register_error_domain">
+<description>
+Helper function for associating a #GError error domain with D-Bus error names.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings
+<parameter name="error_domain_quark_name">
+<parameter_description> The error domain name.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to query the range of
+<parameter name="quark_volatile">
+<parameter_description> A pointer where to store the #GQuark.
+</parameter_description>
+</parameter>
+<parameter name="entries">
+<parameter_description> A pointer to @num_entries #GDBusErrorEntry struct items.
+</parameter_description>
+</parameter>
+<parameter name="num_entries">
+<parameter_description> Number of items to register.
</parameter_description>
</parameter>
</parameters>
-<return> a #GVariant describing the range
-</return>
+<return></return>
</function>
-<function name="g_settings_get_string">
+<function name="g_dbus_error_set_dbus_error">
<description>
-Gets the value that is stored at @key in @settings.
-
-A convenience variant of g_settings_get() for strings.
-
-It is a programmer error to give a @key that isn't specified as
-having a string type in the schema for @settings.
+Does nothing if @error is %NULL. Otherwise sets * error to
+a new #GError created with g_dbus_error_new_for_dbus_error()
+with @dbus_error_message prepend with @format (unless %NULL).
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="error">
+<parameter_description> A pointer to a #GError or %NULL.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> Arguments for @format.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string
-</return>
+<return></return>
</function>
-<function name="g_settings_get_strv">
+<function name="g_dbus_error_set_dbus_error_valist">
<description>
-A convenience variant of g_settings_get() for string arrays.
-
-It is a programmer error to give a @key that isn't specified as
-having an array of strings type in the schema for @settings.
+Like g_dbus_error_set_dbus_error() but intended for language bindings.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="error">
+<parameter_description> A pointer to a #GError or %NULL.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="dbus_error_name">
+<parameter_description> D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_message">
+<parameter_description> D-Bus error message.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format to prepend to @dbus_error_message or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> Arguments for @format.
</parameter_description>
</parameter>
</parameters>
-<return> a
-newly-allocated, %NULL-terminated array of strings, the value that
-is stored at @key in @settings.
-</return>
+<return></return>
</function>
-<function name="g_settings_get_value">
+<function name="g_dbus_error_strip_remote_error">
<description>
-Gets the value that is stored in @settings for @key.
+Looks for extra information in the error message used to recover
+the D-Bus error name and strips it if found. If stripped, the
+message field in @error will correspond exactly to what was
+received on the wire.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings.
+This is typically used when presenting errors to the end user.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the key to get the value for
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GVariant
+<return> %TRUE if information was stripped, %FALSE otherwise.
+
</return>
</function>
-<function name="g_settings_is_writable">
+<function name="g_dbus_error_unregister_error">
<description>
-Finds out if a key can be written or not
+Destroys an association previously set up with g_dbus_error_register_error().
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="error_domain">
+<parameter_description> A #GQuark for a error domain.
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name of a key
+<parameter name="error_code">
+<parameter_description> An error code.
+</parameter_description>
+</parameter>
+<parameter name="dbus_error_name">
+<parameter_description> A D-Bus error name.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the key @name is writable
+<return> %TRUE if the association was destroyed, %FALSE if it wasn't found.
+
</return>
</function>
-<function name="g_settings_list_children">
+<function name="g_dbus_generate_guid">
<description>
-Gets the list of children on @settings.
+Generate a D-Bus GUID that can be used with
+e.g. g_dbus_connection_new().
-The list is exactly the list of strings for which it is not an error
-to call g_settings_get_child().
+See the D-Bus specification regarding what strings are valid D-Bus
+GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
-For GSettings objects that are lists, this value can change at any
-time and you should connect to the "children-changed" signal to watch
-for those changes. Note that there is a race condition here: you may
-request a child after listing it only for it to have been destroyed
-in the meantime. For this reason, g_settings_get_child() may return
-%NULL even for a child that was listed by this function.
+Since: 2.26
-For GSettings objects that are not lists, you should probably not be
-calling this function from "normal" code (since you should already
-know what children are in your schema). This function may still be
-useful there for introspection reasons, however.
+</description>
+<parameters>
+</parameters>
+<return> A valid D-Bus GUID. Free with g_free().
-You should free the return value with g_strfreev() when you are done
-with it.
+</return>
+</function>
+
+<function name="g_dbus_gvalue_to_gvariant">
+<description>
+Converts a #GValue to a #GVariant of the type indicated by the @type parameter.
+
+The conversion is using the following rules:
+<table frame='all'>
+<title>#GValue / #GVariant conversion rules</title>
+<tgroup cols='2' align='left' colsep='1' rowsep='1'>
+<thead>
+<row>
+<entry>If the #GType for @gvalue is...</entry>
+<entry>... then @type must be</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>#G_TYPE_STRING</entry>
+<entry><link linkend="G-VARIANT-TYPE-STRING:CAPS">'s'</link>, <link linkend="G-VARIANT-TYPE-OBJECT-PATH:CAPS">'o'</link>, <link linkend="G-VARIANT-TYPE-SIGNATURE:CAPS">'g'</link> or <link linkend="G-VARIANT-TYPE-BYTESTRING:CAPS">'ay'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_STRV</entry>
+<entry><link linkend="G-VARIANT-TYPE-STRING-ARRAY:CAPS">'as'</link>, <link linkend="G-VARIANT-TYPE-OBJECT-PATH-ARRAY:CAPS">'ao'</link> or <link linkend="G-VARIANT-TYPE-BYTESTRING-ARRAY:CAPS">'aay'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_BOOLEAN</entry>
+<entry><link linkend="G-VARIANT-TYPE-BOOLEAN:CAPS">'b'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_UCHAR</entry>
+<entry><link linkend="G-VARIANT-TYPE-BYTE:CAPS">'y'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_INT</entry>
+<entry><link linkend="G-VARIANT-TYPE-INT32:CAPS">'i'</link> or <link linkend="G-VARIANT-TYPE-INT16:CAPS">'n'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_UINT</entry>
+<entry><link linkend="G-VARIANT-TYPE-UINT32:CAPS">'u'</link> or <link linkend="G-VARIANT-TYPE-UINT16:CAPS">'q'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_INT64</entry>
+<entry><link linkend="G-VARIANT-TYPE-INT64:CAPS">'x'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_UINT64</entry>
+<entry><link linkend="G-VARIANT-TYPE-UINT64:CAPS">'t'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_DOUBLE</entry>
+<entry><link linkend="G-VARIANT-TYPE-DOUBLE:CAPS">'d'</link></entry>
+</row>
+<row>
+<entry>#G_TYPE_VARIANT</entry>
+<entry>Any #GVariantType</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type
+is <link linkend="G-VARIANT-TYPE-INT32:CAPS">'i'</link>. It will
+also fail for any #GType (including e.g. #G_TYPE_OBJECT and
+#G_TYPE_BOXED derived-types) not in the table above.
+
+Note that if @gvalue is of type #G_TYPE_VARIANT and its value is
+%NULL, the <emphasis>empty</emphasis> #GVariant instance (never
+%NULL) for @type is returned (e.g. 0 for scalar types, the empty
+string for string types, <literal>'/'</literal> for object path
+types, the empty array for any array type and so on).
+
+See the g_dbus_gvariant_to_gvalue() function for how to convert a
+#GVariant to a #GValue.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="gvalue">
+<parameter_description> A #GValue to convert to a #GVariant.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> A #GVariantType.
</parameter_description>
</parameter>
</parameters>
-<return> a list of the children on @settings
+<return> A #GVariant (never floating) of #GVariantType
+ type holding the data from @gvalue or %NULL in case of
+failure. Free with g_variant_unref().
+
</return>
</function>
-<function name="g_settings_list_keys">
+<function name="g_dbus_gvariant_to_gvalue">
<description>
-Introspects the list of keys on @settings.
+Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
-You should probably not be calling this function from "normal" code
-(since you should already know what keys are in your schema). This
-function is intended for introspection reasons.
+The rules specified in the g_dbus_gvalue_to_gvariant() function are
+used - this function is essentially its reverse form.
-You should free the return value with g_strfreev() when you are done
-with it.
+The conversion never fails - a valid #GValue is always returned in
+ out_gvalue
+
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="value">
+<parameter_description> A #GVariant.
+</parameter_description>
+</parameter>
+<parameter name="out_gvalue">
+<parameter_description> Return location pointing to a zero-filled (uninitialized) #GValue.
</parameter_description>
</parameter>
</parameters>
-<return> a list of the keys on @settings
-</return>
+<return></return>
</function>
-<function name="g_settings_list_relocatable_schemas">
+<function name="g_dbus_interface_dup_object">
<description>
-Gets a list of the relocatable #GSettings schemas installed on the
-system. These are schemas that do not provide their own path. It is
-usual to instantiate these schemas directly, but if you want to you
-can use g_settings_new_with_path() to specify the path.
+Gets the #GDBusObject that @interface_ belongs to, if any.
-The output of this function, tTaken together with the output of
-g_settings_list_schemas() represents the complete list of all
-installed schemas.
+Since: 2.32
-Since: 2.28
</description>
<parameters>
+<parameter name="interface_">
+<parameter_description> An exported D-Bus interface.
+</parameter_description>
+</parameter>
</parameters>
-<return> a list of relocatable
-#GSettings schemas that are available. The list must not be
-modified or freed.
+<return> A #GDBusObject or %NULL. The returned
+reference should be freed with g_object_unref().
</return>
</function>
-<function name="g_settings_list_schemas">
+<function name="g_dbus_interface_get_info">
<description>
-Gets a list of the #GSettings schemas installed on the system. The
-returned list is exactly the list of schemas for which you may call
-g_settings_new() without adverse effects.
-
-This function does not list the schemas that do not provide their own
-paths (ie: schemas for which you must use
-g_settings_new_with_path()). See
-g_settings_list_relocatable_schemas() for that.
+Gets D-Bus introspection information for the D-Bus interface
+implemented by @interface_.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
+<parameter name="interface_">
+<parameter_description> An exported D-Bus interface.
+</parameter_description>
+</parameter>
</parameters>
-<return> a list of #GSettings
-schemas that are available. The list must not be modified or
-freed.
+<return> A #GDBusInterfaceInfo. Do not free.
</return>
</function>
-<function name="g_settings_new">
+<function name="g_dbus_interface_get_object">
<description>
-Creates a new #GSettings object with a given schema.
+Gets the #GDBusObject that @interface_ belongs to, if any.
-Signals on the newly created #GSettings object will be dispatched
-via the thread-default #GMainContext in effect at the time of the
-call to g_settings_new(). The new #GSettings will hold a reference
-on the context. See g_main_context_push_thread_default().
+<warning>It is not safe to use the returned object if @interface_
+or the returned object is being used from other threads. See
+g_dbus_interface_dup_object() for a thread-safe
+alternative.</warning>
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="interface_">
+<parameter_description> An exported D-Bus interface.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
+<return> A #GDBusObject or %NULL. The returned
+reference belongs to @interface_ and should not be freed.
+
</return>
</function>
-<function name="g_settings_new_with_backend">
+<function name="g_dbus_interface_info_cache_build">
<description>
-Creates a new #GSettings object with a given schema and backend.
+Builds a lookup-cache to speed up
+g_dbus_interface_info_lookup_method(),
+g_dbus_interface_info_lookup_signal() and
+g_dbus_interface_info_lookup_property().
-Creating settings objects with an different backend allows accessing settings
-from a database other than the usual one. For example, it may make
-sense to pass a backend corresponding to the "defaults" settings database on
-the system to get a settings object that modifies the system default
-settings instead of the settings for this user.
+If this has already been called with @info, the existing cache is
+used and its use count is increased.
-Since: 2.26
+Note that @info cannot be modified until
+g_dbus_interface_info_cache_release() is called.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
-<parameter name="backend">
-<parameter_description> the #GSettingsBackend to use
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_interface_info_cache_release">
+<description>
+Decrements the usage count for the cache for @info built by
+g_dbus_interface_info_cache_build() (if any) and frees the
+resources used by the cache if the usage count drops to zero.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A GDBusInterfaceInfo
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
-</return>
+<return></return>
</function>
-<function name="g_settings_new_with_backend_and_path">
+<function name="g_dbus_interface_info_generate_xml">
<description>
-Creates a new #GSettings object with a given schema, backend and
-path.
+Appends an XML representation of @info (and its children) to @string_builder.
-This is a mix of g_settings_new_with_backend() and
-g_settings_new_with_path().
+This function is typically used for generating introspection XML
+documents at run-time for handling the
+<literal>org.freedesktop.DBus.Introspectable.Introspect</literal>
+method.
Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
</parameter_description>
</parameter>
-<parameter name="backend">
-<parameter_description> the #GSettingsBackend to use
+<parameter name="indent">
+<parameter_description> Indentation level.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path to use
+<parameter name="string_builder">
+<parameter_description> A #GString to to append XML data to.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
-</return>
+<return></return>
</function>
-<function name="g_settings_new_with_path">
+<function name="g_dbus_interface_info_lookup_method">
<description>
-Creates a new #GSettings object with a given schema and path.
-
-You only need to do this if you want to directly create a settings
-object with a schema that doesn't have a specified path of its own.
-That's quite rare.
+Looks up information about a method.
-It is a programmer error to call this function for a schema that
-has an explicitly specified path.
+This cost of this function is O(n) in number of methods unless
+g_dbus_interface_info_cache_build() has been used on @info.
Since: 2.26
</description>
<parameters>
-<parameter name="schema">
-<parameter_description> the name of the schema
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
-<parameter name="path">
-<parameter_description> the path to use
+<parameter name="name">
+<parameter_description> A D-Bus method name (typically in CamelCase)
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSettings object
+<return> A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
+
</return>
</function>
-<function name="g_settings_range_check">
+<function name="g_dbus_interface_info_lookup_property">
<description>
-Checks if the given @value is of the correct type and within the
-permitted range for @key.
-
-This API is not intended to be used by normal programs -- they should
-already know what is permitted by their own schemas. This API is
-meant to be used by programs such as editors or commandline tools.
+Looks up information about a property.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings.
+This cost of this function is O(n) in number of properties unless
+g_dbus_interface_info_cache_build() has been used on @info.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the key to check
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to check
+<parameter name="name">
+<parameter_description> A D-Bus property name (typically in CamelCase).
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @value is valid for @key
+<return> A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
+
</return>
</function>
-<function name="g_settings_reset">
+<function name="g_dbus_interface_info_lookup_signal">
<description>
-Resets @key to its default value.
+Looks up information about a signal.
-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
-administrator.
+This cost of this function is O(n) in number of signals unless
+g_dbus_interface_info_cache_build() has been used on @info.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of a key
+<parameter name="name">
+<parameter_description> A D-Bus signal name (typically in CamelCase)
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
+
+</return>
</function>
-<function name="g_settings_revert">
+<function name="g_dbus_interface_info_ref">
<description>
-Reverts all non-applied changes to the settings. This function
-does nothing unless @settings is in 'delay-apply' mode; see
-g_settings_delay(). In the normal case settings are always applied
-immediately.
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
-Change notifications will be emitted for affected keys.
+Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings instance
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The same @info.
+
+</return>
</function>
-<function name="g_settings_set">
+<function name="g_dbus_interface_info_unref">
<description>
-Sets @key in @settings to @value.
-
-A convenience function that combines g_settings_set_value() with
-g_variant_new().
-
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or for the #GVariantType of @format to mismatch
-the type given in the schema.
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
Since: 2.26
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a #GVariant format string
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> arguments as per @format
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
-</return>
+<return></return>
</function>
-<function name="g_settings_set_boolean">
+<function name="g_dbus_interface_set_object">
<description>
-Sets @key in @settings to @value.
-
-A convenience variant of g_settings_set() for booleans.
+Sets the #GDBusObject for @interface_ to @object.
-It is a programmer error to give a @key that isn't specified as
-having a boolean type in the schema for @settings.
+Note that @interface_ will hold a weak reference to @object.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
+<parameter name="interface_">
+<parameter_description> An exported D-Bus interface.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to
+<parameter name="object">
+<parameter_description> A #GDBusObject or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
-</return>
+<return></return>
</function>
-<function name="g_settings_set_double">
+<function name="g_dbus_interface_skeleton_export">
<description>
-Sets @key in @settings to @value.
+Exports @interface_ at @object_path on @connection.
-A convenience variant of g_settings_set() for doubles.
+This can be called multiple times to export the same @interface_
+onto multiple connections however the @object_path provided must be
+the same for all connections.
-It is a programmer error to give a @key that isn't specified as
-having a 'double' type in the schema for @settings.
+Use g_dbus_interface_skeleton_unexport() to unexport the object.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="interface_">
+<parameter_description> The D-Bus interface to export.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
+<parameter name="connection">
+<parameter_description> A #GDBusConnection to export @interface_ on.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to
+<parameter name="object_path">
+<parameter_description> The path to export the interface at.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
+<return> %TRUE if the interface was exported on @connection, otherwise %FALSE with
+ error set.
+
</return>
</function>
-<function name="g_settings_set_enum">
+<function name="g_dbus_interface_skeleton_flush">
<description>
-Looks up the enumerated type nick for @value and writes it to @key,
-within @settings.
+If @interface_ has outstanding changes, request for these changes to be
+emitted immediately.
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or is not marked as an enumerated type, or for
- value not to be a valid value for the named type.
+For example, an exported D-Bus interface may queue up property
+changes and emit the
+<literal>org.freedesktop.DBus.Properties::PropertiesChanged</literal>
+signal later (e.g. in an idle handler). This technique is useful
+for collapsing multiple property changes into one.
-After performing the write, accessing @key directly with
-g_settings_get_string() will return the 'nick' associated with
- value
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> a key, within @settings
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> an enumerated value
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE, if the set succeeds
-</return>
+<return></return>
</function>
-<function name="g_settings_set_flags">
+<function name="g_dbus_interface_skeleton_get_connection">
<description>
-Looks up the flags type nicks for the bits specified by @value, puts
-them in an array of strings and writes the array to @key, withing
- settings
-
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or is not marked as a flags type, or for @value
-to contain any bits that are not value for the named type.
+Gets the first connection that @interface_ is exported on, if any.
-After performing the write, accessing @key directly with
-g_settings_get_strv() will return an array of 'nicks'; one for each
-bit in @value.
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> a key, within @settings
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> a flags value
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE, if the set succeeds
+<return> A #GDBusConnection or %NULL if @interface_ is
+not exported anywhere. Do not free, the object belongs to @interface_.
+
</return>
</function>
-<function name="g_settings_set_int">
+<function name="g_dbus_interface_skeleton_get_connections">
<description>
-Sets @key in @settings to @value.
-
-A convenience variant of g_settings_set() for 32-bit integers.
-
-It is a programmer error to give a @key that isn't specified as
-having a int32 type in the schema for @settings.
+Gets a list of the connections that @interface_ is exported on.
-Since: 2.26
+Since: 2.32
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
+<return> A list of
+all the connections that @interface_ is exported on. The returned
+list should be freed with g_list_free() after each element has
+been freed with g_object_unref().
+
</return>
</function>
-<function name="g_settings_set_string">
+<function name="g_dbus_interface_skeleton_get_flags">
<description>
-Sets @key in @settings to @value.
-
-A convenience variant of g_settings_set() for strings.
-
-It is a programmer error to give a @key that isn't specified as
-having a string type in the schema for @settings.
+Gets the #GDBusInterfaceSkeletonFlags that describes what the behavior
+of @interface_
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
+</parameters>
+<return> One or more flags from the #GDBusInterfaceSkeletonFlags enumeration.
+
+</return>
+</function>
+
+<function name="g_dbus_interface_skeleton_get_info">
+<description>
+Gets D-Bus introspection information for the D-Bus interface
+implemented by @interface_.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to
+</parameters>
+<return> A #GDBusInterfaceInfo (never %NULL). Do not free.
+
+</return>
+</function>
+
+<function name="g_dbus_interface_skeleton_get_object_path">
+<description>
+Gets the object path that @interface_ is exported on, if any.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
+<return> A string owned by @interface_ or %NULL if @interface_ is not exported
+anywhere. Do not free, the string belongs to @interface_.
+
</return>
</function>
-<function name="g_settings_set_strv">
+<function name="g_dbus_interface_skeleton_get_properties">
<description>
-Sets @key in @settings to @value.
+Gets all D-Bus properties for @interface_.
-A convenience variant of g_settings_set() for string arrays. If
- value is %NULL, then @key is set to be the empty array.
+Since: 2.30
-It is a programmer error to give a @key that isn't specified as
-having an array of strings type in the schema for @settings.
+</description>
+<parameters>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GVariant of type <link linkend="G-VARIANT-TYPE-VARDICT:CAPS">'a{sv}'</link>. Free with g_variant_unref().
-Since: 2.26
+</return>
+</function>
+
+<function name="g_dbus_interface_skeleton_get_vtable">
+<description>
+Gets the interface vtable for the D-Bus interface implemented by
+ interface_ The returned function pointers should expect @interface_
+itself to be passed as @user_data.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
+</parameters>
+<return> A #GDBusInterfaceVTable (never %NULL).
+
+</return>
+</function>
+
+<function name="g_dbus_interface_skeleton_has_connection">
+<description>
+Checks if @interface_ is export on @connection.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to set it to, or %NULL
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
+<return> %TRUE if @interface_ is exported on @connection, %FALSE otherwise.
+
</return>
</function>
-<function name="g_settings_set_value">
+<function name="g_dbus_interface_skeleton_set_flags">
<description>
-Sets @key in @settings to @value.
-
-It is a programmer error to give a @key that isn't contained in the
-schema for @settings or for @value to have the incorrect type, per
-the schema.
-
-If @value is floating then this function consumes the reference.
+Sets flags describing what the behavior of @skeleton should be.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="settings">
-<parameter_description> a #GSettings object
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> the name of the key to set
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a #GVariant of the correct type
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusInterfaceSkeletonFlags enumeration.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if setting the key succeeded,
-%FALSE if the key was not writable
-</return>
+<return></return>
</function>
-<function name="g_settings_sync">
+<function name="g_dbus_interface_skeleton_unexport">
<description>
-Ensures that all pending operations for the given are complete for
-the default backend.
+Stops exporting @interface_ on all connections it is exported on.
-Writes made to a #GSettings are handled asynchronously. For this
-reason, it is very unlikely that the changes have it to disk by the
-time g_settings_set() returns.
+To unexport @interface_ from only a single connection, use
+g_dbus_interface_skeleton_export_from_connection()
-This call will block until all of the writes have made it to the
-backend. Since the mainloop is not running, no change notifications
-will be dispatched during this call (but some may be queued by the
-time the call is done).
+Since: 2.30
</description>
<parameters>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
+</parameter_description>
+</parameter>
</parameters>
<return></return>
</function>
-<function name="g_settings_unbind">
+<function name="g_dbus_interface_skeleton_unexport_from_connection">
<description>
-Removes an existing binding for @property on @object.
+Stops exporting @interface_ on @connection.
-Note that bindings are automatically removed when the
-object is finalized, so it is rarely necessary to call this
-function.
+To stop exporting on all connections the interface is exported on,
+use g_dbus_interface_skeleton_unexport().
-Since: 2.26
+Since: 2.32
</description>
<parameters>
-<parameter name="object">
-<parameter_description> the object
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
-<parameter name="property">
-<parameter_description> the property whose binding is removed
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_simple_action_group_insert">
+<function name="g_dbus_is_address">
<description>
-Adds an action to the action group.
-
-If the action group already contains an action with the same name as
- action then the old action is dropped from the group.
+Checks if @string is a D-Bus address.
-The action group takes its own reference on @action.
+This doesn't check if @string is actually supported by #GDBusServer
+or #GDBusConnection - use g_dbus_is_supported_address() to do more
+checks.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action">
-<parameter_description> a #GAction
+<parameter name="string">
+<parameter_description> A string.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @string is a valid D-Bus address, %FALSE otherwise.
+
+</return>
</function>
-<function name="g_simple_action_group_lookup">
+<function name="g_dbus_is_guid">
<description>
-Looks up the action with the name @action_name in the group.
+Checks if @string is a D-Bus GUID.
-If no such action exists, returns %NULL.
+See the D-Bus specification regarding what strings are valid D-Bus
+GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of an action
+<parameter name="string">
+<parameter_description> The string to check.
</parameter_description>
</parameter>
</parameters>
-<return> a #GAction, or %NULL
+<return> %TRUE if @string is a guid, %FALSE otherwise.
</return>
</function>
-<function name="g_simple_action_group_new">
+<function name="g_dbus_is_interface_name">
<description>
-Creates a new, empty, #GSimpleActionGroup.
+Checks if @string is a valid D-Bus interface name.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
+<parameter name="string">
+<parameter_description> The string to check.
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GSimpleActionGroup
+<return> %TRUE if valid, %FALSE otherwise.
</return>
</function>
-<function name="g_simple_action_group_remove">
+<function name="g_dbus_is_member_name">
<description>
-Removes the named action from the action group.
-
-If no action of this name is in the group then nothing happens.
+Checks if @string is a valid D-Bus member (e.g. signal or method) name.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleActionGroup
-</parameter_description>
-</parameter>
-<parameter name="action_name">
-<parameter_description> the name of the action
+<parameter name="string">
+<parameter_description> The string to check.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if valid, %FALSE otherwise.
+
+</return>
</function>
-<function name="g_simple_action_new">
+<function name="g_dbus_is_name">
<description>
-Creates a new action.
-
-The created action is stateless. See g_simple_action_new_stateful().
+Checks if @string is a valid D-Bus bus name (either unique or well-known).
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="name">
-<parameter_description> the name of the action
-</parameter_description>
-</parameter>
-<parameter name="parameter_type">
-<parameter_description> the type of parameter to the activate function
+<parameter name="string">
+<parameter_description> The string to check.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSimpleAction
+<return> %TRUE if valid, %FALSE otherwise.
</return>
</function>
-<function name="g_simple_action_new_stateful">
+<function name="g_dbus_is_supported_address">
<description>
-Creates a new stateful action.
-
- state is the initial state of the action. All future state values
-must have the same #GVariantType as the initial state.
-
-If the @state GVariant is floating, it is consumed.
+Like g_dbus_is_address() but also checks if the library suppors the
+transports in @string and that key/value pairs for each transport
+are valid.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="name">
-<parameter_description> the name of the action
-</parameter_description>
-</parameter>
-<parameter name="parameter_type">
-<parameter_description> the type of the parameter to the activate function
+<parameter name="string">
+<parameter_description> A string.
</parameter_description>
</parameter>
-<parameter name="state">
-<parameter_description> the initial state of the action
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSimpleAction
+<return> %TRUE if @string is a valid D-Bus address that is
+supported by this library, %FALSE if @error is set.
</return>
</function>
-<function name="g_simple_action_set_enabled">
+<function name="g_dbus_is_unique_name">
<description>
-Sets the action as enabled or not.
-
-An action must be enabled in order to be activated or in order to
-have its state changed from outside callers.
+Checks if @string is a valid D-Bus unique bus name.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAction
-</parameter_description>
-</parameter>
-<parameter name="enabled">
-<parameter_description> whether the action is enabled
+<parameter name="string">
+<parameter_description> The string to check.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if valid, %FALSE otherwise.
+
+</return>
</function>
-<function name="g_simple_async_report_error_in_idle">
+<function name="g_dbus_menu_model_get">
<description>
-Reports an error in an asynchronous function in an idle function by
-directly setting the contents of the #GAsyncResult with the given error
-information.
+Obtains a #GDBusMenuModel for the menu model which is exported
+at the given @bus_name and @object_path.
+
+The thread default main context is taken at the time of this call.
+All signals on the menu model (and any linked models) are reported
+with respect to this context. All calls on the returned menu model
+(and linked models) must also originate from this same context, with
+the thread default main context unchanged.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #GObject, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark containing the error domain (usually #G_IO_ERROR).
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> a specific error code.
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a formatted error reporting string.
+<parameter name="bus_name">
+<parameter_description> the bus name which exports the menu model
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> a list of variables to fill in @format.
+<parameter name="object_path">
+<parameter_description> the object path at which the menu model is exported
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GDBusMenuModel object. Free with
+g_object_unref().
+
+</return>
</function>
-<function name="g_simple_async_report_gerror_in_idle">
+<function name="g_dbus_message_bytes_needed">
<description>
-Reports an error in an idle function. Similar to
-g_simple_async_report_error_in_idle(), but takes a #GError rather
-than building a new one.
+Utility function to calculate how many bytes are needed to
+completely deserialize the D-Bus message stored at @blob.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #GObject, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
+<parameter name="blob">
+<parameter_description> A blob represent a binary D-Bus message.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="blob_len">
+<parameter_description> The length of @blob (must be at least 16).
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> the #GError to report
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> Number of bytes needed or -1 if @error is set (e.g. if
+ blob contains invalid data or not enough data is available to
+determine the size).
+
+</return>
</function>
-<function name="g_simple_async_report_take_gerror_in_idle">
+<function name="g_dbus_message_copy">
<description>
-Reports an error in an idle function. Similar to
-g_simple_async_report_gerror_in_idle(), but takes over the caller's
-ownership of @error, so the caller does not have to free it any more.
+Copies @message. The copy is a deep copy and the returned
+#GDBusMessage is completely identical except that it is guaranteed
+to not be locked.
-Since: 2.28
+This operation can fail if e.g. @message contains file descriptors
+and the per-process or system-wide open files limit is reached.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="object">
-<parameter_description> a #GObject, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> the #GError to report
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A new #GDBusMessage or %NULL if @error is set.
+Free with g_object_unref().
+
+</return>
</function>
-<function name="g_simple_async_result_complete">
+<function name="g_dbus_message_get_arg0">
<description>
-Completes an asynchronous I/O job immediately. Must be called in
-the thread where the asynchronous result was to be delivered, as it
-invokes the callback directly. If you are in a different thread use
-g_simple_async_result_complete_in_idle().
+Convenience to get the first item in the body of @message.
-Calling this function takes a reference to @simple for as long as
-is needed to complete the call.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The string item or %NULL if the first item in the body of
+ message is not a string.
+
+</return>
</function>
-<function name="g_simple_async_result_complete_in_idle">
+<function name="g_dbus_message_get_body">
<description>
-Completes an asynchronous function in an idle handler in the <link
-linkend="g-main-context-push-thread-default">thread-default main
-loop</link> of the thread that @simple was initially created in.
+Gets the body of a message.
-Calling this function takes a reference to @simple for as long as
-is needed to complete the call.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message.
+
+</return>
</function>
-<function name="g_simple_async_result_get_op_res_gboolean">
+<function name="g_dbus_message_get_byte_order">
<description>
-Gets the operation result boolean from within the asynchronous result.
+Gets the byte order of @message.
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the operation's result was %TRUE, %FALSE
-if the operation's result was %FALSE.
+<return> The byte order.
</return>
</function>
-<function name="g_simple_async_result_get_op_res_gpointer">
+<function name="g_dbus_message_get_destination">
<description>
-Gets a pointer result as returned by the asynchronous function.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer from the result.
+<return> The value.
+
</return>
</function>
-<function name="g_simple_async_result_get_op_res_gssize">
+<function name="g_dbus_message_get_error_name">
<description>
-Gets a gssize from the asynchronous result.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a gssize returned from the asynchronous function.
+<return> The value.
+
</return>
</function>
-<function name="g_simple_async_result_get_source_tag">
+<function name="g_dbus_message_get_flags">
<description>
-Gets the source tag for the #GSimpleAsyncResult.
+Gets the flags for @message.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #gpointer to the source object for the #GSimpleAsyncResult.
+<return> Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).
+
</return>
</function>
-<function name="g_simple_async_result_is_valid">
+<function name="g_dbus_message_get_header">
<description>
-Ensures that the data passed to the _finish function of an async
-operation is consistent. Three checks are performed.
-
-First, @result is checked to ensure that it is really a
-#GSimpleAsyncResult. Second, @source is checked to ensure that it
-matches the source object of @result. Third, @source_tag is
-checked to ensure that it is either %NULL (as it is when the result was
-created by g_simple_async_report_error_in_idle() or
-g_simple_async_report_gerror_in_idle()) or equal to the
- source_tag argument given to g_simple_async_result_new() (which, by
-convention, is a pointer to the _async function corresponding to the
-_finish function from which this function is called).
+Gets a header field on @message.
-Since: 2.20
+Since: 2.26
</description>
<parameters>
-<parameter name="result">
-<parameter_description> the #GAsyncResult passed to the _finish function.
-</parameter_description>
-</parameter>
-<parameter name="source">
-<parameter_description> the #GObject passed to the _finish function.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="source_tag">
-<parameter_description> the asynchronous function.
+<parameter name="header_field">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
</parameter_description>
</parameter>
</parameters>
-<return> #TRUE if all checks passed or #FALSE if any failed.
+<return> A #GVariant with the value if the header was found, %NULL
+otherwise. Do not free, it is owned by @message.
</return>
</function>
-<function name="g_simple_async_result_new">
+<function name="g_dbus_message_get_header_fields">
<description>
-Creates a #GSimpleAsyncResult.
+Gets an array of all header fields on @message that are set.
+Since: 2.26
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="source_tag">
-<parameter_description> the asynchronous function.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult.
+<return> An array of header fields
+terminated by %G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element
+is a #guchar. Free with g_free().
+
</return>
</function>
-<function name="g_simple_async_result_new_error">
+<function name="g_dbus_message_get_interface">
<description>
-Creates a new #GSimpleAsyncResult with a set error.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+Since: 2.26
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark.
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> an error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a string with format characters.
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> a list of values to insert into @format.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult.
+<return> The value.
+
</return>
</function>
-<function name="g_simple_async_result_new_from_error">
+<function name="g_dbus_message_get_locked">
<description>
-Creates a #GSimpleAsyncResult from an error condition.
+Checks whether @message is locked. To monitor changes to this
+value, conncet to the #GObject::notify signal to listen for changes
+on the #GDBusMessage:locked property.
+Since: 2.26
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult.
+<return> %TRUE if @message is locked, %FALSE otherwise.
+
</return>
</function>
-<function name="g_simple_async_result_new_take_error">
+<function name="g_dbus_message_get_member">
<description>
-Creates a #GSimpleAsyncResult from an error condition, and takes over the
-caller's ownership of @error, so the caller does not need to free it anymore.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="source_object">
-<parameter_description> a #GObject, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data passed to @callback
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSimpleAsyncResult
+<return> The value.
</return>
</function>
-<function name="g_simple_async_result_propagate_error">
+<function name="g_dbus_message_get_message_type">
<description>
-Propagates an error from within the simple asynchronous result to
-a given destination.
+Gets the type of @message.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="dest">
-<parameter_description> a location to propagate the error to.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the error was propagated to @dest. %FALSE otherwise.
+<return> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
+
</return>
</function>
-<function name="g_simple_async_result_run_in_thread">
+<function name="g_dbus_message_get_num_unix_fds">
<description>
-Runs the asynchronous job in a separate thread and then calls
-g_simple_async_result_complete_in_idle() on @simple to return
-the result to the appropriate main loop.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
-Calling this function takes a reference to @simple for as long as
-is needed to run the job and report its completion.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #GSimpleAsyncThreadFunc.
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the io priority of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
-<function name="g_simple_async_result_set_error">
+<function name="g_dbus_message_get_path">
<description>
-Sets an error within the asynchronous result without a #GError.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark (usually #G_IO_ERROR).
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> an error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a formatted error reporting string.
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> a list of variables to fill in @format.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
-<function name="g_simple_async_result_set_error_va">
+<function name="g_dbus_message_get_reply_serial">
<description>
-Sets an error within the asynchronous result without a #GError.
-Unless writing a binding, see g_simple_async_result_set_error().
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a #GQuark (usually #G_IO_ERROR).
-</parameter_description>
-</parameter>
-<parameter name="code">
-<parameter_description> an error code.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a formatted error reporting string.
-</parameter_description>
-</parameter>
-<parameter name="args">
-<parameter_description> va_list of arguments.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
-<function name="g_simple_async_result_set_from_error">
+<function name="g_dbus_message_get_sender">
<description>
-Sets the result from a #GError.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
-<function name="g_simple_async_result_set_handle_cancellation">
+<function name="g_dbus_message_get_serial">
<description>
-Sets whether to handle cancellation within the asynchronous operation.
+Gets the serial for @message.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="handle_cancellation">
-<parameter_description> a #gboolean.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #guint32.
+
+</return>
</function>
-<function name="g_simple_async_result_set_op_res_gboolean">
+<function name="g_dbus_message_get_signature">
<description>
-Sets the operation result to a boolean within the asynchronous result.
+Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="op_res">
-<parameter_description> a #gboolean.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The value.
+
+</return>
</function>
-<function name="g_simple_async_result_set_op_res_gpointer">
+<function name="g_dbus_message_get_unix_fd_list">
<description>
-Sets the operation result within the asynchronous result to a pointer.
+Gets the UNIX file descriptors associated with @message, if any.
-</description>
-<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="op_res">
-<parameter_description> a pointer result from an asynchronous function.
-</parameter_description>
-</parameter>
-<parameter name="destroy_op_res">
-<parameter_description> a #GDestroyNotify function.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
+This method is only available on UNIX.
-<function name="g_simple_async_result_set_op_res_gssize">
-<description>
-Sets the operation result within the asynchronous result to
-the given @op_res.
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult.
-</parameter_description>
-</parameter>
-<parameter name="op_res">
-<parameter_description> a #gssize.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return>A #GUnixFDList or %NULL if no file descriptors are
+associated. Do not free, this object is owned by @message.
+
+</return>
</function>
-<function name="g_simple_async_result_take_error">
+<function name="g_dbus_message_lock">
<description>
-Sets the result from @error, and takes over the caller's ownership
-of @error, so the caller does not need to free it any more.
+If @message is locked, does nothing. Otherwise locks the message.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="simple">
-<parameter_description> a #GSimpleAsyncResult
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_simple_permission_new">
+<function name="g_dbus_message_new">
<description>
-Creates a new #GPermission instance that represents an action that is
-either always or never allowed.
+Creates a new empty #GDBusMessage.
Since: 2.26
</description>
<parameters>
-<parameter name="allowed">
-<parameter_description> %TRUE if the action is allowed
-</parameter_description>
-</parameter>
</parameters>
-<return> the #GSimplePermission, as a #GPermission
+<return> A #GDBusMessage. Free with g_object_unref().
+
</return>
</function>
-<function name="g_socket_accept">
+<function name="g_dbus_message_new_from_blob">
<description>
-Accept incoming connections on a connection-based socket. This removes
-the first outstanding connection request from the listening socket and
-creates a #GSocket object for it.
-
-The @socket must be bound to a local address with g_socket_bind() and
-must be listening for incoming connections (g_socket_listen()).
-
-If there are no outstanding connections then the operation will block
-or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
-To be notified of an incoming connection, wait for the %G_IO_IN condition.
+Creates a new #GDBusMessage from the data stored at @blob. The byte
+order that the message was in can be retrieved using
+g_dbus_message_get_byte_order().
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="blob">
+<parameter_description> A blob represent a binary D-Bus message.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter name="blob_len">
+<parameter_description> The length of @blob.
+</parameter_description>
+</parameter>
+<parameter name="capabilities">
+<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSocket, or %NULL on error.
-Free the returned object with g_object_unref().
+<return> A new #GDBusMessage or %NULL if @error is set. Free with
+g_object_unref().
</return>
</function>
-<function name="g_socket_address_enumerator_next">
+<function name="g_dbus_message_new_method_call">
<description>
-Retrieves the next #GSocketAddress from @enumerator. Note that this
-may block for some amount of time. (Eg, a #GNetworkAddress may need
-to do a DNS lookup before it can return an address.) Use
-g_socket_address_enumerator_next_async() if you need to avoid
-blocking.
-
-If @enumerator is expected to yield addresses, but for some reason
-is unable to (eg, because of a DNS error), then the first call to
-g_socket_address_enumerator_next() will return an appropriate error
-in * error However, if the first call to
-g_socket_address_enumerator_next() succeeds, then any further
-internal errors (other than @cancellable being triggered) will be
-ignored.
+Creates a new #GDBusMessage for a method call.
+Since: 2.26
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GSocketAddressEnumerator
+<parameter name="name">
+<parameter_description> A valid D-Bus name or %NULL.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="path">
+<parameter_description> A valid object path.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError.
+<parameter name="interface_">
+<parameter_description> A valid D-Bus interface name or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="method">
+<parameter_description> A valid method name.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress (owned by the caller), or %NULL on
-error (in which case * error will be set) or if there are no
-more addresses.
+<return> A #GDBusMessage. Free with g_object_unref().
+
</return>
</function>
-<function name="g_socket_address_enumerator_next_async">
+<function name="g_dbus_message_new_method_error">
<description>
-Asynchronously retrieves the next #GSocketAddress from @enumerator
-and then calls @callback, which must call
-g_socket_address_enumerator_next_finish() to get the result.
+Creates a new #GDBusMessage that is an error reply to @method_call_message.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GSocketAddressEnumerator
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback to call when the request
-is satisfied
+<parameter name="error_message_format">
+<parameter_description> The D-Bus error message in a printf() format.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to callback function
+<parameter name="Varargs">
+<parameter_description> Arguments for @error_message_format.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusMessage. Free with g_object_unref().
+
+</return>
</function>
-<function name="g_socket_address_enumerator_next_finish">
+<function name="g_dbus_message_new_method_error_literal">
<description>
-Retrieves the result of a completed call to
-g_socket_address_enumerator_next_async(). See
-g_socket_address_enumerator_next() for more information about
-error handling.
+Creates a new #GDBusMessage that is an error reply to @method_call_message.
+Since: 2.26
</description>
<parameters>
-<parameter name="enumerator">
-<parameter_description> a #GSocketAddressEnumerator
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
</parameter_description>
</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="error_message">
+<parameter_description> The D-Bus error message.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress (owned by the caller), or %NULL on
-error (in which case * error will be set) or if there are no
-more addresses.
+<return> A #GDBusMessage. Free with g_object_unref().
+
</return>
</function>
-<function name="g_socket_address_get_family">
+<function name="g_dbus_message_new_method_error_valist">
<description>
-Gets the socket family type of @address.
+Like g_dbus_message_new_method_error() but intended for language bindings.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
+</parameter_description>
+</parameter>
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="error_message_format">
+<parameter_description> The D-Bus error message in a printf() format.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> Arguments for @error_message_format.
</parameter_description>
</parameter>
</parameters>
-<return> the socket family type of @address.
+<return> A #GDBusMessage. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_address_get_native_size">
+<function name="g_dbus_message_new_method_reply">
<description>
-Gets the size of @address's native <type>struct sockaddr</type>.
-You can use this to allocate memory to pass to
-g_socket_address_to_native().
+Creates a new #GDBusMessage that is a reply to @method_call_message.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
+<parameter name="method_call_message">
+<parameter_description> A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
+create a reply message to.
</parameter_description>
</parameter>
</parameters>
-<return> the size of the native <type>struct sockaddr</type> that
- address represents
+<return> #GDBusMessage. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_address_new_from_native">
+<function name="g_dbus_message_new_signal">
<description>
-Creates a #GSocketAddress subclass corresponding to the native
-<type>struct sockaddr</type> @native.
+Creates a new #GDBusMessage for a signal emission.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="native">
-<parameter_description> a pointer to a <type>struct sockaddr</type>
+<parameter name="path">
+<parameter_description> A valid object path.
</parameter_description>
</parameter>
-<parameter name="len">
-<parameter_description> the size of the memory location pointed to by @native
+<parameter name="interface_">
+<parameter_description> A valid D-Bus interface name.
+</parameter_description>
+</parameter>
+<parameter name="signal">
+<parameter_description> A valid signal name.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSocketAddress if @native could successfully be converted,
-otherwise %NULL.
+<return> A #GDBusMessage. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_address_to_native">
+<function name="g_dbus_message_print">
<description>
-Converts a #GSocketAddress to a native <type>struct
-sockaddr</type>, which can be passed to low-level functions like
-connect() or bind().
+Produces a human-readable multi-line description of @message.
-If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is
-returned. If the address type is not known on the system
-then a %G_IO_ERROR_NOT_SUPPORTED error is returned.
+The contents of the description has no ABI guarantees, the contents
+and formatting is subject to change at any time. Typical output
+looks something like this:
+<programlisting>
+Type: method-call
+Flags: none
+Version: 0
+Serial: 4
+Headers:
+path -> objectpath '/org/gtk/GDBus/TestObject'
+interface -> 'org.gtk.GDBus.TestInterface'
+member -> 'GimmeStdout'
+destination -> ':1.146'
+Body: ()
+UNIX File Descriptors:
+(none)
+</programlisting>
+or
+<programlisting>
+Type: method-return
+Flags: no-reply-expected
+Version: 0
+Serial: 477
+Headers:
+reply-serial -> uint32 4
+destination -> ':1.159'
+sender -> ':1.146'
+num-unix-fds -> uint32 1
+Body: ()
+UNIX File Descriptors:
+fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
+</programlisting>
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
-</parameter_description>
-</parameter>
-<parameter name="dest">
-<parameter_description> a pointer to a memory location that will contain the native
-<type>struct sockaddr</type>.
-</parameter_description>
-</parameter>
-<parameter name="destlen">
-<parameter_description> the size of @dest. Must be at least as large as
-g_socket_address_get_native_size().
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="indent">
+<parameter_description> Indentation level.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @dest was filled in, %FALSE on error
+<return> A string that should be freed with g_free().
</return>
</function>
-<function name="g_socket_bind">
+<function name="g_dbus_message_set_body">
<description>
-When a socket is created it is attached to an address family, but it
-doesn't have an address in this family. g_socket_bind() assigns the
-address (sometimes called name) of the socket.
-
-It is generally required to bind to a local address before you can
-receive connections. (See g_socket_listen() and g_socket_accept() ).
-In certain situations, you may also want to bind a socket that will be
-used to initiate connections, though this is not normally required.
+Sets the body @message. As a side-effect the
+%G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
+type string of @body (or cleared if @body is %NULL).
- allow_reuse should be %TRUE for server sockets (sockets that you will
-eventually call g_socket_accept() on), and %FALSE for client sockets.
-(Specifically, if it is %TRUE, then g_socket_bind() will set the
-%SO_REUSEADDR flag on the socket, allowing it to bind @address even if
-that address was previously used by another socket that has not yet been
-fully cleaned-up by the kernel. Failing to set this flag on a server
-socket may cause the bind call to return %G_IO_ERROR_ADDRESS_IN_USE if
-the server program is stopped and then immediately restarted.)
+If @body is floating, @message assumes ownership of @body.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress specifying the local address.
+<parameter name="body">
+<parameter_description> Either %NULL or a #GVariant that is a tuple.
</parameter_description>
</parameter>
-<parameter name="allow_reuse">
-<parameter_description> whether to allow reusing this address
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_set_byte_order">
+<description>
+Sets the byte order of @message.
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="byte_order">
+<parameter_description> The byte order.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_check_connect_result">
+<function name="g_dbus_message_set_destination">
<description>
-Checks and resets the pending connect error for the socket.
-This is used to check for errors when g_socket_connect() is
-used in non-blocking mode.
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if no error, %FALSE otherwise, setting @error to the error
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_add_application_proxy">
+<function name="g_dbus_message_set_error_name">
<description>
-Enable proxy protocols to be handled by the application. When the
-indicated proxy protocol is returned by the #GProxyResolver,
-#GSocketClient will consider this protocol as supported but will
-not try find a #GProxy instance to handle handshaking. The
-application must check for this case by calling
-g_socket_connection_get_remote_address() on the returned
-#GSocketConnection, and seeing if it's a #GProxyAddress of the
-appropriate type, to determine whether or not it needs to handle
-the proxy handshaking itself.
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
-This should be used for proxy protocols that are dialects of
-another protocol such as HTTP proxy. It also allows cohabitation of
-proxy protocols that are reused between protocols. A good example
-is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
-be use as generic socket proxy through the HTTP CONNECT method.
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> The proxy protocol
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_connect">
+<function name="g_dbus_message_set_flags">
<description>
-Tries to resolve the @connectable and make a network connection to it..
-
-Upon a successful connection, a new #GSocketConnection is constructed
-and returned. The caller owns this new object and must drop their
-reference to it when finished with it.
-
-The type of the #GSocketConnection object returned depends on the type of
-the underlying socket that is used. For instance, for a TCP/IP connection
-it will be a #GTcpConnection.
-
-The socket created will be the same family as the the address that the
- connectable resolves to, unless family is set with g_socket_client_set_family()
-or indirectly via g_socket_client_set_local_address(). The socket type
-defaults to %G_SOCKET_TYPE_STREAM but can be set with
-g_socket_client_set_socket_type().
-
-If a local address is specified with g_socket_client_set_local_address() the
-socket will be bound to this address before connecting.
+Sets the flags to set on @message.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="connectable">
-<parameter_description> a #GSocketConnectable specifying the remote address.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="flags">
+<parameter_description> Flags for @message that are set (typically values from the #GDBusMessageFlags
+enumeration bitwise ORed together).
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_async">
+<function name="g_dbus_message_set_header">
<description>
-This is the asynchronous version of g_socket_client_connect().
+Sets a header field on @message.
-When the operation is finished @callback will be
-called. You can then call g_socket_client_connect_finish() to get
-the result of the operation.
+If @value is floating, @message assumes ownership of @value.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GTcpClient
-</parameter_description>
-</parameter>
-<parameter name="connectable">
-<parameter_description> a #GSocketConnectable specifying the remote address.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter name="header_field">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="value">
+<parameter_description> A #GVariant to set the header field or %NULL to clear the header field.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_connect_finish">
+<function name="g_dbus_message_set_interface">
<description>
-Finishes an async connect operation. See g_socket_client_connect_async()
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_host">
+<function name="g_dbus_message_set_member">
<description>
-This is a helper function for g_socket_client_connect().
-
-Attempts to create a TCP connection to the named host.
-
- host_and_port may be in any of a number of recognised formats; an IPv6
-address, an IPv4 address, or a domain name (in which case a DNS
-lookup is performed). Quoting with [] is supported for all address
-types. A port override may be specified in the usual way with a
-colon. Ports may be given as decimal numbers or symbolic names (in
-which case an /etc/services lookup is performed).
-
-If no port override is given in @host_and_port then @default_port will be
-used as the port number to connect to.
-
-In general, @host_and_port is expected to be provided by the user (allowing
-them to give the hostname, and a port overide if necessary) and
- default_port is expected to be provided by the application.
-
-In the case that an IP address is given, a single connection
-attempt is made. In the case that a name is given, multiple
-connection attempts may be made, in turn and according to the
-number of address records in DNS, until a connection succeeds.
-
-Upon a successful connection, a new #GSocketConnection is constructed
-and returned. The caller owns this new object and must drop their
-reference to it when finished with it.
-
-In the event of any failure (DNS error, service not found, no hosts
-connectable) %NULL is returned and @error (if non-%NULL) is set
-accordingly.
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
-</parameter_description>
-</parameter>
-<parameter name="host_and_port">
-<parameter_description> the name and optionally port of the host to connect to
-</parameter_description>
-</parameter>
-<parameter name="default_port">
-<parameter_description> the default port to connect to
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_host_async">
+<function name="g_dbus_message_set_message_type">
<description>
-This is the asynchronous version of g_socket_client_connect_to_host().
-
-When the operation is finished @callback will be
-called. You can then call g_socket_client_connect_to_host_finish() to get
-the result of the operation.
+Sets @message to be of @type.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GTcpClient
-</parameter_description>
-</parameter>
-<parameter name="host_and_port">
-<parameter_description> the name and optionally the port of the host to connect to
-</parameter_description>
-</parameter>
-<parameter name="default_port">
-<parameter_description> the default port to connect to
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="type">
+<parameter_description> A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_connect_to_host_finish">
+<function name="g_dbus_message_set_num_unix_fds">
<description>
-Finishes an async connect operation. See g_socket_client_connect_to_host_async()
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_service">
+<function name="g_dbus_message_set_path">
<description>
-Attempts to create a TCP connection to a service.
-
-This call looks up the SRV record for @service at @domain for the
-"tcp" protocol. It then attempts to connect, in turn, to each of
-the hosts providing the service until either a connection succeeds
-or there are no hosts remaining.
-
-Upon a successful connection, a new #GSocketConnection is constructed
-and returned. The caller owns this new object and must drop their
-reference to it when finished with it.
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
-In the event of any failure (DNS error, service not found, no hosts
-connectable) %NULL is returned and @error (if non-%NULL) is set
-accordingly.
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketConnection
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a domain name
-</parameter_description>
-</parameter>
-<parameter name="service">
-<parameter_description> the name of the service to connect to
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection if successful, or %NULL on error
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_service_async">
+<function name="g_dbus_message_set_reply_serial">
<description>
-This is the asynchronous version of
-g_socket_client_connect_to_service().
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
-</parameter_description>
-</parameter>
-<parameter name="domain">
-<parameter_description> a domain name
-</parameter_description>
-</parameter>
-<parameter name="service">
-<parameter_description> the name of the service to connect to
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_set_sender">
+<description>
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_connect_to_service_finish">
+<function name="g_dbus_message_set_serial">
<description>
-Finishes an async connect operation. See g_socket_client_connect_to_service_async()
+Sets the serial for @message.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="serial">
+<parameter_description> A #guint32.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_uri">
+<function name="g_dbus_message_set_signature">
<description>
-This is a helper function for g_socket_client_connect().
+Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
-Attempts to create a TCP connection with a network URI.
-
- uri may be any valid URI containing an "authority" (hostname/port)
-component. If a port is not specified in the URI, @default_port
-will be used. TLS will be negotiated if #GSocketClient:tls is %TRUE.
-(#GSocketClient does not know to automatically assume TLS for
-certain URI schemes.)
-
-Using this rather than g_socket_client_connect() or
-g_socket_client_connect_to_host() allows #GSocketClient to
-determine when to use application-specific proxy protocols.
-
-Upon a successful connection, a new #GSocketConnection is constructed
-and returned. The caller owns this new object and must drop their
-reference to it when finished with it.
-
-In the event of any failure (DNS error, service not found, no hosts
-connectable) %NULL is returned and @error (if non-%NULL) is set
-accordingly.
-
-Since: 2.26
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
-</parameter_description>
-</parameter>
-<parameter name="uri">
-<parameter_description> A network URI
-</parameter_description>
-</parameter>
-<parameter name="default_port">
-<parameter_description> the default port to connect to
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a pointer to a #GError, or %NULL
+<parameter name="value">
+<parameter_description> The value to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_client_connect_to_uri_async">
+<function name="g_dbus_message_set_unix_fd_list">
<description>
-This is the asynchronous version of g_socket_client_connect_to_uri().
+Sets the UNIX file descriptors associated with @message. As a
+side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
+field is set to the number of fds in @fd_list (or cleared if
+ fd_list is %NULL).
-When the operation is finished @callback will be
-called. You can then call g_socket_client_connect_to_uri_finish() to get
-the result of the operation.
+This method is only available on UNIX.
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="uri">
-<parameter_description> a network uri
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
-<parameter name="default_port">
-<parameter_description> the default port to connect to
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_message_to_blob">
+<description>
+Serializes @message to a blob. The byte order returned by
+g_dbus_message_get_byte_order() will be used.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="out_size">
+<parameter_description> Return location for size of generated blob.
</parameter_description>
</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter name="capabilities">
+<parameter_description> A #GDBusCapabilityFlags describing what protocol features are supported.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="error">
+<parameter_description> Return location for error.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A pointer to a
+valid binary D-Bus message of @out_size bytes generated by @message
+or %NULL if @error is set. Free with g_free().
+
+</return>
</function>
-<function name="g_socket_client_connect_to_uri_finish">
+<function name="g_dbus_message_to_gerror">
<description>
-Finishes an async connect operation. See g_socket_client_connect_to_uri_async()
+If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
+nothing and returns %FALSE.
+
+Otherwise this method encodes the error in @message as a #GError
+using g_dbus_error_set_dbus_error() using the information in the
+%G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as
+well as the first string item in @message's body.
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="message">
+<parameter_description> A #GDBusMessage.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> The #GError to set.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
+<return> %TRUE if @error was set, %FALSE otherwise.
</return>
</function>
-<function name="g_socket_client_get_enable_proxy">
+<function name="g_dbus_method_info_ref">
<description>
-Gets the proxy enable state; see g_socket_client_set_enable_proxy()
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="info">
+<parameter_description> A #GDBusMethodInfo
</parameter_description>
</parameter>
</parameters>
-<return> whether proxying is enabled
+<return> The same @info.
</return>
</function>
-<function name="g_socket_client_get_family">
+<function name="g_dbus_method_info_unref">
<description>
-Gets the socket family of the socket client.
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
-See g_socket_client_set_family() for details.
+Since: 2.26
-Since: 2.22
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusMethodInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_method_invocation_get_connection">
+<description>
+Gets the #GDBusConnection the method was invoked on.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketFamily
+<return>A #GDBusConnection. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_local_address">
+<function name="g_dbus_method_invocation_get_interface_name">
<description>
-Gets the local address of the socket client.
-
-See g_socket_client_set_local_address() for details.
+Gets the name of the D-Bus interface the method was invoked on.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddres or %NULL. don't free
+<return> A string. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_protocol">
+<function name="g_dbus_method_invocation_get_message">
<description>
-Gets the protocol name type of the socket client.
+Gets the #GDBusMessage for the method invocation. This is useful if
+you need to use low-level protocol features, such as UNIX file
+descriptor passing, that cannot be properly expressed in the
+#GVariant API.
-See g_socket_client_set_protocol() for details.
+See <xref linkend="gdbus-server"/> and <xref
+linkend="gdbus-unix-fd-client"/> for an example of how to use this
+low-level API to send and receive UNIX file descriptors.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketProtocol
+<return> #GDBusMessage. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_socket_type">
+<function name="g_dbus_method_invocation_get_method_info">
<description>
-Gets the socket type of the socket client.
-
-See g_socket_client_set_socket_type() for details.
+Gets information about the method call, if any.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketFamily
+<return> A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_timeout">
+<function name="g_dbus_method_invocation_get_method_name">
<description>
-Gets the I/O timeout time for sockets created by @client.
-
-See g_socket_client_set_timeout() for details.
+Gets the name of the method that was invoked.
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the timeout in seconds
+<return> A string. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_tls">
+<function name="g_dbus_method_invocation_get_object_path">
<description>
-Gets whether @client creates TLS connections. See
-g_socket_client_set_tls() for details.
+Gets the object path the method was invoked on.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> whether @client uses TLS
+<return> A string. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_get_tls_validation_flags">
+<function name="g_dbus_method_invocation_get_parameters">
<description>
-Gets the TLS validation flags used creating TLS connections via
- client
+Gets the parameters of the method invocation. If there are no input
+parameters then this will return a GVariant with 0 children rather than NULL.
-Since: 2.28
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return> the TLS validation flags
+<return> A #GVariant tuple. Do not unref this because it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_new">
+<function name="g_dbus_method_invocation_get_sender">
<description>
-Creates a new #GSocketClient with the default options.
+Gets the bus name that invoked the method.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GSocketClient.
-Free the returned object with g_object_unref().
+<return> A string. Do not free, it is owned by @invocation.
</return>
</function>
-<function name="g_socket_client_set_enable_proxy">
+<function name="g_dbus_method_invocation_get_user_data">
<description>
-Sets whether or not @client attempts to make connections via a
-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.
+Gets the @user_data #gpointer passed to g_dbus_connection_register_object().
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
-</parameter_description>
-</parameter>
-<parameter name="enable">
-<parameter_description> whether to enable proxies
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #gpointer.
+
+</return>
</function>
-<function name="g_socket_client_set_family">
+<function name="g_dbus_method_invocation_return_dbus_error">
<description>
-Sets the socket family of the socket client.
-If this is set to something other than %G_SOCKET_FAMILY_INVALID
-then the sockets created by this object will be of the specified
-family.
+Finishes handling a D-Bus method call by returning an error.
-This might be useful for instance if you want to force the local
-connection to be an ipv4 socket, even though the address might
-be an ipv6 mapped to ipv4 address.
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="family">
-<parameter_description> a #GSocketFamily
+<parameter name="error_name">
+<parameter_description> A valid D-Bus error name.
+</parameter_description>
+</parameter>
+<parameter name="error_message">
+<parameter_description> A valid D-Bus error message.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_local_address">
+<function name="g_dbus_method_invocation_return_error">
<description>
-Sets the local address of the socket client.
-The sockets created by this object will bound to the
-specified address (if not %NULL) before connecting.
+Finishes handling a D-Bus method call by returning an error.
-This is useful if you want to ensure the the local
-side of the connection is on a specific port, or on
-a specific interface.
+See g_dbus_error_encode_gerror() for details about what error name
+will be returned on the wire. In a nutshell, if the given error is
+registered using g_dbus_error_register_error() the name given
+during registration is used. Otherwise, a name of the form
+<literal>org.gtk.GDBus.UnmappedGError.Quark...</literal> is
+used. This provides transparent mapping of #GError between
+applications using GDBus.
-Since: 2.22
+If you are writing an application intended to be portable,
+<emphasis>always</emphasis> register errors with g_dbus_error_register_error()
+or use g_dbus_method_invocation_return_dbus_error().
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress, or %NULL
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> Parameters for @format.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_protocol">
+<function name="g_dbus_method_invocation_return_error_literal">
<description>
-Sets the protocol of the socket client.
-The sockets created by this object will use of the specified
-protocol.
+Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
-If @protocol is %0 that means to use the default
-protocol for the socket family and type.
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> a #GSocketProtocol
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> The error message.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_socket_type">
+<function name="g_dbus_method_invocation_return_error_valist">
<description>
-Sets the socket type of the socket client.
-The sockets created by this object will be of the specified
-type.
+Like g_dbus_method_invocation_return_error() but intended for
+language bindings.
-It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM,
-as GSocketClient is used for connection oriented services.
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
+<parameter name="domain">
+<parameter_description> A #GQuark for the #GError error domain.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> The error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> #va_list of parameters for @format.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_timeout">
+<function name="g_dbus_method_invocation_return_gerror">
<description>
-Sets the I/O timeout for sockets created by @client. @timeout is a
-time in seconds, or 0 for no timeout (the default).
+Like g_dbus_method_invocation_return_error() but takes a #GError
+instead of the error domain, error code and message.
-The timeout value affects the initial connection attempt as well,
-so setting this may cause calls to g_socket_client_connect(), etc,
-to fail with %G_IO_ERROR_TIMED_OUT.
+This method will free @invocation, you cannot use it afterwards.
Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="timeout">
-<parameter_description> the timeout
+<parameter name="error">
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_tls">
+<function name="g_dbus_method_invocation_return_value">
<description>
-Sets whether @client creates TLS (aka SSL) connections. If @tls is
-%TRUE, @client will wrap its connections in a #GTlsClientConnection
-and perform a TLS handshake when connecting.
+Finishes handling a D-Bus method call by returning @parameters.
+If the @parameters GVariant is floating, it is consumed.
-Note that since #GSocketClient must return a #GSocketConnection,
-but #GTlsClientConnection is not a #GSocketConnection, this
-actually wraps the resulting #GTlsClientConnection in a
-#GTcpWrapperConnection when returning it. You can use
-g_tcp_wrapper_connection_get_base_io_stream() on the return value
-to extract the #GTlsClientConnection.
+It is an error if @parameters is not of the right format.
-Since: 2.28
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="tls">
-<parameter_description> whether to use TLS
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_client_set_tls_validation_flags">
+<function name="g_dbus_method_invocation_return_value_with_unix_fd_list">
<description>
-Sets the TLS validation flags used when creating TLS connections
-via @client. The default value is %G_TLS_CERTIFICATE_VALIDATE_ALL.
+Like g_dbus_method_invocation_return_value() but also takes a #GUnixFDList.
-Since: 2.28
+This method is only available on UNIX.
+
+This method will free @invocation, you cannot use it afterwards.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="client">
-<parameter_description> a #GSocketClient.
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> the validation flags
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_close">
+<function name="g_dbus_method_invocation_take_error">
<description>
-Closes the socket, shutting down any active connection.
-
-Closing a socket does not wait for all outstanding I/O operations
-to finish, so the caller should not rely on them to be guaranteed
-to complete even if the close returns with no error.
-
-Once the socket is closed, all other operations will return
-%G_IO_ERROR_CLOSED. Closing a socket multiple times will not
-return an error.
-
-Sockets will be automatically closed when the last reference
-is dropped, but you might want to call this function to make sure
-resources are released as early as possible.
+Like g_dbus_method_invocation_return_gerror() but takes ownership
+of @error so the caller does not need to free it.
-Beware that due to the way that TCP works, it is possible for
-recently-sent data to be lost if either you close a socket while the
-%G_IO_IN condition is set, or else if the remote connection tries to
-send something to you after you close the socket but before it has
-finished reading all of the data you sent. There is no easy generic
-way to avoid this problem; the easiest fix is to design the network
-protocol such that the client will never send data "out of turn".
-Another solution is for the server to half-close the connection by
-calling g_socket_shutdown() with only the @shutdown_write flag set,
-and then wait for the client to notice this and close its side of the
-connection, after which the server can safely call g_socket_close().
-(This is what #GTcpConnection does if you call
-g_tcp_connection_set_graceful_disconnect(). But of course, this
-only works if the client will close its connection after the server
-does.)
+This method will free @invocation, you cannot use it afterwards.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> A #GError.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error
-
-</return>
+<return></return>
</function>
-<function name="g_socket_condition_check">
+<function name="g_dbus_node_info_generate_xml">
<description>
-Checks on the readiness of @socket to perform operations.
-The operations specified in @condition are checked for and masked
-against the currently-satisfied conditions on @socket. The result
-is returned.
+Appends an XML representation of @info (and its children) to @string_builder.
-Note that on Windows, it is possible for an operation to return
-%G_IO_ERROR_WOULD_BLOCK even immediately after
-g_socket_condition_check() has claimed that the socket is ready for
-writing. Rather than calling g_socket_condition_check() and then
-writing to the socket if it succeeds, it is generally better to
-simply try writing to the socket right away, and try again later if
-the initial attempt returns %G_IO_ERROR_WOULD_BLOCK.
-
-It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
-these conditions will always be set in the output if they are true.
-
-This call never blocks.
+This function is typically used for generating introspection XML documents at run-time for
+handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
</parameter_description>
</parameter>
-<parameter name="condition">
-<parameter_description> a #GIOCondition mask to check
+<parameter name="indent">
+<parameter_description> Indentation level.
+</parameter_description>
+</parameter>
+<parameter name="string_builder">
+<parameter_description> A #GString to to append XML data to.
</parameter_description>
</parameter>
</parameters>
-<return> the @GIOCondition mask of the current state
-
-</return>
+<return></return>
</function>
-<function name="g_socket_condition_wait">
+<function name="g_dbus_node_info_lookup_interface">
<description>
-Waits for @condition to become true on @socket. When the condition
-is met, %TRUE is returned.
+Looks up information about an interface.
-If @cancellable is cancelled before the condition is met, or if the
-socket has a timeout set and it is reached before the condition is
-met, then %FALSE is returned and @error, if non-%NULL, is set to
-the appropriate value (%G_IO_ERROR_CANCELLED or
-%G_IO_ERROR_TIMED_OUT).
+This cost of this function is O(n) in number of interfaces.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
-</parameter_description>
-</parameter>
-<parameter name="condition">
-<parameter_description> a #GIOCondition mask to wait for
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError pointer, or %NULL
+<parameter name="name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the condition was met, %FALSE otherwise
+<return> A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
</return>
</function>
-<function name="g_socket_connect">
+<function name="g_dbus_node_info_new_for_xml">
<description>
-Connect the socket to the specified remote address.
-
-For connection oriented socket this generally means we attempt to make
-a connection to the @address. For a connection-less socket it sets
-the default address for g_socket_send() and discards all incoming datagrams
-from other sources.
-
-Generally connection oriented sockets can only connect once, but
-connection-less sockets can connect multiple times to change the
-default address.
+Parses @xml_data and returns a #GDBusNodeInfo representing the data.
-If the connect call needs to do network I/O it will block, unless
-non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned
-and the user can be notified of the connection finishing by waiting
-for the G_IO_OUT condition. The result of the connection can then be
-checked with g_socket_check_connect_result().
+Note that this routine is using a
+<link linkend="glib-Simple-XML-Subset-Parser.description">GMarkup</link>-based
+parser that only accepts a subset of valid XML documents.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
-</parameter_description>
-</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress specifying the remote address.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter name="xml_data">
+<parameter_description> Valid D-Bus introspection XML.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if connected, %FALSE on error.
+<return> A #GDBusNodeInfo structure or %NULL if @error is set. Free
+with g_dbus_node_info_unref().
</return>
</function>
-<function name="g_socket_connectable_enumerate">
+<function name="g_dbus_node_info_ref">
<description>
-Creates a #GSocketAddressEnumerator for @connectable.
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="connectable">
-<parameter_description> a #GSocketConnectable
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSocketAddressEnumerator.
+<return> The same @info.
</return>
</function>
-<function name="g_socket_connectable_proxy_enumerate">
+<function name="g_dbus_node_info_unref">
<description>
-Creates a #GSocketAddressEnumerator for @connectable that will
-return #GProxyAddress<!-- -->es for addresses that you must connect
-to via a proxy.
-
-If @connectable does not implement
-g_socket_connectable_proxy_enumerate(), this will fall back to
-calling g_socket_connectable_enumerate().
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
Since: 2.26
</description>
<parameters>
-<parameter name="connectable">
-<parameter_description> a #GSocketConnectable
+<parameter name="info">
+<parameter_description> A #GDBusNodeInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSocketAddressEnumerator.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_connection_factory_create_connection">
+<function name="g_dbus_object_get_interface">
<description>
-Creates a #GSocketConnection subclass of the right type for
- socket
+Gets the D-Bus interface with name @interface_name associated with
+ object, if any.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="object">
+<parameter_description> A #GDBusObject.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection
+<return> %NULL if not found, otherwise a
+#GDBusInterface that must be freed with g_object_unref().
</return>
</function>
-<function name="g_socket_connection_factory_lookup_type">
+<function name="g_dbus_object_get_interfaces">
<description>
-Looks up the #GType to be used when creating socket connections on
-sockets with the specified @family,@type and @protocol_id.
-
-If no type is registered, the #GSocketConnection base type is returned.
+Gets the D-Bus interfaces associated with @object.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="family">
-<parameter_description> a #GSocketFamily
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
-</parameter_description>
-</parameter>
-<parameter name="protocol_id">
-<parameter_description> a protocol id
+<parameter name="object">
+<parameter_description> A #GDBusObject.
</parameter_description>
</parameter>
</parameters>
-<return> a #GType
+<return> A list of #GDBusInterface instances.
+The returned list must be freed by g_list_free() after each element has been freed
+with g_object_unref().
</return>
</function>
-<function name="g_socket_connection_factory_register_type">
+<function name="g_dbus_object_get_object_path">
<description>
-Looks up the #GType to be used when creating socket connections on
-sockets with the specified @family,@type and @protocol.
-
-If no type is registered, the #GSocketConnection base type is returned.
+Gets the object path for @object.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="g_type">
-<parameter_description> a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION
-</parameter_description>
-</parameter>
-<parameter name="family">
-<parameter_description> a #GSocketFamily
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> a protocol id
+<parameter name="object">
+<parameter_description> A #GDBusObject.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A string owned by @object. Do not free.
+
+</return>
</function>
-<function name="g_socket_connection_get_local_address">
+<function name="g_dbus_object_manager_client_get_connection">
<description>
-Try to get the local address of a socket connection.
+Gets the #GDBusConnection used by @manager.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GSocketConnection
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress or %NULL on error.
-Free the returned object with g_object_unref().
+<return> A #GDBusConnection object. Do not free,
+the object belongs to @manager.
</return>
</function>
-<function name="g_socket_connection_get_remote_address">
+<function name="g_dbus_object_manager_client_get_flags">
<description>
-Try to get the remote address of a socket connection.
+Gets the flags that @manager was constructed with.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GSocketConnection
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameters>
+<return> Zero of more flags from the #GDBusObjectManagerClientFlags
+enumeration.
+
+</return>
+</function>
+
+<function name="g_dbus_object_manager_client_get_name">
+<description>
+Gets the name that @manager is for.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress or %NULL on error.
-Free the returned object with g_object_unref().
+<return> A unique or well-known name. Do not free, the string
+belongs to @manager.
</return>
</function>
-<function name="g_socket_connection_get_socket">
+<function name="g_dbus_object_manager_client_get_name_owner">
<description>
-Gets the underlying #GSocket object of the connection.
-This can be useful if you want to do something unusual on it
-not supported by the #GSocketConnection APIs.
+The unique name that owns the name that @manager is for or %NULL if
+no-one currently owns that name. You can connect to the
+#GObject::notify signal to track changes to the
+#GDBusObjectManagerClient:name-owner property.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GSocketConnection
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerClient.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress or %NULL on error.
+<return> The name owner or %NULL if no name owner exists. Free with
+g_free().
</return>
</function>
-<function name="g_socket_control_message_deserialize">
+<function name="g_dbus_object_manager_client_new">
<description>
-Tries to deserialize a socket control message of a given
- level and @type. This will ask all known (to GType) subclasses
-of #GSocketControlMessage if they can understand this kind
-of message and if so deserialize it into a #GSocketControlMessage.
+Asynchronously creates a new #GDBusObjectManagerClient object.
-If there is no implementation for this kind of control message, %NULL
-will be returned.
+This is an asynchronous failable constructor. When the result is
+ready, @callback will be invoked in the
+<link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+of the thread you are calling this method from. You can
+then call g_dbus_object_manager_client_new_finish() to get the result. See
+g_dbus_object_manager_client_new_sync() for the synchronous version.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="level">
-<parameter_description> a socket level
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> a socket control message type for the given @level
+<parameter name="flags">
+<parameter_description> Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the size of the data in bytes
+<parameter name="name">
+<parameter_description> The owner of the control object (unique or well-known name).
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> pointer to the message data
+<parameter name="object_path">
+<parameter_description> The object path of the control object.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_func">
+<parameter_description> A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_user_data">
+<parameter_description> User data to pass to @get_proxy_type_func.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_destroy_notify">
+<parameter_description> Free function for @get_proxy_type_user_data or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> the deserialized message or %NULL
-
-</return>
+<return></return>
</function>
-<function name="g_socket_control_message_get_level">
+<function name="g_dbus_object_manager_client_new_finish">
<description>
-Returns the "level" (i.e. the originating protocol) of the control message.
-This is often SOL_SOCKET.
+Finishes an operation started with g_dbus_object_manager_client_new().
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_object_manager_client_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> an integer describing the level
+<return> A
+#GDBusObjectManagerClient object or %NULL if @error is set. Free
+with g_object_unref().
</return>
</function>
-<function name="g_socket_control_message_get_msg_type">
+<function name="g_dbus_object_manager_client_new_for_bus">
<description>
-Returns the protocol specific type of the control message.
-For instance, for UNIX fd passing this would be SCM_RIGHTS.
+Like g_dbus_object_manager_client_new() but takes a #GBusType instead of a
+#GDBusConnection.
-Since: 2.22
+This is an asynchronous failable constructor. When the result is
+ready, @callback will be invoked in the
+<link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+of the thread you are calling this method from. You can
+then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See
+g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The owner of the control object (unique or well-known name).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path of the control object.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_func">
+<parameter_description> A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_user_data">
+<parameter_description> User data to pass to @get_proxy_type_func.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_destroy_notify">
+<parameter_description> Free function for @get_proxy_type_user_data or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> an integer describing the type of control message
-
-</return>
+<return></return>
</function>
-<function name="g_socket_control_message_get_size">
+<function name="g_dbus_object_manager_client_new_for_bus_finish">
<description>
-Returns the space required for the control message, not including
-headers or alignment.
+Finishes an operation started with g_dbus_object_manager_client_new_for_bus().
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_object_manager_client_new_for_bus().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> The number of bytes required.
+<return> A
+#GDBusObjectManagerClient object or %NULL if @error is set. Free
+with g_object_unref().
</return>
</function>
-<function name="g_socket_control_message_serialize">
+<function name="g_dbus_object_manager_client_new_for_bus_sync">
<description>
-Converts the data in the message to bytes placed in the
-message.
+Like g_dbus_object_manager_client_new_sync() but takes a #GBusType instead
+of a #GDBusConnection.
- data is guaranteed to have enough space to fit the size
-returned by g_socket_control_message_get_size() on this
-object.
+This is a synchronous failable constructor - the calling thread is
+blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus()
+for the asynchronous version.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="message">
-<parameter_description> a #GSocketControlMessage
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> A buffer to write data to
+<parameter name="flags">
+<parameter_description> Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The owner of the control object (unique or well-known name).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path of the control object.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_func">
+<parameter_description> A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_user_data">
+<parameter_description> User data to pass to @get_proxy_type_func.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_destroy_notify">
+<parameter_description> Free function for @get_proxy_type_user_data or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A
+#GDBusObjectManagerClient object or %NULL if @error is set. Free
+with g_object_unref().
+
+</return>
</function>
-<function name="g_socket_create_source">
+<function name="g_dbus_object_manager_client_new_sync">
<description>
-Creates a %GSource that can be attached to a %GMainContext to monitor
-for the availibility of the specified @condition on the socket.
-
-The callback on the source is of the #GSocketSourceFunc type.
-
-It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition;
-these conditions will always be reported output if they are true.
-
- cancellable if not %NULL can be used to cancel the source, which will
-cause the source to trigger, reporting the current condition (which
-is likely 0 unless cancellation happened at the same time as a
-condition change). You can check for this in the callback using
-g_cancellable_is_cancelled().
+Creates a new #GDBusObjectManagerClient object.
-If @socket has a timeout set, and it is reached before @condition
-occurs, the source will then trigger anyway, reporting %G_IO_IN or
-%G_IO_OUT depending on @condition. However, @socket will have been
-marked as having had a timeout, and so the next #GSocket I/O method
-you call will then fail with a %G_IO_ERROR_TIMED_OUT.
+This is a synchronous failable constructor - the calling thread is
+blocked until a reply is received. See g_dbus_object_manager_client_new()
+for the asynchronous version.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="condition">
-<parameter_description> a #GIOCondition mask to monitor
+<parameter name="flags">
+<parameter_description> Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The owner of the control object (unique or well-known name).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> The object path of the control object.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_func">
+<parameter_description> A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_user_data">
+<parameter_description> User data to pass to @get_proxy_type_func.
+</parameter_description>
+</parameter>
+<parameter name="get_proxy_type_destroy_notify">
+<parameter_description> Free function for @get_proxy_type_user_data or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated %GSource, free with g_source_unref().
+<return> A
+#GDBusObjectManagerClient object or %NULL if @error is set. Free
+with g_object_unref().
</return>
</function>
-<function name="g_socket_get_blocking">
+<function name="g_dbus_object_manager_get_interface">
<description>
-Gets the blocking mode of the socket. For details on blocking I/O,
-see g_socket_set_blocking().
+Gets the interface proxy for @interface_name at @object_path, if
+any.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManager.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> Object path to lookup.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> D-Bus interface name to lookup.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if blocking I/O is used, %FALSE otherwise.
+<return> A #GDBusInterface instance or %NULL. Free
+with g_object_unref().
</return>
</function>
-<function name="g_socket_get_credentials">
+<function name="g_dbus_object_manager_get_object">
<description>
-Returns the credentials of the foreign process connected to this
-socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX
-sockets).
-
-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.
-
-Other ways to obtain credentials from a foreign peer includes the
-#GUnixCredentialsMessage type and
-g_unix_connection_send_credentials() /
-g_unix_connection_receive_credentials() functions.
+Gets the #GDBusObjectProxy at @object_path, if any.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManager.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="object_path">
+<parameter_description> Object path to lookup.
</parameter_description>
</parameter>
</parameters>
-<return> %NULL if @error is set, otherwise a #GCredentials object
-that must be freed with g_object_unref().
+<return> A #GDBusObject or %NULL. Free with
+g_object_unref().
</return>
</function>
-<function name="g_socket_get_family">
+<function name="g_dbus_object_manager_get_object_path">
<description>
-Gets the socket family of the socket.
+Gets the object path that @manager is for.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManager.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketFamily
+<return> A string owned by @manager. Do not free.
</return>
</function>
-<function name="g_socket_get_fd">
+<function name="g_dbus_object_manager_get_objects">
<description>
-Returns the underlying OS socket object. On unix this
-is a socket file descriptor, and on windows this is
-a Winsock2 SOCKET handle. This may be useful for
-doing platform specific or otherwise unusual operations
-on the socket.
+Gets all #GDBusObject objects known to @manager.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManager.
</parameter_description>
</parameter>
</parameters>
-<return> the file descriptor of the socket.
+<return> A list of
+#GDBusObject objects. The returned list should be freed with
+g_list_free() after each element has been freed with
+g_object_unref().
</return>
</function>
-<function name="g_socket_get_keepalive">
+<function name="g_dbus_object_manager_server_export">
<description>
-Gets the keepalive mode of the socket. For details on this,
-see g_socket_set_keepalive().
+Exports @object on @manager.
-Since: 2.22
+If there is already a #GDBusObject exported at the object path,
+then the old object is removed.
+
+The object path for @object must be in the hierarchy rooted by the
+object path for @manager.
+
+Note that @manager will take a reference on @object for as long as
+it is exported.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerServer.
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if keepalive is active, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_get_listen_backlog">
+<function name="g_dbus_object_manager_server_export_uniquely">
<description>
-Gets the listen backlog setting of the socket. For details on this,
-see g_socket_set_listen_backlog().
+Like g_dbus_object_manager_server_export() but appends a string of
+the form <literal>_N</literal> (with N being a natural number) to
+ object<!-- -->'s object path if an object with the given path
+already exists. As such, the #GDBusObjectProxy:g-object-path property
+of @object may be modified.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerServer.
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> An object.
</parameter_description>
</parameter>
</parameters>
-<return> the maximum number of pending connections.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_get_local_address">
+<function name="g_dbus_object_manager_server_get_connection">
<description>
-Try to get the local address of a bound socket. This is only
-useful if the socket has been bound to a local address,
-either explicitly or implicitly when connecting.
+Gets the #GDBusConnection used by @manager.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerServer
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress or %NULL on error.
-Free the returned object with g_object_unref().
+<return> A #GDBusConnection object or %NULL if
+ manager isn't exported on a connection. The returned object should
+be freed with g_object_unref().
</return>
</function>
-<function name="g_socket_get_protocol">
+<function name="g_dbus_object_manager_server_new">
<description>
-Gets the socket protocol id the socket was created with.
-In case the protocol is unknown, -1 is returned.
+Creates a new #GDBusObjectManagerServer object.
-Since: 2.22
+The returned server isn't yet exported on any connection. To do so,
+use g_dbus_object_manager_server_set_connection(). Normally you
+want to export all of your objects before doing so to avoid <ulink
+url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager">InterfacesAdded</ulink>
+signals being emitted.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="object_path">
+<parameter_description> The object path to export the manager object at.
</parameter_description>
</parameter>
</parameters>
-<return> a protocol id, or -1 if unknown
+<return> A #GDBusObjectManagerServer object. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_get_remote_address">
+<function name="g_dbus_object_manager_server_set_connection">
<description>
-Try to get the remove address of a connected socket. This is only
-useful for connection oriented sockets that have been connected.
-
-Since: 2.22
+Exports all objects managed by @manager on @connection. If
+ connection is %NULL, stops exporting objects.
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerServer.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="connection">
+<parameter_description> A #GDBusConnection or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketAddress or %NULL on error.
-Free the returned object with g_object_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_socket_get_socket_type">
+<function name="g_dbus_object_manager_server_unexport">
<description>
-Gets the socket type of the socket.
+If @manager has an object at @path, removes the object. Otherwise
+does nothing.
-Since: 2.22
+Note that @object_path must be in the hierarchy rooted by the
+object path for @manager.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="manager">
+<parameter_description> A #GDBusObjectManagerServer.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketType
+<return> %TRUE if object at @object_path was removed, %FALSE otherwise.
</return>
</function>
-<function name="g_socket_get_timeout">
+<function name="g_dbus_object_proxy_get_connection">
<description>
-Gets the timeout setting of the socket. For details on this, see
-g_socket_set_timeout().
+Gets the connection that @proxy is for.
-Since: 2.26
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="proxy">
+<parameter_description> a #GDBusObjectProxy
</parameter_description>
</parameter>
</parameters>
-<return> the timeout in seconds
+<return> A #GDBusConnection. Do not free, the
+object is owned by @proxy.
</return>
</function>
-<function name="g_socket_is_closed">
+<function name="g_dbus_object_proxy_new">
<description>
-Checks whether a socket is closed.
+Creates a new #GDBusObjectProxy for the given connection and
+object path.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="connection">
+<parameter_description> a #GDBusConnection
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> the object path
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if socket is closed, %FALSE otherwise
+<return> a new #GDBusObjectProxy
</return>
</function>
-<function name="g_socket_is_connected">
+<function name="g_dbus_object_skeleton_add_interface">
<description>
-Check whether the socket is connected. This is only useful for
-connection-oriented sockets.
+Adds @interface_ to @object.
-Since: 2.22
+If @object already contains a #GDBusInterfaceSkeleton with the same
+interface name, it is removed before @interface_ is added.
+
+Note that @object takes its own reference on @interface_ and holds
+it until removed.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
+</parameter_description>
+</parameter>
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if socket is connected, %FALSE otherwise.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_listen">
+<function name="g_dbus_object_skeleton_flush">
<description>
-Marks the socket as a server socket, i.e. a socket that is used
-to accept incoming requests using g_socket_accept().
-
-Before calling this the socket must be bound to a local address using
-g_socket_bind().
-
-To set the maximum amount of outstanding clients, use
-g_socket_set_listen_backlog().
+This method simply calls g_dbus_interface_skeleton_flush() on all
+interfaces belonging to @object. See that method for when flushing
+is useful.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_object_skeleton_new">
+<description>
+Creates a new #GDBusObjectSkeleton.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> A #GDBusObjectSkeleton. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_listener_accept">
+<function name="g_dbus_object_skeleton_remove_interface">
<description>
-Blocks waiting for a client to connect to any of the sockets added
-to the listener. Returns a #GSocketConnection for the socket that was
-accepted.
-
-If @source_object is not %NULL it will be filled out with the source
-object specified when the corresponding socket or address was added
-to the listener.
-
-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.
+Removes @interface_ from @object.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> location where #GObject pointer will be stored, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="interface_">
+<parameter_description> A #GDBusInterfaceSkeleton.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_listener_accept_async">
+<function name="g_dbus_object_skeleton_remove_interface_by_name">
<description>
-This is the asynchronous version of g_socket_listener_accept().
+Removes the #GDBusInterface with @interface_name from @object.
-When the operation is finished @callback will be
-called. You can then call g_socket_listener_accept_socket()
-to get the result of the operation.
+If no D-Bus interface of the given interface exists, this function
+does nothing.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_listener_accept_finish">
+<function name="g_dbus_object_skeleton_set_object_path">
<description>
-Finishes an async accept operation. See g_socket_listener_accept_async()
+Sets the object path for @object.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="object">
+<parameter_description> A #GDBusObjectSkeleton.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="object_path">
+<parameter_description> A valid D-Bus object path.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_property_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusPropertyInfo
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnection on success, %NULL on error.
+<return> The same @info.
</return>
</function>
-<function name="g_socket_listener_accept_socket">
+<function name="g_dbus_property_info_unref">
<description>
-Blocks waiting for a client to connect to any of the sockets added
-to the listener. Returns the #GSocket that was accepted.
-
-If you want to accept the high-level #GSocketConnection, not a #GSocket,
-which is often the case, then you should use g_socket_listener_accept()
-instead.
-
-If @source_object is not %NULL it will be filled out with the source
-object specified when the corresponding socket or address was added
-to the listener.
-
-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 @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="source_object">
-<parameter_description> location where #GObject pointer will be stored, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="info">
+<parameter_description> A #GDBusPropertyInfo.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket on success, %NULL on error.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_listener_accept_socket_async">
+<function name="g_dbus_proxy_call">
<description>
-This is the asynchronous version of g_socket_listener_accept_socket().
+Asynchronously invokes the @method_name method on @proxy.
-When the operation is finished @callback will be
-called. You can then call g_socket_listener_accept_socket_finish()
-to get the result of the operation.
+If @method_name contains any dots, then @name is split into interface and
+method name parts. This allows using @proxy for invoking methods on
+other interfaces.
-Since: 2.22
+If the #GDBusConnection associated with @proxy is closed then
+the operation will fail with %G_IO_ERROR_CLOSED. If
+ cancellable is canceled, the operation will fail with
+%G_IO_ERROR_CANCELLED. If @parameters contains a value not
+compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
+
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_proxy_call (proxy,
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+(GAsyncReadyCallback) two_strings_done,
+&data);
+]|
+
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info) and @method_name is referenced by it,
+then the return value is checked against the return type.
+
+This is an asynchronous method. When the operation is finished,
+ callback will be invoked in the
+<link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+of the thread you are calling this method from.
+You can then call g_dbus_proxy_call_finish() to get the result of
+the operation. See g_dbus_proxy_call_sync() for the synchronous
+version of this method.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
+"infinite") or -1 to use the proxy default timeout.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> a #GAsyncReadyCallback
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
+care about the result of the method invocation.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data for the callback
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_socket_listener_accept_socket_finish">
+<function name="g_dbus_proxy_call_finish">
<description>
-Finishes an async accept operation. See g_socket_listener_accept_socket_async()
+Finishes an operation started with g_dbus_proxy_call().
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket on success, %NULL on error.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_socket_listener_add_address">
+<function name="g_dbus_proxy_call_sync">
<description>
-Creates a socket of type @type and protocol @protocol, binds
-it to @address and adds it to the set of sockets we're accepting
-sockets from.
+Synchronously invokes the @method_name method on @proxy.
-Note that adding an IPv6 address, depending on the platform,
-may or may not result in a listener that also accepts IPv4
-connections. For more determinstic behaviour, see
-g_socket_listener_add_inet_port().
+If @method_name contains any dots, then @name is split into interface and
+method name parts. This allows using @proxy for invoking methods on
+other interfaces.
- source_object will be passed out in the various calls
-to accept to identify this particular source, which is
-useful if you're listening on multiple addresses and do
-different things depending on what address is connected to.
+If the #GDBusConnection associated with @proxy is disconnected then
+the operation will fail with %G_IO_ERROR_CLOSED. If
+ cancellable is canceled, the operation will fail with
+%G_IO_ERROR_CANCELLED. If @parameters contains a value not
+compatible with the D-Bus protocol, the operation fails with
+%G_IO_ERROR_INVALID_ARGUMENT.
-If successful and @effective_address is non-%NULL then it will
-be set to the address that the binding actually occured at. This
-is helpful for determining the port number that was used for when
-requesting a binding to port 0 (ie: "any port"). This address, if
-requested, belongs to the caller and must be freed.
+If the @parameters #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.:
+|[
+g_dbus_proxy_call_sync (proxy,
+"TwoStrings",
+g_variant_new ("(ss)",
+"Thing One",
+"Thing Two"),
+G_DBUS_CALL_FLAGS_NONE,
+-1,
+NULL,
+&error);
+]|
-Since: 2.22
+The calling thread is blocked until a reply is received. See
+g_dbus_proxy_call() for the asynchronous version of this
+method.
+
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info) and @method_name is referenced by it,
+then the return value is checked against the return type.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
</parameter_description>
</parameter>
-<parameter name="type">
-<parameter_description> a #GSocketType
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal
+or %NULL if not passing parameters.
</parameter_description>
</parameter>
-<parameter name="protocol">
-<parameter_description> a #GSocketProtocol
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
+"infinite") or -1 to use the proxy default timeout.
</parameter_description>
</parameter>
-<parameter name="effective_address">
-<parameter_description> location to store the address that was bound to, or %NULL.
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_socket_listener_add_any_inet_port">
+<function name="g_dbus_proxy_call_with_unix_fd_list">
<description>
-Listens for TCP connections on any available port number for both
-IPv6 and IPv4 (if each are available).
-
-This is useful if you need to have a socket for incoming connections
-but don't care about the specific port number.
+Like g_dbus_proxy_call() but also takes a #GUnixFDList object.
- source_object will be passed out in the various calls
-to accept to identify this particular source, which is
-useful if you're listening on multiple addresses and do
-different things depending on what address is connected to.
+This method is only available on UNIX.
-Since: 2.24
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
-ignore.
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
+"infinite") or -1 to use the proxy default timeout.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
+care about the result of the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> The data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> the port number, or 0 in case of failure.
-
-</return>
+<return></return>
</function>
-<function name="g_socket_listener_add_inet_port">
+<function name="g_dbus_proxy_call_with_unix_fd_list_finish">
<description>
-Helper function for g_socket_listener_add_address() that
-creates a TCP/IP socket listening on IPv4 and IPv6 (if
-supported) on the specified port on all interfaces.
-
- source_object will be passed out in the various calls
-to accept to identify this particular source, which is
-useful if you're listening on multiple addresses and do
-different things depending on what address is connected to.
+Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list().
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="port">
-<parameter_description> an IP port number (non-zero)
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call_with_unix_fd_list().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_socket_listener_add_socket">
+<function name="g_dbus_proxy_call_with_unix_fd_list_sync">
<description>
-Adds @socket to the set of sockets that we try to accept
-new clients from. The socket must be bound to a local
-address and listened to.
+Like g_dbus_proxy_call_sync() but also takes and returns #GUnixFDList objects.
- source_object will be passed out in the various calls
-to accept to identify this particular source, which is
-useful if you're listening on multiple addresses and do
-different things depending on what address is connected to.
+This method is only available on UNIX.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="socket">
-<parameter_description> a listening #GSocket
+<parameter name="method_name">
+<parameter_description> Name of method to invoke.
</parameter_description>
</parameter>
-<parameter name="source_object">
-<parameter_description> Optional #GObject identifying this source
+<parameter name="parameters">
+<parameter_description> A #GVariant tuple with parameters for the signal
+or %NULL if not passing parameters.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusCallFlags enumeration.
+</parameter_description>
+</parameter>
+<parameter name="timeout_msec">
+<parameter_description> The timeout in milliseconds (with %G_MAXINT meaning
+"infinite") or -1 to use the proxy default timeout.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="out_fd_list">
+<parameter_description> Return location for a #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error.
+<return> %NULL if @error is set. Otherwise a #GVariant tuple with
+return values. Free with g_variant_unref().
</return>
</function>
-<function name="g_socket_listener_close">
+<function name="g_dbus_proxy_get_cached_property">
<description>
-Closes all the sockets in the listener.
+Looks up the value for a property from the cache. This call does no
+blocking IO.
-Since: 2.22
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info) and @property_name is referenced by
+it, then @value is checked against the type of the property.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> Property name.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A reference to the #GVariant instance that holds the value
+for @property_name or %NULL if the value is not in the cache. The
+returned reference must be freed with g_variant_unref().
+
+</return>
</function>
-<function name="g_socket_listener_new">
+<function name="g_dbus_proxy_get_cached_property_names">
<description>
-Creates a new #GSocketListener with no sockets to listen for.
-New listeners can be added with e.g. g_socket_listener_add_address()
-or g_socket_listener_add_inet_port().
+Gets the names of all cached properties on @proxy.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GSocketListener.
+<return> A %NULL-terminated array of strings or %NULL if
+ proxy has no cached properties. Free the returned array with
+g_strfreev().
</return>
</function>
-<function name="g_socket_listener_set_backlog">
+<function name="g_dbus_proxy_get_connection">
<description>
-Sets the listen backlog on the sockets in the listener.
-
-See g_socket_set_listen_backlog() for details
+Gets the connection @proxy is for.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="listener">
-<parameter_description> a #GSocketListener
-</parameter_description>
-</parameter>
-<parameter name="listen_backlog">
-<parameter_description> an integer
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> A #GDBusConnection owned by @proxy. Do not free.
+
+</return>
</function>
-<function name="g_socket_new">
+<function name="g_dbus_proxy_get_default_timeout">
<description>
-Creates a new #GSocket with the defined family, type and protocol.
-If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
-for the family and type is used.
-
-The @protocol is a family and type specific int that specifies what
-kind of protocol to use. #GSocketProtocol lists several common ones.
-Many families only support one protocol, and use 0 for this, others
-support several and using 0 means to use the default protocol for
-the family and type.
+Gets the timeout to use if -1 (specifying default timeout) is
+passed as @timeout_msec in the g_dbus_proxy_call() and
+g_dbus_proxy_call_sync() functions.
-The protocol id is passed directly to the operating
-system, so you can use protocols not listed in #GSocketProtocol if you
-know the protocol number used for it.
+See the #GDBusProxy:g-default-timeout property for more details.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="family">
-<parameter_description> the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> the socket type to use.
-</parameter_description>
-</parameter>
-<parameter name="protocol">
-<parameter_description> the id of the protocol to use, or 0 for default.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket or %NULL on error.
-Free the returned object with g_object_unref().
+<return> Timeout to use for @proxy.
</return>
</function>
-<function name="g_socket_new_from_fd">
+<function name="g_dbus_proxy_get_flags">
<description>
-Creates a new #GSocket from a native file descriptor
-or winsock SOCKET handle.
-
-This reads all the settings from the file descriptor so that
-all properties should work. Note that the file descriptor
-will be set to non-blocking mode, independent on the blocking
-mode of the #GSocket.
+Gets the flags that @proxy was constructed with.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="fd">
-<parameter_description> a native socket file descriptor.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocket or %NULL on error.
-Free the returned object with g_object_unref().
+<return> Flags from the #GDBusProxyFlags enumeration.
</return>
</function>
-<function name="g_socket_receive">
+<function name="g_dbus_proxy_get_interface_info">
<description>
-Receive data (up to @size bytes) from a socket. This is mainly used by
-connection-oriented sockets; it is identical to g_socket_receive_from()
-with @address set to %NULL.
+Returns the #GDBusInterfaceInfo, if any, specifying the interface
+that @proxy conforms to. See the #GDBusProxy:g-interface-info
+property for more details.
-For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets,
-g_socket_receive() will always read either 0 or 1 complete messages from
-the socket. If the received message is too large to fit in @buffer, then
-the data beyond @size bytes will be discarded, without any explicit
-indication that this has occurred.
+Since: 2.26
-For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any
-number of bytes, up to @size. If more than @size bytes have been
-received, the additional data will be returned in future calls to
-g_socket_receive().
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusInterfaceInfo or %NULL. Do not unref the returned
+object, it is owned by @proxy.
-If the socket is in blocking mode the call will block until there is
-some data to receive or there is an error. If there is no data available
-and the socket is in non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified when data is available, wait for the
-%G_IO_IN condition.
+</return>
+</function>
-On error -1 is returned and @error is set accordingly.
+<function name="g_dbus_proxy_get_interface_name">
+<description>
+Gets the D-Bus interface name @proxy is for.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
-</parameter_description>
-</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to read from the socket
+</parameters>
+<return> A string owned by @proxy. Do not free.
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_get_name">
+<description>
+Gets the name that @proxy was constructed for.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+</parameters>
+<return> A string owned by @proxy. Do not free.
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_get_name_owner">
+<description>
+The unique name that owns the name that @proxy is for or %NULL if
+no-one currently owns that name. You may connect to the
+#GObject::notify signal to track changes to the
+#GDBusProxy:g-name-owner property.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameters>
+<return> The name owner or %NULL if no name owner exists. Free with g_free().
+
+</return>
+</function>
+
+<function name="g_dbus_proxy_get_object_path">
+<description>
+Gets the object path @proxy is for.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> A string owned by @proxy. Do not free.
</return>
</function>
-<function name="g_socket_receive_from">
+<function name="g_dbus_proxy_new">
<description>
-Receive data (up to @size bytes) from a socket.
+Creates a proxy for accessing @interface_name on the remote object
+at @object_path owned by @name at @connection and asynchronously
+loads D-Bus properties unless the
+%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to
+the #GDBusProxy::g-properties-changed signal to get notified about
+property changes.
-If @address is non-%NULL then @address will be set equal to the
-source address of the received packet.
- address is owned by the caller.
+If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
+match rules for signals. Connect to the #GDBusProxy::g-signal signal
+to handle signals from the remote object.
-See g_socket_receive() for additional information.
+If @name is a well-known name and the
+%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
+owner currently exists, the message bus will be requested to launch
+a name owner for the name.
-Since: 2.22
+This is a failable asynchronous constructor - when the proxy is
+ready, @callback will be invoked and you can use
+g_dbus_proxy_new_finish() to get the result.
+
+See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a pointer to a #GSocketAddress pointer, or %NULL
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to read from the socket
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="callback">
+<parameter_description> Callback function to invoke when the proxy is ready.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
-
-</return>
+<return></return>
</function>
-<function name="g_socket_receive_message">
+<function name="g_dbus_proxy_new_finish">
<description>
-Receive data from a socket. This is the most complicated and
-fully-featured version of this call. For easier use, see
-g_socket_receive() and g_socket_receive_from().
-
-If @address is non-%NULL then @address will be set equal to the
-source address of the received packet.
- address is owned by the caller.
-
- vector must point to an array of #GInputVector structs and
- num_vectors must be the length of this array. These structs
-describe the buffers that received data will be scattered into.
-If @num_vectors is -1, then @vectors is assumed to be terminated
-by a #GInputVector with a %NULL buffer pointer.
-
-As a special case, if @num_vectors is 0 (in which case, @vectors
-may of course be %NULL), then a single byte is received and
-discarded. This is to facilitate the common practice of sending a
-single '\0' byte for the purposes of transferring ancillary data.
-
- messages, if non-%NULL, will be set to point to a newly-allocated
-array of #GSocketControlMessage instances or %NULL if no such
-messages was received. These correspond to the control messages
-received from the kernel, one #GSocketControlMessage per message
-from the kernel. This array is %NULL-terminated and must be freed
-by the caller using g_free() after calling g_object_unref() on each
-element. If @messages is %NULL, any control messages received will
-be discarded.
-
- num_messages, if non-%NULL, will be set to the number of control
-messages received.
+Finishes creating a #GDBusProxy.
-If both @messages and @num_messages are non-%NULL, then
- num_messages gives the number of #GSocketControlMessage instances
-in @messages (ie: not including the %NULL terminator).
+Since: 2.26
- flags is an in/out parameter. The commonly available arguments
-for this are available in the #GSocketMsgFlags enum, but the
-values there are the same as the system values, and the flags
-are passed in as-is, so you can pass in system-specific flags too
-(and g_socket_receive_message() may pass system-specific flags out).
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
-As with g_socket_receive(), data may be discarded if @socket is
-%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
-provide enough buffer space to read a complete message. You can pass
-%G_SOCKET_MSG_PEEK in @flags to peek at the current message without
-removing it from the receive queue, but there is no portable way to find
-out the length of the message other than by reading it into a
-sufficiently-large buffer.
+</return>
+</function>
-If the socket is in blocking mode the call will block until there
-is some data to receive or there is an error. If there is no data
-available and the socket is in non-blocking mode, a
-%G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when
-data is available, wait for the %G_IO_IN condition.
+<function name="g_dbus_proxy_new_for_bus">
+<description>
+Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
-On error -1 is returned and @error is set accordingly.
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a pointer to a #GSocketAddress pointer, or %NULL
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
</parameter_description>
</parameter>
-<parameter name="vectors">
-<parameter_description> an array of #GInputVector structs
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
</parameter_description>
</parameter>
-<parameter name="num_vectors">
-<parameter_description> the number of elements in @vectors, or -1
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
</parameter_description>
</parameter>
-<parameter name="messages">
-<parameter_description> a pointer which
-may be filled with an array of #GSocketControlMessages, or %NULL
+<parameter name="object_path">
+<parameter_description> An object path.
</parameter_description>
</parameter>
-<parameter name="num_messages">
-<parameter_description> a pointer which will be filled with the number of
-elements in @messages, or %NULL
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> a pointer to an int containing #GSocketMsgFlags flags
+<parameter name="cancellable">
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter name="callback">
+<parameter_description> Callback function to invoke when the proxy is ready.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User data to pass to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_proxy_new_for_bus_finish">
+<description>
+Finishes creating a #GDBusProxy.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError pointer, or %NULL
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> A #GDBusProxy or %NULL if @error is set. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_receive_with_blocking">
+<function name="g_dbus_proxy_new_for_bus_sync">
<description>
-This behaves exactly the same as g_socket_receive(), except that
-the choice of blocking or non-blocking behavior is determined by
-the @blocking argument rather than by @socket's properties.
+Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="bus_type">
+<parameter_description> A #GBusType.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
-bytes long).
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes you want to read from the socket
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface
+that @proxy conforms to or %NULL.
</parameter_description>
</parameter>
-<parameter name="blocking">
-<parameter_description> whether to do blocking or non-blocking I/O
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique).
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_send">
+<function name="g_dbus_proxy_new_sync">
<description>
-Tries to send @size bytes from @buffer on the socket. This is
-mainly used by connection-oriented sockets; it is identical to
-g_socket_send_to() with @address set to %NULL.
+Creates a proxy for accessing @interface_name on the remote object
+at @object_path owned by @name at @connection and synchronously
+loads D-Bus properties unless the
+%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used.
-If the socket is in blocking mode the call will block until there is
-space for the data in the socket queue. If there is no space available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified when space is available, wait for the
-%G_IO_OUT condition. Note though that you may still receive
-%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
-notified of a %G_IO_OUT condition. (On Windows in particular, this is
-very common due to the way the underlying APIs work.)
+If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
+match rules for signals. Connect to the #GDBusProxy::g-signal signal
+to handle signals from the remote object.
-On error -1 is returned and @error is set accordingly.
+If @name is a well-known name and the
+%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name
+owner currently exists, the message bus will be requested to launch
+a name owner for the name.
-Since: 2.22
+This is a synchronous failable constructor. See g_dbus_proxy_new()
+and g_dbus_proxy_new_finish() for the asynchronous version.
+
+See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to send.
+<parameter name="flags">
+<parameter_description> Flags used when constructing the proxy.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes to send
+<parameter name="info">
+<parameter_description> A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.
+</parameter_description>
+</parameter>
+<parameter name="object_path">
+<parameter_description> An object path.
+</parameter_description>
+</parameter>
+<parameter name="interface_name">
+<parameter_description> A D-Bus interface name.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for error or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written (which may be less than @size), or -1
-on error
+<return> A #GDBusProxy or %NULL if error is set. Free with g_object_unref().
</return>
</function>
-<function name="g_socket_send_message">
+<function name="g_dbus_proxy_set_cached_property">
<description>
-Send data to @address on @socket. This is the most complicated and
-fully-featured version of this call. For easier use, see
-g_socket_send() and g_socket_send_to().
-
-If @address is %NULL then the message is sent to the default receiver
-(set by g_socket_connect()).
+If @value is not %NULL, sets the cached value for the property with
+name @property_name to the value in @value.
- vectors must point to an array of #GOutputVector structs and
- num_vectors must be the length of this array. (If @num_vectors is -1,
-then @vectors is assumed to be terminated by a #GOutputVector with a
-%NULL buffer pointer.) The #GOutputVector structs describe the buffers
-that the sent data will be gathered from. Using multiple
-#GOutputVector<!-- -->s is more memory-efficient than manually copying
-data from multiple sources into a single buffer, and more
-network-efficient than making multiple calls to g_socket_send().
+If @value is %NULL, then the cached value is removed from the
+property cache.
- messages, if non-%NULL, is taken to point to an array of @num_messages
-#GSocketControlMessage instances. These correspond to the control
-messages to be sent on the socket.
-If @num_messages is -1 then @messages is treated as a %NULL-terminated
-array.
+If @proxy has an expected interface (see
+#GDBusProxy:g-interface-info) and @property_name is referenced by
+it, then @value is checked against the type of the property.
- flags modify how the message is sent. The commonly available arguments
-for this are available in the #GSocketMsgFlags enum, but the
-values there are the same as the system values, and the flags
-are passed in as-is, so you can pass in system-specific flags too.
+If the @value #GVariant is floating, it is consumed. This allows
+convenient 'inline' use of g_variant_new(), e.g.
+|[
+g_dbus_proxy_set_cached_property (proxy,
+"SomeProperty",
+g_variant_new ("(si)",
+"A String",
+42));
+]|
-If the socket is in blocking mode the call will block until there is
-space for the data in the socket queue. If there is no space available
-and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
-will be returned. To be notified when space is available, wait for the
-%G_IO_OUT condition. Note though that you may still receive
-%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
-notified of a %G_IO_OUT condition. (On Windows in particular, this is
-very common due to the way the underlying APIs work.)
+Normally you will not need to use this method since @proxy is
+tracking changes using the
+<literal>org.freedesktop.DBus.Properties.PropertiesChanged</literal>
+D-Bus signal. However, for performance reasons an object may decide
+to not use this signal for some properties and instead use a
+proprietary out-of-band mechanism to transmit changes.
-On error -1 is returned and @error is set accordingly.
+As a concrete example, consider an object with a property
+<literal>ChatroomParticipants</literal> which is an array of
+strings. Instead of transmitting the same (long) array every time
+the property changes, it is more efficient to only transmit the
+delta using e.g. signals <literal>ChatroomParticipantJoined(String
+name)</literal> and <literal>ChatroomParticipantParted(String
+name)</literal>.
-Since: 2.22
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
</parameter_description>
</parameter>
-<parameter name="address">
-<parameter_description> a #GSocketAddress, or %NULL
+<parameter name="property_name">
+<parameter_description> Property name.
</parameter_description>
</parameter>
-<parameter name="vectors">
-<parameter_description> an array of #GOutputVector structs
+<parameter name="value">
+<parameter_description> Value for the property or %NULL to remove it from the cache.
</parameter_description>
</parameter>
-<parameter name="num_vectors">
-<parameter_description> the number of elements in @vectors, or -1
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_proxy_set_default_timeout">
+<description>
+Sets the timeout to use if -1 (specifying default timeout) is
+passed as @timeout_msec in the g_dbus_proxy_call() and
+g_dbus_proxy_call_sync() functions.
+
+See the #GDBusProxy:g-default-timeout property for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy.
</parameter_description>
</parameter>
-<parameter name="messages">
-<parameter_description> a pointer to an
-array of #GSocketControlMessages, or %NULL.
+<parameter name="timeout_msec">
+<parameter_description> Timeout in milliseconds.
</parameter_description>
</parameter>
-<parameter name="num_messages">
-<parameter_description> number of elements in @messages, or -1.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_proxy_set_interface_info">
+<description>
+Ensure that interactions with @proxy conform to the given
+interface. See the #GDBusProxy:g-interface-info property for more
+details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GDBusProxy
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> an int containing #GSocketMsgFlags flags
+<parameter name="info">
+<parameter_description> Minimum interface this proxy conforms to or %NULL to unset.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_server_get_client_address">
+<description>
+Gets a D-Bus address string that can be used by clients to connect
+to @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameters>
+<return> A D-Bus address string. Do not free, the string is owned
+by @server.
+
+</return>
+</function>
+
+<function name="g_dbus_server_get_flags">
+<description>
+Gets the flags for @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written (which may be less than @size), or -1
-on error
+<return> A set of flags from the #GDBusServerFlags enumeration.
</return>
</function>
-<function name="g_socket_send_to">
+<function name="g_dbus_server_get_guid">
<description>
-Tries to send @size bytes from @buffer to @address. If @address is
-%NULL then the message is sent to the default receiver (set by
-g_socket_connect()).
+Gets the GUID for @server.
-See g_socket_send() for additional information.
+Since: 2.26
-Since: 2.22
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A D-Bus GUID. Do not free this string, it is owned by @server.
+
+</return>
+</function>
+
+<function name="g_dbus_server_is_active">
+<description>
+Gets whether @server is active.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
+</parameters>
+<return> %TRUE if server is active, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_dbus_server_new_sync">
+<description>
+Creates a new D-Bus server that listens on the first address in
+ address that works.
+
+Once constructed, you can use g_dbus_server_get_client_address() to
+get a D-Bus address string that clients can use to connect.
+
+Connect to the #GDBusServer::new-connection signal to handle
+incoming connections.
+
+The returned #GDBusServer isn't active - you have to start it with
+g_dbus_server_start().
+
+See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can
+be used.
+
+This is a synchronous failable constructor. See
+g_dbus_server_new() for the asynchronous version.
+
+Since: 2.26
+
+</description>
+<parameters>
<parameter name="address">
-<parameter_description> a #GSocketAddress, or %NULL
+<parameter_description> A D-Bus address.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to send.
+<parameter name="flags">
+<parameter_description> Flags from the #GDBusServerFlags enumeration.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes to send
+<parameter name="guid">
+<parameter_description> A D-Bus GUID.
+</parameter_description>
+</parameter>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver or %NULL.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+<parameter_description> A #GCancellable or %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> Return location for server or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written (which may be less than @size), or -1
-on error
+<return> A #GDBusServer or %NULL if @error is set. Free with
+g_object_unref().
</return>
</function>
-<function name="g_socket_send_with_blocking">
+<function name="g_dbus_server_start">
<description>
-This behaves exactly the same as g_socket_send(), except that
-the choice of blocking or non-blocking behavior is determined by
-the @blocking argument rather than by @socket's properties.
+Starts @server.
Since: 2.26
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
-<parameter name="buffer">
-<parameter_description> the buffer containing the data to send.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_server_stop">
+<description>
+Stops @server.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="server">
+<parameter_description> A #GDBusServer.
</parameter_description>
</parameter>
-<parameter name="size">
-<parameter_description> the number of bytes to send
+</parameters>
+<return></return>
+</function>
+
+<function name="g_dbus_signal_info_ref">
+<description>
+If @info is statically allocated does nothing. Otherwise increases
+the reference count.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusSignalInfo
</parameter_description>
</parameter>
-<parameter name="blocking">
-<parameter_description> whether to do blocking or non-blocking I/O
+</parameters>
+<return> The same @info.
+
+</return>
+</function>
+
+<function name="g_dbus_signal_info_unref">
+<description>
+If @info is statically allocated, does nothing. Otherwise decreases
+the reference count of @info. When its reference count drops to 0,
+the memory used is freed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> A #GDBusSignalInfo.
</parameter_description>
</parameter>
-<parameter name="cancellable">
-<parameter_description> a %GCancellable or %NULL
+</parameters>
+<return></return>
+</function>
+
+<function name="g_desktop_app_info_get_categories">
+<description>
+Gets the categories from the desktop file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameters>
+<return> The unparsed Categories key from the desktop file;
+i.e. no attempt is made to split it by ';' or validate it.
+</return>
+</function>
+
+<function name="g_desktop_app_info_get_filename">
+<description>
+When @info was created from a known filename, return it. In some
+situations such as the #GDesktopAppInfo returned from
+g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes written (which may be less than @size), or -1
-on error
+<return> The full path to the file for @info, or %NULL if not known.
+</return>
+</function>
+
+<function name="g_desktop_app_info_get_generic_name">
+<description>
+Gets the generic name from the destkop file.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value of the GenericName key
</return>
</function>
-<function name="g_socket_service_is_active">
+<function name="g_desktop_app_info_get_is_hidden">
<description>
-Check whether the service is active or not. An active
-service will accept new clients that connect, while
-a non-active service will let connecting clients queue
-up until the service is started.
+A desktop file is hidden if the Hidden key in it is
+set to True.
-Since: 2.22
</description>
<parameters>
-<parameter name="service">
-<parameter_description> a #GSocketService
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the service is active, %FALSE otherwise
+<return> %TRUE if hidden, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_desktop_app_info_get_keywords">
+<description>
+Gets the keywords from the desktop file.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+</parameters>
+<return> The value of the Keywords key
</return>
</function>
-<function name="g_socket_service_new">
+<function name="g_desktop_app_info_get_nodisplay">
<description>
-Creates a new #GSocketService with no sockets to listen for.
-New listeners can be added with e.g. g_socket_listener_add_address()
-or g_socket_listener_add_inet_port().
+Gets the value of the NoDisplay key, which helps determine if the
+application info should be shown in menus. See
+#G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show().
-Since: 2.22
+Since: 2.30
</description>
<parameters>
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GSocketService.
+<return> The value of the NoDisplay key
</return>
</function>
-<function name="g_socket_service_start">
+<function name="g_desktop_app_info_get_show_in">
<description>
-Starts the service, i.e. start accepting connections
-from the added sockets when the mainloop runs.
+Checks if the application info should be shown in menus that list available
+applications for a specific name of the desktop, based on the
+<literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys.
-This call is threadsafe, so it may be called from a thread
-handling an incomming client request.
+If @desktop_env is %NULL, then the name of the desktop set with
+g_desktop_app_info_set_desktop_env() is used.
-Since: 2.22
+Note that g_app_info_should_show() for @info will include this check (with
+%NULL for @desktop_env) as well as additional checks.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="service">
-<parameter_description> a #GSocketService
+<parameter name="info">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+<parameter name="desktop_env">
+<parameter_description> a string specifying a desktop name
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if the @info should be shown in @desktop_env according to the
+<literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys, %FALSE
+otherwise.
+
+</return>
</function>
-<function name="g_socket_service_stop">
+<function name="g_desktop_app_info_launch_uris_as_manager">
<description>
-Stops the service, i.e. stops accepting connections
-from the added sockets when the mainloop runs.
+This function performs the equivalent of g_app_info_launch_uris(),
+but is intended primarily for operating system components that
+launch applications. Ordinary applications should use
+g_app_info_launch_uris().
+
+In contrast to g_app_info_launch_uris(), all processes created will
+always be run directly as children as if by the UNIX fork()/exec()
+calls.
-This call is threadsafe, so it may be called from a thread
-handling an incomming client request.
+This guarantee allows additional control over the exact environment
+of the child processes, which is provided via a setup function
+ user_setup, as well as the process identifier of each child process
+via @pid_callback. See g_spawn_async() for more information about the
+semantics of the @user_setup function.
-Since: 2.22
</description>
<parameters>
-<parameter name="service">
-<parameter_description> a #GSocketService
+<parameter name="appinfo">
+<parameter_description> a #GDesktopAppInfo
+</parameter_description>
+</parameter>
+<parameter name="uris">
+<parameter_description> List of URIs
+</parameter_description>
+</parameter>
+<parameter name="launch_context">
+<parameter_description> a #GAppLaunchContext
+</parameter_description>
+</parameter>
+<parameter name="spawn_flags">
+<parameter_description> #GSpawnFlags, used for each process
+</parameter_description>
+</parameter>
+<parameter name="user_setup">
+<parameter_description> a #GSpawnChildSetupFunc, used once for
+each process.
+</parameter_description>
+</parameter>
+<parameter name="user_setup_data">
+<parameter_description> User data for @user_setup
+</parameter_description>
+</parameter>
+<parameter name="pid_callback">
+<parameter_description> Callback for child processes
+</parameter_description>
+</parameter>
+<parameter name="pid_callback_data">
+<parameter_description> User data for @callback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on successful launch, %FALSE otherwise.
+</return>
</function>
-<function name="g_socket_set_blocking">
+<function name="g_desktop_app_info_lookup_get_default_for_uri_scheme">
<description>
-Sets the blocking mode of the socket. In blocking mode
-all operations block until they succeed or there is an error. In
-non-blocking mode all functions return results immediately or
-with a %G_IO_ERROR_WOULD_BLOCK error.
+Gets the default application for launching applications
+using this URI scheme for a particular GDesktopAppInfoLookup
+implementation.
+
+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.
+
+</description>
+<parameters>
+<parameter name="lookup">
+<parameter_description> a #GDesktopAppInfoLookup
+</parameter_description>
+</parameter>
+<parameter name="uri_scheme">
+<parameter_description> a string containing a URI scheme.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GAppInfo for given @uri_scheme or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_desktop_app_info_new">
+<description>
+Creates a new #GDesktopAppInfo based on a desktop file id.
+
+A desktop file id is the basename of the desktop file, including the
+.desktop extension. GIO is looking for a desktop file with this name
+in the <filename>applications</filename> subdirectories of the XDG data
+directories (i.e. the directories specified in the
+<envar>XDG_DATA_HOME</envar> and <envar>XDG_DATA_DIRS</envar> environment
+variables). GIO also supports the prefix-to-subdirectory mapping that is
+described in the <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Menu Spec</ulink>
+(i.e. a desktop id of kde-foo.desktop will match
+<filename>/usr/share/applications/kde/foo.desktop</filename>).
+
+
+</description>
+<parameters>
+<parameter name="desktop_id">
+<parameter_description> the desktop file id
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GDesktopAppInfo, or %NULL if no desktop file with that id
+</return>
+</function>
+
+<function name="g_desktop_app_info_new_from_filename">
+<description>
+Creates a new #GDesktopAppInfo.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> the path of a desktop file, in the GLib filename encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GDesktopAppInfo or %NULL on error.
+</return>
+</function>
+
+<function name="g_desktop_app_info_new_from_keyfile">
+<description>
+Creates a new #GDesktopAppInfo.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="key_file">
+<parameter_description> an opened #GKeyFile
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GDesktopAppInfo or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_desktop_app_info_set_desktop_env">
+<description>
+Sets the name of the desktop that the application is running in.
+This is used by g_app_info_should_show() and
+g_desktop_app_info_get_show_in() to evaluate the
+<literal>OnlyShowIn</literal> and <literal>NotShowIn</literal>
+desktop entry fields.
+
+The <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Desktop
+Menu specification</ulink> recognizes the following:
+<simplelist>
+<member>GNOME</member>
+<member>KDE</member>
+<member>ROX</member>
+<member>XFCE</member>
+<member>LXDE</member>
+<member>Unity</member>
+<member>Old</member>
+</simplelist>
+
+Should be called only once; subsequent calls are ignored.
+
+</description>
+<parameters>
+<parameter name="desktop_env">
+<parameter_description> a string specifying what desktop this is
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_can_eject">
+<description>
+Checks if a drive can be ejected.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be ejected, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_can_poll_for_media">
+<description>
+Checks if a drive can be polled for media changes.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be polled for media changes,
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_can_start">
+<description>
+Checks if a drive can be started.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be started, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_can_start_degraded">
+<description>
+Checks if a drive can be started degraded.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be started degraded, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_can_stop">
+<description>
+Checks if a drive can be stopped.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive can be stopped, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_eject">
+<description>
+Asynchronously ejects a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_eject_finish() to obtain the
+result of the operation.
+
+Deprecated: 2.22: Use g_drive_eject_with_operation() instead.
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_eject_finish">
+<description>
+Finishes ejecting a drive.
+
+Deprecated: 2.22: Use g_drive_eject_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the drive has been ejected successfully,
+%FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_eject_with_operation">
+<description>
+Ejects a drive. This is an asynchronous operation, and is
+finished by calling g_drive_eject_with_operation_finish() with the @drive
+and #GAsyncResult data returned in the @callback.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_eject_with_operation_finish">
+<description>
+Finishes ejecting a drive. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the drive was successfully ejected. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_enumerate_identifiers">
+<description>
+Gets the kinds of identifiers that @drive has.
+Use g_drive_get_identifer() to obtain the identifiers
+themselves.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %NULL-terminated
+array of strings containing kinds of identifiers. Use g_strfreev()
+to free.
+</return>
+</function>
+
+<function name="g_drive_get_icon">
+<description>
+Gets the icon for @drive.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GIcon for the @drive.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_drive_get_identifier">
+<description>
+Gets the identifier of the given kind for @drive.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive
+</parameter_description>
+</parameter>
+<parameter name="kind">
+<parameter_description> the kind of identifier to return
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing the
+requested identfier, or %NULL if the #GDrive
+doesn't have this kind of identifier.
+</return>
+</function>
+
+<function name="g_drive_get_name">
+<description>
+Gets the name of @drive.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing @drive's name. The returned
+string should be freed when no longer needed.
+</return>
+</function>
+
+<function name="g_drive_get_sort_key">
+<description>
+Gets the sort key for @drive, if any.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> A #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Sorting key for @drive or %NULL if no such key is available.
+
+</return>
+</function>
+
+<function name="g_drive_get_start_stop_type">
+<description>
+Gets a hint about how a drive can be started/stopped.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A value from the #GDriveStartStopType enumeration.
+
+</return>
+</function>
+
+<function name="g_drive_get_volumes">
+<description>
+Get a list of mountable volumes for @drive.
+
+The returned list should be freed with g_list_free(), after
+its elements have been unreffed with g_object_unref().
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GList containing any #GVolume objects on the given @drive.
+</return>
+</function>
+
+<function name="g_drive_has_media">
+<description>
+Checks if the @drive has media. Note that the OS may not be polling
+the drive for media changes; see g_drive_is_media_check_automatic()
+for more details.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @drive has media, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_has_volumes">
+<description>
+Check if @drive has any mountable volumes.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive contains volumes, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_is_media_check_automatic">
+<description>
+Checks if @drive is capabable of automatically detecting media changes.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @drive is capabable of automatically detecting
+media changes, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_is_media_removable">
+<description>
+Checks if the @drive supports removable media.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @drive supports removable media, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_poll_for_media">
+<description>
+Asynchronously polls @drive to see if media has been inserted or removed.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_poll_for_media_finish() to obtain the
+result of the operation.
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_poll_for_media_finish">
+<description>
+Finishes an operation started with g_drive_poll_for_media() on a drive.
+
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the drive has been poll_for_mediaed successfully,
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_drive_start">
+<description>
+Asynchronously starts a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_start_finish() to obtain the
+result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the start operation.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_start_finish">
+<description>
+Finishes starting a drive.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the drive has been started successfully,
+%FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_drive_stop">
+<description>
+Asynchronously stops a drive.
+
+When the operation is finished, @callback will be called.
+You can then call g_drive_stop_finish() to obtain the
+result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for stopping.
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_drive_stop_finish">
+<description>
+Finishes stopping a drive.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the drive has been stopped successfully,
+%FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_emblem_get_icon">
+<description>
+Gives back the icon from @emblem.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblem">
+<parameter_description> a #GEmblem from which the icon should be extracted.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIcon. The returned object belongs to
+the emblem and should not be modified or freed.
+
+</return>
+</function>
+
+<function name="g_emblem_get_origin">
+<description>
+Gets the origin of the emblem.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblem">
+<parameter_description> a #GEmblem
+</parameter_description>
+</parameter>
+</parameters>
+<return> the origin of the emblem
+
+</return>
+</function>
+
+<function name="g_emblem_new">
+<description>
+Creates a new emblem for @icon.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a GIcon containing the icon.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GEmblem.
+
+</return>
+</function>
+
+<function name="g_emblem_new_with_origin">
+<description>
+Creates a new emblem for @icon.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a GIcon containing the icon.
+</parameter_description>
+</parameter>
+<parameter name="origin">
+<parameter_description> a GEmblemOrigin enum defining the emblem's origin
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GEmblem.
+
+</return>
+</function>
+
+<function name="g_emblemed_icon_add_emblem">
+<description>
+Adds @emblem to the #GList of #GEmblem <!-- -->s.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
+</parameter_description>
+</parameter>
+<parameter name="emblem">
+<parameter_description> a #GEmblem
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_emblemed_icon_clear_emblems">
+<description>
+Removes all the emblems from @icon.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_emblemed_icon_get_emblems">
+<description>
+Gets the list of emblems for the @icon.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of
+#GEmblem <!-- -->s that is owned by @emblemed
+
+</return>
+</function>
+
+<function name="g_emblemed_icon_get_icon">
+<description>
+Gets the main icon for @emblemed.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="emblemed">
+<parameter_description> a #GEmblemedIcon
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIcon that is owned by @emblemed
+
+</return>
+</function>
+
+<function name="g_emblemed_icon_new">
+<description>
+Creates a new emblemed icon for @icon with the emblem @emblem.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GIcon
+</parameter_description>
+</parameter>
+<parameter name="emblem">
+<parameter_description> a #GEmblem, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GIcon
+
+</return>
+</function>
+
+<function name="g_file_append_to">
+<description>
+Gets an output stream for appending data to the file. If
+the file doesn't already exist it is created.
+
+By default files created are generally readable by everyone,
+but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
+will be made readable only to the current user, to the level that
+is supported on the target filesystem.
+
+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.
+
+Some file systems don't allow all file names, and may
+return an %G_IO_ERROR_INVALID_FILENAME error.
+If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be
+returned. Other errors are possible too, and depend on what kind of
+filesystem the file is on.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileOutputStream, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_append_to_async">
+<description>
+Asynchronously opens @file for appending.
+
+For more details, see g_file_append_to() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_append_to_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_append_to_finish">
+<description>
+Finishes an asynchronous file append operation started with
+g_file_append_to_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a valid #GFileOutputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_add">
+<description>
+Adds a new attribute with @name to the @list, setting
+its @type and @flags.
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the attribute to add.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the #GFileAttributeType for the attribute.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #GFileAttributeInfoFlags for the attribute.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_attribute_info_list_dup">
+<description>
+Makes a duplicate of a file attribute info list.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList to duplicate.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a copy of the given @list.
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_lookup">
+<description>
+Gets the file attribute with the name @name from @list.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the attribute to lookup.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeInfo for the @name, or %NULL if an
+attribute isn't found.
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_new">
+<description>
+Creates a new file attribute info list.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GFileAttributeInfoList.
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_ref">
+<description>
+References a file attribute info list.
+
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> a #GFileAttributeInfoList to reference.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileAttributeInfoList or %NULL on error.
+</return>
+</function>
+
+<function name="g_file_attribute_info_list_unref">
+<description>
+Removes a reference from the given @list. If the reference count
+falls to zero, the @list is deleted.
+
+</description>
+<parameters>
+<parameter name="list">
+<parameter_description> The #GFileAttributeInfoList to unreference.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_attribute_matcher_enumerate_namespace">
+<description>
+Checks if the matcher will match all of the keys in a given namespace.
+This will always return %TRUE if a wildcard character is in use (e.g. if
+matcher was created with "standard::*" and @ns is "standard", or if matcher was created
+using "*" and namespace is anything.)
+
+TODO: this is awkwardly worded.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+<parameter name="ns">
+<parameter_description> a string containing a file attribute namespace.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the matcher matches all of the entries
+in the given @ns, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_enumerate_next">
+<description>
+Gets the next matched attribute from a #GFileAttributeMatcher.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the next attribute or %NULL if
+no more attribute exist.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_matches">
+<description>
+Checks if an attribute will be matched by an attribute matcher. If
+the matcher was created with the "*" matching string, this function
+will always return %TRUE.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @attribute matches @matcher. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_matches_only">
+<description>
+Checks if a attribute matcher only matches a given attribute. Always
+returns %FALSE if "*" was used when creating the matcher.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the matcher only matches @attribute. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_new">
+<description>
+Creates a new file attribute matcher, which matches attributes
+against a given string. #GFileAttributeMatcher<!-- -->s are reference
+counted structures, and are created with a reference count of 1. If
+the number of references falls to 0, the #GFileAttributeMatcher is
+automatically destroyed.
+
+The @attribute string should be formatted with specific keys separated
+from namespaces with a double colon. Several "namespace::key" strings may be
+concatenated with a single comma (e.g. "standard::type,standard::is-hidden").
+The wildcard "*" may be used to match all keys and namespaces, or
+"namespace::*" will match all keys in a given namespace.
+
+Examples of strings to use:
+<table>
+<title>File Attribute Matcher strings and results</title>
+<tgroup cols='2' align='left'><thead>
+<row><entry> Matcher String </entry><entry> Matches </entry></row></thead>
+<tbody>
+<row><entry>"*"</entry><entry>matches all attributes.</entry></row>
+<row><entry>"standard::is-hidden"</entry><entry>matches only the key is-hidden in the standard namespace.</entry></row>
+<row><entry>"standard::type,unix::*"</entry><entry>matches the type key in the standard namespace and
+all keys in the unix namespace.</entry></row>
+</tbody></tgroup>
+</table>
+
+
+</description>
+<parameters>
+<parameter name="attributes">
+<parameter_description> an attribute string to match.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeMatcher.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_ref">
+<description>
+References a file attribute matcher.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeMatcher.
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_subtract">
+<description>
+Subtracts all attributes of @subtract from @matcher and returns
+a matcher that supports those attributes.
+
+Note that currently it is not possible to remove a single
+attribute when the @matcher matches the whole namespace - or remove
+a namespace or attribute when the matcher matches everything. This
+is a limitation of the current implementation, but may be fixed
+in the future.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> Matcher to subtract from
+</parameter_description>
+</parameter>
+<parameter name="subtract">
+<parameter_description> The matcher to subtract
+</parameter_description>
+</parameter>
+</parameters>
+<return> A file attribute matcher matching all attributes of
+ matcher that are not matched by @subtract
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_to_string">
+<description>
+Prints what the matcher is matching against. The format will be
+equal to the format passed to g_file_attribute_matcher_new().
+The output however, might not be identical, as the matcher may
+decide to use a different order or omit needless parts.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string describing the attributes the matcher matches
+against or %NULL if @matcher was %NULL.
+
+</return>
+</function>
+
+<function name="g_file_attribute_matcher_unref">
+<description>
+Unreferences @matcher. If the reference count falls below 1,
+the @matcher is automatically freed.
+
+
+</description>
+<parameters>
+<parameter name="matcher">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_copy">
+<description>
+Copies the file @source to the location specified by @destination.
+Can not handle recursive copies of directories.
+
+If the flag #G_FILE_COPY_OVERWRITE is specified an already
+existing @destination file is overwritten.
+
+If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
+will be copied as symlinks, otherwise the target of the
+ source symlink will be copied.
+
+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 @progress_callback is not %NULL, then the operation can be monitored by
+setting this to a #GFileProgressCallback function. @progress_callback_data
+will be passed to this function. It is guaranteed that this callback will
+be called after all data has been transferred with the total number of bytes
+copied during the operation.
+
+If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
+error is returned, independent on the status of the @destination.
+
+If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
+error G_IO_ERROR_EXISTS is returned.
+
+If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
+error is returned. If trying to overwrite a directory with a directory the
+G_IO_ERROR_WOULD_MERGE error is returned.
+
+If the source is a directory and the target does not exist, or
+#G_FILE_COPY_OVERWRITE is specified and the target is a file, then the
+G_IO_ERROR_WOULD_RECURSE error is returned.
+
+If you are interested in copying the #GFile object itself (not the on-disk
+file), see g_file_dup().
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="destination">
+<parameter_description> destination #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> set of #GFileCopyFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="progress_callback">
+<parameter_description> function to callback with
+progress information, or %NULL if progress information is not needed
+</parameter_description>
+</parameter>
+<parameter name="progress_callback_data">
+<parameter_description> user data to pass to @progress_callback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError to set on error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_copy_async">
+<description>
+Copies the file @source to the location specified by @destination
+asynchronously. For details of the behaviour, see g_file_copy().
+
+If @progress_callback is not %NULL, then that function that will be called
+just like in g_file_copy(), however the callback will run in the main loop,
+not in the thread that is doing the I/O operation.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_copy_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="destination">
+<parameter_description> destination #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> set of #GFileCopyFlags
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="progress_callback">
+<parameter_description> function to callback with progress
+information, or %NULL if progress information is not needed
+</parameter_description>
+</parameter>
+<parameter name="progress_callback_data">
+<parameter_description> user data to pass to @progress_callback
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_copy_attributes">
+<description>
+Copies the file attributes from @source to @destination.
+
+Normally only a subset of the file attributes are copied,
+those that are copies in a normal file copy operation
+(which for instance does not include e.g. owner). However
+if #G_FILE_COPY_ALL_METADATA is specified in @flags, then
+all the metadata that is possible to copy is copied. This
+is useful when implementing move by copy + delete source.
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GFile with attributes.
+</parameter_description>
+</parameter>
+<parameter name="destination">
+<parameter_description> a #GFile to copy attributes to.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCopyFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the attributes were copied successfully, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_copy_finish">
+<description>
+Finishes copying the file started with
+g_file_copy_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %TRUE on success, %FALSE on error.
+</return>
+</function>
+
+<function name="g_file_create">
+<description>
+Creates a new file and returns an output stream for writing to it.
+The file must not already exist.
+
+By default files created are generally readable by everyone,
+but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
+will be made readable only to the current user, to the level that
+is supported on the target filesystem.
+
+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 a file or directory with this name already exists the G_IO_ERROR_EXISTS
+error will be returned.
+Some file systems don't allow all file names, and may
+return an G_IO_ERROR_INVALID_FILENAME error, and if the name
+is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
+Other errors are possible too, and depend on what kind of
+filesystem the file is on.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileOutputStream for the newly created file, or
+%NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_create_async">
+<description>
+Asynchronously creates a new file and returns an output stream for writing to it.
+The file must not already exist.
+
+For more details, see g_file_create() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_create_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_create_finish">
+<description>
+Finishes an asynchronous file create operation started with
+g_file_create_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileOutputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_create_readwrite">
+<description>
+Creates a new file and returns a stream for reading and writing to it.
+The file must not already exist.
+
+By default files created are generally readable by everyone,
+but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
+will be made readable only to the current user, to the level that
+is supported on the target filesystem.
+
+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 a file or directory with this name already exists the %G_IO_ERROR_EXISTS
+error will be returned. Some file systems don't allow all file names,
+and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name
+is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors
+are possible too, and depend on what kind of filesystem the file is on.
+
+Note that in many non-local file cases read and write streams are not
+supported, so make sure you really need to do read and write streaming,
+rather than just opening for reading or writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileIOStream for the newly created file, or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_create_readwrite_async">
+<description>
+Asynchronously creates a new file and returns a stream for reading and
+writing to it. The file must not already exist.
+
+For more details, see g_file_create_readwrite() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then
+call g_file_create_readwrite_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_create_readwrite_finish">
+<description>
+Finishes an asynchronous file create operation started with
+g_file_create_readwrite_async().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileIOStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_delete">
+<description>
+Deletes a file. If the @file is a directory, it will only be deleted if it
+is empty.
+
+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.
+
+Virtual: delete_file
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file was deleted. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_descriptor_based_get_fd">
+<description>
+Gets the underlying file descriptor.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="fd_based">
+<parameter_description> a #GFileDescriptorBased.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The file descriptor
+
+</return>
+</function>
+
+<function name="g_file_dup">
+<description>
+Duplicates a #GFile handle. This operation does not duplicate
+the actual file or directory represented by the #GFile; see
+g_file_copy() if attempting to copy a file.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile that is a duplicate of the given #GFile.
+</return>
+</function>
+
+<function name="g_file_eject_mountable">
+<description>
+Starts an asynchronous eject on a mountable.
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_eject_mountable_finish().
+
+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.
+
+Deprecated: 2.22: Use g_file_eject_mountable_with_operation() instead.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_eject_mountable_finish">
+<description>
+Finishes an asynchronous eject operation started by
+g_file_eject_mountable().
+
+Deprecated: 2.22: Use g_file_eject_mountable_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @file was ejected successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_eject_mountable_with_operation">
+<description>
+Starts an asynchronous eject on a mountable.
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_eject_mountable_with_operation_finish().
+
+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.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_eject_mountable_with_operation_finish">
+<description>
+Finishes an asynchronous eject operation started by
+g_file_eject_mountable_with_operation().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @file was ejected successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_enumerate_children">
+<description>
+Gets the requested information about the files in a directory. The result
+is a #GFileEnumerator object that will give out #GFileInfo objects for
+all the files in the directory.
+
+The @attributes value is a string that specifies the file attributes that
+should be gathered. It is not an error if it's not possible to read a particular
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
+means all attributes, and a wildcard like "standard::*" means all attributes in the standard
+namespace. An example attribute query be "standard::*,owner::user".
+The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
+
+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 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 error will be returned.
+Other errors are possible too.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileEnumerator if successful, %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_enumerate_children_async">
+<description>
+Asynchronously gets the requested information about the files in a directory. The result
+is a #GFileEnumerator object that will give out #GFileInfo objects for
+all the files in the directory.
+
+For more details, see g_file_enumerate_children() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_enumerate_children_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the
+request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_enumerate_children_finish">
+<description>
+Finishes an async enumerate children operation.
+See g_file_enumerate_children_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileEnumerator or %NULL if an error occurred.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_enumerator_close">
+<description>
+Releases all resources used by this enumerator, making the
+enumerator return %G_IO_ERROR_CLOSED on all calls.
+
+This will be automatically called when the last reference
+is dropped, but you might want to call this function to make
+sure resources are released as early as possible.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE on success or #FALSE on error.
+</return>
+</function>
+
+<function name="g_file_enumerator_close_async">
+<description>
+Asynchronously closes the file enumerator.
+
+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 in
+g_file_enumerator_close_finish().
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_enumerator_close_finish">
+<description>
+Finishes closing a file enumerator, started from g_file_enumerator_close_async().
+
+If the file enumerator was already closed when g_file_enumerator_close_async()
+was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
+return %FALSE. If the file enumerator had pending operation when the close
+operation was started, then this function will report %G_IO_ERROR_PENDING, and
+return %FALSE. If @cancellable was not %NULL, then the operation may have been
+cancelled by triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
+returned.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the close operation has finished successfully.
+</return>
+</function>
+
+<function name="g_file_enumerator_get_container">
+<description>
+Get the #GFile container which is being enumerated.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GFile which is being enumerated.
+
+</return>
+</function>
+
+<function name="g_file_enumerator_has_pending">
+<description>
+Checks if the file enumerator has pending operations.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @enumerator has pending operations.
+</return>
+</function>
+
+<function name="g_file_enumerator_is_closed">
+<description>
+Checks if the file enumerator has been closed.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @enumerator is closed.
+</return>
+</function>
+
+<function name="g_file_enumerator_next_file">
+<description>
+Returns information for the next file in the enumerated object.
+Will block until the information is available. The #GFileInfo
+returned from this function will contain attributes that match the
+attribute string that was passed when the #GFileEnumerator was created.
+
+On error, returns %NULL and sets @error to the error. If the
+enumerator is at the end, %NULL will be returned and @error will
+be unset.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileInfo or %NULL on error or end of enumerator.
+Free the returned object with g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_enumerator_next_files_async">
+<description>
+Request information for a number of files from the enumerator asynchronously.
+When all i/o for the operation is finished the @callback will be called with
+the requested information.
+
+The callback can be called with less than @num_files files in case of error
+or at the end of the enumerator. In case of a partial error the callback will
+be called with any succeeding items and no error, and on the next request the
+error will be reported. If a request is cancelled the callback will be called
+with %G_IO_ERROR_CANCELLED.
+
+During an async request no other sync and async calls are allowed, and will
+result in %G_IO_ERROR_PENDING errors.
+
+Any outstanding i/o request with higher priority (lower numerical value) will
+be executed before an outstanding request with lower priority. Default
+priority is %G_PRIORITY_DEFAULT.
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="num_files">
+<parameter_description> the number of file info objects to request
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="gioscheduler">io priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_enumerator_next_files_finish">
+<description>
+Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GFileInfo<!---->s. You must free the list with
+g_list_free() and unref the infos with g_object_unref() when you're
+done with them.
+</return>
+</function>
+
+<function name="g_file_enumerator_set_pending">
+<description>
+Sets the file enumerator as having pending operations.
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GFileEnumerator.
+</parameter_description>
+</parameter>
+<parameter name="pending">
+<parameter_description> a boolean value.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_equal">
+<description>
+Checks equality of two given #GFile<!-- -->s. Note that two
+#GFile<!-- -->s that differ can still refer to the same
+file on the filesystem due to various forms of filename
+aliasing.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file1">
+<parameter_description> the first #GFile.
+</parameter_description>
+</parameter>
+<parameter name="file2">
+<parameter_description> the second #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @file1 and @file2 are equal.
+%FALSE if either is not a #GFile.
+</return>
+</function>
+
+<function name="g_file_find_enclosing_mount">
+<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.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GMount where the @file is located or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_find_enclosing_mount_async">
+<description>
+Asynchronously gets the mount for the file.
+
+For more details, see g_file_find_enclosing_mount() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_find_enclosing_mount_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_find_enclosing_mount_finish">
+<description>
+Finishes an asynchronous find mount request.
+See g_file_find_enclosing_mount_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GMount for given @file or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_get_basename">
+<description>
+Gets the base name (the last component of the path) for a given #GFile.
+
+If called for the top level of a system (such as the filesystem root
+or a uri like sftp://host/) it will return a single directory separator
+(and on Windows, possibly a drive letter).
+
+The base name is a byte string (*not* UTF-8). It has no defined encoding
+or rules other than it may not contain zero bytes. If you want to use
+filenames in a user interface you should use the display name that you
+can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
+attribute with g_file_query_info().
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> string containing the #GFile's base name, or %NULL
+if given #GFile is invalid. The returned string should be
+freed with g_free() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_get_child">
+<description>
+Gets a child of @file with basename equal to @name.
+
+Note that the file with that specific name might not exist, but
+you can still have a #GFile that points to it. You can use this
+for instance to create that file.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> string containing the child's basename.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile to a child specified by @name.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_get_child_for_display_name">
+<description>
+Gets the child of @file for a given @display_name (i.e. a UTF8
+version of the name). If this function fails, it returns %NULL and @error will be
+set. This is very useful when constructing a GFile for a new file
+and the user entered the filename in the user interface, for instance
+when you select a directory and type a filename in the file selector.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="display_name">
+<parameter_description> string to a possible child.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile to the specified child, or
+%NULL if the display name couldn't be converted.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_get_parent">
+<description>
+Gets the parent directory for the @file.
+If the @file represents the root directory of the
+file system, then %NULL will be returned.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile structure to the parent of the given
+#GFile or %NULL if there is no parent.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_get_parse_name">
+<description>
+Gets the parse name of the @file.
+A parse name is a UTF-8 string that describes the
+file such that one can get the #GFile back using
+g_file_parse_name().
+
+This is generally used to show the #GFile as a nice
+full-pathname kind of string in a user interface,
+like in a location entry.
+
+For local files with names that can safely be converted
+to UTF8 the pathname is used, otherwise the IRI is used
+(a form of URI that allows UTF8 characters unescaped).
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the #GFile's parse name. The returned
+string should be freed with g_free() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_get_path">
+<description>
+Gets the local pathname for #GFile, if one exists.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> string containing the #GFile's path, or %NULL if
+no such path exists. The returned string should be
+freed with g_free() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_get_relative_path">
+<description>
+Gets the path for @descendant relative to @parent.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="parent">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="descendant">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> string with the relative path from @descendant
+to @parent, or %NULL if @descendant doesn't have @parent as prefix.
+The returned string should be freed with g_free() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_get_uri">
+<description>
+Gets the URI for the @file.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the #GFile's URI.
+The returned string should be freed with g_free() when no longer needed.
+</return>
+</function>
+
+<function name="g_file_get_uri_scheme">
+<description>
+Gets the URI scheme for a #GFile.
+RFC 3986 decodes the scheme as:
+<programlisting>
+URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
+</programlisting>
+Common schemes include "file", "http", "ftp", etc.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the URI scheme for the given
+#GFile. The returned string should be freed with g_free()
+when no longer needed.
+</return>
+</function>
+
+<function name="g_file_has_parent">
+<description>
+Checks if @file has a parent, and optionally, if it is @parent.
+
+If @parent is %NULL then this function returns %TRUE if @file has any
+parent at all. If @parent is non-%NULL then %TRUE is only returned
+if @file is a child of @parent.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the parent to check for, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @file is a child of @parent (or any parent in the
+case that @parent is %NULL).
+
+</return>
+</function>
+
+<function name="g_file_has_prefix">
+<description>
+Checks whether @file has the prefix specified by @prefix. In other word,
+if the names of initial elements of @file<!-- -->s pathname match @prefix.
+Only full pathname elements are matched, so a path like /foo is not
+considered a prefix of /foobar, only of /foo/bar.
+
+This call does no i/o, as it works purely on names. As such it can
+sometimes return %FALSE even if @file is inside a @prefix (from a
+filesystem point of view), because the prefix of @file is an alias
+of @prefix.
+
+Virtual: prefix_matches
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="prefix">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @files's parent, grandparent, etc is @prefix.
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_has_uri_scheme">
+<description>
+Checks to see if a #GFile has a given URI scheme.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="uri_scheme">
+<parameter_description> a string containing a URI scheme.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if #GFile's backend supports the
+given URI scheme, %FALSE if URI scheme is %NULL,
+not supported, or #GFile is invalid.
+</return>
+</function>
+
+<function name="g_file_hash">
+<description>
+Creates a hash value for a #GFile.
+
+This call does no blocking i/o.
+
+Virtual: hash
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> #gconstpointer to a #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> 0 if @file is not a valid #GFile, otherwise an
+integer that can be used as hash value for the #GFile.
+This function is intended for easily hashing a #GFile to
+add to a #GHashTable or similar data structure.
+</return>
+</function>
+
+<function name="g_file_icon_get_file">
+<description>
+Gets the #GFile associated with the given @icon.
+
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GIcon.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile, or %NULL.
+</return>
+</function>
+
+<function name="g_file_icon_new">
+<description>
+Creates a new icon for a file.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIcon for the given
+ file, or %NULL on error.
+</return>
+</function>
+
+<function name="g_file_info_clear_status">
+<description>
+Clears the status information from @info.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_copy_into">
+<description>
+Copies all of the #GFileAttribute<!-- -->s from @src_info to @dest_info.
+
+</description>
+<parameters>
+<parameter name="src_info">
+<parameter_description> source to copy attributes from.
+</parameter_description>
+</parameter>
+<parameter name="dest_info">
+<parameter_description> destination to copy attributes to.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_dup">
+<description>
+Duplicates a file info structure.
+
+
+</description>
+<parameters>
+<parameter name="other">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a duplicate #GFileInfo of @other.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_as_string">
+<description>
+Gets the value of a attribute, formated as a string.
+This escapes things as needed to make the string valid
+utf8.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a UTF-8 string associated with the given @attribute.
+When you're done with the string it must be freed with g_free().
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_boolean">
+<description>
+Gets the value of a boolean attribute. If the attribute does not
+contain a boolean value, %FALSE will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the boolean value contained within the attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_byte_string">
+<description>
+Gets the value of a byte string attribute. If the attribute does
+not contain a byte string, %NULL will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the contents of the @attribute value as a byte string, or
+%NULL otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_data">
+<description>
+Gets the attribute type, value and status for an attribute key.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> return location for the attribute type, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="value_pp">
+<parameter_description> return location for the attribute value, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="status">
+<parameter_description> return location for the attribute status, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @info has an attribute named @attribute,
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_int32">
+<description>
+Gets a signed 32-bit integer contained within the attribute. If the
+attribute does not contain a signed 32-bit integer, or is invalid,
+0 will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a signed 32-bit integer from the attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_int64">
+<description>
+Gets a signed 64-bit integer contained within the attribute. If the
+attribute does not contain an signed 64-bit integer, or is invalid,
+0 will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a signed 64-bit integer from the attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_object">
+<description>
+Gets the value of a #GObject attribute. If the attribute does
+not contain a #GObject, %NULL will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GObject associated with the given @attribute, or
+%NULL otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_status">
+<description>
+Gets the attribute status for an attribute key.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeStatus for the given @attribute, or
+%G_FILE_ATTRIBUTE_STATUS_UNSET if the key is invalid.
+
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_string">
+<description>
+Gets the value of a string attribute. If the attribute does
+not contain a string, %NULL will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the contents of the @attribute value as a UTF-8 string, or
+%NULL otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_stringv">
+<description>
+Gets the value of a stringv attribute. If the attribute does
+not contain a stringv, %NULL will be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the contents of the @attribute value as a stringv, or
+%NULL otherwise. Do not free. These returned strings are UTF-8.
+
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_type">
+<description>
+Gets the attribute type for an attribute key.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeType for the given @attribute, or
+%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_uint32">
+<description>
+Gets an unsigned 32-bit integer contained within the attribute. If the
+attribute does not contain an unsigned 32-bit integer, or is invalid,
+0 will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> an unsigned 32-bit integer from the attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_attribute_uint64">
+<description>
+Gets a unsigned 64-bit integer contained within the attribute. If the
+attribute does not contain an unsigned 64-bit integer, or is invalid,
+0 will be returned.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a unsigned 64-bit integer from the attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_content_type">
+<description>
+Gets the file's content type.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the file's content type.
+</return>
+</function>
+
+<function name="g_file_info_get_display_name">
+<description>
+Gets a display name for a file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the display name.
+</return>
+</function>
+
+<function name="g_file_info_get_edit_name">
+<description>
+Gets the edit name for a file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the edit name.
+</return>
+</function>
+
+<function name="g_file_info_get_etag">
+<description>
+Gets the <link linkend="gfile-etag">entity tag</link> for a given
+#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the value of the "etag:value" attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_file_type">
+<description>
+Gets a file's type (whether it is a regular file, symlink, etc).
+This is different from the file's content type, see g_file_info_get_content_type().
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileType for the given file.
+</return>
+</function>
+
+<function name="g_file_info_get_icon">
+<description>
+Gets the icon for a file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GIcon for the given @info.
+</return>
+</function>
+
+<function name="g_file_info_get_is_backup">
+<description>
+Checks if a file is a backup file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if file is a backup file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_is_hidden">
+<description>
+Checks if a file is hidden.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file is a hidden file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_info_get_is_symlink">
+<description>
+Checks if a file is a symlink.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the given @info is a symlink.
+</return>
+</function>
+
+<function name="g_file_info_get_modification_time">
+<description>
+Gets the modification time of the current @info and sets it
+in @result.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GTimeVal.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_get_name">
+<description>
+Gets the name for a file.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the file name.
+</return>
+</function>
+
+<function name="g_file_info_get_size">
+<description>
+Gets the file's size.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #goffset containing the file's size.
+</return>
+</function>
+
+<function name="g_file_info_get_sort_order">
+<description>
+Gets the value of the sort_order attribute from the #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gint32 containing the value of the "standard::sort_order" attribute.
+</return>
+</function>
+
+<function name="g_file_info_get_symlink_target">
+<description>
+Gets the symlink target for a given #GFileInfo.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the symlink target.
+</return>
+</function>
+
+<function name="g_file_info_has_attribute">
+<description>
+Checks if a file info structure has an attribute named @attribute.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @Ginfo has an attribute named @attribute,
+%FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_info_has_namespace">
+<description>
+Checks if a file info structure has an attribute in the
+specified @name_space.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="name_space">
+<parameter_description> a file attribute namespace.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @Ginfo has an attribute in @name_space,
+%FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_file_info_list_attributes">
+<description>
+Lists the file info structure's attributes.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="name_space">
+<parameter_description> a file attribute key's namespace.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a null-terminated array of strings of all of the
+possible attribute types for the given @name_space, or
+%NULL on error.
+</return>
+</function>
+
+<function name="g_file_info_new">
+<description>
+Creates a new file info structure.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GFileInfo.
+</return>
+</function>
+
+<function name="g_file_info_remove_attribute">
+<description>
+Removes all cases of @attribute from @info if it exists.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute">
+<description>
+Sets the @attribute to contain the given value, if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GFileAttributeType
+</parameter_description>
+</parameter>
+<parameter name="value_p">
+<parameter_description> pointer to the value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_boolean">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a boolean value.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_byte_string">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a byte string.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_int32">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a signed 32-bit integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_int64">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> attribute name to set.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> int64 value to set attribute to.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_mask">
+<description>
+Sets @mask on @info to match specific attribute types.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> a #GFileAttributeMatcher.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_object">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a #GObject.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_status">
+<description>
+Sets the attribute status for an attribute key. This is only
+needed by external code that implement g_file_set_attributes_from_info()
+or similar functions.
+
+The attribute must exist in @info for this to work. Otherwise %FALSE
+is returned and @info is unchanged.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key
+</parameter_description>
+</parameter>
+<parameter name="status">
+<parameter_description> a #GFileAttributeStatus
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the status was changed, %FALSE if the key was not set.
+
+</return>
+</function>
+
+<function name="g_file_info_set_attribute_string">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a UTF-8 string.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_stringv">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+Sinze: 2.22
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> a %NULL terminated array of UTF-8 strings.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_uint32">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> an unsigned 32-bit integer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_attribute_uint64">
+<description>
+Sets the @attribute to contain the given @attr_value,
+if possible.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a file attribute key.
+</parameter_description>
+</parameter>
+<parameter name="attr_value">
+<parameter_description> an unsigned 64-bit integer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_content_type">
+<description>
+Sets the content type attribute for a given #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="content_type">
+<parameter_description> a content type. See <link linkend="gio-GContentType">GContentType</link>.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_display_name">
+<description>
+Sets the display name for the current #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="display_name">
+<parameter_description> a string containing a display name.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_edit_name">
+<description>
+Sets the edit name for the current file.
+See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="edit_name">
+<parameter_description> a string containing an edit name.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_file_type">
+<description>
+Sets the file type in a #GFileInfo to @type.
+See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GFileType.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_icon">
+<description>
+Sets the icon for a given #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_ICON.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="icon">
+<parameter_description> a #GIcon.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_is_hidden">
+<description>
+Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink.
+See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="is_hidden">
+<parameter_description> a #gboolean.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_is_symlink">
+<description>
+Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
+See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="is_symlink">
+<parameter_description> a #gboolean.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_modification_time">
+<description>
+Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
+info to the given time value.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="mtime">
+<parameter_description> a #GTimeVal.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_name">
+<description>
+Sets the name attribute for the current #GFileInfo.
+See %G_FILE_ATTRIBUTE_STANDARD_NAME.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> a string containing a name.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_size">
+<description>
+Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info
+to the given size.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a #goffset containing the file's size.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_sort_order">
+<description>
+Sets the sort order attribute in the file info structure. See
+%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="sort_order">
+<parameter_description> a sort order integer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_set_symlink_target">
+<description>
+Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
+to the given symlink target.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="symlink_target">
+<parameter_description> a static string containing a path to a symlink target.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_info_unset_attribute_mask">
+<description>
+Unsets a mask set by g_file_info_set_attribute_mask(), if one
+is set.
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_input_stream_query_info">
+<description>
+Queries a file input stream the given @attributes. This function blocks
+while querying the stream. For the asynchronous (non-blocking) version
+of this function, see g_file_input_stream_query_info_async(). While the
+stream is blocked, the stream will set the pending flag internally, and
+any other operations on the stream will fail with %G_IO_ERROR_PENDING.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo, or %NULL on error.
+</return>
+</function>
+
+<function name="g_file_input_stream_query_info_async">
+<description>
+Queries the stream information asynchronously.
+When the operation is finished @callback will be called.
+You can then call g_file_input_stream_query_info_finish()
+to get the result of the operation.
+
+For the synchronous version of this function,
+see g_file_input_stream_query_info().
+
+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 set
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_input_stream_query_info_finish">
+<description>
+Finishes an asynchronous info query operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring,
+or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileInfo.
+</return>
+</function>
+
+<function name="g_file_io_stream_get_etag">
+<description>
+Gets the entity tag for the file when it has been written.
+This must be called after the stream has been written
+and closed, as the etag can change while writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileIOStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the entity tag for the stream.
+
+</return>
+</function>
+
+<function name="g_file_io_stream_query_info">
+<description>
+Queries a file io stream for the given @attributes.
+This function blocks while querying the stream. For the asynchronous
+version of this function, see g_file_io_stream_query_info_async().
+While the stream is blocked, the stream will set the pending flag
+internally, and any other operations on the stream will fail with
+%G_IO_ERROR_PENDING.
+
+Can fail if the stream was already closed (with @error being set to
+%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
+set to %G_IO_ERROR_PENDING), or if querying info is not supported for
+the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
+all cases of failure, %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
+was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
+be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileIOStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo for the @stream, or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_file_io_stream_query_info_async">
+<description>
+Asynchronously queries the @stream for a #GFileInfo. When completed,
+ callback will be called with a #GAsyncResult which can be used to
+finish the operation with g_file_io_stream_query_info_finish().
+
+For the synchronous version of this function, see
+g_file_io_stream_query_info().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileIOStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_io_stream_query_info_finish">
+<description>
+Finalizes the asynchronous query started
+by g_file_io_stream_query_info_async().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileIOStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileInfo for the finished query.
+
+</return>
+</function>
+
+<function name="g_file_is_native">
+<description>
+Checks to see if a file is native to the platform.
+
+A native file s one expressed in the platform-native filename format,
+e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
+as it might be on a locally mounted remote filesystem.
+
+On some systems non-native files may be available using
+the native filesystem via a userspace filesystem (FUSE), in
+these cases this call will return %FALSE, but g_file_get_path()
+will still return a native path.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if file is native.
+</return>
+</function>
+
+<function name="g_file_load_contents">
+<description>
+Loads the content of the file into memory. The data is always
+zero-terminated, but this is not included in the resultant @length.
+The returned @content should be freed with g_free() when no longer
+needed.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> a location to place the contents of the file.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="etag_out">
+<parameter_description> a location to place the current entity tag for the file,
+or %NULL if the entity tag is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @file's contents were successfully loaded.
+%FALSE if there were errors.
+</return>
+</function>
+
+<function name="g_file_load_contents_async">
+<description>
+Starts an asynchronous load of the @file's contents.
+
+For more details, see g_file_load_contents() which is
+the synchronous version of this call.
+
+When the load operation has completed, @callback will be called
+with @user data. To finish the operation, call
+g_file_load_contents_finish() with the #GAsyncResult returned by
+the @callback.
+
+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.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_load_contents_finish">
+<description>
+Finishes an asynchronous load of the @file's contents.
+The contents are placed in @contents, and @length is set to the
+size of the @contents string. The @content should be freed with
+g_free() when no longer needed. If @etag_out is present, it will be
+set to the new entity tag for the @file.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> a location to place the contents of the file.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="etag_out">
+<parameter_description> a location to place the current entity tag for the file,
+or %NULL if the entity tag is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the load was successful. If %FALSE and @error is
+present, it will be set appropriately.
+</return>
+</function>
+
+<function name="g_file_load_partial_contents_async">
+<description>
+Reads the partial contents of a file. A #GFileReadMoreCallback should be
+used to stop reading from the file when appropriate, else this function
+will behave exactly as g_file_load_contents_async(). This operation
+can be finished by g_file_load_partial_contents_finish().
+
+Users of this function should be aware that @user_data is passed to
+both the @read_more_callback and the @callback.
+
+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.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="read_more_callback">
+<parameter_description> a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback functions.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_load_partial_contents_finish">
+<description>
+Finishes an asynchronous partial load operation that was started
+with g_file_load_partial_contents_async(). The data is always
+zero-terminated, but this is not included in the resultant @length.
+The returned @content should be freed with g_free() when no longer
+needed.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> a location to place the contents of the file.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="etag_out">
+<parameter_description> a location to place the current entity tag for the file,
+or %NULL if the entity tag is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the load was successful. If %FALSE and @error is
+present, it will be set appropriately.
+</return>
+</function>
+
+<function name="g_file_make_directory">
+<description>
+Creates a directory. Note that this will only create a child directory of
+the immediate parent directory of the path or URI given by the #GFile. To
+recursively create directories, see g_file_make_directory_with_parents().
+This function will fail if the parent directory does not exist, setting
+ error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support creating
+directories, this function will fail, setting @error to
+%G_IO_ERROR_NOT_SUPPORTED.
+
+For a local #GFile the newly created directory will have the default
+(current) ownership and permissions of the current process.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on successful creation, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_make_directory_with_parents">
+<description>
+Creates a directory and any parent directories that may not exist similar to
+'mkdir -p'. If the file system does not support creating directories, this
+function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED. If the
+directory itself already exists, this function will fail setting @error
+to %G_IO_ERROR_EXISTS, unlike the similar g_mkdir_with_parents().
+
+For a local #GFile the newly created directories will have the default
+(current) ownership and permissions of the current process.
+
+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.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if all directories have been successfully created, %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_make_symbolic_link">
+<description>
+Creates a symbolic link named @file which contains the string
+ symlink_value
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile with the name of the symlink to create
+</parameter_description>
+</parameter>
+<parameter name="symlink_value">
+<parameter_description> a string with the path for the target of the new symlink
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on the creation of a new symlink, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_monitor">
+<description>
+Obtains a file or directory monitor for the given file, depending
+on the type of the file.
+
+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.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileMonitorFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_monitor_cancel">
+<description>
+Cancels a file monitor.
+
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if monitor was cancelled.
+</return>
+</function>
+
+<function name="g_file_monitor_directory">
+<description>
+Obtains a directory monitor for the given file.
+This may fail if directory monitoring is not supported.
+
+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.
+
+Virtual: monitor_dir
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileMonitorFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_monitor_emit_event">
+<description>
+Emits the #GFileMonitor::changed signal if a change
+has taken place. Should be called from file monitor
+implementations only.
+
+The signal will be emitted from an idle handler (in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+context</link>).
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
+</parameter_description>
+</parameter>
+<parameter name="child">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+<parameter name="other_file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+<parameter name="event_type">
+<parameter_description> a set of #GFileMonitorEvent flags.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_monitor_file">
+<description>
+Obtains a file monitor for the given file. If no file notification
+mechanism exists, then regular polling of the file is used.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileMonitorFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileMonitor for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_monitor_is_cancelled">
+<description>
+Returns whether the monitor is canceled.
+
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if monitor is canceled. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_monitor_set_rate_limit">
+<description>
+Sets the rate limit to which the @monitor will report
+consecutive change events to the same file.
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GFileMonitor.
+</parameter_description>
+</parameter>
+<parameter name="limit_msecs">
+<parameter_description> a non-negative integer with the limit in milliseconds
+to poll for changes
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_mount_enclosing_volume">
+<description>
+Starts a @mount_operation, mounting the volume that contains the file @location.
+
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_mount_enclosing_volume_finish().
+
+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.
+
+</description>
+<parameters>
+<parameter name="location">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_mount_enclosing_volume_finish">
+<description>
+Finishes a mount operation started by g_file_mount_enclosing_volume().
+
+
+</description>
+<parameters>
+<parameter name="location">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if successful. If an error
+has occurred, this function will return %FALSE and set @error
+appropriately if present.
+</return>
+</function>
+
+<function name="g_file_mount_mountable">
+<description>
+Mounts a file of type G_FILE_TYPE_MOUNTABLE.
+Using @mount_operation, you can request callbacks when, for instance,
+passwords are needed during authentication.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_mount_mountable_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_mount_mountable_finish">
+<description>
+Finishes a mount operation. See g_file_mount_mountable() for details.
+
+Finish an asynchronous mount operation that was started
+with g_file_mount_mountable().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_move">
+<description>
+Tries to move the file or directory @source to the location specified by @destination.
+If native move operations are supported then this is used, otherwise a copy + delete
+fallback is used. The native implementation may support moving directories (for instance
+on moves inside the same filesystem), but the fallback code does not.
+
+If the flag #G_FILE_COPY_OVERWRITE is specified an already
+existing @destination file is overwritten.
+
+If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
+will be copied as symlinks, otherwise the target of the
+ source symlink will be copied.
+
+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 @progress_callback is not %NULL, then the operation can be monitored by
+setting this to a #GFileProgressCallback function. @progress_callback_data
+will be passed to this function. It is guaranteed that this callback will
+be called after all data has been transferred with the total number of bytes
+copied during the operation.
+
+If the @source file does not exist then the G_IO_ERROR_NOT_FOUND
+error is returned, independent on the status of the @destination.
+
+If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the
+error G_IO_ERROR_EXISTS is returned.
+
+If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY
+error is returned. If trying to overwrite a directory with a directory the
+G_IO_ERROR_WOULD_MERGE error is returned.
+
+If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is
+specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error
+may be returned (if the native move operation isn't available).
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> #GFile pointing to the source location.
+</parameter_description>
+</parameter>
+<parameter name="destination">
+<parameter_description> #GFile pointing to the destination location.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> set of #GFileCopyFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="progress_callback">
+<parameter_description> #GFileProgressCallback function for updates.
+</parameter_description>
+</parameter>
+<parameter name="progress_callback_data">
+<parameter_description> gpointer to user data for the callback function.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for returning error conditions, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on successful move, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_new_for_commandline_arg">
+<description>
+Creates a #GFile with the given argument from the command line. The value of
+ arg can be either a URI, an absolute path or a relative path resolved
+relative to the current working directory.
+This operation never fails, but the returned object might not support any
+I/O operation if @arg points to a malformed path.
+
+
+</description>
+<parameters>
+<parameter name="arg">
+<parameter_description> a command line string.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_new_for_path">
+<description>
+Constructs a #GFile for a given path. This operation never
+fails, but the returned object might not support any I/O
+operation if @path is malformed.
+
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a string containing a relative or absolute path. The string
+must be encoded in the glib filename encoding.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile for the given @path.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_new_for_uri">
+<description>
+Constructs a #GFile for a given URI. This operation never
+fails, but the returned object might not support any I/O
+operation if @uri is malformed or if the uri type is
+not supported.
+
+
+</description>
+<parameters>
+<parameter name="uri">
+<parameter_description> a UTF8 string containing a URI.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile for the given @uri.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_new_tmp">
+<description>
+Opens a file in the preferred directory for temporary files (as
+returned by g_get_tmp_dir()) and returns a #GFile and
+#GFileIOStream pointing to it.
+
+ template should be a string in the GLib file name encoding
+containing a sequence of six 'X' characters, and containing no
+directory components. If it is %NULL, a default template is used.
+
+Unlike the other #GFile constructors, this will return %NULL if
+a temporary file could not be created.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="tmpl">
+<parameter_description> Template for the file
+name, as in g_file_open_tmp(), or %NULL for a default template.
+</parameter_description>
+</parameter>
+<parameter name="iostream">
+<parameter_description> on return, a #GFileIOStream for the created file.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_open_readwrite">
+<description>
+Opens an existing file for reading and writing. The result is
+a #GFileIOStream that can be used to read and write the contents of the file.
+
+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 the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
+If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
+Other errors are possible too, and depend on what kind of filesystem the file is on.
+Note that in many non-local file cases read and write streams are not supported,
+so make sure you really need to do read and write streaming, rather than
+just opening for reading or writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> #GFile to open
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileIOStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_open_readwrite_async">
+<description>
+Asynchronously opens @file for reading and writing.
+
+For more details, see g_file_open_readwrite() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_open_readwrite_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_open_readwrite_finish">
+<description>
+Finishes an asynchronous file read operation started with
+g_file_open_readwrite_async().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileIOStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_output_stream_get_etag">
+<description>
+Gets the entity tag for the file when it has been written.
+This must be called after the stream has been written
+and closed, as the etag can change while writing.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the entity tag for the stream.
+</return>
+</function>
+
+<function name="g_file_output_stream_query_info">
+<description>
+Queries a file output stream for the given @attributes.
+This function blocks while querying the stream. For the asynchronous
+version of this function, see g_file_output_stream_query_info_async().
+While the stream is blocked, the stream will set the pending flag
+internally, and any other operations on the stream will fail with
+%G_IO_ERROR_PENDING.
+
+Can fail if the stream was already closed (with @error being set to
+%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
+set to %G_IO_ERROR_PENDING), or if querying info is not supported for
+the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
+all cases of failure, %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
+was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
+be returned.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo for the @stream, or %NULL on error.
+</return>
+</function>
+
+<function name="g_file_output_stream_query_info_async">
+<description>
+Asynchronously queries the @stream for a #GFileInfo. When completed,
+ callback will be called with a #GAsyncResult which can be used to
+finish the operation with g_file_output_stream_query_info_finish().
+
+For the synchronous version of this function, see
+g_file_output_stream_query_info().
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> a file attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="gio-GIOScheduler">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_output_stream_query_info_finish">
+<description>
+Finalizes the asynchronous query started
+by g_file_output_stream_query_info_async().
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFileOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GFileInfo for the finished query.
+</return>
+</function>
+
+<function name="g_file_parse_name">
+<description>
+Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()).
+This operation never fails, but the returned object might not support any I/O
+operation if the @parse_name cannot be parsed.
+
+
+</description>
+<parameters>
+<parameter name="parse_name">
+<parameter_description> a file name or path to be parsed.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFile.
+</return>
+</function>
+
+<function name="g_file_poll_mountable">
+<description>
+Polls a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_mount_mountable_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_poll_mountable_finish">
+<description>
+Finishes a poll operation. See g_file_poll_mountable() for details.
+
+Finish an asynchronous poll operation that was polled
+with g_file_poll_mountable().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_query_default_handler">
+<description>
+Returns the #GAppInfo that is registered as the default
+application to handle the file specified by @file.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile to open.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GAppInfo if the handle was found, %NULL if there were errors.
+When you are done with it, release it with g_object_unref()
+</return>
+</function>
+
+<function name="g_file_query_exists">
+<description>
+Utility function to check if a particular file exists. This is
+implemented using g_file_query_info() and as such does blocking I/O.
+
+Note that in many cases it is racy to first check for file existence
+and then execute something based on the outcome of that, because the
+file might have been created or removed in between the operations. The
+general approach to handling that is to not check, but just do the
+operation and handle the errors as they come.
+
+As an example of race-free checking, take the case of reading a file, and
+if it doesn't exist, creating it. There are two racy versions: read it, and
+on error create it; and: check if it exists, if not create it. These
+can both result in two processes creating the file (with perhaps a partially
+written file as the result). The correct approach is to always try to create
+the file with g_file_create() which will either atomically create the file
+or fail with a G_IO_ERROR_EXISTS error.
+
+However, in many cases an existence check is useful in a user
+interface, for instance to make a menu item sensitive/insensitive, so that
+you don't have to fool users that something is possible and then just show
+and error dialog. If you do this, you should make sure to also handle the
+errors that can happen due to races when you execute the operation.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled).
+</return>
+</function>
+
+<function name="g_file_query_file_type">
+<description>
+Utility function to inspect the #GFileType of a file. This is
+implemented using g_file_query_info() and as such does blocking I/O.
+
+The primary use case of this method is to check if a file is a regular file,
+directory, or symlink.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags passed to g_file_query_info().
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file
+does not exist
+
+</return>
+</function>
+
+<function name="g_file_query_filesystem_info">
+<description>
+Similar to g_file_query_info(), but obtains information
+about the filesystem the @file is on, rather than the file itself.
+For instance the amount of space available and the type of
+the filesystem.
+
+The @attributes value is a string that specifies the file attributes that
+should be gathered. It is not an error if it's not possible to read a particular
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
+means all attributes, and a wildcard like "filesystem::*" means all attributes in the
+filesystem namespace. The standard namespace for filesystem attributes is "filesystem".
+Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE
+(the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of
+bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
+
+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 the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
+Other errors are possible too, and depend on what kind of filesystem the file is on.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo or %NULL if there was an error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_query_filesystem_info_async">
+<description>
+Asynchronously gets the requested information about the filesystem
+that the specified @file is on. The result is a #GFileInfo object
+that contains key-value attributes (such as type or size for the
+file).
+
+For more details, see g_file_query_filesystem_info() which is the
+synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can
+then call g_file_query_info_finish() to get the result of the
+operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_query_filesystem_info_finish">
+<description>
+Finishes an asynchronous filesystem info query. See
+g_file_query_filesystem_info_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileInfo for given @file or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_query_info">
+<description>
+Gets the requested information about specified @file. The result
+is a #GFileInfo object that contains key-value attributes (such as
+the type or size of the file).
+
+The @attributes value is a string that specifies the file attributes that
+should be gathered. It is not an error if it's not possible to read a particular
+requested attribute from a file - it just won't be set. @attributes should
+be a comma-separated list of attributes or attribute wildcards. The wildcard "*"
+means all attributes, and a wildcard like "standard::*" means all attributes in the standard
+namespace. An example attribute query be "standard::*,owner::user".
+The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME.
+
+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.
+
+For symlinks, normally the information about the target of the
+symlink is returned, rather than information about the symlink itself.
+However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the
+information about the symlink itself will be returned. Also, for symlinks
+that point to non-existing files the information about the symlink itself
+will be returned.
+
+If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
+Other errors are possible too, and depend on what kind of filesystem the file is on.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInfo for the given @file, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_query_info_async">
+<description>
+Asynchronously gets the requested information about specified @file. The result
+is a #GFileInfo object that contains key-value attributes (such as type or size
+for the file).
+
+For more details, see g_file_query_info() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_query_info_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attributes">
+<parameter_description> an attribute query string.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_query_info_finish">
+<description>
+Finishes an asynchronous file info query.
+See g_file_query_info_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileInfo for given @file or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_query_settable_attributes">
+<description>
+Obtain the list of settable attributes for the file.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeInfoList describing the settable attributes.
+When you are done with it, release it with g_file_attribute_info_list_unref()
+</return>
+</function>
+
+<function name="g_file_query_writable_namespaces">
+<description>
+Obtain the list of attribute namespaces where new attributes
+can be created by a user. An example of this is extended
+attributes (in the "xattr" namespace).
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileAttributeInfoList describing the writable namespaces.
+When you are done with it, release it with g_file_attribute_info_list_unref()
+</return>
+</function>
+
+<function name="g_file_read">
+<description>
+Opens a file for reading. The result is a #GFileInputStream that
+can be used to read the contents of the file.
+
+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 the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned.
+If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned.
+Other errors are possible too, and depend on what kind of filesystem the file is on.
+
+Virtual: read_fn
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> #GFile to read.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileInputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_read_async">
+<description>
+Asynchronously opens @file for reading.
+
+For more details, see g_file_read() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_read_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_read_finish">
+<description>
+Finishes an asynchronous file read operation started with
+g_file_read_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileInputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_replace">
+<description>
+Returns an output stream for overwriting the file, possibly
+creating a backup copy of the file first. If the file doesn't exist,
+it will be created.
+
+This will try to replace the file in the safest way possible so
+that any errors during the writing will not affect an already
+existing copy of the file. For instance, for local files it
+may write to a temporary file and then atomically rename over
+the destination when the stream is closed.
+
+By default files created are generally readable by everyone,
+but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
+will be made readable only to the current user, to the level that
+is supported on the target filesystem.
+
+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 you pass in a non-#NULL @etag value, then this value is
+compared to the current entity tag of the file, and if they differ
+an G_IO_ERROR_WRONG_ETAG error is returned. This generally means
+that the file has been changed since you last read it. You can get
+the new etag from g_file_output_stream_get_etag() after you've
+finished writing and closed the #GFileOutputStream. When you load
+a new file you can use g_file_input_stream_query_info() to get
+the etag of the file.
+
+If @make_backup is %TRUE, this function will attempt to make a backup
+of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP
+error will be returned. If you want to replace anyway, try again with
+ make_backup set to %FALSE.
+
+If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned,
+and if the file is some other form of non-regular file then a
+G_IO_ERROR_NOT_REGULAR_FILE error will be returned.
+Some file systems don't allow all file names, and may
+return an G_IO_ERROR_INVALID_FILENAME error, and if the name
+is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned.
+Other errors are possible too, and depend on what kind of
+filesystem the file is on.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
+current #GFile, or #NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileOutputStream or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_replace_async">
+<description>
+Asynchronously overwrites the file, replacing the contents, possibly
+creating a backup copy of the file first.
+
+For more details, see g_file_replace() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_replace_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> an <link linkend="gfile-etag">entity tag</link> for the
+current #GFile, or NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_replace_contents">
+<description>
+Replaces the contents of @file with @contents of @length bytes.
+
+If @etag is specified (not %NULL) any existing file must have that etag, or
+the error %G_IO_ERROR_WRONG_ETAG will be returned.
+
+If @make_backup is %TRUE, this function will attempt to make a backup of @file.
+
+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.
+
+The returned @new_etag can be used to verify that the file hasn't changed the
+next time it is saved over.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> a string containing the new contents for @file.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @contents in bytes.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> the old <link linkend="gfile-etag">entity tag</link>
+for the document, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="new_etag">
+<parameter_description> a location to a new <link linkend="gfile-etag">entity tag</link>
+for the document. This should be freed with g_free() when no longer
+needed, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if successful. If an error
+has occurred, this function will return %FALSE and set @error
+appropriately if present.
+</return>
+</function>
+
+<function name="g_file_replace_contents_async">
+<description>
+Starts an asynchronous replacement of @file with the given
+ contents of @length bytes. @etag will replace the document's
+current entity tag.
+
+When this operation has completed, @callback will be called with
+ user_user data, and the operation can be finalized with
+g_file_replace_contents_finish().
+
+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 @make_backup is %TRUE, this function will attempt to
+make a backup of @file.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> string of contents to replace the file with.
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @contents in bytes.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_replace_contents_finish">
+<description>
+Finishes an asynchronous replace of the given @file. See
+g_file_replace_contents_async(). Sets @new_etag to the new entity
+tag for the document, if present.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="new_etag">
+<parameter_description> a location of a new <link linkend="gfile-etag">entity tag</link>
+for the document. This should be freed with g_free() when it is no
+longer needed, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on failure.
+</return>
+</function>
+
+<function name="g_file_replace_finish">
+<description>
+Finishes an asynchronous file replace operation started with
+g_file_replace_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileOutputStream, or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_replace_readwrite">
+<description>
+Returns an output stream for overwriting the file in readwrite mode,
+possibly creating a backup copy of the file first. If the file doesn't
+exist, it will be created.
+
+For details about the behaviour, see g_file_replace() which does the same
+thing but returns an output stream only.
+
+Note that in many non-local file cases read and write streams are not
+supported, so make sure you really need to do read and write streaming,
+rather than just opening for reading or writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> an optional <link linkend="gfile-etag">entity tag</link> for the
+current #GFile, or #NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileIOStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_replace_readwrite_async">
+<description>
+Asynchronously overwrites the file in read-write mode, replacing the
+contents, possibly creating a backup copy of the file first.
+
+For more details, see g_file_replace_readwrite() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then
+call g_file_replace_readwrite_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="etag">
+<parameter_description> an <link linkend="gfile-etag">entity tag</link> for the
+current #GFile, or NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="make_backup">
+<parameter_description> %TRUE if a backup should be created.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileCreateFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_replace_readwrite_finish">
+<description>
+Finishes an asynchronous file replace operation started with
+g_file_replace_readwrite_async().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFileIOStream, or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_file_resolve_relative_path">
+<description>
+Resolves a relative path for @file to an absolute path.
+
+This call does no blocking i/o.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="relative_path">
+<parameter_description> a given relative path string.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFile to the resolved path. %NULL if @relative_path
+is %NULL or if @file is invalid.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_set_attribute">
+<description>
+Sets an attribute in the file with attribute name @attribute to @value.
+
+Some attributes can be unset by setting @attribute to
+%G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> The type of the attribute
+</parameter_description>
+</parameter>
+<parameter name="value_p">
+<parameter_description> a pointer to the value (or the pointer itself if the type is a pointer type)
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the attribute was set, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_byte_string">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
+If @attribute is of a different type, this operation will fail,
+returning %FALSE.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a string containing the attribute's new value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set to @value
+in the @file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_int32">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
+If @attribute is of a different type, this operation will fail.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #gint32 containing the attribute's new value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set to @value
+in the @file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_int64">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value.
+If @attribute is of a different type, this operation will fail.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #guint64 containing the attribute's new value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_string">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value.
+If @attribute is of a different type, this operation will fail.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a string containing the attribute's value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_uint32">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value.
+If @attribute is of a different type, this operation will fail.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #guint32 containing the attribute's new value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set to @value
+in the @file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attribute_uint64">
+<description>
+Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value.
+If @attribute is of a different type, this operation will fail.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> a string containing the attribute's name.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #guint64 containing the attribute's new value.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @attribute was successfully set to @value
+in the @file, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attributes_async">
+<description>
+Asynchronously sets the attributes of @file with @info.
+
+For more details, see g_file_set_attributes_from_info() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_set_attributes_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a #GFileQueryInfoFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> a #gpointer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_set_attributes_finish">
+<description>
+Finishes setting an attribute started in g_file_set_attributes_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the attributes were set correctly, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_attributes_from_info">
+<description>
+Tries to set all attributes in the #GFileInfo on the target values,
+not stopping on the first error.
+
+If there is any error during this operation then @error will be set to
+the first error. Error on particular fields are flagged by setting
+the "status" field in the attribute value to
+%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect
+further errors.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #GFileQueryInfoFlags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if there was any error, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_set_display_name">
+<description>
+Renames @file to the specified display name.
+
+The display name is converted from UTF8 to the correct encoding for the target
+filesystem if possible and the @file is renamed to this.
+
+If you want to implement a rename operation in the user interface the edit name
+(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename
+widget, and then the result after editing should be passed to g_file_set_display_name().
+
+On success the resulting converted filename is returned.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="display_name">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile specifying what @file was renamed to, or %NULL
+if there was an error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_set_display_name_async">
+<description>
+Asynchronously sets the display name for a given #GFile.
+
+For more details, see g_file_set_display_name() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_set_display_name_finish() to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="display_name">
+<parameter_description> a string.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_set_display_name_finish">
+<description>
+Finishes setting a display name started with
+g_file_set_display_name_async().
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile or %NULL on error.
+Free the returned object with g_object_unref().
+</return>
+</function>
+
+<function name="g_file_start_mountable">
+<description>
+Starts a file of type G_FILE_TYPE_MOUNTABLE.
+Using @start_operation, you can request callbacks when, for instance,
+passwords are needed during authentication.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_mount_mountable_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="start_operation">
+<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_start_mountable_finish">
+<description>
+Finishes a start operation. See g_file_start_mountable() for details.
+
+Finish an asynchronous start operation that was started
+with g_file_start_mountable().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_stop_mountable">
+<description>
+Stops a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_stop_mountable_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_stop_mountable_finish">
+<description>
+Finishes an stop operation, see g_file_stop_mountable() for details.
+
+Finish an asynchronous stop operation that was started
+with g_file_stop_mountable().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_supports_thread_contexts">
+<description>
+Checks if @file supports <link
+linkend="g-main-context-push-thread-default-context">thread-default
+contexts</link>. If this returns %FALSE, you cannot perform
+asynchronous operations on @file in a thread that has a
+thread-default context.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Whether or not @file supports thread-default contexts.
+
+</return>
+</function>
+
+<function name="g_file_trash">
+<description>
+Sends @file to the "Trashcan", if possible. This is similar to
+deleting it, but the user can recover it before emptying the trashcan.
+Not all file systems support trashing, so this call can return the
+%G_IO_ERROR_NOT_SUPPORTED error.
+
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> #GFile to send to trash.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on successful trash, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_file_unmount_mountable">
+<description>
+Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_unmount_mountable_finish() to get the result of the operation.
+
+Deprecated: 2.22: Use g_file_unmount_mountable_with_operation() instead.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_unmount_mountable_finish">
+<description>
+Finishes an unmount operation, see g_file_unmount_mountable() for details.
+
+Finish an asynchronous unmount operation that was started
+with g_file_unmount_mountable().
+
+Deprecated: 2.22: Use g_file_unmount_mountable_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_file_unmount_mountable_with_operation">
+<description>
+Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
+
+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.
+
+When the operation is finished, @callback will be called. You can then call
+g_file_unmount_mountable_finish() to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation, or %NULL to avoid user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_file_unmount_mountable_with_operation_finish">
+<description>
+Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details.
+
+Finish an asynchronous unmount operation that was started
+with g_file_unmount_mountable_with_operation().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> input #GFile.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation finished successfully. %FALSE
+otherwise.
+
+</return>
+</function>
+
+<function name="g_filename_completer_get_completion_suffix">
+<description>
+Obtains a completion for @initial_text from @completer.
+
+
+</description>
+<parameters>
+<parameter name="completer">
+<parameter_description> the filename completer.
+</parameter_description>
+</parameter>
+<parameter name="initial_text">
+<parameter_description> text to be completed.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a completed string, or %NULL if no completion exists.
+This string is not owned by GIO, so remember to g_free() it
+when finished.
+</return>
+</function>
+
+<function name="g_filename_completer_get_completions">
+<description>
+Gets an array of completion strings for a given initial text.
+
+
+</description>
+<parameters>
+<parameter name="completer">
+<parameter_description> the filename completer.
+</parameter_description>
+</parameter>
+<parameter name="initial_text">
+<parameter_description> text to be completed.
+</parameter_description>
+</parameter>
+</parameters>
+<return> array of strings with possible completions for @initial_text.
+This array must be freed by g_strfreev() when finished.
+</return>
+</function>
+
+<function name="g_filename_completer_new">
+<description>
+Creates a new filename completer.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GFilenameCompleter.
+</return>
+</function>
+
+<function name="g_filename_completer_set_dirs_only">
+<description>
+If @dirs_only is %TRUE, @completer will only
+complete directory names, and not file names.
+
+</description>
+<parameters>
+<parameter name="completer">
+<parameter_description> the filename completer.
+</parameter_description>
+</parameter>
+<parameter name="dirs_only">
+<parameter_description> a #gboolean.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_filter_input_stream_get_base_stream">
+<description>
+Gets the base stream for the filter stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream.
+</return>
+</function>
+
+<function name="g_filter_input_stream_get_close_base_stream">
+<description>
+Returns whether the base stream will be closed when @stream is
+closed.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the base stream will be closed.
+</return>
+</function>
+
+<function name="g_filter_input_stream_set_close_base_stream">
+<description>
+Sets whether the base stream will be closed when @stream is closed.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterInputStream.
+</parameter_description>
+</parameter>
+<parameter name="close_base">
+<parameter_description> %TRUE to close the base stream.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_filter_output_stream_get_base_stream">
+<description>
+Gets the base stream for the filter stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GOutputStream.
+</return>
+</function>
+
+<function name="g_filter_output_stream_get_close_base_stream">
+<description>
+Returns whether the base stream will be closed when @stream is
+closed.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the base stream will be closed.
+</return>
+</function>
+
+<function name="g_filter_output_stream_set_close_base_stream">
+<description>
+Sets whether the base stream will be closed when @stream is closed.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GFilterOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="close_base">
+<parameter_description> %TRUE to close the base stream.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_icon_equal">
+<description>
+Checks if two icons are equal.
+
+
+</description>
+<parameters>
+<parameter name="icon1">
+<parameter_description> pointer to the first #GIcon.
+</parameter_description>
+</parameter>
+<parameter name="icon2">
+<parameter_description> pointer to the second #GIcon.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @icon1 is equal to @icon2. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_icon_hash">
+<description>
+Gets a hash for an icon.
+
+Virtual: hash
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> #gconstpointer to an icon object.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #guint containing a hash for the @icon, suitable for
+use in a #GHashTable or similar data structure.
+</return>
+</function>
+
+<function name="g_icon_new_for_string">
+<description>
+Generate a #GIcon instance from @str. This function can fail if
+ str is not valid - see g_icon_to_string() for discussion.
+
+If your application or library provides one or more #GIcon
+implementations you need to ensure that each #GType is registered
+with the type system prior to calling g_icon_new_for_string().
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="str">
+<parameter_description> A string obtained via g_icon_to_string().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An object implementing the #GIcon
+interface or %NULL if @error is set.
+
+</return>
+</function>
+
+<function name="g_icon_to_string">
+<description>
+Generates a textual representation of @icon that can be used for
+serialization such as when passing @icon to a different process or
+saving it to persistent storage. Use g_icon_new_for_string() to
+get @icon back from the returned string.
+
+The encoding of the returned string is proprietary to #GIcon except
+in the following two cases
+
+<itemizedlist>
+<listitem><para>
+If @icon is a #GFileIcon, the returned string is a native path
+(such as <literal>/path/to/my icon.png</literal>) without escaping
+if the #GFile for @icon is a native file. If the file is not
+native, the returned string is the result of g_file_get_uri()
+(such as <literal>sftp://path/to/my%20icon.png</literal>).
+</para></listitem>
+<listitem><para>
+If @icon is a #GThemedIcon with exactly one name, the encoding is
+simply the name (such as <literal>network-server</literal>).
+</para></listitem>
+</itemizedlist>
+
+Virtual: to_tokens
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GIcon.
+</parameter_description>
+</parameter>
+</parameters>
+<return> An allocated NUL-terminated UTF8 string or %NULL if @icon can't
+be serialized. Use g_free() to free.
+
+</return>
+</function>
+
+<function name="g_inet_address_equal">
+<description>
+Checks if two #GInetAddress instances are equal, e.g. the same address.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> A #GInetAddress.
+</parameter_description>
+</parameter>
+<parameter name="other_address">
+<parameter_description> Another #GInetAddress.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address and @other_address are equal, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_family">
+<description>
+Gets @address's family
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> @address's family
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_any">
+<description>
+Tests whether @address is the "any" address for its family.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is the "any" address for its family.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_link_local">
+<description>
+Tests whether @address is a link-local address (that is, if it
+identifies a host on a local network that is not connected to the
+Internet).
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a link-local address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_loopback">
+<description>
+Tests whether @address is the loopback address for its family.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is the loopback address for its family.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_mc_global">
+<description>
+Tests whether @address is a global multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a global multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_mc_link_local">
+<description>
+Tests whether @address is a link-local multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a link-local multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_mc_node_local">
+<description>
+Tests whether @address is a node-local multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a node-local multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_mc_org_local">
+<description>
+Tests whether @address is an organization-local multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is an organization-local multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_mc_site_local">
+<description>
+Tests whether @address is a site-local multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a site-local multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_multicast">
+<description>
+Tests whether @address is a multicast address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a multicast address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_is_site_local">
+<description>
+Tests whether @address is a site-local address such as 10.0.0.1
+(that is, the address identifies a host on a local network that can
+not be reached directly from the Internet, but which may have
+outgoing Internet connectivity via a NAT or firewall).
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @address is a site-local address.
+
+</return>
+</function>
+
+<function name="g_inet_address_get_native_size">
+<description>
+Gets the size of the native raw binary address for @address. This
+is the size of the data that you get from g_inet_address_to_bytes().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes used for the native version of @address.
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_equal">
+<description>
+Tests if @mask and @mask2 are the same mask.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+<parameter name="mask2">
+<parameter_description> another #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @mask and @mask2 are the same mask
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_get_address">
+<description>
+Gets @mask's base address
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return> @mask's base address
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_get_family">
+<description>
+Gets the #GSocketFamily of @mask's address
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GSocketFamily of @mask's address
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_get_length">
+<description>
+Gets @mask's length
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return> @mask's length
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_matches">
+<description>
+Tests if @address falls within the range described by @mask.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @address falls within the range described by
+ mask
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_new">
+<description>
+Creates a new #GInetAddressMask representing all addresses whose
+first @length bits match @addr.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="addr">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> number of bits of @addr to use
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddressMask, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_new_from_string">
+<description>
+Parses @mask_string as an IP address and (optional) length, and
+creates a new #GInetAddressMask. The length, if present, is
+delimited by a "/". If it is not present, then the length is
+assumed to be the full length of the address.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask_string">
+<parameter_description> an IP address or address/length string
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddressMask corresponding to @string, or %NULL
+on error.
+
+</return>
+</function>
+
+<function name="g_inet_address_mask_to_string">
+<description>
+Converts @mask back to its corresponding string form.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mask">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string corresponding to @mask.
+
+</return>
+</function>
+
+<function name="g_inet_address_new_any">
+<description>
+Creates a #GInetAddress for the "any" address (unassigned/"don't
+care") for @family.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="family">
+<parameter_description> the address family
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddress corresponding to the "any" address
+for @family.
+
+</return>
+</function>
+
+<function name="g_inet_address_new_from_bytes">
+<description>
+Creates a new #GInetAddress from the given @family and @bytes.
+ bytes should be 4 bytes for %G_SOCKET_FAMILY_IPV4 and 16 bytes for
+%G_SOCKET_FAMILY_IPV6.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> raw address data
+</parameter_description>
+</parameter>
+<parameter name="family">
+<parameter_description> the address family of @bytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddress corresponding to @family and @bytes.
+
+</return>
+</function>
+
+<function name="g_inet_address_new_from_string">
+<description>
+Parses @string as an IP address and creates a new #GInetAddress.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a string representation of an IP address
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddress corresponding to @string, or %NULL if
+ string could not be parsed.
+
+</return>
+</function>
+
+<function name="g_inet_address_new_loopback">
+<description>
+Creates a #GInetAddress for the loopback address for @family.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="family">
+<parameter_description> the address family
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetAddress corresponding to the loopback address
+for @family.
+
+</return>
+</function>
+
+<function name="g_inet_address_to_bytes">
+<description>
+Gets the raw binary address data from @address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to an internal array of the bytes in @address,
+which should not be modified, stored, or freed. The size of this
+array can be gotten with g_inet_address_get_native_size().
+
+</return>
+</function>
+
+<function name="g_inet_address_to_string">
+<description>
+Converts @address to string form.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> a representation of @address as a string, which should be
+freed after use.
+
+</return>
+</function>
+
+<function name="g_inet_socket_address_get_address">
+<description>
+Gets @address's #GInetAddress.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GInetAddress for @address, which must be
+g_object_ref()'d if it will be stored
+
+</return>
+</function>
+
+<function name="g_inet_socket_address_get_flowinfo">
+<description>
+Gets the <literal>sin6_flowinfo</literal> field from @address,
+which must be an IPv6 address.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a %G_SOCKET_FAMILY_IPV6 #GInetSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the flowinfo field
+
+</return>
+</function>
+
+<function name="g_inet_socket_address_get_port">
+<description>
+Gets @address's port.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the port for @address
+
+</return>
+</function>
+
+<function name="g_inet_socket_address_get_scope_id">
+<description>
+Gets the <literal>sin6_scope_id</literal> field from @address,
+which must be an IPv6 address.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a %G_SOCKET_FAMILY_IPV6 #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the scope id field
+
+</return>
+</function>
+
+<function name="g_inet_socket_address_new">
+<description>
+Creates a new #GInetSocketAddress for @address and @port.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GInetAddress
+</parameter_description>
+</parameter>
+<parameter name="port">
+<parameter_description> a port number
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GInetSocketAddress
+
+</return>
+</function>
+
+<function name="g_initable_init">
+<description>
+Initializes the object implementing the interface.
+
+The object must be initialized before any real use after initial
+construction, either with this function or g_async_initable_init_async().
+
+Implementations may also support cancellation. If @cancellable is not %NULL,
+then initialization 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 @cancellable is not %NULL and
+the object doesn't support cancellable initialization the error
+%G_IO_ERROR_NOT_SUPPORTED will be returned.
+
+If the object is not initialized, or initialization returns with an
+error, then all operations on the object except g_object_ref() and
+g_object_unref() are considered to be invalid, and have undefined
+behaviour. See the <xref linkend="ginitable"/> section introduction
+for more details.
+
+Implementations of this method must be idempotent, i.e. multiple calls
+to this function with the same argument should return the same results.
+Only the first call initializes the object, further calls return the result
+of the first call. This is so that it's safe to implement the singleton
+pattern in the GObject constructor function.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="initable">
+<parameter_description> a #GInitable.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if successful. If an error has occurred, this function will
+return %FALSE and set @error appropriately if present.
+
+</return>
+</function>
+
+<function name="g_initable_new">
+<description>
+Helper function for constructing #GInitiable object. This is
+similar to g_object_new() but also initializes the object
+and returns %NULL, setting an error on failure.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GInitable.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, or %NULL if no
+properties
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the value if the first property, followed by and other property
+value pairs, and ended by %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GObject, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_initable_new_valist">
+<description>
+Helper function for constructing #GInitiable object. This is
+similar to g_object_new_valist() but also initializes the object
+and returns %NULL, setting an error on failure.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GInitable.
+</parameter_description>
+</parameter>
+<parameter name="first_property_name">
+<parameter_description> the name of the first property, followed by
+the value, and other property value pairs, and ended by %NULL.
+</parameter_description>
+</parameter>
+<parameter name="var_args">
+<parameter_description> The var args list generated from @first_property_name.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GObject, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_initable_newv">
+<description>
+Helper function for constructing #GInitiable object. This is
+similar to g_object_newv() but also initializes the object
+and returns %NULL, setting an error on failure.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="object_type">
+<parameter_description> a #GType supporting #GInitable.
+</parameter_description>
+</parameter>
+<parameter name="n_parameters">
+<parameter_description> the number of parameters in @parameters
+</parameter_description>
+</parameter>
+<parameter name="parameters">
+<parameter_description> the parameters to use to construct the object
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GObject, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_input_stream_clear_pending">
+<description>
+Clears the pending flag on @stream.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> input stream
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_input_stream_close">
+<description>
+Closes the stream, releasing resources related to it.
+
+Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
+Closing a stream multiple times will not return an error.
+
+Streams will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Some streams might keep the backing store of the stream (e.g. a file descriptor)
+open after the stream is closed. See the documentation for the individual
+stream for details.
+
+On failure the first error that happened will be reported, but the close
+operation will finish as much as possible. A stream that failed to
+close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
+is important to check and report the error to the user.
+
+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.
+Cancelling a close will still leave the stream closed, but some streams
+can use a faster close that doesn't block to e.g. check errors.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on failure
+</return>
+</function>
+
+<function name="g_input_stream_close_async">
+<description>
+Requests an asynchronous closes of the stream, releasing resources related to it.
+When the operation is finished @callback will be called.
+You can then call g_input_stream_close_finish() to get the result of the
+operation.
+
+For behaviour details see g_input_stream_close().
+
+The asyncronous methods have a default fallback that uses threads to implement
+asynchronicity, so they are optional for inheriting classes. However, if you
+override one you must override all.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_input_stream_close_finish">
+<description>
+Finishes closing a stream asynchronously, started from g_input_stream_close_async().
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the stream was closed successfully.
+</return>
+</function>
+
+<function name="g_input_stream_has_pending">
+<description>
+Checks if an input stream has pending actions.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> input stream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream has pending actions.
+</return>
+</function>
+
+<function name="g_input_stream_is_closed">
+<description>
+Checks if an input stream is closed.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> input stream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the stream is closed.
+</return>
+</function>
+
+<function name="g_input_stream_read">
+<description>
+Tries to read @count bytes from the stream into the buffer starting at
+ buffer Will block during this read.
+
+If count is zero returns zero and does nothing. A value of @count
+larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes read into the buffer is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. near the end of a file. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
+
+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 an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error -1 is returned and @error is set accordingly.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least count bytes long).
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes read, or -1 on error
+</return>
+</function>
+
+<function name="g_input_stream_read_all">
+<description>
+Tries to read @count bytes from the stream into the buffer starting at
+ buffer Will block during this read.
+
+This function is similar to g_input_stream_read(), except it tries to
+read as many bytes as requested, only stopping on an error or end of stream.
+
+On a successful read of @count bytes, or if we reached the end of the
+stream, %TRUE is returned, and @bytes_read is set to the number of bytes
+read into @buffer.
+
+If there is an error during the operation %FALSE is returned and @error
+is set to indicate the error status, @bytes_read is updated to contain
+the number of bytes read into @buffer before the error occurred.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least count bytes long).
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> location to store the number of bytes that was read from the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+</return>
+</function>
+
+<function name="g_input_stream_read_async">
+<description>
+Request an asynchronous read of @count bytes from the stream into the buffer
+starting at @buffer. When the operation is finished @callback will be called.
+You can then call g_input_stream_read_finish() to get the result of the
+operation.
+
+During an async request no other sync and async calls are allowed on @stream, and will
+result in %G_IO_ERROR_PENDING errors.
+
+A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes read into the buffer will be passed to the
+callback. It is not an error if this is not the same as the requested size, as it
+can happen e.g. near the end of a file, but generally we try to read
+as many bytes as requested. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
+
+Any outstanding i/o request with higher priority (lower numerical value) will
+be executed before an outstanding request with lower priority. Default
+priority is %G_PRIORITY_DEFAULT.
+
+The asyncronous methods have a default fallback that uses threads to implement
+asynchronicity, so they are optional for inheriting classes. However, if you
+override one you must override all.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least count bytes long).
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_input_stream_read_finish">
+<description>
+Finishes an asynchronous stream read operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> number of bytes read in, or -1 on error.
+</return>
+</function>
+
+<function name="g_input_stream_set_pending">
+<description>
+Sets @stream to have actions pending. If the pending flag is
+already set or @stream is closed, it will return %FALSE and set
+ error
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> input stream
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if pending was previously unset and is now set.
+</return>
+</function>
+
+<function name="g_input_stream_skip">
+<description>
+Tries to skip @count bytes from the stream. Will block during the operation.
+
+This is identical to g_input_stream_read(), from a behaviour standpoint,
+but the bytes that are skipped are not returned to the user. Some
+streams have an implementation that is more efficient than reading the data.
+
+This function is optional for inherited classes, as the default implementation
+emulates it using read.
+
+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 an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be skipped from the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes skipped, or -1 on error
+</return>
+</function>
+
+<function name="g_input_stream_skip_async">
+<description>
+Request an asynchronous skip of @count bytes from the stream.
+When the operation is finished @callback will be called.
+You can then call g_input_stream_skip_finish() to get the result
+of the operation.
+
+During an async request no other sync and async calls are allowed,
+and will result in %G_IO_ERROR_PENDING errors.
+
+A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes skipped will be passed to the callback.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. near the end of a file, but generally we try to skip
+as many bytes as requested. Zero is returned on end of file
+(or if @count is zero), but never otherwise.
+
+Any outstanding i/o request with higher priority (lower numerical value)
+will be executed before an outstanding request with lower priority.
+Default priority is %G_PRIORITY_DEFAULT.
+
+The asynchronous methods have a default fallback that uses threads to
+implement asynchronicity, so they are optional for inheriting classes.
+However, if you override one, you must override all.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be skipped from the stream
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_input_stream_skip_finish">
+<description>
+Finishes a stream skip operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the size of the bytes skipped, or %-1 on error.
+</return>
+</function>
+
+<function name="g_io_error_from_errno">
+<description>
+Converts errno.h error codes into GIO error codes.
+
+
+</description>
+<parameters>
+<parameter name="err_no">
+<parameter_description> Error number as defined in errno.h.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GIOErrorEnum value for the given errno.h error number.
+</return>
+</function>
+
+<function name="g_io_error_from_win32_error">
+<description>
+Converts some common error codes into GIO error codes. The
+fallback value G_IO_ERROR_FAILED is returned for error codes not
+handled.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="error_code">
+<parameter_description> Windows error number.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GIOErrorEnum value for the given error number.
+
+</return>
+</function>
+
+<function name="g_io_error_quark">
+<description>
+Gets the GIO Error Quark.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GQuark.
+</return>
+</function>
+
+<function name="g_io_extension_get_name">
+<description>
+Gets the name under which @extension was registered.
+
+Note that the same type may be registered as extension
+for multiple extension points, under different names.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of @extension.
+</return>
+</function>
+
+<function name="g_io_extension_get_priority">
+<description>
+Gets the priority with which @extension was registered.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the priority of @extension
+</return>
+</function>
+
+<function name="g_io_extension_get_type">
+<description>
+Gets the type associated with @extension.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of @extension
+</return>
+</function>
+
+<function name="g_io_extension_point_get_extension_by_name">
+<description>
+Finds a #GIOExtension for an extension point by name.
+
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the extension to get
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GIOExtension for @extension_point that has the
+given name, or %NULL if there is no extension with that name
+</return>
+</function>
+
+<function name="g_io_extension_point_get_extensions">
+<description>
+Gets a list of all extensions that implement this extension point.
+The list is sorted by priority, beginning with the highest priority.
+
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of
+#GIOExtension<!-- -->s. The list is owned by GIO and should not be
+modified.
+</return>
+</function>
+
+<function name="g_io_extension_point_get_required_type">
+<description>
+Gets the required type for @extension_point.
+
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GType that all implementations must have,
+or #G_TYPE_INVALID if the extension point has no required type
+</return>
+</function>
+
+<function name="g_io_extension_point_implement">
+<description>
+Registers @type as extension for the extension point with name
+ extension_point_name
+
+If @type has already been registered as an extension for this
+extension point, the existing #GIOExtension object is returned.
+
+
+</description>
+<parameters>
+<parameter name="extension_point_name">
+<parameter_description> the name of the extension point
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the #GType to register as extension
+</parameter_description>
+</parameter>
+<parameter name="extension_name">
+<parameter_description> the name for the extension
+</parameter_description>
+</parameter>
+<parameter name="priority">
+<parameter_description> the priority for the extension
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIOExtension object for #GType
+</return>
+</function>
+
+<function name="g_io_extension_point_lookup">
+<description>
+Looks up an existing extension point.
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name of the extension point
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GIOExtensionPoint, or %NULL if there
+is no registered extension point with the given name.
+</return>
+</function>
+
+<function name="g_io_extension_point_register">
+<description>
+Registers an extension point.
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> The name of the extension point
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GIOExtensionPoint. This object is
+owned by GIO and should not be freed.
+</return>
+</function>
+
+<function name="g_io_extension_point_set_required_type">
+<description>
+Sets the required type for @extension_point to @type.
+All implementations must henceforth have this type.
+
+</description>
+<parameters>
+<parameter name="extension_point">
+<parameter_description> a #GIOExtensionPoint
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the #GType to require
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_extension_ref_class">
+<description>
+Gets a reference to the class for the type that is
+associated with @extension.
+
+
+</description>
+<parameters>
+<parameter name="extension">
+<parameter_description> a #GIOExtension
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GTypeClass for the type of @extension
+</return>
+</function>
+
+<function name="g_io_module_new">
+<description>
+Creates a new GIOModule that will load the specific
+shared library when in use.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> filename of the shared library module.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIOModule from given @filename,
+or %NULL on error.
+</return>
+</function>
+
+<function name="g_io_module_scope_block">
+<description>
+Block modules with the given @basename from being loaded when
+this scope is used with g_io_modules_scan_all_in_directory_with_scope()
+or g_io_modules_load_all_in_directory_with_scope().
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="scope">
+<parameter_description> a module loading scope
+</parameter_description>
+</parameter>
+<parameter name="basename">
+<parameter_description> the basename to block
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_module_scope_free">
+<description>
+Free a module scope.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="scope">
+<parameter_description> a module loading scope
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_module_scope_new">
+<description>
+Create a new scope for loading of IO modules. A scope can be used for
+blocking duplicate modules, or blocking a module you don't want to load.
+
+Specify the %G_IO_MODULES_SCOPE_BLOCK_DUPLICATES flag to block modules
+which have the same base name as a module that has already been seen
+in this scope.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="flags">
+<parameter_description> flags for the new scope
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new module scope
+
+</return>
+</function>
+
+<function name="g_io_modules_load_all_in_directory">
+<description>
+Loads all the modules in the specified directory.
+
+If don't require all modules to be initialized (and thus registering
+all gtypes) then you can use g_io_modules_scan_all_in_directory()
+which allows delayed/lazy loading of modules.
+
+
+</description>
+<parameters>
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to load.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of #GIOModules loaded
+from the directory,
+All the modules are loaded into memory, if you want to
+unload them (enabling on-demand loading) you must call
+g_type_module_unuse() on all the modules. Free the list
+with g_list_free().
+</return>
+</function>
+
+<function name="g_io_modules_load_all_in_directory_with_scope">
+<description>
+Loads all the modules in the specified directory.
+
+If don't require all modules to be initialized (and thus registering
+all gtypes) then you can use g_io_modules_scan_all_in_directory()
+which allows delayed/lazy loading of modules.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to load.
+</parameter_description>
+</parameter>
+<parameter name="scope">
+<parameter_description> a scope to use when scanning the modules.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of #GIOModules loaded
+from the directory,
+All the modules are loaded into memory, if you want to
+unload them (enabling on-demand loading) you must call
+g_type_module_unuse() on all the modules. Free the list
+with g_list_free().
+
+</return>
+</function>
+
+<function name="g_io_modules_scan_all_in_directory">
+<description>
+Scans all the modules in the specified directory, ensuring that
+any extension point implemented by a module is registered.
+
+This may not actually load and initialize all the types in each
+module, some modules may be lazily loaded and initialized when
+an extension point it implementes is used with e.g.
+g_io_extension_point_get_extensions() or
+g_io_extension_point_get_extension_by_name().
+
+If you need to guarantee that all types are loaded in all the modules,
+use g_io_modules_load_all_in_directory().
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to scan.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_modules_scan_all_in_directory_with_scope">
+<description>
+Scans all the modules in the specified directory, ensuring that
+any extension point implemented by a module is registered.
+
+This may not actually load and initialize all the types in each
+module, some modules may be lazily loaded and initialized when
+an extension point it implementes is used with e.g.
+g_io_extension_point_get_extensions() or
+g_io_extension_point_get_extension_by_name().
+
+If you need to guarantee that all types are loaded in all the modules,
+use g_io_modules_load_all_in_directory().
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="dirname">
+<parameter_description> pathname for a directory containing modules to scan.
+</parameter_description>
+</parameter>
+<parameter name="scope">
+<parameter_description> a scope to use when scanning the modules
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_scheduler_cancel_all_jobs">
+<description>
+Cancels all cancellable I/O jobs.
+
+A job is cancellable if a #GCancellable was passed into
+g_io_scheduler_push_job().
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_scheduler_job_send_to_mainloop">
+<description>
+Used from an I/O job to send a callback to be run in the thread
+that the job was started from, waiting for the result (and thus
+blocking the I/O job).
+
+
+</description>
+<parameters>
+<parameter name="job">
+<parameter_description> a #GIOSchedulerJob
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #GSourceFunc callback that will be called in the original thread
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> The return value of @func
+</return>
+</function>
+
+<function name="g_io_scheduler_job_send_to_mainloop_async">
+<description>
+Used from an I/O job to send a callback to be run asynchronously in
+the thread that the job was started from. The callback will be run
+when the main loop is available, but at that time the I/O job might
+have finished. The return value from the callback is ignored.
+
+Note that if you are passing the @user_data from g_io_scheduler_push_job()
+on to this function you have to ensure that it is not freed before
+ func is called, either by passing %NULL as @notify to
+g_io_scheduler_push_job() or by using refcounting for @user_data.
+
+</description>
+<parameters>
+<parameter name="job">
+<parameter_description> a #GIOSchedulerJob
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #GSourceFunc callback that will be called in the original thread
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_scheduler_push_job">
+<description>
+Schedules the I/O job to run in another thread.
+
+ notify will be called on @user_data after @job_func has returned,
+regardless whether the job was cancelled or has run to completion.
+
+If @cancellable is not %NULL, it can be used to cancel the I/O job
+by calling g_cancellable_cancel() or by calling
+g_io_scheduler_cancel_all_jobs().
+
+</description>
+<parameters>
+<parameter name="job_func">
+<parameter_description> a #GIOSchedulerJobFunc.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @job_func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify for @user_data, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="gioscheduler">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_stream_clear_pending">
+<description>
+Clears the pending flag on @stream.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_stream_close">
+<description>
+Closes the stream, releasing resources related to it. This will also
+closes the individual input and output streams, if they are not already
+closed.
+
+Once the stream is closed, all other operations will return
+%G_IO_ERROR_CLOSED. Closing a stream multiple times will not
+return an error.
+
+Closing a stream will automatically flush any outstanding buffers
+in the stream.
+
+Streams will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Some streams might keep the backing store of the stream (e.g. a file
+descriptor) open after the stream is closed. See the documentation for
+the individual stream for details.
+
+On failure the first error that happened will be reported, but the
+close operation will finish as much as possible. A stream that failed
+to close will still return %G_IO_ERROR_CLOSED for all operations.
+Still, it is important to check and report the error to the user,
+otherwise there might be a loss of data as all data might not be written.
+
+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.
+Cancelling a close will still leave the stream closed, but some streams
+can use a faster close that doesn't block to e.g. check errors.
+
+The default implementation of this method just calls close on the
+individual input/output streams.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on failure
+
+</return>
+</function>
+
+<function name="g_io_stream_close_async">
+<description>
+Requests an asynchronous close of the stream, releasing resources
+related to it. When the operation is finished @callback will be
+called. You can then call g_io_stream_close_finish() to get
+the result of the operation.
+
+For behaviour details see g_io_stream_close().
+
+The asynchronous methods have a default fallback that uses threads
+to implement asynchronicity, so they are optional for inheriting
+classes. However, if you override one you must override all.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_stream_close_finish">
+<description>
+Closes a stream.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if stream was successfully closed, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_io_stream_get_input_stream">
+<description>
+Gets the input stream for this object. This is used
+for reading.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream, owned by the #GIOStream.
+Do not free.
+
+</return>
+</function>
+
+<function name="g_io_stream_get_output_stream">
+<description>
+Gets the output stream for this object. This is used for
+writing.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GOutputStream, owned by the #GIOStream.
+Do not free.
+
+</return>
+</function>
+
+<function name="g_io_stream_has_pending">
+<description>
+Checks if a stream has pending actions.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream has pending actions.
+
+</return>
+</function>
+
+<function name="g_io_stream_is_closed">
+<description>
+Checks if a stream is closed.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the stream is closed.
+
+</return>
+</function>
+
+<function name="g_io_stream_set_pending">
+<description>
+Sets @stream to have actions pending. If the pending flag is
+already set or @stream is closed, it will return %FALSE and set
+ error
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if pending was previously unset and is now set.
+
+</return>
+</function>
+
+<function name="g_io_stream_splice_async">
+<description>
+Asyncronously splice the output stream of @stream1 to the input stream of
+ stream2, and splice the output stream of @stream2 to the input stream of
+ stream1
+
+When the operation is finished @callback will be called.
+You can then call g_io_stream_splice_finish() to get the
+result of the operation.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream1">
+<parameter_description> a #GIOStream.
+</parameter_description>
+</parameter>
+<parameter name="stream2">
+<parameter_description> a #GIOStream.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GIOStreamSpliceFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_io_stream_splice_finish">
+<description>
+Finishes an asynchronous io stream splice operation.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_keyfile_settings_backend_new">
+<description>
+Creates a keyfile-backed #GSettingsBackend.
+
+The filename of the keyfile to use is given by @filename.
+
+All settings read to or written from the backend must fall under the
+path given in @root_path (which must start and end with a slash and
+not contain two consecutive slashes). @root_path may be "/".
+
+If @root_group is non-%NULL then it specifies the name of the keyfile
+group used for keys that are written directly below @root_path. For
+example, if @root_path is "/apps/example/" and @root_group is
+"toplevel", then settings the key "/apps/example/enabled" to a value
+of %TRUE will cause the following to appear in the keyfile:
+
+|[
+[toplevel]
+enabled=true
+]|
+
+If @root_group is %NULL then it is not permitted to store keys
+directly below the @root_path.
+
+For keys not stored directly below @root_path (ie: in a sub-path),
+the name of the subpath (with the final slash stripped) is used as
+the name of the keyfile group. To continue the example, if
+"/apps/example/profiles/default/font-size" were set to
+12 then the following would appear in the keyfile:
+
+|[
+[profiles/default]
+font-size=12
+]|
+
+The backend will refuse writes (and return writability as being
+%FALSE) for keys outside of @root_path and, in the event that
+ root_group is %NULL, also for keys directly under @root_path.
+Writes will also be refused if the backend detects that it has the
+inability to rewrite the keyfile (ie: the containing directory is not
+writable).
+
+There is no checking done for your key namespace clashing with the
+syntax of the key file format. For example, if you have '[' or ']'
+characters in your path names or '=' in your key names you may be in
+trouble.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> the filename of the keyfile
+</parameter_description>
+</parameter>
+<parameter name="root_path">
+<parameter_description> the path under which all settings keys appear
+</parameter_description>
+</parameter>
+<parameter name="root_group">
+<parameter_description> the group name corresponding to
+ root_path, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a keyfile-backed #GSettingsBackend
+</return>
+</function>
+
+<function name="g_loadable_icon_load">
+<description>
+Loads a loadable icon. For the asynchronous version of this function,
+see g_loadable_icon_load_async().
+
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GLoadableIcon.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> an integer.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a location to store the type of the
+loaded icon, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream to read the icon from.
+</return>
+</function>
+
+<function name="g_loadable_icon_load_async">
+<description>
+Loads an icon asynchronously. To finish this function, see
+g_loadable_icon_load_finish(). For the synchronous, blocking
+version of this function, see g_loadable_icon_load().
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GLoadableIcon.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> an integer.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the
+request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_loadable_icon_load_finish">
+<description>
+Finishes an asynchronous icon load started in g_loadable_icon_load_async().
+
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GLoadableIcon.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a location to store the type of the loaded icon, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GInputStream to read the icon from.
+</return>
+</function>
+
+<function name="g_local_vfs_new">
+<description>
+Returns a new #GVfs handle for a local vfs.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GVfs handle.
+</return>
+</function>
+
+<function name="g_memory_input_stream_add_data">
+<description>
+Appends @data to data that can be read from the input stream
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GMemoryInputStream
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> input data
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> function that is called to free @data, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_memory_input_stream_new">
+<description>
+Creates a new empty #GMemoryInputStream.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GInputStream
+</return>
+</function>
+
+<function name="g_memory_input_stream_new_from_data">
+<description>
+Creates a new #GMemoryInputStream with data in memory of a given size.
+
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> input data
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> length of the data, may be -1 if @data is a nul-terminated string
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> function that is called to free @data, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> new #GInputStream read from @data of @len bytes.
+</return>
+</function>
+
+<function name="g_memory_output_stream_get_data">
+<description>
+Gets any loaded data from the @ostream.
+
+Note that the returned pointer may become invalid on the next
+write or truncate operation on the stream.
+
+
+</description>
+<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> pointer to the stream's data
+</return>
+</function>
+
+<function name="g_memory_output_stream_get_data_size">
+<description>
+Returns the number of bytes from the start up
+to including the last byte written in the stream
+that has not been truncated away.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes written to the stream
+
+</return>
+</function>
+
+<function name="g_memory_output_stream_get_size">
+<description>
+Gets the size of the currently allocated data area (available from
+g_memory_output_stream_get_data()). If the stream isn't
+growable (no realloc was passed to g_memory_output_stream_new()) then
+this is the maximum size of the stream and further writes
+will return %G_IO_ERROR_NO_SPACE.
+
+Note that for growable streams the returned size may become invalid on
+the next write or truncate operation on the stream.
+
+If you want the number of bytes currently written to the stream, use
+g_memory_output_stream_get_data_size().
+
+
+</description>
+<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes allocated for the data buffer
+</return>
+</function>
+
+<function name="g_memory_output_stream_new">
+<description>
+Creates a new #GMemoryOutputStream.
+
+If @data is non-%NULL, the stream will use that for its internal storage.
+If @realloc_fn is non-%NULL, it will be used for resizing the internal
+storage when necessary. To construct a fixed-size output stream,
+pass %NULL as @realloc_fn.
+
+|[
+/ * a stream that can grow * /
+stream = g_memory_output_stream_new (NULL, 0, realloc, free);
+
+/ * another stream that can grow * /
+stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
+
+/ * a fixed-size stream * /
+data = malloc (200);
+stream3 = g_memory_output_stream_new (data, 200, NULL, free);
+]|
+
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> pointer to a chunk of memory to use, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of @data
+</parameter_description>
+</parameter>
+<parameter name="realloc_function">
+<parameter_description> a function with realloc() semantics (like g_realloc())
+to be called when @data needs to be grown, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="destroy_function">
+<parameter_description> a function to be called on @data when the stream is
+finalized, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A newly created #GMemoryOutputStream object.
+</return>
+</function>
+
+<function name="g_memory_output_stream_steal_data">
+<description>
+Gets any loaded data from the @ostream. Ownership of the data
+is transferred to the caller; when no longer needed it must be
+freed using the free function set in @ostream's
+#GMemoryOutputStream:destroy-function property.
+
+ ostream must be closed before calling this function.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the stream's data
+
+</return>
+</function>
+
+<function name="g_memory_settings_backend_new">
+<description>
+Creates a memory-backed #GSettingsBackend.
+
+This backend allows changes to settings, but does not write them
+to any backing storage, so the next time you run your application,
+the memory backend will start out with the default values again.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> a newly created #GSettingsBackend
+
+</return>
+</function>
+
+<function name="g_menu_append">
+<description>
+Convenience function for appending a normal menu item to the end of
+ menu Combine g_menu_new() and g_menu_insert_item() for a more
+flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="detailed_action">
+<parameter_description> the detailed action string, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_append_item">
+<description>
+Appends @item to the end of @menu.
+
+See g_menu_insert_item() for more information.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="item">
+<parameter_description> a #GMenuItem to append
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_append_section">
+<description>
+Convenience function for appending a section menu item to the end of
+ menu Combine g_menu_item_new_section() and g_menu_insert_item() for a
+more flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="section">
+<parameter_description> a #GMenuModel with the items of the section
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_append_submenu">
+<description>
+Convenience function for appending a submenu menu item to the end of
+ menu Combine g_menu_new_submenu() and g_menu_insert_item() for a
+more flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="submenu">
+<parameter_description> a #GMenuModel with the items of the submenu
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_attribute_iter_get_name">
+<description>
+Gets the name of the attribute at the current iterator position, as
+a string.
+
+The iterator is not advanced.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuAttributeIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the attribute
+
+</return>
+</function>
+
+<function name="g_menu_attribute_iter_get_next">
+<description>
+This function combines g_menu_attribute_iter_next() with
+g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value().
+
+First the iterator is advanced to the next (possibly first) attribute.
+If that fails, then %FALSE is returned and there are no other
+effects.
+
+If successful, @name and @value are set to the name and value of the
+attribute that has just been advanced to. At this point,
+g_menu_item_get_name() and g_menu_item_get_value() will return the
+same values again.
+
+The value returned in @name remains valid for as long as the iterator
+remains at the current position. The value returned in @value must
+be unreffed using g_variant_unref() when it is no longer in use.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuAttributeIter
+</parameter_description>
+</parameter>
+<parameter name="out_name">
+<parameter_description> the type of the attribute
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the attribute value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, or %FALSE if there is no additional
+attribute
+
+</return>
+</function>
+
+<function name="g_menu_attribute_iter_get_value">
+<description>
+Gets the value of the attribute at the current iterator position.
+
+The iterator is not advanced.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuAttributeIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the current attribute
+
+</return>
+</function>
+
+<function name="g_menu_attribute_iter_next">
+<description>
+Attempts to advance the iterator to the next (possibly first)
+attribute.
+
+%TRUE is returned on success, or %FALSE if there are no more
+attributes.
+
+You must call this function when you first acquire the iterator
+to advance it to the first attribute (and determine if the first
+attribute exists at all).
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuAttributeIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, or %FALSE when there are no more attributes
+
+</return>
+</function>
+
+<function name="g_menu_freeze">
+<description>
+Marks @menu as frozen.
+
+After the menu is frozen, it is an error to attempt to make any
+changes to it. In effect this means that the #GMenu API must no
+longer be used.
+
+This function causes g_menu_model_is_mutable() to begin returning
+%FALSE, which has some positive performance implications.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_insert">
+<description>
+Convenience function for inserting a normal menu item into @menu.
+Combine g_menu_new() and g_menu_insert_item() for a more flexible
+alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position at which to insert the item
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="detailed_action">
+<parameter_description> the detailed action string, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_insert_item">
+<description>
+Inserts @item into @menu.
+
+The "insertion" is actually done by copying all of the attribute and
+link values of @item and using them to form a new item within @menu.
+As such, @item itself is not really inserted, but rather, a menu item
+that is exactly the same as the one presently described by @item.
+
+This means that @item is essentially useless after the insertion
+occurs. Any changes you make to it are ignored unless it is inserted
+again (at which point its updated values will be copied).
+
+You should probably just free @item once you're done.
+
+There are many convenience functions to take care of common cases.
+See g_menu_insert(), g_menu_insert_section() and
+g_menu_insert_submenu() as well as "prepend" and "append" variants of
+each of these functions.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position at which to insert the item
+</parameter_description>
+</parameter>
+<parameter name="item">
+<parameter_description> the #GMenuItem to insert
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_insert_section">
+<description>
+Convenience function for inserting a section menu item into @menu.
+Combine g_menu_item_new_section() and g_menu_insert_item() for a more
+flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position at which to insert the item
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="section">
+<parameter_description> a #GMenuModel with the items of the section
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_insert_submenu">
+<description>
+Convenience function for inserting a submenu menu item into @menu.
+Combine g_menu_new_submenu() and g_menu_insert_item() for a more
+flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position at which to insert the item
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="submenu">
+<parameter_description> a #GMenuModel with the items of the submenu
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_new">
+<description>
+Creates a new #GMenuItem.
+
+If @label is non-%NULL it is used to set the "label" attribute of the
+new item.
+
+If @detailed_action is non-%NULL it is used to set the "action" and
+possibly the "target" attribute of the new item. See
+g_menu_item_set_detailed_action() for more information.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="detailed_action">
+<parameter_description> the detailed action string, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GMenuItem
+
+</return>
+</function>
+
+<function name="g_menu_item_new_section">
+<description>
+Creates a new #GMenuItem representing a section.
+
+This is a convenience API around g_menu_item_new() and
+g_menu_item_set_section().
+
+The effect of having one menu appear as a section of another is
+exactly as it sounds: the items from @section become a direct part of
+the menu that @menu_item is added to.
+
+Visual separation is typically displayed between two non-empty
+sections. If @label is non-%NULL then it will be encorporated into
+this visual indication. This allows for labeled subsections of a
+menu.
+
+As a simple example, consider a typical "Edit" menu from a simple
+program. It probably contains an "Undo" and "Redo" item, followed by
+a separator, followed by "Cut", "Copy" and "Paste".
+
+This would be accomplished by creating three #GMenu instances. The
+first would be populated with the "Undo" and "Redo" items, and the
+second with the "Cut", "Copy" and "Paste" items. The first and
+second menus would then be added as submenus of the third. In XML
+format, this would look something like the following:
+
+<informalexample><programlisting><![CDATA[
+<menu id='edit-menu'>
+<section>
+<item label='Undo'/>
+<item label='Redo'/>
+</section>
+<section>
+<item label='Cut'/>
+<item label='Copy'/>
+<item label='Paste'/>
+</section>
+</menu>
+]]></programlisting></informalexample>
+
+The following example is exactly equivalent. It is more illustrative
+of the exact relationship between the menus and items (keeping in
+mind that the 'link' element defines a new menu that is linked to the
+containing one). The style of the second example is more verbose and
+difficult to read (and therefore not recommended except for the
+purpose of understanding what is really going on).
+
+<informalexample><programlisting><![CDATA[
+<menu id='edit-menu'>
+<item>
+<link name='section'>
+<item label='Undo'/>
+<item label='Redo'/>
+</link>
+</item>
+<item>
+<link name='section'>
+<item label='Cut'/>
+<item label='Copy'/>
+<item label='Paste'/>
+</link>
+</item>
+</menu>
+]]></programlisting></informalexample>
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="section">
+<parameter_description> a #GMenuModel with the items of the section
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GMenuItem
+
+</return>
+</function>
+
+<function name="g_menu_item_new_submenu">
+<description>
+Creates a new #GMenuItem representing a submenu.
+
+This is a convenience API around g_menu_item_new() and
+g_menu_item_set_submenu().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="submenu">
+<parameter_description> a #GMenuModel with the items of the submenu
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GMenuItem
+
+</return>
+</function>
+
+<function name="g_menu_item_set_action_and_target">
+<description>
+Sets or unsets the "action" and "target" attributes of @menu_item.
+
+If @action is %NULL then both the "action" and "target" attributes
+are unset (and @format_string is ignored along with the positional
+parameters).
+
+If @action is non-%NULL then the "action" attribute is set.
+ format_string is then inspected. If it is non-%NULL then the proper
+position parameters are collected to create a #GVariant instance to
+use as the target value. If it is %NULL then the positional
+parameters are ignored and the "target" attribute is unset.
+
+See also g_menu_item_set_action_and_target_value() for an equivalent
+call that directly accepts a #GVariant. See
+g_menu_item_set_detailed_action() for a more convenient version that
+works with string-typed targets.
+
+See also g_menu_item_set_action_and_target_value() for a
+description of the semantics of the action and target attributes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> the name of the action for this item
+</parameter_description>
+</parameter>
+<parameter name="format_string">
+<parameter_description> a GVariant format string
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> positional parameters, as per @format_string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_action_and_target_value">
+<description>
+Sets or unsets the "action" and "target" attributes of @menu_item.
+
+If @action is %NULL then both the "action" and "target" attributes
+are unset (and @target_value is ignored).
+
+If @action is non-%NULL then the "action" attribute is set. The
+"target" attribute is then set to the value of @target_value if it is
+non-%NULL or unset otherwise.
+
+Normal menu items (ie: not submenu, section or other custom item
+types) are expected to have the "action" attribute set to identify
+the action that they are associated with. The state type of the
+action help to determine the disposition of the menu item. See
+#GAction and #GActionGroup for an overview of actions.
+
+In general, clicking on the menu item will result in activation of
+the named action with the "target" attribute given as the parameter
+to the action invocation. If the "target" attribute is not set then
+the action is invoked with no parameter.
+
+If the action has no state then the menu item is usually drawn as a
+plain menu item (ie: with no additional decoration).
+
+If the action has a boolean state then the menu item is usually drawn
+as a toggle menu item (ie: with a checkmark or equivalent
+indication). The item should be marked as 'toggled' or 'checked'
+when the boolean state is %TRUE.
+
+If the action has a string state then the menu item is usually drawn
+as a radio menu item (ie: with a radio bullet or equivalent
+indication). The item should be marked as 'selected' when the string
+state is equal to the value of the @target property.
+
+See g_menu_item_set_action_and_target() or
+g_menu_item_set_detailed_action() for two equivalent calls that are
+probably more convenient for most uses.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> the name of the action for this item
+</parameter_description>
+</parameter>
+<parameter name="target_value">
+<parameter_description> a #GVariant to use as the action target
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_attribute">
+<description>
+Sets or unsets an attribute on @menu_item.
+
+The attribute to set or unset is specified by @attribute. This
+can be one of the standard attribute names %G_MENU_ATTRIBUTE_LABEL,
+%G_MENU_ATTRIBUTE_ACTION, %G_MENU_ATTRIBUTE_TARGET, or a custom
+attribute name.
+Attribute names are restricted to lowercase characters, numbers
+and '-'. Furthermore, the names must begin with a lowercase character,
+must not end with a '-', and must not contain consecutive dashes.
+
+If @format_string is non-%NULL then the proper position parameters
+are collected to create a #GVariant instance to use as the attribute
+value. If it is %NULL then the positional parameterrs are ignored
+and the named attribute is unset.
+
+See also g_menu_item_set_attribute_value() for an equivalent call
+that directly accepts a #GVariant.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> the attribute to set
+</parameter_description>
+</parameter>
+<parameter name="format_string">
+<parameter_description> a #GVariant format string, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> positional parameters, as per @format_string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_attribute_value">
+<description>
+Sets or unsets an attribute on @menu_item.
+
+The attribute to set or unset is specified by @attribute. This
+can be one of the standard attribute names %G_MENU_ATTRIBUTE_LABEL,
+%G_MENU_ATTRIBUTE_ACTION, %G_MENU_ATTRIBUTE_TARGET, or a custom
+attribute name.
+Attribute names are restricted to lowercase characters, numbers
+and '-'. Furthermore, the names must begin with a lowercase character,
+must not end with a '-', and must not contain consecutive dashes.
+
+must consist only of lowercase
+ASCII characters, digits and '-'.
+
+If @value is non-%NULL then it is used as the new value for the
+attribute. If @value is %NULL then the attribute is unset. If
+the @value #GVariant is floating, it is consumed.
+
+See also g_menu_item_set_attribute() for a more convenient way to do
+the same.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> the attribute to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GVariant to use as the value, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_detailed_action">
+<description>
+Sets the "action" and possibly the "target" attribute of @menu_item.
+
+If @detailed_action contains a double colon ("::") then it is used as
+a separator between an action name and a target string. In this
+case, this call is equivalent to calling
+g_menu_item_set_action_and_target() with the part before the "::" and
+g_menu_item_set_target_value() with a string-type #GVariant
+containing the part following the "::".
+
+If @detailed_action doesn't contain "::" then the action is set to
+the given string (verbatim) and the target value is unset.
+
+See g_menu_item_set_action_and_target() or
+g_menu_item_set_action_and_target_value() for more flexible (but
+slightly less convenient) alternatives.
+
+See also g_menu_set_action_and_target_value() for a description of
+the semantics of the action and target attributes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="detailed_action">
+<parameter_description> the "detailed" action string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_label">
+<description>
+Sets or unsets the "label" attribute of @menu_item.
+
+If @label is non-%NULL it is used as the label for the menu item. If
+it is %NULL then the label attribute is unset.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the label to set, or %NULL to unset
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_link">
+<description>
+Creates a link from @menu_item to @model if non-%NULL, or unsets it.
+
+Links are used to establish a relationship between a particular menu
+item and another menu. For example, %G_MENU_LINK_SUBMENU is used to
+associate a submenu with a particular menu item, and %G_MENU_LINK_SECTION
+is used to create a section. Other types of link can be used, but there
+is no guarantee that clients will be able to make sense of them.
+Link types are restricted to lowercase characters, numbers
+and '-'. Furthermore, the names must begin with a lowercase character,
+must not end with a '-', and must not contain consecutive dashes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="link">
+<parameter_description> type of link to establish or unset
+</parameter_description>
+</parameter>
+<parameter name="model">
+<parameter_description> the #GMenuModel to link to (or %NULL to unset)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_section">
+<description>
+Sets or unsets the "section" link of @menu_item to @section.
+
+The effect of having one menu appear as a section of another is
+exactly as it sounds: the items from @section become a direct part of
+the menu that @menu_item is added to. See g_menu_item_new_section()
+for more information about what it means for a menu item to be a
+section.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="section">
+<parameter_description> a #GMenuModel, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_item_set_submenu">
+<description>
+Sets or unsets the "submenu" link of @menu_item to @submenu.
+
+If @submenu is non-%NULL, it is linked to. If it is %NULL then the
+link is unset.
+
+The effect of having one menu appear as a submenu of another is
+exactly as it sounds.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu_item">
+<parameter_description> a #GMenuItem
+</parameter_description>
+</parameter>
+<parameter name="submenu">
+<parameter_description> a #GMenuModel, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_link_iter_get_name">
+<description>
+Gets the name of the link at the current iterator position.
+
+The iterator is not advanced.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuLinkIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the link
+
+</return>
+</function>
+
+<function name="g_menu_link_iter_get_next">
+<description>
+This function combines g_menu_link_iter_next() with
+g_menu_link_iter_get_name() and g_menu_link_iter_get_value().
+
+First the iterator is advanced to the next (possibly first) link.
+If that fails, then %FALSE is returned and there are no other effects.
+
+If successful, @out_link and @value are set to the name and #GMenuModel
+of the link that has just been advanced to. At this point,
+g_menu_item_get_name() and g_menu_item_get_value() will return the
+same values again.
+
+The value returned in @out_link remains valid for as long as the iterator
+remains at the current position. The value returned in @value must
+be unreffed using g_object_unref() when it is no longer in use.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuLinkIter
+</parameter_description>
+</parameter>
+<parameter name="out_link">
+<parameter_description> the name of the link
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the linked #GMenuModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, or %FALSE if there is no additional link
+
+</return>
+</function>
+
+<function name="g_menu_link_iter_get_value">
+<description>
+Gets the linked #GMenuModel at the current iterator position.
+
+The iterator is not advanced.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuLinkIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GMenuModel that is linked to
+
+</return>
+</function>
+
+<function name="g_menu_link_iter_next">
+<description>
+Attempts to advance the iterator to the next (possibly first)
+link.
+
+%TRUE is returned on success, or %FALSE if there are no more links.
+
+You must call this function when you first acquire the iterator to
+advance it to the first link (and determine if the first link exists
+at all).
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> a #GMenuLinkIter
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, or %FALSE when there are no more links
+
+</return>
+</function>
+
+<function name="g_menu_model_get_item_attribute">
+<description>
+Queries item at position @item_index in @model for the attribute
+specified by @attribute.
+
+If the attribute exists and matches the #GVariantType corresponding
+to @format_string then @format_string is used to deconstruct the
+value into the positional parameters and %TRUE is returned.
+
+If the attribute does not exist, or it does exist but has the wrong
+type, then the positional parameters are ignored and %FALSE is
+returned.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="item_index">
+<parameter_description> the index of the item
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> the attribute to query
+</parameter_description>
+</parameter>
+<parameter name="format_string">
+<parameter_description> a #GVariant format string
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> positional parameters, as per @format_string
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the named attribute was found with the expected
+type
+
+</return>
+</function>
+
+<function name="g_menu_model_get_item_attribute_value">
+<description>
+Queries the item at position @item_index in @model for the attribute
+specified by @attribute.
+
+If @expected_type is non-%NULL then it specifies the expected type of
+the attribute. If it is %NULL then any type will be accepted.
+
+If the attribute exists and matches @expected_type (or if the
+expected type is unspecified) then the value is returned.
+
+If the attribute does not exist, or does not match the expected type
+then %NULL is returned.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="item_index">
+<parameter_description> the index of the item
+</parameter_description>
+</parameter>
+<parameter name="attribute">
+<parameter_description> the attribute to query
+</parameter_description>
+</parameter>
+<parameter name="expected_type">
+<parameter_description> the expected type of the attribute, or
+%NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the attribute
+
+</return>
+</function>
+
+<function name="g_menu_model_get_item_link">
+<description>
+Queries the item at position @item_index in @model for the link
+specified by @link.
+
+If the link exists, the linked #GMenuModel is returned. If the link
+does not exist, %NULL is returned.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="item_index">
+<parameter_description> the index of the item
+</parameter_description>
+</parameter>
+<parameter name="link">
+<parameter_description> the link to query
+</parameter_description>
+</parameter>
+</parameters>
+<return> the linked #GMenuModel, or %NULL
+
+</return>
+</function>
+
+<function name="g_menu_model_get_n_items">
+<description>
+Query the number of items in @model.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of items
+
+</return>
+</function>
+
+<function name="g_menu_model_is_mutable">
+<description>
+Queries if @model is mutable.
+
+An immutable #GMenuModel will never emit the #GMenuModel::items-changed
+signal. Consumers of the model may make optimisations accordingly.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the model is mutable (ie: "items-changed" may be
+emitted).
+
+</return>
+</function>
+
+<function name="g_menu_model_items_changed">
+<description>
+Requests emission of the #GMenuModel::items-changed signal on @model.
+
+This function should never be called except by #GMenuModel
+subclasses. Any other calls to this function will very likely lead
+to a violation of the interface of the model.
+
+The implementation should update its internal representation of the
+menu before emitting the signal. The implementation should further
+expect to receive queries about the new state of the menu (and
+particularly added menu items) while signal handlers are running.
+
+The implementation must dispatch this call directly from a mainloop
+entry and not in response to calls -- particularly those from the
+#GMenuModel API. Said another way: the menu must not change while
+user code is running without returning to the mainloop.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of the change
+</parameter_description>
+</parameter>
+<parameter name="removed">
+<parameter_description> the number of items removed
+</parameter_description>
+</parameter>
+<parameter name="added">
+<parameter_description> the number of items added
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_model_iterate_item_attributes">
+<description>
+Creates a #GMenuAttributeIter to iterate over the attributes of
+the item at position @item_index in @model.
+
+You must free the iterator with g_object_unref() when you are done.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="item_index">
+<parameter_description> the index of the item
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GMenuAttributeIter
+
+</return>
+</function>
+
+<function name="g_menu_model_iterate_item_links">
+<description>
+Creates a #GMenuLinkIter to iterate over the links of the item at
+position @item_index in @model.
+
+You must free the iterator with g_object_unref() when you are done.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> a #GMenuModel
+</parameter_description>
+</parameter>
+<parameter name="item_index">
+<parameter_description> the index of the item
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GMenuLinkIter
+
+</return>
+</function>
+
+<function name="g_menu_new">
+<description>
+Creates a new #GMenu.
+
+The new menu has no items.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GMenu
+
+</return>
+</function>
+
+<function name="g_menu_prepend">
+<description>
+Convenience function for prepending a normal menu item to the start
+of @menu. Combine g_menu_new() and g_menu_insert_item() for a more
+flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="detailed_action">
+<parameter_description> the detailed action string, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_prepend_item">
+<description>
+Prepends @item to the start of @menu.
+
+See g_menu_insert_item() for more information.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="item">
+<parameter_description> a #GMenuItem to prepend
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_prepend_section">
+<description>
+Convenience function for prepending a section menu item to the start
+of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for
+a more flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="section">
+<parameter_description> a #GMenuModel with the items of the section
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_prepend_submenu">
+<description>
+Convenience function for prepending a submenu menu item to the start
+of @menu. Combine g_menu_new_submenu() and g_menu_insert_item() for
+a more flexible alternative.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="label">
+<parameter_description> the section label, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="submenu">
+<parameter_description> a #GMenuModel with the items of the submenu
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_menu_remove">
+<description>
+Removes an item from the menu.
+
+ position gives the index of the item to remove.
+
+It is an error if position is not in range the range from 0 to one
+less than the number of items in the menu.
+
+It is not possible to remove items by identity since items are added
+to the menu simply by copying their links and attributes (ie:
+identity of the item itself is not preserved).
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="menu">
+<parameter_description> a #GMenu
+</parameter_description>
+</parameter>
+<parameter name="position">
+<parameter_description> the position of the item to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_can_eject">
+<description>
+Checks if @mount can be eject.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @mount can be ejected.
+</return>
+</function>
+
+<function name="g_mount_can_unmount">
+<description>
+Checks if @mount can be mounted.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @mount can be unmounted.
+</return>
+</function>
+
+<function name="g_mount_eject">
+<description>
+Ejects a mount. This is an asynchronous operation, and is
+finished by calling g_mount_eject_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Deprecated: 2.22: Use g_mount_eject_with_operation() instead.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_eject_finish">
+<description>
+Finishes ejecting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_mount_eject_with_operation">
+<description>
+Ejects a mount. This is an asynchronous operation, and is
+finished by calling g_mount_eject_with_operation_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the unmount if required for eject
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_eject_with_operation_finish">
+<description>
+Finishes ejecting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the mount was successfully ejected. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_mount_get_default_location">
+<description>
+Gets the default location of @mount. The default location of the given
+ mount is a path that reflects the main entry point for the user (e.g.
+the home directory, or the root of the volume).
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_drive">
+<description>
+Gets the drive for the @mount.
+
+This is a convenience method for getting the #GVolume and then
+using that object to get the #GDrive.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GDrive or %NULL if @mount is not associated with a volume or a drive.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_icon">
+<description>
+Gets the icon for @mount.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIcon.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_name">
+<description>
+Gets the name of @mount.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name for the given @mount.
+The returned string should be freed with g_free()
+when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_root">
+<description>
+Gets the root directory on @mount.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GFile.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_sort_key">
+<description>
+Gets the sort key for @mount, if any.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> A #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Sorting key for @mount or %NULL if no such key is available.
+
+</return>
+</function>
+
+<function name="g_mount_get_uuid">
+<description>
+Gets the UUID for the @mount. The reference is typically based on
+the file system UUID for the mount in question and should be
+considered an opaque string. Returns %NULL if there is no UUID
+available.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the UUID for @mount or %NULL if no UUID can be computed.
+The returned string should be freed with g_free()
+when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_get_volume">
+<description>
+Gets the volume for the @mount.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GVolume or %NULL if @mount is not associated with a volume.
+The returned object should be unreffed with
+g_object_unref() when no longer needed.
+</return>
+</function>
+
+<function name="g_mount_guess_content_type">
+<description>
+Tries to guess the type of content stored on @mount. Returns one or
+more textual identifiers of well-known content types (typically
+prefixed with "x-content/"), e.g. x-content/image-dcf for camera
+memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
+specification for more on x-content types.
+
+This is an asynchronous operation (see
+g_mount_guess_content_type_sync() for the synchronous version), and
+is finished by calling g_mount_guess_content_type_finish() with the
+ mount and #GAsyncResult data returned in the @callback.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount
+</parameter_description>
+</parameter>
+<parameter name="force_rescan">
+<parameter_description> Whether to force a rescan of the content.
+Otherwise a cached result will be used if available
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_guess_content_type_finish">
+<description>
+Finishes guessing content types of @mount. If any errors occurred
+during the operation, @error will be set to contain the errors and
+%FALSE will be returned. In particular, you may get an
+%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
+guessing.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %NULL-terminated array of content types or %NULL on error.
+Caller should free this array with g_strfreev() when done with it.
+
+</return>
+</function>
+
+<function name="g_mount_guess_content_type_sync">
+<description>
+Tries to guess the type of content stored on @mount. Returns one or
+more textual identifiers of well-known content types (typically
+prefixed with "x-content/"), e.g. x-content/image-dcf for camera
+memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
+specification for more on x-content types.
+
+This is an synchronous operation and as such may block doing IO;
+see g_mount_guess_content_type() for the asynchronous version.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount
+</parameter_description>
+</parameter>
+<parameter name="force_rescan">
+<parameter_description> Whether to force a rescan of the content.
+Otherwise a cached result will be used if available
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> a %NULL-terminated array of content types or %NULL on error.
+Caller should free this array with g_strfreev() when done with it.
+
+</return>
+</function>
+
+<function name="g_mount_is_shadowed">
+<description>
+Determines if @mount is shadowed. Applications or libraries should
+avoid displaying @mount in the user interface if it is shadowed.
+
+A mount is said to be shadowed if there exists one or more user
+visible objects (currently #GMount objects) with a root that is
+inside the root of @mount.
+
+One application of shadow mounts is when exposing a single file
+system that is used to address several logical volumes. In this
+situation, a #GVolumeMonitor implementation would create two
+#GVolume objects (for example, one for the camera functionality of
+the device and one for a SD card reader on the device) with
+activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal>
+and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the
+underlying mount (with root
+<literal>gphoto2://[usb:001,002]/</literal>) is mounted, said
+#GVolumeMonitor implementation would create two #GMount objects
+(each with their root matching the corresponding volume activation
+root) that would shadow the original mount.
+
+The proxy monitor in GVfs 2.26 and later, automatically creates and
+manage shadow mounts (and shadows the underlying mount) if the
+activation root on a #GVolume is set.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> A #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @mount is shadowed.
+
+</return>
+</function>
+
+<function name="g_mount_operation_get_anonymous">
+<description>
+Check to see whether the mount operation is being used
+for an anonymous user.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if mount operation is anonymous.
+</return>
+</function>
+
+<function name="g_mount_operation_get_choice">
+<description>
+Gets a choice from the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> an integer containing an index of the user's choice from
+the choice's list, or %0.
+</return>
+</function>
+
+<function name="g_mount_operation_get_domain">
+<description>
+Gets the domain of the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string set to the domain.
+</return>
+</function>
+
+<function name="g_mount_operation_get_password">
+<description>
+Gets a password from the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the password within @op.
+</return>
+</function>
+
+<function name="g_mount_operation_get_password_save">
+<description>
+Gets the state of saving passwords for the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GPasswordSave flag.
+</return>
+</function>
+
+<function name="g_mount_operation_get_username">
+<description>
+Get the user name from the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the user name.
+</return>
+</function>
+
+<function name="g_mount_operation_new">
+<description>
+Creates a new mount operation.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a #GMountOperation.
+</return>
+</function>
+
+<function name="g_mount_operation_reply">
+<description>
+Emits the #GMountOperation::reply signal.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GMountOperationResult
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_anonymous">
+<description>
+Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="anonymous">
+<parameter_description> boolean value.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_choice">
+<description>
+Sets a default choice for the mount operation.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="choice">
+<parameter_description> an integer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_domain">
+<description>
+Sets the mount operation's domain.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> the domain to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_password">
+<description>
+Sets the mount operation's password to @password.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="password">
+<parameter_description> password to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_password_save">
+<description>
+Sets the state of saving passwords for the mount operation.
+
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="save">
+<parameter_description> a set of #GPasswordSave flags.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_operation_set_username">
+<description>
+Sets the user name within @op to @username.
+
+</description>
+<parameters>
+<parameter name="op">
+<parameter_description> a #GMountOperation.
+</parameter_description>
+</parameter>
+<parameter name="username">
+<parameter_description> input username.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_remount">
+<description>
+Remounts a mount. This is an asynchronous operation, and is
+finished by calling g_mount_remount_finish() with the @mount
+and #GAsyncResults data returned in the @callback.
+
+Remounting is useful when some setting affecting the operation
+of the volume has been changed, as these may need a remount to
+take affect. While this is semantically equivalent with unmounting
+and then remounting not all backends might need to actually be
+unmounted.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_remount_finish">
+<description>
+Finishes remounting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the mount was successfully remounted. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_mount_shadow">
+<description>
+Increments the shadow count on @mount. Usually used by
+#GVolumeMonitor implementations when creating a shadow mount for
+ mount, see g_mount_is_shadowed() for more information. The caller
+will need to emit the #GMount::changed signal on @mount manually.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> A #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_unmount">
+<description>
+Unmounts a mount. This is an asynchronous operation, and is
+finished by calling g_mount_unmount_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_unmount_finish">
+<description>
+Finishes unmounting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_mount_unmount_with_operation">
+<description>
+Unmounts a mount. This is an asynchronous operation, and is
+finished by calling g_mount_unmount_with_operation_finish() with the @mount
+and #GAsyncResult data returned in the @callback.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags affecting the operation
+</parameter_description>
+</parameter>
+<parameter name="mount_operation">
+<parameter_description> a #GMountOperation or %NULL to avoid
+user interaction.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mount_unmount_with_operation_finish">
+<description>
+Finishes unmounting a mount. If any errors occurred during the operation,
+ error will be set to contain the errors and %FALSE will be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> a #GMount.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the mount was successfully unmounted. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_mount_unshadow">
+<description>
+Decrements the shadow count on @mount. Usually used by
+#GVolumeMonitor implementations when destroying a shadow mount for
+ mount, see g_mount_is_shadowed() for more information. The caller
+will need to emit the #GMount::changed signal on @mount manually.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="mount">
+<parameter_description> A #GMount.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_network_address_get_hostname">
+<description>
+Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
+depending on what @addr was created with.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="addr">
+<parameter_description> a #GNetworkAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> @addr's hostname
+
+</return>
+</function>
+
+<function name="g_network_address_get_port">
+<description>
+Gets @addr's port number
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="addr">
+<parameter_description> a #GNetworkAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> @addr's port (which may be 0)
+
+</return>
+</function>
+
+<function name="g_network_address_get_scheme">
+<description>
+Gets @addr's scheme
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="addr">
+<parameter_description> a #GNetworkAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> @addr's scheme (%NULL if not built from URI)
+
+</return>
+</function>
+
+<function name="g_network_address_new">
+<description>
+Creates a new #GSocketConnectable for connecting to the given
+ hostname and @port.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="hostname">
+<parameter_description> the hostname
+</parameter_description>
+</parameter>
+<parameter name="port">
+<parameter_description> the port
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GNetworkAddress
+
+</return>
+</function>
+
+<function name="g_network_address_parse">
+<description>
+Creates a new #GSocketConnectable for connecting to the given
+ hostname and @port. May fail and return %NULL in case
+parsing @host_and_port fails.
+
+ host_and_port may be in any of a number of recognised formats; an IPv6
+address, an IPv4 address, or a domain name (in which case a DNS
+lookup is performed). Quoting with [] is supported for all address
+types. A port override may be specified in the usual way with a
+colon.
+
+If no port is specified in @host_and_port then @default_port will be
+used as the port number to connect to.
+
+In general, @host_and_port is expected to be provided by the user
+(allowing them to give the hostname, and a port overide if necessary)
+and @default_port is expected to be provided by the application.
+
+(The port component of @host_and_port can also be specified as a
+service name rather than as a numeric port, but this functionality
+is deprecated, because it depends on the contents of /etc/services,
+which is generally quite sparse on platforms other than Linux.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="host_and_port">
+<parameter_description> the hostname and optionally a port
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port if not in @host_and_port
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GNetworkAddress, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_network_address_parse_uri">
+<description>
+Creates a new #GSocketConnectable for connecting to the given
+ uri May fail and return %NULL in case parsing @uri fails.
+
+Using this rather than g_network_address_new() or
+g_network_address_parse_host() allows #GSocketClient to determine
+when to use application-specific proxy protocols.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="uri">
+<parameter_description> the hostname and optionally a port
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> The default port if none is found in the URI
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GNetworkAddress, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_network_monitor_base_add_network">
+<description>
+Adds @network to @monitor's list of available networks.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> the #GNetworkMonitorBase
+</parameter_description>
+</parameter>
+<parameter name="network">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_network_monitor_base_remove_network">
+<description>
+Removes @network from @monitor's list of available networks.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> the #GNetworkMonitorBase
+</parameter_description>
+</parameter>
+<parameter name="network">
+<parameter_description> a #GInetAddressMask
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_network_monitor_base_set_networks">
+<description>
+Drops @monitor's current list of available networks and replaces
+it with @networks.
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> the #GNetworkMonitorBase
+</parameter_description>
+</parameter>
+<parameter name="networks">
+<parameter_description> an array of #GInetAddressMask
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of @networks
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_network_monitor_can_reach">
+<description>
+Attempts to determine whether or not the host pointed to by
+ connectable can be reached, without actually trying to connect to
+it.
+
+This may return %TRUE even when #GNetworkMonitor:network-available
+is %FALSE, if, for example, @monitor can determine that
+ connectable refers to a host on a local network.
+
+If @monitor believes that an attempt to connect to @connectable
+will succeed, it will return %TRUE. Otherwise, it will return
+%FALSE and set @error to an appropriate error (such as
+%G_IO_ERROR_HOST_UNREACHABLE).
+
+Note that although this does not attempt to connect to
+ connectable, it may still block for a brief period of time (eg,
+trying to do multicast DNS on the local network), so if you do not
+want to block, you should use g_network_monitor_can_reach_async().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GNetworkMonitor
+</parameter_description>
+</parameter>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @connectable is reachable, %FALSE if not.
+
+</return>
+</function>
+
+<function name="g_network_monitor_can_reach_async">
+<description>
+Asynchronously attempts to determine whether or not the host
+pointed to by @connectable can be reached, without actually
+trying to connect to it.
+
+For more details, see g_network_monitor_can_reach().
+
+When the operation is finished, @callback will be called.
+You can then call g_network_monitor_can_reach_finish()
+to get the result of the operation.
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GNetworkMonitor
+</parameter_description>
+</parameter>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the
+request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_network_monitor_can_reach_finish">
+<description>
+Finishes an async network connectivity test.
+See g_network_monitor_can_reach_async().
+
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GNetworkMonitor
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for errors, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if network is reachable, %FALSE if not.
+</return>
+</function>
+
+<function name="g_network_monitor_get_default">
+<description>
+Gets the default #GNetworkMonitor for the system.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return> a #GNetworkMonitor
+
+</return>
+</function>
+
+<function name="g_network_monitor_get_network_available">
+<description>
+Checks if the network is available. "Available" here means that the
+system has a default route available for at least one of IPv4 or
+IPv6. It does not necessarily imply that the public Internet is
+reachable. See #GNetworkMonitor:network-available for more details.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> the #GNetworkMonitor
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether the network is available
+
+</return>
+</function>
+
+<function name="g_network_service_get_domain">
+<description>
+Gets the domain that @srv serves. This might be either UTF-8 or
+ASCII-encoded, depending on what @srv was created with.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+</parameters>
+<return> @srv's domain name
+
+</return>
+</function>
+
+<function name="g_network_service_get_protocol">
+<description>
+Gets @srv's protocol name (eg, "tcp").
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+</parameters>
+<return> @srv's protocol name
+
+</return>
+</function>
+
+<function name="g_network_service_get_scheme">
+<description>
+Get's the URI scheme used to resolve proxies. By default, the service name
+is used as scheme.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+</parameters>
+<return> @srv's scheme name
+
+</return>
+</function>
+
+<function name="g_network_service_get_service">
+<description>
+Gets @srv's service name (eg, "ldap").
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+</parameters>
+<return> @srv's service name
+
+</return>
+</function>
+
+<function name="g_network_service_new">
+<description>
+Creates a new #GNetworkService representing the given @service,
+ protocol, and @domain. This will initially be unresolved; use the
+#GSocketConnectable interface to resolve it.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="service">
+<parameter_description> the service type to look up (eg, "ldap")
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> the networking protocol to use for @service (eg, "tcp")
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> the DNS domain to look up the service in
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GNetworkService
+
+</return>
+</function>
+
+<function name="g_network_service_set_scheme">
+<description>
+Set's the URI scheme used to resolve proxies. By default, the service name
+is used as scheme.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="srv">
+<parameter_description> a #GNetworkService
+</parameter_description>
+</parameter>
+<parameter name="scheme">
+<parameter_description> a URI scheme
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_null_settings_backend_new">
+<description>
+Creates a readonly #GSettingsBackend.
+
+This backend does not allow changes to settings, so all settings
+will always have their default values.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> a newly created #GSettingsBackend
+
+</return>
+</function>
+
+<function name="g_output_stream_clear_pending">
+<description>
+Clears the pending flag on @stream.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> output stream
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_close">
+<description>
+Closes the stream, releasing resources related to it.
+
+Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
+Closing a stream multiple times will not return an error.
+
+Closing a stream will automatically flush any outstanding buffers in the
+stream.
+
+Streams will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Some streams might keep the backing store of the stream (e.g. a file descriptor)
+open after the stream is closed. See the documentation for the individual
+stream for details.
+
+On failure the first error that happened will be reported, but the close
+operation will finish as much as possible. A stream that failed to
+close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
+is important to check and report the error to the user, otherwise
+there might be a loss of data as all data might not be written.
+
+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.
+Cancelling a close will still leave the stream closed, but there some streams
+can use a faster close that doesn't block to e.g. check errors. On
+cancellation (as with any error) there is no guarantee that all written
+data will reach the target.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on failure
+</return>
+</function>
+
+<function name="g_output_stream_close_async">
+<description>
+Requests an asynchronous close of the stream, releasing resources
+related to it. When the operation is finished @callback will be
+called. You can then call g_output_stream_close_finish() to get
+the result of the operation.
+
+For behaviour details see g_output_stream_close().
+
+The asyncronous methods have a default fallback that uses threads
+to implement asynchronicity, so they are optional for inheriting
+classes. However, if you override one you must override all.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_close_finish">
+<description>
+Closes an output stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if stream was successfully closed, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_output_stream_flush">
+<description>
+Forces a write of all user-space buffered data for the given
+ stream Will block during the operation. Closing the stream will
+implicitly cause a flush.
+
+This function is optional for inherited classes.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error
+</return>
+</function>
+
+<function name="g_output_stream_flush_async">
+<description>
+Forces an asynchronous write of all user-space buffered data for
+the given @stream.
+For behaviour details see g_output_stream_flush().
+
+When the operation is finished @callback will be
+called. You can then call g_output_stream_flush_finish() to get the
+result of the operation.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_flush_finish">
+<description>
+Finishes flushing an output stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if flush operation succeeded, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_output_stream_has_pending">
+<description>
+Checks if an ouput stream has pending actions.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream has pending actions.
+</return>
+</function>
+
+<function name="g_output_stream_is_closed">
+<description>
+Checks if an output stream has already been closed.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is closed. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_output_stream_is_closing">
+<description>
+Checks if an output stream is being closed. This can be
+used inside e.g. a flush implementation to see if the
+flush (or other i/o operation) is called from within
+the closing operation.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is being closed. %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_output_stream_set_pending">
+<description>
+Sets @stream to have actions pending. If the pending flag is
+already set or @stream is closed, it will return %FALSE and set
+ error
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if pending was previously unset and is now set.
+</return>
+</function>
+
+<function name="g_output_stream_splice">
+<description>
+Splices an input stream into an output stream.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GOutputStreamSpliceFlags.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gssize containing the size of the data spliced, or
+-1 if an error occurred. Note that if the number of bytes
+spliced is greater than %G_MAXSSIZE, then that will be
+returned, and there is no way to determine the actual number
+of bytes spliced.
+</return>
+</function>
+
+<function name="g_output_stream_splice_async">
+<description>
+Splices a stream asynchronously.
+When the operation is finished @callback will be called.
+You can then call g_output_stream_splice_finish() to get the
+result of the operation.
+
+For the synchronous, blocking version of this function, see
+g_output_stream_splice().
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a set of #GOutputStreamSpliceFlags.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_splice_finish">
+<description>
+Finishes an asynchronous stream splice operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gssize of the number of bytes spliced. Note that if the
+number of bytes spliced is greater than %G_MAXSSIZE, then that
+will be returned, and there is no way to determine the actual
+number of bytes spliced.
+</return>
+</function>
+
+<function name="g_output_stream_write">
+<description>
+Tries to write @count bytes from @buffer into the stream. Will block
+during the operation.
+
+If count is 0, returns 0 and does nothing. A value of @count
+larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes written to the stream is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. on a partial I/O error, or if there is not enough
+storage in the stream. All writes block until at least one byte
+is written or an error occurs; 0 is never returned (unless
+ count is 0).
+
+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 an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error -1 is returned and @error is set accordingly.
+
+Virtual: write_fn
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written, or -1 on error
+</return>
+</function>
+
+<function name="g_output_stream_write_all">
+<description>
+Tries to write @count bytes from @buffer into the stream. Will block
+during the operation.
+
+This function is similar to g_output_stream_write(), except it tries to
+write as many bytes as requested, only stopping on an error.
+
+On a successful write of @count bytes, %TRUE is returned, and @bytes_written
+is set to @count.
+
+If there is an error during the operation FALSE is returned and @error
+is set to indicate the error status, @bytes_written is updated to contain
+the number of bytes written into the stream before the error occurred.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that was
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+</return>
+</function>
+
+<function name="g_output_stream_write_async">
+<description>
+Request an asynchronous write of @count bytes from @buffer into
+the stream. When the operation is finished @callback will be called.
+You can then call g_output_stream_write_finish() to get the result of the
+operation.
+
+During an async request no other sync and async calls are allowed,
+and will result in %G_IO_ERROR_PENDING errors.
+
+A value of @count larger than %G_MAXSSIZE will cause a
+%G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes written will be passed to the
+ callback It is not an error if this is not the same as the
+requested size, as it can happen e.g. on a partial I/O error,
+but generally we try to write as many bytes as requested.
+
+You are guaranteed that this method will never fail with
+%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
+method will just wait until this changes.
+
+Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is %G_PRIORITY_DEFAULT.
+
+The asyncronous methods have a default fallback that uses threads
+to implement asynchronicity, so they are optional for inheriting
+classes. However, if you override one you must override all.
+
+For the synchronous, blocking version of this function, see
+g_output_stream_write().
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_write_finish">
+<description>
+Finishes a stream write operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gssize containing the number of bytes written to the stream.
+</return>
+</function>
+
+<function name="g_permission_acquire">
+<description>
+Attempts to acquire the permission represented by @permission.
+
+The precise method by which this happens depends on the permission
+and the underlying authentication mechanism. A simple example is
+that a dialog may appear asking the user to enter their password.
+
+You should check with g_permission_get_can_acquire() before calling
+this function.
+
+If the permission is acquired then %TRUE is returned. Otherwise,
+%FALSE is returned and @error is set appropriately.
+
+This call is blocking, likely for a very long time (in the case that
+user interaction is required). See g_permission_acquire_async() for
+the non-blocking version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully acquired
+
+</return>
+</function>
+
+<function name="g_permission_acquire_async">
+<description>
+Attempts to acquire the permission represented by @permission.
+
+This is the first half of the asynchronous version of
+g_permission_acquire().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the #GAsyncReadyCallback to call when done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_permission_acquire_finish">
+<description>
+Collects the result of attempting to acquire the permission
+represented by @permission.
+
+This is the second half of the asynchronous version of
+g_permission_acquire().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully acquired
+
+</return>
+</function>
+
+<function name="g_permission_get_allowed">
+<description>
+Gets the value of the 'allowed' property. This property is %TRUE if
+the caller currently has permission to perform the action that
+ permission represents the permission to perform.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'allowed' property
+
+</return>
+</function>
+
+<function name="g_permission_get_can_acquire">
+<description>
+Gets the value of the 'can-acquire' property. This property is %TRUE
+if it is generally possible to acquire the permission by calling
+g_permission_acquire().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'can-acquire' property
+
+</return>
+</function>
+
+<function name="g_permission_get_can_release">
+<description>
+Gets the value of the 'can-release' property. This property is %TRUE
+if it is generally possible to release the permission by calling
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the 'can-release' property
+
+</return>
+</function>
+
+<function name="g_permission_impl_update">
+<description>
+This function is called by the #GPermission implementation to update
+the properties of the permission. You should never call this
+function except from a #GPermission implementation.
+
+GObject notify signals are generated, as appropriate.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="allowed">
+<parameter_description> the new value for the 'allowed' property
+</parameter_description>
+</parameter>
+<parameter name="can_acquire">
+<parameter_description> the new value for the 'can-acquire' property
+</parameter_description>
+</parameter>
+<parameter name="can_release">
+<parameter_description> the new value for the 'can-release' property
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_permission_release">
+<description>
+Attempts to release the permission represented by @permission.
+
+The precise method by which this happens depends on the permission
+and the underlying authentication mechanism. In most cases the
+permission will be dropped immediately without further action.
+
+You should check with g_permission_get_can_release() before calling
+this function.
+
+If the permission is released then %TRUE is returned. Otherwise,
+%FALSE is returned and @error is set appropriately.
+
+This call is blocking, likely for a very long time (in the case that
+user interaction is required). See g_permission_release_async() for
+the non-blocking version.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully released
+
+</return>
+</function>
+
+<function name="g_permission_release_async">
+<description>
+Attempts to release the permission represented by @permission.
+
+This is the first half of the asynchronous version of
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> the #GAsyncReadyCallback to call when done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the user data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_permission_release_finish">
+<description>
+Collects the result of attempting to release the permission
+represented by @permission.
+
+This is the second half of the asynchronous version of
+g_permission_release().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="permission">
+<parameter_description> a #GPermission instance
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult given to the #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a %NULL #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the permission was successfully released
+
+</return>
+</function>
+
+<function name="g_poll_file_monitor_new">
+<description>
+Polls @file for changes.
+
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> a #GFile.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GFileMonitor for the given #GFile.
+</return>
+</function>
+
+<function name="g_pollable_input_stream_can_poll">
+<description>
+Checks if @stream is actually pollable. Some classes may implement
+#GPollableInputStream but have only certain instances of that class
+be pollable. If this method returns %FALSE, then the behavior of
+other #GPollableInputStream methods is undefined.
+
+For any given stream, the value returned by this method is constant;
+a stream cannot switch from pollable to non-pollable or vice versa.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is pollable, %FALSE if not.
+
+</return>
+</function>
+
+<function name="g_pollable_input_stream_create_source">
+<description>
+Creates a #GSource that triggers when @stream can be read, or
+ cancellable is triggered or an error occurs. The callback on the
+source is of the #GPollableSourceFunc type.
+
+As with g_pollable_input_stream_is_readable(), it is possible that
+the stream may not actually be readable even after the source
+triggers, so you should use g_pollable_input_stream_read_nonblocking()
+rather than g_input_stream_read() from the callback.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableInputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSource
+
+</return>
+</function>
+
+<function name="g_pollable_input_stream_is_readable">
+<description>
+Checks if @stream can be read.
+
+Note that some stream types may not be able to implement this 100%
+reliably, and it is possible that a call to g_input_stream_read()
+after this returns %TRUE would still block. To guarantee
+non-blocking behavior, you should always use
+g_pollable_input_stream_read_nonblocking(), which will return a
+%G_IO_ERROR_WOULD_BLOCK error rather than blocking.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableInputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is readable, %FALSE if not. If an error
+has occurred on @stream, this will result in
+g_pollable_input_stream_is_readable() returning %TRUE, and the
+next attempt to read will return the error.
+
+</return>
+</function>
+
+<function name="g_pollable_input_stream_read_nonblocking">
+<description>
+Attempts to read up to @size bytes from @stream into @buffer, as
+with g_input_stream_read(). If @stream is not currently readable,
+this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
+use g_pollable_input_stream_create_source() to create a #GSource
+that will be triggered when @stream is readable.
+
+Note that since this method never blocks, you cannot actually
+use @cancellable to cancel it. However, it will return an error
+if @cancellable has already been cancelled when you call, which
+may happen if you call this method after a source triggers due
+to having been cancelled.
+
+Virtual: read_nonblocking
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableInputStream
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes you want to read
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes read, or -1 on error (including
+%G_IO_ERROR_WOULD_BLOCK).
+</return>
+</function>
+
+<function name="g_pollable_output_stream_can_poll">
+<description>
+Checks if @stream is actually pollable. Some classes may implement
+#GPollableOutputStream but have only certain instances of that
+class be pollable. If this method returns %FALSE, then the behavior
+of other #GPollableOutputStream methods is undefined.
+
+For any given stream, the value returned by this method is constant;
+a stream cannot switch from pollable to non-pollable or vice versa.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is pollable, %FALSE if not.
+
+</return>
+</function>
+
+<function name="g_pollable_output_stream_create_source">
+<description>
+Creates a #GSource that triggers when @stream can be written, or
+ cancellable is triggered or an error occurs. The callback on the
+source is of the #GPollableSourceFunc type.
+
+As with g_pollable_output_stream_is_writable(), it is possible that
+the stream may not actually be writable even after the source
+triggers, so you should use g_pollable_output_stream_write_nonblocking()
+rather than g_output_stream_write() from the callback.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSource
+
+</return>
+</function>
+
+<function name="g_pollable_output_stream_is_writable">
+<description>
+Checks if @stream can be written.
+
+Note that some stream types may not be able to implement this 100%
+reliably, and it is possible that a call to g_output_stream_write()
+after this returns %TRUE would still block. To guarantee
+non-blocking behavior, you should always use
+g_pollable_output_stream_write_nonblocking(), which will return a
+%G_IO_ERROR_WOULD_BLOCK error rather than blocking.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableOutputStream.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @stream is writable, %FALSE if not. If an error
+has occurred on @stream, this will result in
+g_pollable_output_stream_is_writable() returning %TRUE, and the
+next attempt to write will return the error.
+
+</return>
+</function>
+
+<function name="g_pollable_output_stream_write_nonblocking">
+<description>
+Attempts to write up to @size bytes from @buffer to @stream, as
+with g_output_stream_write(). If @stream is not currently writable,
+this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
+use g_pollable_output_stream_create_source() to create a #GSource
+that will be triggered when @stream is writable.
+
+Note that since this method never blocks, you cannot actually
+use @cancellable to cancel it. However, it will return an error
+if @cancellable has already been cancelled when you call, which
+may happen if you call this method after a source triggers due
+to having been cancelled.
+
+Virtual: write_nonblocking
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GPollableOutputStream
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to write
+data from
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes you want to write
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes written, or -1 on error (including
+%G_IO_ERROR_WOULD_BLOCK).
+</return>
+</function>
+
+<function name="g_pollable_source_new">
+<description>
+Utility method for #GPollableInputStream and #GPollableOutputStream
+implementations. Creates a new #GSource that expects a callback of
+type #GPollableSourceFunc. The new source does not actually do
+anything on its own; use g_source_add_child_source() to add other
+sources to it to cause it to trigger.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="pollable_stream">
+<parameter_description> the stream associated with the new source
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GSource.
+
+</return>
+</function>
+
+<function name="g_proxy_address_get_destination_hostname">
+<description>
+Gets @proxy's destination hostname.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's destination hostname
+
+</return>
+</function>
+
+<function name="g_proxy_address_get_destination_port">
+<description>
+Gets @proxy's destination port.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's destination port
+
+</return>
+</function>
+
+<function name="g_proxy_address_get_password">
+<description>
+Gets @proxy's password.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's password
+
+</return>
+</function>
+
+<function name="g_proxy_address_get_protocol">
+<description>
+Gets @proxy's protocol.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's protocol
+
+</return>
+</function>
+
+<function name="g_proxy_address_get_username">
+<description>
+Gets @proxy's username.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's username
+
+</return>
+</function>
+
+<function name="g_proxy_address_new">
+<description>
+Creates a new #GProxyAddress for @inetaddr with @protocol that should
+tunnel through @dest_hostname and @dest_port.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="inetaddr">
+<parameter_description> The proxy server #GInetAddress.
+</parameter_description>
+</parameter>
+<parameter name="port">
+<parameter_description> The proxy server port.
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> The proxy protocol to support, in lower case (e.g. socks, http).
+</parameter_description>
+</parameter>
+<parameter name="dest_hostname">
+<parameter_description> The destination hostname the the proxy should tunnel to.
+</parameter_description>
+</parameter>
+<parameter name="dest_port">
+<parameter_description> The destination port to tunnel to.
+</parameter_description>
+</parameter>
+<parameter name="username">
+<parameter_description> The username to authenticate to the proxy server
+(or %NULL).
+</parameter_description>
+</parameter>
+<parameter name="password">
+<parameter_description> The password to authenticate to the proxy server
+(or %NULL).
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GProxyAddress
+
+</return>
+</function>
+
+<function name="g_proxy_connect">
+<description>
+Given @connection to communicate with a proxy (eg, a
+#GSocketConnection that is connected to the proxy server), this
+does the necessary handshake to connect to @proxy_address, and if
+required, wraps the #GIOStream to handle proxy payload.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxy
+</parameter_description>
+</parameter>
+<parameter name="connection">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="proxy_address">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIOStream that will replace @connection. This might
+be the same as @connection, in which case a reference
+will be added.
+
+</return>
+</function>
+
+<function name="g_proxy_connect_async">
+<description>
+Asynchronous version of g_proxy_connect().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxy
+</parameter_description>
+</parameter>
+<parameter name="connection">
+<parameter_description> a #GIOStream
+</parameter_description>
+</parameter>
+<parameter name="proxy_address">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> callback data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_proxy_connect_finish">
+<description>
+See g_proxy_connect().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxy
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GIOStream.
+
+</return>
+</function>
+
+<function name="g_proxy_get_default_for_protocol">
+<description>
+Lookup "gio-proxy" extension point for a proxy implementation that supports
+specified protocol.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="protocol">
+<parameter_description> the proxy protocol name (e.g. http, socks, etc)
+</parameter_description>
+</parameter>
+</parameters>
+<return> return a #GProxy or NULL if protocol
+is not supported.
+
+</return>
+</function>
+
+<function name="g_proxy_resolver_get_default">
+<description>
+Gets the default #GProxyResolver for the system.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> the default #GProxyResolver.
+
+</return>
+</function>
+
+<function name="g_proxy_resolver_is_supported">
+<description>
+Checks if @resolver can be used on this system. (This is used
+internally; g_proxy_resolver_get_default() will only return a proxy
+resolver that returns %TRUE for this method.)
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GProxyResolver
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @resolver is supported.
+
+</return>
+</function>
+
+<function name="g_proxy_resolver_lookup">
+<description>
+Looks into the system proxy configuration to determine what proxy,
+if any, to use to connect to @uri. The returned proxy URIs are of the
+form <literal><protocol>://[user[:password] ]host:port</literal>
+or <literal>direct://</literal>, where <protocol> could be
+http, rtsp, socks or other proxying protocol.
+
+If you don't know what network protocol is being used on the
+socket, you should use <literal>none</literal> as the URI protocol.
+In this case, the resolver might still return a generic proxy type
+(such as SOCKS), but would not return protocol-specific proxy types
+(such as http).
+
+<literal>direct://</literal> is used when no proxy is needed.
+Direct connection should not be attempted unless it is part of the
+returned array of proxies.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GProxyResolver
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> a URI representing the destination to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A
+NULL-terminated array of proxy URIs. Must be freed
+with g_strfreev().
+
+</return>
+</function>
+
+<function name="g_proxy_resolver_lookup_async">
+<description>
+Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
+details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GProxyResolver
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> a URI representing the destination to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_proxy_resolver_lookup_finish">
+<description>
+Call this function to obtain the array of proxy URIs when
+g_proxy_resolver_lookup_async() is complete. See
+g_proxy_resolver_lookup() for more details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GProxyResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A
+NULL-terminated array of proxy URIs. Must be freed
+with g_strfreev().
+
+</return>
+</function>
+
+<function name="g_proxy_supports_hostname">
+<description>
+Some proxy protocols expect to be passed a hostname, which they
+will resolve to an IP address themselves. Others, like SOCKS4, do
+not allow this. This function will return %FALSE if @proxy is
+implementing such a protocol. When %FALSE is returned, the caller
+should resolve the destination hostname first, and then pass a
+#GProxyAddress containing the stringified IP address to
+g_proxy_connect() or g_proxy_connect_async().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxy
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if hostname resolution is supported.
+
+</return>
+</function>
+
+<function name="g_remote_action_group_activate_action_full">
+<description>
+Activates the remote action.
+
+This is the same as g_action_group_activate_action() except that it
+allows for provision of "platform data" to be sent along with the
+activation request. This typically contains details such as the user
+interaction timestamp or startup notification information.
+
+ platform_data must be non-%NULL and must have the type
+%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="remote">
+<parameter_description> a #GDBusActionGroup
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action to activate
+</parameter_description>
+</parameter>
+<parameter name="parameter">
+<parameter_description> the optional parameter to the activation
+</parameter_description>
+</parameter>
+<parameter name="platform_data">
+<parameter_description> the platform data to send
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_remote_action_group_change_action_state_full">
+<description>
+Changes the state of a remote action.
+
+This is the same as g_action_group_change_action_state() except that
+it allows for provision of "platform data" to be sent along with the
+state change request. This typically contains details such as the
+user interaction timestamp or startup notification information.
+
+ platform_data must be non-%NULL and must have the type
+%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="remote">
+<parameter_description> a #GRemoteActionGroup
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action to change the state of
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the new requested value for the state
+</parameter_description>
+</parameter>
+<parameter name="platform_data">
+<parameter_description> the platform data to send
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_error_quark">
+<description>
+Gets the #GResolver Error Quark.
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> a #GQuark.
+
+</return>
+</function>
+
+<function name="g_resolver_free_addresses">
+<description>
+Frees @addresses (which should be the return value from
+g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
+(This is a convenience method; you can also simply free the results
+by hand.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="addresses">
+<parameter_description> a #GList of #GInetAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_free_targets">
+<description>
+Frees @targets (which should be the return value from
+g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
+(This is a convenience method; you can also simply free the
+results by hand.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="targets">
+<parameter_description> a #GList of #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_get_default">
+<description>
+Gets the default #GResolver. You should unref it when you are done
+with it. #GResolver may use its reference count as a hint about how
+many threads it should allocate for concurrent DNS resolutions.
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> the default #GResolver.
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_address">
+<description>
+Synchronously reverse-resolves @address to determine its
+associated hostname.
+
+If the DNS resolution fails, @error (if non-%NULL) will be set to
+a value from #GResolverError.
+
+If @cancellable is non-%NULL, it can be used to cancel the
+operation, in which case @error (if non-%NULL) will be set to
+%G_IO_ERROR_CANCELLED.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> the address to reverse-resolve
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hostname (either ASCII-only, or in ASCII-encoded
+form), or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_address_async">
+<description>
+Begins asynchronously reverse-resolving @address to determine its
+associated hostname, and eventually calls @callback, which must
+call g_resolver_lookup_by_address_finish() to get the final result.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> the address to reverse-resolve
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_lookup_by_address_finish">
+<description>
+Retrieves the result of a previous call to
+g_resolver_lookup_by_address_async().
+
+If the DNS resolution failed, @error (if non-%NULL) will be set to
+a value from #GResolverError. If the operation was cancelled,
+ error will be set to %G_IO_ERROR_CANCELLED.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hostname (either ASCII-only, or in ASCII-encoded
+form), or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_name">
+<description>
+Synchronously resolves @hostname to determine its associated IP
+address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
+the textual form of an IP address (in which case this just becomes
+a wrapper around g_inet_address_new_from_string()).
+
+On success, g_resolver_lookup_by_name() will return a #GList of
+#GInetAddress, sorted in order of preference and guaranteed to not
+contain duplicates. That is, if using the result to connect to
+ hostname, you should attempt to connect to the first address
+first, then the second if the first fails, etc. If you are using
+the result to listen on a socket, it is appropriate to add each
+result using e.g. g_socket_listener_add_address().
+
+If the DNS resolution fails, @error (if non-%NULL) will be set to a
+value from #GResolverError.
+
+If @cancellable is non-%NULL, it can be used to cancel the
+operation, in which case @error (if non-%NULL) will be set to
+%G_IO_ERROR_CANCELLED.
+
+If you are planning to connect to a socket on the resolved IP
+address, it may be easier to create a #GNetworkAddress and use its
+#GSocketConnectable interface.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> the hostname to look up
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList
+of #GInetAddress, or %NULL on error. You
+must unref each of the addresses and free the list when you are
+done with it. (You can use g_resolver_free_addresses() to do this.)
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_by_name_async">
+<description>
+Begins asynchronously resolving @hostname to determine its
+associated IP address(es), and eventually calls @callback, which
+must call g_resolver_lookup_by_name_finish() to get the result.
+See g_resolver_lookup_by_name() for more details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> the hostname to look up the address of
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_lookup_by_name_finish">
+<description>
+Retrieves the result of a call to
+g_resolver_lookup_by_name_async().
+
+If the DNS resolution failed, @error (if non-%NULL) will be set to
+a value from #GResolverError. If the operation was cancelled,
+ error will be set to %G_IO_ERROR_CANCELLED.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList
+of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
+for more details.
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_service">
+<description>
+Synchronously performs a DNS SRV lookup for the given @service and
+ protocol in the given @domain and returns an array of #GSrvTarget.
+ domain may be an ASCII-only or UTF-8 hostname. Note also that the
+ service and @protocol arguments <emphasis>do not</emphasis>
+include the leading underscore that appears in the actual DNS
+entry.
+
+On success, g_resolver_lookup_service() will return a #GList of
+#GSrvTarget, sorted in order of preference. (That is, you should
+attempt to connect to the first target first, then the second if
+the first fails, etc.)
+
+If the DNS resolution fails, @error (if non-%NULL) will be set to
+a value from #GResolverError.
+
+If @cancellable is non-%NULL, it can be used to cancel the
+operation, in which case @error (if non-%NULL) will be set to
+%G_IO_ERROR_CANCELLED.
+
+If you are planning to connect to the service, it is usually easier
+to create a #GNetworkService and use its #GSocketConnectable
+interface.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the service type to look up (eg, "ldap")
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> the networking protocol to use for @service (eg, "tcp")
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> the DNS domain to look up the service in
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GSrvTarget,
+or %NULL on error. You must free each of the targets and the list when you are
+done with it. (You can use g_resolver_free_targets() to do this.)
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_service_async">
+<description>
+Begins asynchronously performing a DNS SRV lookup for the given
+ service and @protocol in the given @domain, and eventually calls
+ callback, which must call g_resolver_lookup_service_finish() to
+get the final result. See g_resolver_lookup_service() for more
+details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the service type to look up (eg, "ldap")
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> the networking protocol to use for @service (eg, "tcp")
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> the DNS domain to look up the service in
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_lookup_service_finish">
+<description>
+Retrieves the result of a previous call to
+g_resolver_lookup_service_async().
+
+If the DNS resolution failed, @error (if non-%NULL) will be set to
+a value from #GResolverError. If the operation was cancelled,
+ error will be set to %G_IO_ERROR_CANCELLED.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GSrvTarget,
+or %NULL on error. See g_resolver_lookup_service() for more details.
+
+</return>
+</function>
+
+<function name="g_resolver_set_default">
+<description>
+Sets @resolver to be the application's default resolver (reffing
+ resolver, and unreffing the previous default resolver, if any).
+Future calls to g_resolver_get_default() will return this resolver.
+
+This can be used if an application wants to perform any sort of DNS
+caching or "pinning"; it can implement its own #GResolver that
+calls the original default resolver for DNS operations, and
+implements its own cache policies on top of that, and then set
+itself as the default resolver for all later code to use.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> the new default #GResolver
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resource_enumerate_children">
+<description>
+Returns all the names of children at the specified @path in the resource.
+The return result is a %NULL terminated list of strings which should
+be released with g_strfreev().
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of constant strings
+
+</return>
+</function>
+
+<function name="g_resource_error_quark">
+<description>
+Gets the #GResource Error Quark.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return> a #GQuark.
+
+</return>
+</function>
+
+<function name="g_resource_get_info">
+<description>
+Looks for a file at the specified @path in the resource and
+if found returns information about it.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a location to place the flags about the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file was found. %FALSE if there were errors.
+
+</return>
+</function>
+
+<function name="g_resource_load">
+<description>
+Loads a binary resource bundle and creates a #GResource representation of it, allowing
+you to query it for data.
+
+If you want to use this resource in the global resource namespace you need
+to register it with g_resources_register().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> the path of a filename to load, in the GLib filename encoding.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GResource, or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_resource_lookup_data">
+<description>
+Looks for a file at the specified @path in the resource and
+returns a #GBytes that lets you directly access the data in
+memory.
+
+The data is always followed by a zero byte, so you
+can safely use the data as a C string. However, that byte
+is not included in the size of the GBytes.
+
+For uncompressed resource files this is a pointer directly into
+the resource bundle, which is typically in some readonly data section
+in the program binary. For compressed files we allocate memory on
+the heap and automatically uncompress the data.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GBytes or %NULL on error.
+Free the returned object with g_bytes_unref().
+
+</return>
+</function>
+
+<function name="g_resource_new_from_data">
+<description>
+Creates a GResource from a reference to the binary resource bundle.
+This will keep a reference to @data while the resource lives, so
+the data should not be modified or freed.
+
+If you want to use this resource in the global resource namespace you need
+to register it with g_resources_register().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> A #GBytes.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GResource, or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_resource_open_stream">
+<description>
+Looks for a file at the specified @path in the resource and
+returns a #GInputStream that lets you read the data.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GInputStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_resource_ref">
+<description>
+Atomically increments the reference count of @array by one. This
+function is MT-safe and may be called from any thread.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The passed in #GResource.
+
+</return>
+</function>
+
+<function name="g_resource_unref">
+<description>
+Atomically decrements the reference count of @resource by one. If the
+reference count drops to 0, all memory allocated by the array is
+released. This function is MT-safe and may be called from any
+thread.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resources_enumerate_children">
+<description>
+Returns all the names of children at the specified @path in the set of
+globally registred resources.
+The return result is a %NULL terminated list of strings which should
+be released with g_strfreev().
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of constant strings
+
+</return>
+</function>
+
+<function name="g_resources_get_info">
+<description>
+Looks for a file at the specified @path in the set of
+globally registred resources and if found returns information about it.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> a location to place the length of the contents of the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a location to place the flags about the file,
+or %NULL if the length is not needed
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the file was found. %FALSE if there were errors.
+
+</return>
+</function>
+
+<function name="g_resources_lookup_data">
+<description>
+Looks for a file at the specified @path in the set of
+globally registred resources and returns a #GBytes that
+lets you directly access the data in memory.
+
+The data is always followed by a zero byte, so you
+can safely use the data as a C string. However, that byte
+is not included in the size of the GBytes.
+
+For uncompressed resource files this is a pointer directly into
+the resource bundle, which is typically in some readonly data section
+in the program binary. For compressed files we allocate memory on
+the heap and automatically uncompress the data.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GBytes or %NULL on error.
+Free the returned object with g_bytes_unref().
+
+</return>
+</function>
+
+<function name="g_resources_open_stream">
+<description>
+Looks for a file at the specified @path in the set of
+globally registred resources and returns a #GInputStream
+that lets you read the data.
+
+ lookup_flags controls the behaviour of the lookup.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> A pathname inside the resource.
+</parameter_description>
+</parameter>
+<parameter name="lookup_flags">
+<parameter_description> A #GResourceLookupFlags.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GInputStream or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_resources_register">
+<description>
+Registers the resource with the process-global set of resources.
+Once a resource is registered the files in it can be accessed
+with the global resource lookup functions like g_resources_lookup_data().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resources_unregister">
+<description>
+Unregisters the resource from the process-global set of resources.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="resource">
+<parameter_description> A #GResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_seekable_can_seek">
+<description>
+Tests if the stream supports the #GSeekableIface.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @seekable can be seeked. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_seekable_can_truncate">
+<description>
+Tests if the stream can be truncated.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the stream can be truncated, %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_seekable_seek">
+<description>
+Seeks in the stream by the given @offset, modified by @type.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> a #goffset.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSeekType.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if successful. If an error
+has occurred, this function will return %FALSE and set @error
+appropriately if present.
+</return>
+</function>
+
+<function name="g_seekable_tell">
+<description>
+Tells the current position within the stream.
+
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the offset from the beginning of the buffer.
+</return>
+</function>
+
+<function name="g_seekable_truncate">
+<description>
+Truncates a stream with a given #offset.
+
+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 an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+Virtual: truncate_fn
+
+</description>
+<parameters>
+<parameter name="seekable">
+<parameter_description> a #GSeekable.
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> a #goffset.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if successful. If an error
+has occurred, this function will return %FALSE and set @error
+appropriately if present.
+</return>
+</function>
+
+<function name="g_settings_apply">
+<description>
+Applies any changes that have been made to the settings. This
+function does nothing unless @settings is in 'delay-apply' mode;
+see g_settings_delay(). In the normal case settings are always
+applied immediately.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings instance
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_changed">
+<description>
+Signals that a single key has possibly changed. Backend
+implementations should call this if a key has possibly changed its
+value.
+
+ key must be a valid key (ie starting with a slash, not containing
+'//', and not ending with a slash).
+
+The implementation must call this function during any call to
+g_settings_backend_write(), before the call returns (except in the
+case that no keys are actually changed and it cares to detect this
+fact). It may not rely on the existence of a mainloop for
+dispatching the signal later.
+
+The implementation may call this function at any other time it likes
+in response to other events (such as changes occurring outside of the
+program). These calls may originate from a mainloop or may originate
+in response to any other action (including from calls to
+g_settings_backend_write()).
+
+In the case that this call is in response to a call to
+g_settings_backend_write() then @origin_tag must be set to the same
+value that was passed to that call.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_changed_tree">
+<description>
+This call is a convenience wrapper. It gets the list of changes from
+ tree, computes the longest common prefix and calls
+g_settings_backend_changed().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="tree">
+<parameter_description> a #GTree containing the changes
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_flatten_tree">
+<description>
+Calculate the longest common prefix of all keys in a tree and write
+out an array of the key names relative to that prefix and,
+optionally, the value to store at each of those keys.
+
+You must free the value returned in @path, @keys and @values using
+g_free(). You should not attempt to free or unref the contents of
+ keys or @values.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="tree">
+<parameter_description> a #GTree containing the changes
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the location to save the path
+</parameter_description>
+</parameter>
+<parameter name="keys">
+<parameter_description> the
+location to save the relative keys
+</parameter_description>
+</parameter>
+<parameter name="values">
+<parameter_description>
+the location to save the values, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_get_default">
+<description>
+Returns the default #GSettingsBackend. It is possible to override
+the default by setting the <envar>GSETTINGS_BACKEND</envar>
+environment variable to the name of a settings backend.
+
+The user gets a reference to the backend.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> the default #GSettingsBackend
+
+</return>
+</function>
+
+<function name="g_settings_backend_keys_changed">
+<description>
+Signals that a list of keys have possibly changed. Backend
+implementations should call this if keys have possibly changed their
+values.
+
+ path must be a valid path (ie starting and ending with a slash and
+not containing '//'). Each string in @items must form a valid key
+name when @path is prefixed to it (ie: each item must not start or
+end with '/' and must not contain '//').
+
+The meaning of this signal is that any of the key names resulting
+from the contatenation of @path with each item in @items may have
+changed.
+
+The same rules for when notifications must occur apply as per
+g_settings_backend_changed(). These two calls can be used
+interchangeably if exactly one item has changed (although in that
+case g_settings_backend_changed() is definitely preferred).
+
+For efficiency reasons, the implementation should strive for @path to
+be as long as possible (ie: the longest common prefix of all of the
+keys that were changed) but this is not strictly required.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path containing the changes
+</parameter_description>
+</parameter>
+<parameter name="items">
+<parameter_description> the %NULL-terminated list of changed keys
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_path_changed">
+<description>
+Signals that all keys below a given path may have possibly changed.
+Backend implementations should call this if an entire path of keys
+have possibly changed their values.
+
+ path must be a valid path (ie starting and ending with a slash and
+not containing '//').
+
+The meaning of this signal is that any of the key which has a name
+starting with @path may have changed.
+
+The same rules for when notifications must occur apply as per
+g_settings_backend_changed(). This call might be an appropriate
+reasponse to a 'reset' call but implementations are also free to
+explicitly list the keys that were affected by that call if they can
+easily do so.
+
+For efficiency reasons, the implementation should strive for @path to
+be as long as possible (ie: the longest common prefix of all of the
+keys that were changed) but this is not strictly required. As an
+example, if this function is called with the path of "/" then every
+single key in the application will be notified of a possible change.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path containing the changes
+</parameter_description>
+</parameter>
+<parameter name="origin_tag">
+<parameter_description> the origin tag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_path_writable_changed">
+<description>
+Signals that the writability of all keys below a given path may have
+changed.
+
+Since GSettings performs no locking operations for itself, this call
+will always be made in response to external events.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the name of the path
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_backend_writable_changed">
+<description>
+Signals that the writability of a single key has possibly changed.
+
+Since GSettings performs no locking operations for itself, this call
+will always be made in response to external events.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend implementation
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_bind">
+<description>
+Create a binding between the @key in the @settings object
+and the property @property of @object.
+
+The binding uses the default GIO mapping functions to map
+between the settings and property values. These functions
+handle booleans, numeric types and string types in a
+straightforward way. Use g_settings_bind_with_mapping() if
+you need a custom mapping, or map between types that are not
+supported by the default mapping functions.
+
+Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this
+function also establishes a binding between the writability of
+ key and the "sensitive" property of @object (if @object has
+a boolean property by that name). See g_settings_bind_writable()
+for more details about writable bindings.
+
+Note that the lifecycle of the binding is tied to the object,
+and that you can have only one binding per object property.
+If you bind the same property twice on the same object, the second
+binding overrides the first one.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to bind
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the name of the property to bind
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags for the binding
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_bind_with_mapping">
+<description>
+Create a binding between the @key in the @settings object
+and the property @property of @object.
+
+The binding uses the provided mapping functions to map between
+settings and property values.
+
+Note that the lifecycle of the binding is tied to the object,
+and that you can have only one binding per object property.
+If you bind the same property twice on the same object, the second
+binding overrides the first one.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to bind
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the name of the property to bind
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags for the binding
+</parameter_description>
+</parameter>
+<parameter name="get_mapping">
+<parameter_description> a function that gets called to convert values
+from @settings to @object, or %NULL to use the default GIO mapping
+</parameter_description>
+</parameter>
+<parameter name="set_mapping">
+<parameter_description> a function that gets called to convert values
+from @object to @settings, or %NULL to use the default GIO mapping
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data that gets passed to @get_mapping and @set_mapping
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> #GDestroyNotify function for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_bind_writable">
+<description>
+Create a binding between the writability of @key in the
+ settings object and the property @property of @object.
+The property must be boolean; "sensitive" or "visible"
+properties of widgets are the most likely candidates.
+
+Writable bindings are always uni-directional; changes of the
+writability of the setting will be propagated to the object
+property, not the other way.
+
+When the @inverted argument is %TRUE, the binding inverts the
+value as it passes from the setting to the object, i.e. @property
+will be set to %TRUE if the key is <emphasis>not</emphasis>
+writable.
+
+Note that the lifecycle of the binding is tied to the object,
+and that you can have only one binding per object property.
+If you bind the same property twice on the same object, the second
+binding overrides the first one.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to bind
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description>a #GObject
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the name of a boolean property to bind
+</parameter_description>
+</parameter>
+<parameter name="inverted">
+<parameter_description> whether to 'invert' the value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_create_action">
+<description>
+Creates a #GAction corresponding to a given #GSettings key.
+
+The action has the same name as the key.
+
+The value of the key becomes the state of the action and the action
+is enabled when the key is writable. Changing the state of the
+action results in the key being written to. Changes to the value or
+writability of the key cause appropriate change notifications to be
+emitted for the action.
+
+For boolean-valued keys, action activations take no parameter and
+result in the toggling of the value. For all other types,
+activations take the new value for the key (which must have the
+correct type).
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of a key in @settings
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GAction
+
+</return>
+</function>
+
+<function name="g_settings_delay">
+<description>
+Changes the #GSettings object into 'delay-apply' mode. In this
+mode, changes to @settings are not immediately propagated to the
+backend, but kept locally until g_settings_apply() is called.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_get">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience function that combines g_settings_get_value() with
+g_variant_get().
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for the #GVariantType of @format to mismatch
+the type given in the schema.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a #GVariant format string
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> arguments as per @format
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_get_boolean">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for booleans.
+
+It is a programmer error to give a @key that isn't specified as
+having a boolean type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a boolean
+
+</return>
+</function>
+
+<function name="g_settings_get_child">
+<description>
+Creates a 'child' settings object which has a base path of
+<replaceable>base-path</replaceable>/@name, where
+<replaceable>base-path</replaceable> is the base path of @settings.
+
+The schema for the child settings object must have been declared
+in the schema of @settings using a <tag class="starttag">child</tag> element.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the 'child' schema
+</parameter_description>
+</parameter>
+</parameters>
+<return> a 'child' settings object
+
+</return>
+</function>
+
+<function name="g_settings_get_double">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for doubles.
+
+It is a programmer error to give a @key that isn't specified as
+having a 'double' type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a double
+
+</return>
+</function>
+
+<function name="g_settings_get_enum">
+<description>
+Gets the value that is stored in @settings for @key and converts it
+to the enum value that it represents.
+
+In order to use this function the type of the value must be a string
+and it must be marked in the schema file as an enumerated type.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as an enumerated type.
+
+If the value stored in the configuration database is not a valid
+value for the enumerated type then this function will return the
+default value.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> the enum value
+
+</return>
+</function>
+
+<function name="g_settings_get_flags">
+<description>
+Gets the value that is stored in @settings for @key and converts it
+to the flags value that it represents.
+
+In order to use this function the type of the value must be an array
+of strings and it must be marked in the schema file as an flags type.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as a flags type.
+
+If the value stored in the configuration database is not a valid
+value for the flags type then this function will return the default
+value.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> the flags value
+
+</return>
+</function>
+
+<function name="g_settings_get_has_unapplied">
+<description>
+Returns whether the #GSettings object has any unapplied
+changes. This can only be the case if it is in 'delayed-apply' mode.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @settings has unapplied changes
+
+</return>
+</function>
+
+<function name="g_settings_get_int">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for 32-bit integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a int32 type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> an integer
+
+</return>
+</function>
+
+<function name="g_settings_get_mapped">
+<description>
+Gets the value that is stored at @key in @settings, subject to
+application-level validation/mapping.
+
+You should use this function when the application needs to perform
+some processing on the value of the key (for example, parsing). The
+ mapping function performs that processing. If the function
+indicates that the processing was unsuccessful (due to a parse error,
+for example) then the mapping is tried again with another value.
+
+This allows a robust 'fall back to defaults' behaviour to be
+implemented somewhat automatically.
+
+The first value that is tried is the user's setting for the key. If
+the mapping function fails to map this value, other values may be
+tried in an unspecified order (system or site defaults, translated
+schema default values, untranslated schema default values, etc).
+
+If the mapping function fails for all possible values, one additional
+attempt is made: the mapping function is called with a %NULL value.
+If the mapping function still indicates failure at this point then
+the application will be aborted.
+
+The result parameter for the @mapping function is pointed to a
+#gpointer which is initially set to %NULL. The same pointer is given
+to each invocation of @mapping. The final value of that #gpointer is
+what is returned by this function. %NULL is valid; it is returned
+just as any other value would be.
+
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+<parameter name="mapping">
+<parameter_description> the function to map the value in the
+settings database to the value used by the application
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for @mapping
+</parameter_description>
+</parameter>
+</parameters>
+<return> the result, which may be %NULL
+</return>
+</function>
+
+<function name="g_settings_get_range">
+<description>
+Queries the range of a key.
+
+This function will return a #GVariant that fully describes the range
+of values that are valid for @key.
+
+The type of #GVariant returned is <literal>(sv)</literal>. The
+string describes the type of range restriction in effect. The type
+and meaning of the value contained in the variant depends on the
+string.
+
+If the string is <literal>'type'</literal> then the variant contains
+an empty array. The element type of that empty array is the expected
+type of value and all values of that type are valid.
+
+If the string is <literal>'enum'</literal> then the variant contains
+an array enumerating the possible values. Each item in the array is
+a possible valid value and no other values are valid.
+
+If the string is <literal>'flags'</literal> then the variant contains
+an array. Each item in the array is a value that may appear zero or
+one times in an array to be used as the value for this key. For
+example, if the variant contained the array <literal>['x',
+'y']</literal> then the valid values for the key would be
+<literal>[]</literal>, <literal>['x']</literal>,
+<literal>['y']</literal>, <literal>['x', 'y']</literal> and
+<literal>['y', 'x']</literal>.
+
+Finally, if the string is <literal>'range'</literal> then the variant
+contains a pair of like-typed values -- the minimum and maximum
+permissible values for this key.
+
+This information should not be used by normal programs. It is
+considered to be a hint for introspection purposes. Normal programs
+should already know what is permitted by their own schema. The
+format may change in any way in the future -- but particularly, new
+forms may be added to the possibilities described above.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings.
+
+You should free the returned value with g_variant_unref() when it is
+no longer needed.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to query the range of
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GVariant describing the range
+
+</return>
+</function>
+
+<function name="g_settings_get_string">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for strings.
+
+It is a programmer error to give a @key that isn't specified as
+having a string type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated string
+
+</return>
+</function>
+
+<function name="g_settings_get_strv">
+<description>
+A convenience variant of g_settings_get() for string arrays.
+
+It is a programmer error to give a @key that isn't specified as
+having an array of strings type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a
+newly-allocated, %NULL-terminated array of strings, the value that
+is stored at @key in @settings.
+
+</return>
+</function>
+
+<function name="g_settings_get_uint">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for 32-bit unsigned
+integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a uint32 type in the schema for @settings.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> an unsigned integer
+
+</return>
+</function>
+
+<function name="g_settings_get_value">
+<description>
+Gets the value that is stored in @settings for @key.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to get the value for
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GVariant
+
+</return>
+</function>
+
+<function name="g_settings_is_writable">
+<description>
+Finds out if a key can be written or not
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of a key
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the key @name is writable
+
+</return>
+</function>
+
+<function name="g_settings_list_children">
+<description>
+Gets the list of children on @settings.
+
+The list is exactly the list of strings for which it is not an error
+to call g_settings_get_child().
+
+For GSettings objects that are lists, this value can change at any
+time and you should connect to the "children-changed" signal to watch
+for those changes. Note that there is a race condition here: you may
+request a child after listing it only for it to have been destroyed
+in the meantime. For this reason, g_settings_get_child() may return
+%NULL even for a child that was listed by this function.
+
+For GSettings objects that are not lists, you should probably not be
+calling this function from "normal" code (since you should already
+know what children are in your schema). This function may still be
+useful there for introspection reasons, however.
+
+You should free the return value with g_strfreev() when you are done
+with it.
+
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of the children on @settings
+</return>
+</function>
+
+<function name="g_settings_list_keys">
+<description>
+Introspects the list of keys on @settings.
+
+You should probably not be calling this function from "normal" code
+(since you should already know what keys are in your schema). This
+function is intended for introspection reasons.
+
+You should free the return value with g_strfreev() when you are done
+with it.
+
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of the keys on @settings
+</return>
+</function>
+
+<function name="g_settings_list_relocatable_schemas">
+<description>
+Gets a list of the relocatable #GSettings schemas installed on the
+system. These are schemas that do not provide their own path. It is
+usual to instantiate these schemas directly, but if you want to you
+can use g_settings_new_with_path() to specify the path.
+
+The output of this function, taken together with the output of
+g_settings_list_schemas() represents the complete list of all
+installed schemas.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> a list of relocatable
+#GSettings schemas that are available. The list must not be
+modified or freed.
+
+</return>
+</function>
+
+<function name="g_settings_list_schemas">
+<description>
+Gets a list of the #GSettings schemas installed on the system. The
+returned list is exactly the list of schemas for which you may call
+g_settings_new() without adverse effects.
+
+This function does not list the schemas that do not provide their own
+paths (ie: schemas for which you must use
+g_settings_new_with_path()). See
+g_settings_list_relocatable_schemas() for that.
+
+Since: 2.26
+
+</description>
+<parameters>
+</parameters>
+<return> a list of #GSettings
+schemas that are available. The list must not be modified or
+freed.
+
+</return>
+</function>
+
+<function name="g_settings_new">
+<description>
+Creates a new #GSettings object with the schema specified by
+ schema_id
+
+Signals on the newly created #GSettings object will be dispatched
+via the thread-default #GMainContext in effect at the time of the
+call to g_settings_new(). The new #GSettings will hold a reference
+on the context. See g_main_context_push_thread_default().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema_id">
+<parameter_description> the id of the schema
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+
+</return>
+</function>
+
+<function name="g_settings_new_full">
+<description>
+Creates a new #GSettings object with a given schema, backend and
+path.
+
+It should be extremely rare that you ever want to use this function.
+It is made available for advanced use-cases (such as plugin systems
+that want to provide access to schemas loaded from custom locations,
+etc).
+
+At the most basic level, a #GSettings object is a pure composition of
+4 things: a #GSettingsSchema, a #GSettingsBackend, a path within that
+backend, and a #GMainContext to which signals are dispatched.
+
+This constructor therefore gives you full control over constructing
+#GSettings instances. The first 4 parameters are given directly as
+ schema, @backend and @path, and the main context is taken from the
+thread-default (as per g_settings_new()).
+
+If @backend is %NULL then the default backend is used.
+
+If @path is %NULL then the path from the schema is used. It is an
+error f @path is %NULL and the schema has no path of its own or if
+ path is non-%NULL and not equal to the path that the schema does
+have.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> a #GSettingsSchema
+</parameter_description>
+</parameter>
+<parameter name="backend">
+<parameter_description> a #GSettingsBackend
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+
+</return>
+</function>
+
+<function name="g_settings_new_with_backend">
+<description>
+Creates a new #GSettings object with the schema specified by
+ schema_id and a given #GSettingsBackend.
+
+Creating a #GSettings object with a different backend allows accessing
+settings from a database other than the usual one. For example, it may make
+sense to pass a backend corresponding to the "defaults" settings database on
+the system to get a settings object that modifies the system default
+settings instead of the settings for this user.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema_id">
+<parameter_description> the id of the schema
+</parameter_description>
+</parameter>
+<parameter name="backend">
+<parameter_description> the #GSettingsBackend to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+
+</return>
+</function>
+
+<function name="g_settings_new_with_backend_and_path">
+<description>
+Creates a new #GSettings object with the schema specified by
+ schema_id and a given #GSettingsBackend and path.
+
+This is a mix of g_settings_new_with_backend() and
+g_settings_new_with_path().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema_id">
+<parameter_description> the id of the schema
+</parameter_description>
+</parameter>
+<parameter name="backend">
+<parameter_description> the #GSettingsBackend to use
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+
+</return>
+</function>
+
+<function name="g_settings_new_with_path">
+<description>
+Creates a new #GSettings object with the relocatable schema specified
+by @schema_id and a given path.
+
+You only need to do this if you want to directly create a settings
+object with a schema that doesn't have a specified path of its own.
+That's quite rare.
+
+It is a programmer error to call this function for a schema that
+has an explicitly specified path.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="schema_id">
+<parameter_description> the id of the schema
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> the path to use
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettings object
+
+</return>
+</function>
+
+<function name="g_settings_range_check">
+<description>
+Checks if the given @value is of the correct type and within the
+permitted range for @key.
+
+This API is not intended to be used by normal programs -- they should
+already know what is permitted by their own schemas. This API is
+meant to be used by programs such as editors or commandline tools.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to check
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @value is valid for @key
+
+</return>
+</function>
+
+<function name="g_settings_reset">
+<description>
+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
+administrator.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of a key
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_revert">
+<description>
+Reverts all non-applied changes to the settings. This function
+does nothing unless @settings is in 'delay-apply' mode; see
+g_settings_delay(). In the normal case settings are always applied
+immediately.
+
+Change notifications will be emitted for affected keys.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings instance
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_schema_get_id">
+<description>
+Get the ID of @schema.
+
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> a #GSettingsSchema
+</parameter_description>
+</parameter>
+</parameters>
+<return> the ID
+</return>
+</function>
+
+<function name="g_settings_schema_get_path">
+<description>
+Gets the path associated with @schema, or %NULL.
+
+Schemas may be single-instance or relocatable. Single-instance
+schemas correspond to exactly one set of keys in the backend
+database: those located at the path returned by this function.
+
+Relocatable schemas can be referenced by other schemas and can
+threfore describe multiple sets of keys at different locations. For
+relocatable schemas, this function will return %NULL.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> a #GSettingsSchema
+</parameter_description>
+</parameter>
+</parameters>
+<return> the path of the schema, or %NULL
+
+</return>
+</function>
+
+<function name="g_settings_schema_ref">
+<description>
+Increase the reference count of @schema, returning a new reference.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> a #GSettingsSchema
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new reference to @schema
+
+</return>
+</function>
+
+<function name="g_settings_schema_source_get_default">
+<description>
+Gets the default system schema source.
+
+This function is not required for normal uses of #GSettings but it
+may be useful to authors of plugin management systems or to those who
+want to introspect the content of schemas.
+
+If no schemas are installed, %NULL will be returned.
+
+The returned source may actually consist of multiple schema sources
+from different directories, depending on which directories were given
+in <envar>XDG_DATA_DIRS</envar> and
+<envar>GSETTINGS_SCHEMA_DIR</envar>. For this reason, all lookups
+performed against the default source should probably be done
+recursively.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return> the default schema source
+
+</return>
+</function>
+
+<function name="g_settings_schema_source_lookup">
+<description>
+Looks up a schema with the identifier @schema_id in @source.
+
+This function is not required for normal uses of #GSettings but it
+may be useful to authors of plugin management systems or to those who
+want to introspect the content of schemas.
+
+If the schema isn't found directly in @source and @recursive is %TRUE
+then the parent sources will also be checked.
+
+If the schema isn't found, %NULL is returned.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSettingsSchemaSource
+</parameter_description>
+</parameter>
+<parameter name="schema_id">
+<parameter_description> a schema ID
+</parameter_description>
+</parameter>
+<parameter name="recursive">
+<parameter_description> %TRUE if the lookup should be recursive
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSettingsSchema
+
+</return>
+</function>
+
+<function name="g_settings_schema_source_new_from_directory">
+<description>
+Attempts to create a new schema source corresponding to the contents
+of the given directory.
+
+This function is not required for normal uses of #GSettings but it
+may be useful to authors of plugin management systems.
+
+The directory should contain a file called
+<filename>gschemas.compiled</filename> as produced by
+<command>glib-compile-schemas</command>.
+
+If @trusted is %TRUE then <filename>gschemas.compiled</filename> is
+trusted not to be corrupted. This assumption has a performance
+advantage, but can result in crashes or inconsistent behaviour in the
+case of a corrupted file. Generally, you should set @trusted to
+%TRUE for files installed by the system and to %FALSE for files in
+the home directory.
+
+If @parent is non-%NULL then there are two effects.
+
+First, if g_settings_schema_source_lookup() is called with the
+ recursive flag set to %TRUE and the schema can not be found in the
+source, the lookup will recurse to the parent.
+
+Second, any references to other schemas specified within this
+source (ie: <literal>child</literal> or <literal>extents</literal>)
+references may be resolved from the @parent.
+
+For this second reason, except in very unusual situations, the
+ parent should probably be given as the default schema source, as
+returned by g_settings_schema_source_get_default().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="directory">
+<parameter_description> the filename of a directory
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> a #GSettingsSchemaSource, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="trusted">
+<parameter_description> %TRUE, if the directory is trusted
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError pointer set to %NULL, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_schema_source_ref">
+<description>
+Increase the reference count of @source, returning a new reference.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSettingsSchemaSource
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new reference to @source
+
+</return>
+</function>
+
+<function name="g_settings_schema_source_unref">
+<description>
+Decrease the reference count of @source, possibly freeing it.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a #GSettingsSchemaSource
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_schema_unref">
+<description>
+Decrease the reference count of @schema, possibly freeing it.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="schema">
+<parameter_description> a #GSettingsSchema
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_set">
+<description>
+Sets @key in @settings to @value.
+
+A convenience function that combines g_settings_set_value() with
+g_variant_new().
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for the #GVariantType of @format to mismatch
+the type given in the schema.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a #GVariant format string
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> arguments as per @format
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_boolean">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for booleans.
+
+It is a programmer error to give a @key that isn't specified as
+having a boolean type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_double">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for doubles.
+
+It is a programmer error to give a @key that isn't specified as
+having a 'double' type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_enum">
+<description>
+Looks up the enumerated type nick for @value and writes it to @key,
+within @settings.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as an enumerated type, or for
+ value not to be a valid value for the named type.
+
+After performing the write, accessing @key directly with
+g_settings_get_string() will return the 'nick' associated with
+ value
+
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key, within @settings
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> an enumerated value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if the set succeeds
+</return>
+</function>
+
+<function name="g_settings_set_flags">
+<description>
+Looks up the flags type nicks for the bits specified by @value, puts
+them in an array of strings and writes the array to @key, within
+ settings
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or is not marked as a flags type, or for @value
+to contain any bits that are not value for the named type.
+
+After performing the write, accessing @key directly with
+g_settings_get_strv() will return an array of 'nicks'; one for each
+bit in @value.
+
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key, within @settings
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a flags value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if the set succeeds
+</return>
+</function>
+
+<function name="g_settings_set_int">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for 32-bit integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a int32 type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_string">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for strings.
+
+It is a programmer error to give a @key that isn't specified as
+having a string type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_strv">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for string arrays. If
+ value is %NULL, then @key is set to be the empty array.
+
+It is a programmer error to give a @key that isn't specified as
+having an array of strings type in the schema for @settings.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_uint">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for 32-bit unsigned
+integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a uint32 type in the schema for @settings.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to set it to
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_set_value">
+<description>
+Sets @key in @settings to @value.
+
+It is a programmer error to give a @key that isn't contained in the
+schema for @settings or for @value to have the incorrect type, per
+the schema.
+
+If @value is floating then this function consumes the reference.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GSettings object
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the name of the key to set
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a #GVariant of the correct type
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if setting the key succeeded,
+%FALSE if the key was not writable
+
+</return>
+</function>
+
+<function name="g_settings_sync">
+<description>
+Ensures that all pending operations for the given are complete for
+the default backend.
+
+Writes made to a #GSettings are handled asynchronously. For this
+reason, it is very unlikely that the changes have it to disk by the
+time g_settings_set() returns.
+
+This call will block until all of the writes have made it to the
+backend. Since the mainloop is not running, no change notifications
+will be dispatched during this call (but some may be queued by the
+time the call is done).
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_settings_unbind">
+<description>
+Removes an existing binding for @property on @object.
+
+Note that bindings are automatically removed when the
+object is finalized, so it is rarely necessary to call this
+function.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> the object
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> the property whose binding is removed
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_action_group_add_entries">
+<description>
+A convenience function for creating multiple #GSimpleAction instances
+and adding them to the action group.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleActionGroup
+</parameter_description>
+</parameter>
+<parameter name="entries">
+<parameter_description> a pointer to the first item in
+an array of #GActionEntry structs
+</parameter_description>
+</parameter>
+<parameter name="n_entries">
+<parameter_description> the length of @entries, or -1
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the user data for signal connections
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_action_group_insert">
+<description>
+Adds an action to the action group.
+
+If the action group already contains an action with the same name as
+ action then the old action is dropped from the group.
+
+The action group takes its own reference on @action.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleActionGroup
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> a #GAction
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_action_group_lookup">
+<description>
+Looks up the action with the name @action_name in the group.
+
+If no such action exists, returns %NULL.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleActionGroup
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of an action
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GAction, or %NULL
+
+</return>
+</function>
+
+<function name="g_simple_action_group_new">
+<description>
+Creates a new, empty, #GSimpleActionGroup.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GSimpleActionGroup
+
+</return>
+</function>
+
+<function name="g_simple_action_group_remove">
+<description>
+Removes the named action from the action group.
+
+If no action of this name is in the group then nothing happens.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleActionGroup
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_action_new">
+<description>
+Creates a new action.
+
+The created action is stateless. See g_simple_action_new_stateful().
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="parameter_type">
+<parameter_description> the type of parameter to the activate function
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSimpleAction
+
+</return>
+</function>
+
+<function name="g_simple_action_new_stateful">
+<description>
+Creates a new stateful action.
+
+ state is the initial state of the action. All future state values
+must have the same #GVariantType as the initial state.
+
+If the @state GVariant is floating, it is consumed.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name of the action
+</parameter_description>
+</parameter>
+<parameter name="parameter_type">
+<parameter_description> the type of the parameter to the activate function
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> the initial state of the action
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSimpleAction
+
+</return>
+</function>
+
+<function name="g_simple_action_set_enabled">
+<description>
+Sets the action as enabled or not.
+
+An action must be enabled in order to be activated or in order to
+have its state changed from outside callers.
+
+This should only be called by the implementor of the action. Users
+of the action should not attempt to modify its enabled flag.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAction
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> whether the action is enabled
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_action_set_state">
+<description>
+Sets the state of the action.
+
+This directly updates the 'state' property to the given value.
+
+This should only be called by the implementor of the action. Users
+of the action should not attempt to directly modify the 'state'
+property. Instead, they should call g_action_change_state() to
+request the change.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAction
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the new #GVariant for the state
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_report_error_in_idle">
+<description>
+Reports an error in an asynchronous function in an idle function by
+directly setting the contents of the #GAsyncResult with the given error
+information.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #GObject, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a #GQuark containing the error domain (usually #G_IO_ERROR).
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> a specific error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a formatted error reporting string.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of variables to fill in @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_report_gerror_in_idle">
+<description>
+Reports an error in an idle function. Similar to
+g_simple_async_report_error_in_idle(), but takes a #GError rather
+than building a new one.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #GObject, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> the #GError to report
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_report_take_gerror_in_idle">
+<description>
+Reports an error in an idle function. Similar to
+g_simple_async_report_gerror_in_idle(), but takes over the caller's
+ownership of @error, so the caller does not have to free it any more.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> a #GObject, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> the #GError to report
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_complete">
+<description>
+Completes an asynchronous I/O job immediately. Must be called in
+the thread where the asynchronous result was to be delivered, as it
+invokes the callback directly. If you are in a different thread use
+g_simple_async_result_complete_in_idle().
+
+Calling this function takes a reference to @simple for as long as
+is needed to complete the call.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_complete_in_idle">
+<description>
+Completes an asynchronous function in an idle handler in the <link
+linkend="g-main-context-push-thread-default">thread-default main
+loop</link> of the thread that @simple was initially created in
+(and re-pushes that context around the invocation of the callback).
+
+Calling this function takes a reference to @simple for as long as
+is needed to complete the call.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_get_op_res_gboolean">
+<description>
+Gets the operation result boolean from within the asynchronous result.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation's result was %TRUE, %FALSE
+if the operation's result was %FALSE.
+</return>
+</function>
+
+<function name="g_simple_async_result_get_op_res_gpointer">
+<description>
+Gets a pointer result as returned by the asynchronous function.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer from the result.
+</return>
+</function>
+
+<function name="g_simple_async_result_get_op_res_gssize">
+<description>
+Gets a gssize from the asynchronous result.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a gssize returned from the asynchronous function.
+</return>
+</function>
+
+<function name="g_simple_async_result_get_source_tag">
+<description>
+Gets the source tag for the #GSimpleAsyncResult.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gpointer to the source object for the #GSimpleAsyncResult.
+</return>
+</function>
+
+<function name="g_simple_async_result_is_valid">
+<description>
+Ensures that the data passed to the _finish function of an async
+operation is consistent. Three checks are performed.
+
+First, @result is checked to ensure that it is really a
+#GSimpleAsyncResult. Second, @source is checked to ensure that it
+matches the source object of @result. Third, @source_tag is
+checked to ensure that it is either %NULL (as it is when the result was
+created by g_simple_async_report_error_in_idle() or
+g_simple_async_report_gerror_in_idle()) or equal to the
+ source_tag argument given to g_simple_async_result_new() (which, by
+convention, is a pointer to the _async function corresponding to the
+_finish function from which this function is called).
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="result">
+<parameter_description> the #GAsyncResult passed to the _finish function.
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> the #GObject passed to the _finish function.
+</parameter_description>
+</parameter>
+<parameter name="source_tag">
+<parameter_description> the asynchronous function.
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE if all checks passed or #FALSE if any failed.
+
+</return>
+</function>
+
+<function name="g_simple_async_result_new">
+<description>
+Creates a #GSimpleAsyncResult.
+
+
+</description>
+<parameters>
+<parameter name="source_object">
+<parameter_description> a #GObject, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="source_tag">
+<parameter_description> the asynchronous function.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSimpleAsyncResult.
+</return>
+</function>
+
+<function name="g_simple_async_result_new_error">
+<description>
+Creates a new #GSimpleAsyncResult with a set error.
+
+
+</description>
+<parameters>
+<parameter name="source_object">
+<parameter_description> a #GObject, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a #GQuark.
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> an error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a string with format characters.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of values to insert into @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSimpleAsyncResult.
+</return>
+</function>
+
+<function name="g_simple_async_result_new_from_error">
+<description>
+Creates a #GSimpleAsyncResult from an error condition.
+
+
+</description>
+<parameters>
+<parameter name="source_object">
+<parameter_description> a #GObject, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback.
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSimpleAsyncResult.
+</return>
+</function>
+
+<function name="g_simple_async_result_new_take_error">
+<description>
+Creates a #GSimpleAsyncResult from an error condition, and takes over the
+caller's ownership of @error, so the caller does not need to free it anymore.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="source_object">
+<parameter_description> a #GObject, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @callback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSimpleAsyncResult
+
+</return>
+</function>
+
+<function name="g_simple_async_result_propagate_error">
+<description>
+Propagates an error from within the simple asynchronous result to
+a given destination.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="dest">
+<parameter_description> a location to propagate the error to.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the error was propagated to @dest. %FALSE otherwise.
+</return>
+</function>
+
+<function name="g_simple_async_result_run_in_thread">
+<description>
+Runs the asynchronous job in a separate thread and then calls
+g_simple_async_result_complete_in_idle() on @simple to return
+the result to the appropriate main loop.
+
+Calling this function takes a reference to @simple for as long as
+is needed to run the job and report its completion.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a #GSimpleAsyncThreadFunc.
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_error">
+<description>
+Sets an error within the asynchronous result without a #GError.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a #GQuark (usually #G_IO_ERROR).
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> an error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a formatted error reporting string.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> a list of variables to fill in @format.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_error_va">
+<description>
+Sets an error within the asynchronous result without a #GError.
+Unless writing a binding, see g_simple_async_result_set_error().
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a #GQuark (usually #G_IO_ERROR).
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> an error code.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a formatted error reporting string.
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> va_list of arguments.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_from_error">
+<description>
+Sets the result from a #GError.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_handle_cancellation">
+<description>
+Sets whether to handle cancellation within the asynchronous operation.
+
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="handle_cancellation">
+<parameter_description> a #gboolean.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_op_res_gboolean">
+<description>
+Sets the operation result to a boolean within the asynchronous result.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="op_res">
+<parameter_description> a #gboolean.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_op_res_gpointer">
+<description>
+Sets the operation result within the asynchronous result to a pointer.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="op_res">
+<parameter_description> a pointer result from an asynchronous function.
+</parameter_description>
+</parameter>
+<parameter name="destroy_op_res">
+<parameter_description> a #GDestroyNotify function.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_set_op_res_gssize">
+<description>
+Sets the operation result within the asynchronous result to
+the given @op_res.
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="op_res">
+<parameter_description> a #gssize.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_async_result_take_error">
+<description>
+Sets the result from @error, and takes over the caller's ownership
+of @error, so the caller does not need to free it any more.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="simple">
+<parameter_description> a #GSimpleAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_simple_permission_new">
+<description>
+Creates a new #GPermission instance that represents an action that is
+either always or never allowed.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="allowed">
+<parameter_description> %TRUE if the action is allowed
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GSimplePermission, as a #GPermission
+
+</return>
+</function>
+
+<function name="g_socket_accept">
+<description>
+Accept incoming connections on a connection-based socket. This removes
+the first outstanding connection request from the listening socket and
+creates a #GSocket object for it.
+
+The @socket must be bound to a local address with g_socket_bind() and
+must be listening for incoming connections (g_socket_listen()).
+
+If there are no outstanding connections then the operation will block
+or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
+To be notified of an incoming connection, wait for the %G_IO_IN condition.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocket, or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_address_enumerator_next">
+<description>
+Retrieves the next #GSocketAddress from @enumerator. Note that this
+may block for some amount of time. (Eg, a #GNetworkAddress may need
+to do a DNS lookup before it can return an address.) Use
+g_socket_address_enumerator_next_async() if you need to avoid
+blocking.
+
+If @enumerator is expected to yield addresses, but for some reason
+is unable to (eg, because of a DNS error), then the first call to
+g_socket_address_enumerator_next() will return an appropriate error
+in * error However, if the first call to
+g_socket_address_enumerator_next() succeeds, then any further
+internal errors (other than @cancellable being triggered) will be
+ignored.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GSocketAddressEnumerator
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress (owned by the caller), or %NULL on
+error (in which case * error will be set) or if there are no
+more addresses.
+</return>
+</function>
+
+<function name="g_socket_address_enumerator_next_async">
+<description>
+Asynchronously retrieves the next #GSocketAddress from @enumerator
+and then calls @callback, which must call
+g_socket_address_enumerator_next_finish() to get the result.
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GSocketAddressEnumerator
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request
+is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_address_enumerator_next_finish">
+<description>
+Retrieves the result of a completed call to
+g_socket_address_enumerator_next_async(). See
+g_socket_address_enumerator_next() for more information about
+error handling.
+
+
+</description>
+<parameters>
+<parameter name="enumerator">
+<parameter_description> a #GSocketAddressEnumerator
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress (owned by the caller), or %NULL on
+error (in which case * error will be set) or if there are no
+more addresses.
+</return>
+</function>
+
+<function name="g_socket_address_get_family">
+<description>
+Gets the socket family type of @address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the socket family type of @address.
+
+</return>
+</function>
+
+<function name="g_socket_address_get_native_size">
+<description>
+Gets the size of @address's native <type>struct sockaddr</type>.
+You can use this to allocate memory to pass to
+g_socket_address_to_native().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the size of the native <type>struct sockaddr</type> that
+ address represents
+
+</return>
+</function>
+
+<function name="g_socket_address_new_from_native">
+<description>
+Creates a #GSocketAddress subclass corresponding to the native
+<type>struct sockaddr</type> @native.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="native">
+<parameter_description> a pointer to a <type>struct sockaddr</type>
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the size of the memory location pointed to by @native
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocketAddress if @native could successfully be converted,
+otherwise %NULL.
+
+</return>
+</function>
+
+<function name="g_socket_address_to_native">
+<description>
+Converts a #GSocketAddress to a native <type>struct
+sockaddr</type>, which can be passed to low-level functions like
+connect() or bind().
+
+If not enough space is available, a %G_IO_ERROR_NO_SPACE error is
+returned. If the address type is not known on the system
+then a %G_IO_ERROR_NOT_SUPPORTED error is returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+<parameter name="dest">
+<parameter_description> a pointer to a memory location that will contain the native
+<type>struct sockaddr</type>.
+</parameter_description>
+</parameter>
+<parameter name="destlen">
+<parameter_description> the size of @dest. Must be at least as large as
+g_socket_address_get_native_size().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @dest was filled in, %FALSE on error
+
+</return>
+</function>
+
+<function name="g_socket_bind">
+<description>
+When a socket is created it is attached to an address family, but it
+doesn't have an address in this family. g_socket_bind() assigns the
+address (sometimes called name) of the socket.
+
+It is generally required to bind to a local address before you can
+receive connections. (See g_socket_listen() and g_socket_accept() ).
+In certain situations, you may also want to bind a socket that will be
+used to initiate connections, though this is not normally required.
+
+ allow_reuse should be %TRUE for server sockets (sockets that you will
+eventually call g_socket_accept() on), and %FALSE for client sockets.
+(Specifically, if it is %TRUE, then g_socket_bind() will set the
+%SO_REUSEADDR flag on the socket, allowing it to bind @address even if
+that address was previously used by another socket that has not yet been
+fully cleaned-up by the kernel. Failing to set this flag on a server
+socket may cause the bind call to return %G_IO_ERROR_ADDRESS_IN_USE if
+the server program is stopped and then immediately restarted.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress specifying the local address.
+</parameter_description>
+</parameter>
+<parameter name="allow_reuse">
+<parameter_description> whether to allow reusing this address
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_check_connect_result">
+<description>
+Checks and resets the pending connect error for the socket.
+This is used to check for errors when g_socket_connect() is
+used in non-blocking mode.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if no error, %FALSE otherwise, setting @error to the error
+
+</return>
+</function>
+
+<function name="g_socket_client_add_application_proxy">
+<description>
+Enable proxy protocols to be handled by the application. When the
+indicated proxy protocol is returned by the #GProxyResolver,
+#GSocketClient will consider this protocol as supported but will
+not try to find a #GProxy instance to handle handshaking. The
+application must check for this case by calling
+g_socket_connection_get_remote_address() on the returned
+#GSocketConnection, and seeing if it's a #GProxyAddress of the
+appropriate type, to determine whether or not it needs to handle
+the proxy handshaking itself.
+
+This should be used for proxy protocols that are dialects of
+another protocol such as HTTP proxy. It also allows cohabitation of
+proxy protocols that are reused between protocols. A good example
+is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
+be use as generic socket proxy through the HTTP CONNECT method.
+
+When the proxy is detected as being an application proxy, TLS handshake
+will be skipped. This is required to let the application do the proxy
+specific handshake.
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> The proxy protocol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_connect">
+<description>
+Tries to resolve the @connectable and make a network connection to it.
+
+Upon a successful connection, a new #GSocketConnection is constructed
+and returned. The caller owns this new object and must drop their
+reference to it when finished with it.
+
+The type of the #GSocketConnection object returned depends on the type of
+the underlying socket that is used. For instance, for a TCP/IP connection
+it will be a #GTcpConnection.
+
+The socket created will be the same family as the address that the
+ connectable resolves to, unless family is set with g_socket_client_set_family()
+or indirectly via g_socket_client_set_local_address(). The socket type
+defaults to %G_SOCKET_TYPE_STREAM but can be set with
+g_socket_client_set_socket_type().
+
+If a local address is specified with g_socket_client_set_local_address() the
+socket will be bound to this address before connecting.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_async">
+<description>
+This is the asynchronous version of g_socket_client_connect().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_client_connect_finish() to get
+the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_connect_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_host">
+<description>
+This is a helper function for g_socket_client_connect().
+
+Attempts to create a TCP connection to the named host.
+
+ host_and_port may be in any of a number of recognized formats; an IPv6
+address, an IPv4 address, or a domain name (in which case a DNS
+lookup is performed). Quoting with [] is supported for all address
+types. A port override may be specified in the usual way with a
+colon. Ports may be given as decimal numbers or symbolic names (in
+which case an /etc/services lookup is performed).
+
+If no port override is given in @host_and_port then @default_port will be
+used as the port number to connect to.
+
+In general, @host_and_port is expected to be provided by the user (allowing
+them to give the hostname, and a port override if necessary) and
+ default_port is expected to be provided by the application.
+
+In the case that an IP address is given, a single connection
+attempt is made. In the case that a name is given, multiple
+connection attempts may be made, in turn and according to the
+number of address records in DNS, until a connection succeeds.
+
+Upon a successful connection, a new #GSocketConnection is constructed
+and returned. The caller owns this new object and must drop their
+reference to it when finished with it.
+
+In the event of any failure (DNS error, service not found, no hosts
+connectable) %NULL is returned and @error (if non-%NULL) is set
+accordingly.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="host_and_port">
+<parameter_description> the name and optionally port of the host to connect to
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_host_async">
+<description>
+This is the asynchronous version of g_socket_client_connect_to_host().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_client_connect_to_host_finish() to get
+the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="host_and_port">
+<parameter_description> the name and optionally the port of the host to connect to
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_connect_to_host_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_to_host_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_service">
+<description>
+Attempts to create a TCP connection to a service.
+
+This call looks up the SRV record for @service at @domain for the
+"tcp" protocol. It then attempts to connect, in turn, to each of
+the hosts providing the service until either a connection succeeds
+or there are no hosts remaining.
+
+Upon a successful connection, a new #GSocketConnection is constructed
+and returned. The caller owns this new object and must drop their
+reference to it when finished with it.
+
+In the event of any failure (DNS error, service not found, no hosts
+connectable) %NULL is returned and @error (if non-%NULL) is set
+accordingly.
+
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a domain name
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the name of the service to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection if successful, or %NULL on error
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_service_async">
+<description>
+This is the asynchronous version of
+g_socket_client_connect_to_service().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> a domain name
+</parameter_description>
+</parameter>
+<parameter name="service">
+<parameter_description> the name of the service to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_connect_to_service_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_to_service_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_uri">
+<description>
+This is a helper function for g_socket_client_connect().
+
+Attempts to create a TCP connection with a network URI.
+
+ uri may be any valid URI containing an "authority" (hostname/port)
+component. If a port is not specified in the URI, @default_port
+will be used. TLS will be negotiated if #GSocketClient:tls is %TRUE.
+(#GSocketClient does not know to automatically assume TLS for
+certain URI schemes.)
+
+Using this rather than g_socket_client_connect() or
+g_socket_client_connect_to_host() allows #GSocketClient to
+determine when to use application-specific proxy protocols.
+
+Upon a successful connection, a new #GSocketConnection is constructed
+and returned. The caller owns this new object and must drop their
+reference to it when finished with it.
+
+In the event of any failure (DNS error, service not found, no hosts
+connectable) %NULL is returned and @error (if non-%NULL) is set
+accordingly.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> A network URI
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a pointer to a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_connect_to_uri_async">
+<description>
+This is the asynchronous version of g_socket_client_connect_to_uri().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_client_connect_to_uri_finish() to get
+the result of the operation.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+<parameter name="uri">
+<parameter_description> a network uri
+</parameter_description>
+</parameter>
+<parameter name="default_port">
+<parameter_description> the default port to connect to
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_connect_to_uri_finish">
+<description>
+Finishes an async connect operation. See g_socket_client_connect_to_uri_async()
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_client_get_enable_proxy">
+<description>
+Gets the proxy enable state; see g_socket_client_set_enable_proxy()
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether proxying is enabled
+
+</return>
+</function>
+
+<function name="g_socket_client_get_family">
+<description>
+Gets the socket family of the socket client.
+
+See g_socket_client_set_family() for details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketFamily
+
+</return>
+</function>
+
+<function name="g_socket_client_get_local_address">
+<description>
+Gets the local address of the socket client.
+
+See g_socket_client_set_local_address() for details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL. Do not free.
+
+</return>
+</function>
+
+<function name="g_socket_client_get_protocol">
+<description>
+Gets the protocol name type of the socket client.
+
+See g_socket_client_set_protocol() for details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketProtocol
+
+</return>
+</function>
+
+<function name="g_socket_client_get_socket_type">
+<description>
+Gets the socket type of the socket client.
+
+See g_socket_client_set_socket_type() for details.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketFamily
+
+</return>
+</function>
+
+<function name="g_socket_client_get_timeout">
+<description>
+Gets the I/O timeout time for sockets created by @client.
+
+See g_socket_client_set_timeout() for details.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient
+</parameter_description>
+</parameter>
+</parameters>
+<return> the timeout in seconds
+
+</return>
+</function>
+
+<function name="g_socket_client_get_tls">
+<description>
+Gets whether @client creates TLS connections. See
+g_socket_client_set_tls() for details.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @client uses TLS
+
+</return>
+</function>
+
+<function name="g_socket_client_get_tls_validation_flags">
+<description>
+Gets the TLS validation flags used creating TLS connections via
+ client
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the TLS validation flags
+
+</return>
+</function>
+
+<function name="g_socket_client_new">
+<description>
+Creates a new #GSocketClient with the default options.
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> a #GSocketClient.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_client_set_enable_proxy">
+<description>
+Sets whether or not @client attempts to make connections via a
+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.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="enable">
+<parameter_description> whether to enable proxies
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_family">
+<description>
+Sets the socket family of the socket client.
+If this is set to something other than %G_SOCKET_FAMILY_INVALID
+then the sockets created by this object will be of the specified
+family.
+
+This might be useful for instance if you want to force the local
+connection to be an ipv4 socket, even though the address might
+be an ipv6 mapped to ipv4 address.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="family">
+<parameter_description> a #GSocketFamily
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_local_address">
+<description>
+Sets the local address of the socket client.
+The sockets created by this object will bound to the
+specified address (if not %NULL) before connecting.
+
+This is useful if you want to ensure that the local
+side of the connection is on a specific port, or on
+a specific interface.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_protocol">
+<description>
+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
+protocol for the socket family and type.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> a #GSocketProtocol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_socket_type">
+<description>
+Sets the socket type of the socket client.
+The sockets created by this object will be of the specified
+type.
+
+It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM,
+as GSocketClient is used for connection oriented services.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_timeout">
+<description>
+Sets the I/O timeout for sockets created by @client. @timeout is a
+time in seconds, or 0 for no timeout (the default).
+
+The timeout value affects the initial connection attempt as well,
+so setting this may cause calls to g_socket_client_connect(), etc,
+to fail with %G_IO_ERROR_TIMED_OUT.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the timeout
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_tls">
+<description>
+Sets whether @client creates TLS (aka SSL) connections. If @tls is
+%TRUE, @client will wrap its connections in a #GTlsClientConnection
+and perform a TLS handshake when connecting.
+
+Note that since #GSocketClient must return a #GSocketConnection,
+but #GTlsClientConnection is not a #GSocketConnection, this
+actually wraps the resulting #GTlsClientConnection in a
+#GTcpWrapperConnection when returning it. You can use
+g_tcp_wrapper_connection_get_base_io_stream() on the return value
+to extract the #GTlsClientConnection.
+
+If you need to modify the behavior of the TLS handshake (eg, by
+setting a client-side certificate to use, or connecting to the
+#GTlsConnection::accept-certificate signal), you can connect to
+ client's #GSocketClient::event signal and wait for it to be
+emitted with %G_SOCKET_CLIENT_TLS_HANDSHAKING, which will give you
+a chance to see the #GTlsClientConnection before the handshake
+starts.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="tls">
+<parameter_description> whether to use TLS
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_client_set_tls_validation_flags">
+<description>
+Sets the TLS validation flags used when creating TLS connections
+via @client. The default value is %G_TLS_CERTIFICATE_VALIDATE_ALL.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="client">
+<parameter_description> a #GSocketClient.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the validation flags
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_close">
+<description>
+Closes the socket, shutting down any active connection.
+
+Closing a socket does not wait for all outstanding I/O operations
+to finish, so the caller should not rely on them to be guaranteed
+to complete even if the close returns with no error.
+
+Once the socket is closed, all other operations will return
+%G_IO_ERROR_CLOSED. Closing a socket multiple times will not
+return an error.
+
+Sockets will be automatically closed when the last reference
+is dropped, but you might want to call this function to make sure
+resources are released as early as possible.
+
+Beware that due to the way that TCP works, it is possible for
+recently-sent data to be lost if either you close a socket while the
+%G_IO_IN condition is set, or else if the remote connection tries to
+send something to you after you close the socket but before it has
+finished reading all of the data you sent. There is no easy generic
+way to avoid this problem; the easiest fix is to design the network
+protocol such that the client will never send data "out of turn".
+Another solution is for the server to half-close the connection by
+calling g_socket_shutdown() with only the @shutdown_write flag set,
+and then wait for the client to notice this and close its side of the
+connection, after which the server can safely call g_socket_close().
+(This is what #GTcpConnection does if you call
+g_tcp_connection_set_graceful_disconnect(). But of course, this
+only works if the client will close its connection after the server
+does.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error
+
+</return>
+</function>
+
+<function name="g_socket_condition_check">
+<description>
+Checks on the readiness of @socket to perform operations.
+The operations specified in @condition are checked for and masked
+against the currently-satisfied conditions on @socket. The result
+is returned.
+
+Note that on Windows, it is possible for an operation to return
+%G_IO_ERROR_WOULD_BLOCK even immediately after
+g_socket_condition_check() has claimed that the socket is ready for
+writing. Rather than calling g_socket_condition_check() and then
+writing to the socket if it succeeds, it is generally better to
+simply try writing to the socket right away, and try again later if
+the initial attempt returns %G_IO_ERROR_WOULD_BLOCK.
+
+It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
+these conditions will always be set in the output if they are true.
+
+This call never blocks.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @GIOCondition mask of the current state
+
+</return>
+</function>
+
+<function name="g_socket_condition_wait">
+<description>
+Waits for @condition to become true on @socket. When the condition
+is met, %TRUE is returned.
+
+If @cancellable is cancelled before the condition is met, or if the
+socket has a timeout set and it is reached before the condition is
+met, then %FALSE is returned and @error, if non-%NULL, is set to
+the appropriate value (%G_IO_ERROR_CANCELLED or
+%G_IO_ERROR_TIMED_OUT).
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to wait for
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the condition was met, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_socket_connect">
+<description>
+Connect the socket to the specified remote address.
+
+For connection oriented socket this generally means we attempt to make
+a connection to the @address. For a connection-less socket it sets
+the default address for g_socket_send() and discards all incoming datagrams
+from other sources.
+
+Generally connection oriented sockets can only connect once, but
+connection-less sockets can connect multiple times to change the
+default address.
+
+If the connect call needs to do network I/O it will block, unless
+non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned
+and the user can be notified of the connection finishing by waiting
+for the G_IO_OUT condition. The result of the connection must then be
+checked with g_socket_check_connect_result().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if connected, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_connectable_enumerate">
+<description>
+Creates a #GSocketAddressEnumerator for @connectable.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocketAddressEnumerator.
+
+</return>
+</function>
+
+<function name="g_socket_connectable_proxy_enumerate">
+<description>
+Creates a #GSocketAddressEnumerator for @connectable that will
+return #GProxyAddress<!-- -->es for addresses that you must connect
+to via a proxy.
+
+If @connectable does not implement
+g_socket_connectable_proxy_enumerate(), this will fall back to
+calling g_socket_connectable_enumerate().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="connectable">
+<parameter_description> a #GSocketConnectable
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocketAddressEnumerator.
+
+</return>
+</function>
+
+<function name="g_socket_connection_connect">
+<description>
+Connect @connection to the specified remote address.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the connection succeeded, %FALSE on error
+
+</return>
+</function>
+
+<function name="g_socket_connection_connect_async">
+<description>
+Asynchronously connect @connection to the specified remote address.
+
+This clears the #GSocket:blocking flag on @connection's underlying
+socket if it is currently set.
+
+Use g_socket_connection_connect_finish() to retrieve the result.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress specifying the remote address.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_connection_connect_finish">
+<description>
+Gets the result of a g_socket_connection_connect_async() call.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the connection succeeded, %FALSE on error
+
+</return>
+</function>
+
+<function name="g_socket_connection_factory_create_connection">
+<description>
+Creates a #GSocketConnection subclass of the right type for
+ socket
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection
+
+</return>
+</function>
+
+<function name="g_socket_connection_factory_lookup_type">
+<description>
+Looks up the #GType to be used when creating socket connections on
+sockets with the specified @family, @type and @protocol_id.
+
+If no type is registered, the #GSocketConnection base type is returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="family">
+<parameter_description> a #GSocketFamily
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+<parameter name="protocol_id">
+<parameter_description> a protocol id
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GType
+
+</return>
+</function>
+
+<function name="g_socket_connection_factory_register_type">
+<description>
+Looks up the #GType to be used when creating socket connections on
+sockets with the specified @family, @type and @protocol.
+
+If no type is registered, the #GSocketConnection base type is returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="g_type">
+<parameter_description> a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION
+</parameter_description>
+</parameter>
+<parameter name="family">
+<parameter_description> a #GSocketFamily
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> a protocol id
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_connection_get_local_address">
+<description>
+Try to get the local address of a socket connection.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_connection_get_remote_address">
+<description>
+Try to get the remote address of a socket connection.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_connection_get_socket">
+<description>
+Gets the underlying #GSocket object of the connection.
+This can be useful if you want to do something unusual on it
+not supported by the #GSocketConnection APIs.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_connection_is_connected">
+<description>
+Checks if @connection is connected. This is equivalent to calling
+g_socket_is_connected() on @connection's underlying #GSocket.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GSocketConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @connection is connected
+
+</return>
+</function>
+
+<function name="g_socket_control_message_deserialize">
+<description>
+Tries to deserialize a socket control message of a given
+ level and @type. This will ask all known (to GType) subclasses
+of #GSocketControlMessage if they can understand this kind
+of message and if so deserialize it into a #GSocketControlMessage.
+
+If there is no implementation for this kind of control message, %NULL
+will be returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="level">
+<parameter_description> a socket level
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a socket control message type for the given @level
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of the data in bytes
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> pointer to the message data
+</parameter_description>
+</parameter>
+</parameters>
+<return> the deserialized message or %NULL
+
+</return>
+</function>
+
+<function name="g_socket_control_message_get_level">
+<description>
+Returns the "level" (i.e. the originating protocol) of the control message.
+This is often SOL_SOCKET.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
+</parameter_description>
+</parameter>
+</parameters>
+<return> an integer describing the level
+
+</return>
+</function>
+
+<function name="g_socket_control_message_get_msg_type">
+<description>
+Returns the protocol specific type of the control message.
+For instance, for UNIX fd passing this would be SCM_RIGHTS.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
+</parameter_description>
+</parameter>
+</parameters>
+<return> an integer describing the type of control message
+
+</return>
+</function>
+
+<function name="g_socket_control_message_get_size">
+<description>
+Returns the space required for the control message, not including
+headers or alignment.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
+</parameter_description>
+</parameter>
+</parameters>
+<return> The number of bytes required.
+
+</return>
+</function>
+
+<function name="g_socket_control_message_serialize">
+<description>
+Converts the data in the message to bytes placed in the
+message.
+
+ data is guaranteed to have enough space to fit the size
+returned by g_socket_control_message_get_size() on this
+object.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="message">
+<parameter_description> a #GSocketControlMessage
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> A buffer to write data to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_create_source">
+<description>
+Creates a %GSource that can be attached to a %GMainContext to monitor
+for the availibility of the specified @condition on the socket.
+
+The callback on the source is of the #GSocketSourceFunc type.
+
+It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition;
+these conditions will always be reported output if they are true.
+
+ cancellable if not %NULL can be used to cancel the source, which will
+cause the source to trigger, reporting the current condition (which
+is likely 0 unless cancellation happened at the same time as a
+condition change). You can check for this in the callback using
+g_cancellable_is_cancelled().
+
+If @socket has a timeout set, and it is reached before @condition
+occurs, the source will then trigger anyway, reporting %G_IO_IN or
+%G_IO_OUT depending on @condition. However, @socket will have been
+marked as having had a timeout, and so the next #GSocket I/O method
+you call will then fail with a %G_IO_ERROR_TIMED_OUT.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="condition">
+<parameter_description> a #GIOCondition mask to monitor
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated %GSource, free with g_source_unref().
+
+</return>
+</function>
+
+<function name="g_socket_get_available_bytes">
+<description>
+Get the amount of data pending in the OS input buffer.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes that can be read from the socket
+without blocking or -1 on error.
+
+</return>
+</function>
+
+<function name="g_socket_get_blocking">
+<description>
+Gets the blocking mode of the socket. For details on blocking I/O,
+see g_socket_set_blocking().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if blocking I/O is used, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_socket_get_broadcast">
+<description>
+Gets the broadcast setting on @socket; if %TRUE,
+it is possible to send packets to broadcast
+addresses or receive from broadcast addresses.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the broadcast setting on @socket
+
+</return>
+</function>
+
+<function name="g_socket_get_credentials">
+<description>
+Returns the credentials of the foreign process connected to this
+socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX
+sockets).
+
+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.
+
+Other ways to obtain credentials from a foreign peer includes the
+#GUnixCredentialsMessage type and
+g_unix_connection_send_credentials() /
+g_unix_connection_receive_credentials() functions.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %NULL if @error is set, otherwise a #GCredentials object
+that must be freed with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_get_family">
+<description>
+Gets the socket family of the socket.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketFamily
+
+</return>
+</function>
+
+<function name="g_socket_get_fd">
+<description>
+Returns the underlying OS socket object. On unix this
+is a socket file descriptor, and on windows this is
+a Winsock2 SOCKET handle. This may be useful for
+doing platform specific or otherwise unusual operations
+on the socket.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the file descriptor of the socket.
+
+</return>
+</function>
+
+<function name="g_socket_get_keepalive">
+<description>
+Gets the keepalive mode of the socket. For details on this,
+see g_socket_set_keepalive().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if keepalive is active, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_socket_get_listen_backlog">
+<description>
+Gets the listen backlog setting of the socket. For details on this,
+see g_socket_set_listen_backlog().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the maximum number of pending connections.
+
+</return>
+</function>
+
+<function name="g_socket_get_local_address">
+<description>
+Try to get the local address of a bound socket. This is only
+useful if the socket has been bound to a local address,
+either explicitly or implicitly when connecting.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_get_multicast_loopback">
+<description>
+Gets the multicast loopback setting on @socket; if %TRUE (the
+default), outgoing multicast packets will be looped back to
+multicast listeners on the same host.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the multicast loopback setting on @socket
+
+</return>
+</function>
+
+<function name="g_socket_get_multicast_ttl">
+<description>
+Gets the multicast time-to-live setting on @socket; see
+g_socket_set_multicast_ttl() for more details.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the multicast time-to-live setting on @socket
+
+</return>
+</function>
+
+<function name="g_socket_get_protocol">
+<description>
+Gets the socket protocol id the socket was created with.
+In case the protocol is unknown, -1 is returned.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a protocol id, or -1 if unknown
+
+</return>
+</function>
+
+<function name="g_socket_get_remote_address">
+<description>
+Try to get the remove address of a connected socket. This is only
+useful for connection oriented sockets that have been connected.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketAddress or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_get_socket_type">
+<description>
+Gets the socket type of the socket.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketType
+
+</return>
+</function>
+
+<function name="g_socket_get_timeout">
+<description>
+Gets the timeout setting of the socket. For details on this, see
+g_socket_set_timeout().
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the timeout in seconds
+
+</return>
+</function>
+
+<function name="g_socket_get_ttl">
+<description>
+Gets the unicast time-to-live setting on @socket; see
+g_socket_set_ttl() for more details.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the time-to-live setting on @socket
+
+</return>
+</function>
+
+<function name="g_socket_is_closed">
+<description>
+Checks whether a socket is closed.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if socket is closed, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_socket_is_connected">
+<description>
+Check whether the socket is connected. This is only useful for
+connection-oriented sockets.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if socket is connected, %FALSE otherwise.
+
+</return>
+</function>
+
+<function name="g_socket_join_multicast_group">
+<description>
+Registers @socket to receive multicast messages sent to @group.
+ socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have
+been bound to an appropriate interface and port with
+g_socket_bind().
+
+If @iface is %NULL, the system will automatically pick an interface
+to bind to based on @group.
+
+If @source_specific is %TRUE, source-specific multicast as defined
+in RFC 4604 is used. Note that on older platforms this may fail
+with a %G_IO_ERROR_NOT_SUPPORTED error.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GInetAddress specifying the group address to join.
+</parameter_description>
+</parameter>
+<parameter name="iface">
+<parameter_description> Name of the interface to use, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="source_specific">
+<parameter_description> %TRUE if source-specific multicast should be used
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_leave_multicast_group">
+<description>
+Removes @socket from the multicast group defined by @group, @iface,
+and @source_specific (which must all have the same values they had
+when you joined the group).
+
+ socket remains bound to its address and port, and can still receive
+unicast messages after calling this.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="group">
+<parameter_description> a #GInetAddress specifying the group address to leave.
+</parameter_description>
+</parameter>
+<parameter name="iface">
+<parameter_description> Interface used
+</parameter_description>
+</parameter>
+<parameter name="source_specific">
+<parameter_description> %TRUE if source-specific multicast was used
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_listen">
+<description>
+Marks the socket as a server socket, i.e. a socket that is used
+to accept incoming requests using g_socket_accept().
+
+Before calling this the socket must be bound to a local address using
+g_socket_bind().
+
+To set the maximum amount of outstanding clients, use
+g_socket_set_listen_backlog().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_accept">
+<description>
+Blocks waiting for a client to connect to any of the sockets added
+to the listener. Returns a #GSocketConnection for the socket that was
+accepted.
+
+If @source_object is not %NULL it will be filled out with the source
+object specified when the corresponding socket or address was added
+to the listener.
+
+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.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> location where #GObject pointer will be stored, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_accept_async">
+<description>
+This is the asynchronous version of g_socket_listener_accept().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_listener_accept_socket()
+to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_listener_accept_finish">
+<description>
+Finishes an async accept operation. See g_socket_listener_accept_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocketConnection on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_accept_socket">
+<description>
+Blocks waiting for a client to connect to any of the sockets added
+to the listener. Returns the #GSocket that was accepted.
+
+If you want to accept the high-level #GSocketConnection, not a #GSocket,
+which is often the case, then you should use g_socket_listener_accept()
+instead.
+
+If @source_object is not %NULL it will be filled out with the source
+object specified when the corresponding socket or address was added
+to the listener.
+
+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.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> location where #GObject pointer will be stored, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_accept_socket_async">
+<description>
+This is the asynchronous version of g_socket_listener_accept_socket().
+
+When the operation is finished @callback will be
+called. You can then call g_socket_listener_accept_socket_finish()
+to get the result of the operation.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data for the callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_listener_accept_socket_finish">
+<description>
+Finishes an async accept operation. See g_socket_listener_accept_socket_async()
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket on success, %NULL on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_add_address">
+<description>
+Creates a socket of type @type and protocol @protocol, binds
+it to @address and adds it to the set of sockets we're accepting
+sockets from.
+
+Note that adding an IPv6 address, depending on the platform,
+may or may not result in a listener that also accepts IPv4
+connections. For more deterministic behavior, see
+g_socket_listener_add_inet_port().
+
+ source_object will be passed out in the various calls
+to accept to identify this particular source, which is
+useful if you're listening on multiple addresses and do
+different things depending on what address is connected to.
+
+If successful and @effective_address is non-%NULL then it will
+be set to the address that the binding actually occurred at. This
+is helpful for determining the port number that was used for when
+requesting a binding to port 0 (ie: "any port"). This address, if
+requested, belongs to the caller and must be freed.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> a #GSocketType
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> a #GSocketProtocol
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="effective_address">
+<parameter_description> location to store the address that was bound to, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_add_any_inet_port">
+<description>
+Listens for TCP connections on any available port number for both
+IPv6 and IPv4 (if each is available).
+
+This is useful if you need to have a socket for incoming connections
+but don't care about the specific port number.
+
+ source_object will be passed out in the various calls
+to accept to identify this particular source, which is
+useful if you're listening on multiple addresses and do
+different things depending on what address is connected to.
+
+Since: 2.24
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the port number, or 0 in case of failure.
+
+</return>
+</function>
+
+<function name="g_socket_listener_add_inet_port">
+<description>
+Helper function for g_socket_listener_add_address() that
+creates a TCP/IP socket listening on IPv4 and IPv6 (if
+supported) on the specified port on all interfaces.
+
+ source_object will be passed out in the various calls
+to accept to identify this particular source, which is
+useful if you're listening on multiple addresses and do
+different things depending on what address is connected to.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="port">
+<parameter_description> an IP port number (non-zero)
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_add_socket">
+<description>
+Adds @socket to the set of sockets that we try to accept
+new clients from. The socket must be bound to a local
+address and listened to.
+
+ source_object will be passed out in the various calls
+to accept to identify this particular source, which is
+useful if you're listening on multiple addresses and do
+different things depending on what address is connected to.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="socket">
+<parameter_description> a listening #GSocket
+</parameter_description>
+</parameter>
+<parameter name="source_object">
+<parameter_description> Optional #GObject identifying this source
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error.
+
+</return>
+</function>
+
+<function name="g_socket_listener_close">
+<description>
+Closes all the sockets in the listener.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_listener_new">
+<description>
+Creates a new #GSocketListener with no sockets to listen for.
+New listeners can be added with e.g. g_socket_listener_add_address()
+or g_socket_listener_add_inet_port().
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GSocketListener.
+
+</return>
+</function>
+
+<function name="g_socket_listener_set_backlog">
+<description>
+Sets the listen backlog on the sockets in the listener.
+
+See g_socket_set_listen_backlog() for details
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="listener">
+<parameter_description> a #GSocketListener
+</parameter_description>
+</parameter>
+<parameter name="listen_backlog">
+<parameter_description> an integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_new">
+<description>
+Creates a new #GSocket with the defined family, type and protocol.
+If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
+for the family and type is used.
+
+The @protocol is a family and type specific int that specifies what
+kind of protocol to use. #GSocketProtocol lists several common ones.
+Many families only support one protocol, and use 0 for this, others
+support several and using 0 means to use the default protocol for
+the family and type.
+
+The protocol id is passed directly to the operating
+system, so you can use protocols not listed in #GSocketProtocol if you
+know the protocol number used for it.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="family">
+<parameter_description> the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4.
+</parameter_description>
+</parameter>
+<parameter name="type">
+<parameter_description> the socket type to use.
+</parameter_description>
+</parameter>
+<parameter name="protocol">
+<parameter_description> the id of the protocol to use, or 0 for default.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_new_from_fd">
+<description>
+Creates a new #GSocket from a native file descriptor
+or winsock SOCKET handle.
+
+This reads all the settings from the file descriptor so that
+all properties should work. Note that the file descriptor
+will be set to non-blocking mode, independent on the blocking
+mode of the #GSocket.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="fd">
+<parameter_description> a native socket file descriptor.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GSocket or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
+<function name="g_socket_receive">
+<description>
+Receive data (up to @size bytes) from a socket. This is mainly used by
+connection-oriented sockets; it is identical to g_socket_receive_from()
+with @address set to %NULL.
+
+For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets,
+g_socket_receive() will always read either 0 or 1 complete messages from
+the socket. If the received message is too large to fit in @buffer, then
+the data beyond @size bytes will be discarded, without any explicit
+indication that this has occurred.
+
+For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any
+number of bytes, up to @size. If more than @size bytes have been
+received, the additional data will be returned in future calls to
+g_socket_receive().
+
+If the socket is in blocking mode the call will block until there
+is some data to receive, the connection is closed, or there is an
+error. If there is no data available and the socket is in
+non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error will be
+returned. To be notified when data is available, wait for the
+%G_IO_IN condition.
+
+On error -1 is returned and @error is set accordingly.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes you want to read from the socket
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes read, or 0 if the connection was closed by
+the peer, or -1 on error
+
+</return>
+</function>
+
+<function name="g_socket_receive_from">
+<description>
+Receive data (up to @size bytes) from a socket.
+
+If @address is non-%NULL then @address will be set equal to the
+source address of the received packet.
+ address is owned by the caller.
+
+See g_socket_receive() for additional information.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a pointer to a #GSocketAddress
+pointer, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to
+read data into (which should be at least @size bytes long).
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes you want to read from the socket
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes read, or 0 if the connection was closed by
+the peer, or -1 on error
+
+</return>
+</function>
+
+<function name="g_socket_receive_message">
+<description>
+Receive data from a socket. This is the most complicated and
+fully-featured version of this call. For easier use, see
+g_socket_receive() and g_socket_receive_from().
+
+If @address is non-%NULL then @address will be set equal to the
+source address of the received packet.
+ address is owned by the caller.
+
+ vector must point to an array of #GInputVector structs and
+ num_vectors must be the length of this array. These structs
+describe the buffers that received data will be scattered into.
+If @num_vectors is -1, then @vectors is assumed to be terminated
+by a #GInputVector with a %NULL buffer pointer.
+
+As a special case, if @num_vectors is 0 (in which case, @vectors
+may of course be %NULL), then a single byte is received and
+discarded. This is to facilitate the common practice of sending a
+single '\0' byte for the purposes of transferring ancillary data.
+
+ messages, if non-%NULL, will be set to point to a newly-allocated
+array of #GSocketControlMessage instances or %NULL if no such
+messages was received. These correspond to the control messages
+received from the kernel, one #GSocketControlMessage per message
+from the kernel. This array is %NULL-terminated and must be freed
+by the caller using g_free() after calling g_object_unref() on each
+element. If @messages is %NULL, any control messages received will
+be discarded.
+
+ num_messages, if non-%NULL, will be set to the number of control
+messages received.
+
+If both @messages and @num_messages are non-%NULL, then
+ num_messages gives the number of #GSocketControlMessage instances
+in @messages (ie: not including the %NULL terminator).
+
+ flags is an in/out parameter. The commonly available arguments
+for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too
+(and g_socket_receive_message() may pass system-specific flags out).
+
+As with g_socket_receive(), data may be discarded if @socket is
+%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
+provide enough buffer space to read a complete message. You can pass
+%G_SOCKET_MSG_PEEK in @flags to peek at the current message without
+removing it from the receive queue, but there is no portable way to find
+out the length of the message other than by reading it into a
+sufficiently-large buffer.
+
+If the socket is in blocking mode the call will block until there
+is some data to receive, the connection is closed, or there is an
+error. If there is no data available and the socket is in
+non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error will be
+returned. To be notified when data is available, wait for the
+%G_IO_IN condition.
+
+On error -1 is returned and @error is set accordingly.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a pointer to a #GSocketAddress
+pointer, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> an array of #GInputVector structs
+</parameter_description>
+</parameter>
+<parameter name="num_vectors">
+<parameter_description> the number of elements in @vectors, or -1
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> a pointer which
+may be filled with an array of #GSocketControlMessages, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> a pointer which will be filled with the number of
+elements in @messages, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> a pointer to an int containing #GSocketMsgFlags flags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes read, or 0 if the connection was closed by
+the peer, or -1 on error
+
+</return>
+</function>
+
+<function name="g_socket_receive_with_blocking">
+<description>
+This behaves exactly the same as g_socket_receive(), except that
+the choice of blocking or non-blocking behavior is determined by
+the @blocking argument rather than by @socket's properties.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into (which should be at least @size
+bytes long).
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes you want to read from the socket
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> whether to do blocking or non-blocking I/O
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes read, or 0 if the connection was closed by
+the peer, or -1 on error
+
+</return>
+</function>
+
+<function name="g_socket_send">
+<description>
+Tries to send @size bytes from @buffer on the socket. This is
+mainly used by connection-oriented sockets; it is identical to
+g_socket_send_to() with @address set to %NULL.
+
+If the socket is in blocking mode the call will block until there is
+space for the data in the socket queue. If there is no space available
+and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
+will be returned. To be notified when space is available, wait for the
+%G_IO_OUT condition. Note though that you may still receive
+%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
+notified of a %G_IO_OUT condition. (On Windows in particular, this is
+very common due to the way the underlying APIs work.)
+
+On error -1 is returned and @error is set accordingly.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer
+containing the data to send.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes to send
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written (which may be less than @size), or -1
+on error
+
+</return>
+</function>
+
+<function name="g_socket_send_message">
+<description>
+Send data to @address on @socket. This is the most complicated and
+fully-featured version of this call. For easier use, see
+g_socket_send() and g_socket_send_to().
+
+If @address is %NULL then the message is sent to the default receiver
+(set by g_socket_connect()).
+
+ vectors must point to an array of #GOutputVector structs and
+ num_vectors must be the length of this array. (If @num_vectors is -1,
+then @vectors is assumed to be terminated by a #GOutputVector with a
+%NULL buffer pointer.) The #GOutputVector structs describe the buffers
+that the sent data will be gathered from. Using multiple
+#GOutputVector<!-- -->s is more memory-efficient than manually copying
+data from multiple sources into a single buffer, and more
+network-efficient than making multiple calls to g_socket_send().
+
+ messages, if non-%NULL, is taken to point to an array of @num_messages
+#GSocketControlMessage instances. These correspond to the control
+messages to be sent on the socket.
+If @num_messages is -1 then @messages is treated as a %NULL-terminated
+array.
+
+ flags modify how the message is sent. The commonly available arguments
+for this are available in the #GSocketMsgFlags enum, but the
+values there are the same as the system values, and the flags
+are passed in as-is, so you can pass in system-specific flags too.
+
+If the socket is in blocking mode the call will block until there is
+space for the data in the socket queue. If there is no space available
+and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
+will be returned. To be notified when space is available, wait for the
+%G_IO_OUT condition. Note though that you may still receive
+%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
+notified of a %G_IO_OUT condition. (On Windows in particular, this is
+very common due to the way the underlying APIs work.)
+
+On error -1 is returned and @error is set accordingly.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="vectors">
+<parameter_description> an array of #GOutputVector structs
+</parameter_description>
+</parameter>
+<parameter name="num_vectors">
+<parameter_description> the number of elements in @vectors, or -1
+</parameter_description>
+</parameter>
+<parameter name="messages">
+<parameter_description> a pointer to an
+array of #GSocketControlMessages, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="num_messages">
+<parameter_description> number of elements in @messages, or -1.
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> an int containing #GSocketMsgFlags flags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written (which may be less than @size), or -1
+on error
+
+</return>
+</function>
+
+<function name="g_socket_send_to">
+<description>
+Tries to send @size bytes from @buffer to @address. If @address is
+%NULL then the message is sent to the default receiver (set by
+g_socket_connect()).
+
+See g_socket_send() for additional information.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="address">
+<parameter_description> a #GSocketAddress, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer
+containing the data to send.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes to send
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written (which may be less than @size), or -1
+on error
+
+</return>
+</function>
+
+<function name="g_socket_send_with_blocking">
+<description>
+This behaves exactly the same as g_socket_send(), except that
+the choice of blocking or non-blocking behavior is determined by
+the @blocking argument rather than by @socket's properties.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer
+containing the data to send.
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the number of bytes to send
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> whether to do blocking or non-blocking I/O
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a %GCancellable or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written (which may be less than @size), or -1
+on error
+
+</return>
+</function>
+
+<function name="g_socket_service_is_active">
+<description>
+Check whether the service is active or not. An active
+service will accept new clients that connect, while
+a non-active service will let connecting clients queue
+up until the service is started.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="service">
+<parameter_description> a #GSocketService
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the service is active, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_socket_service_new">
+<description>
+Creates a new #GSocketService with no sockets to listen for.
+New listeners can be added with e.g. g_socket_listener_add_address()
+or g_socket_listener_add_inet_port().
+
+Since: 2.22
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GSocketService.
+
+</return>
+</function>
+
+<function name="g_socket_service_start">
+<description>
+Starts the service, i.e. start accepting connections
+from the added sockets when the mainloop runs.
+
+This call is thread-safe, so it may be called from a thread
+handling an incoming client request.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="service">
+<parameter_description> a #GSocketService
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_service_stop">
+<description>
+Stops the service, i.e. stops accepting connections
+from the added sockets when the mainloop runs.
+
+This call is thread-safe, so it may be called from a thread
+handling an incoming client request.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="service">
+<parameter_description> a #GSocketService
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_blocking">
+<description>
+Sets the blocking mode of the socket. In blocking mode
+all operations block until they succeed or there is an error. In
+non-blocking mode all functions return results immediately or
+with a %G_IO_ERROR_WOULD_BLOCK error.
+
+All sockets are created in blocking mode. However, note that the
+platform level socket is always non-blocking, and blocking mode
+is a GSocket level feature.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> Whether to use blocking I/O or not.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_broadcast">
+<description>
+Sets whether @socket should allow sending to and receiving from
+broadcast addresses. This is %FALSE by default.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="broadcast">
+<parameter_description> whether @socket should allow sending to and receiving
+from broadcast addresses
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_keepalive">
+<description>
+Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
+this flag is set on a socket, the system will attempt to verify that the
+remote socket endpoint is still present if a sufficiently long period of
+time passes with no data being exchanged. If the system is unable to
+verify the presence of the remote endpoint, it will automatically close
+the connection.
+
+This option is only functional on certain kinds of sockets. (Notably,
+%G_SOCKET_PROTOCOL_TCP sockets.)
+
+The exact time between pings is system- and protocol-dependent, but will
+normally be at least two hours. Most commonly, you would set this flag
+on a server socket if you want to allow clients to remain idle for long
+periods of time, but also want to ensure that connections are eventually
+garbage-collected if clients crash or become unreachable.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="keepalive">
+<parameter_description> Value for the keepalive flag
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_listen_backlog">
+<description>
+Sets the maximum number of outstanding connections allowed
+when listening on this socket. If more clients than this are
+connecting to the socket and the application is not handling them
+on time then the new connections will be refused.
+
+Note that this must be called before g_socket_listen() and has no
+effect if called after that.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="backlog">
+<parameter_description> the maximum number of pending connections.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_multicast_loopback">
+<description>
+Sets whether outgoing multicast packets will be received by sockets
+listening on that multicast address on the same host. This is %TRUE
+by default.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="loopback">
+<parameter_description> whether @socket should receive messages sent to its
+multicast groups from the local host
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_multicast_ttl">
+<description>
+Sets the time-to-live for outgoing multicast datagrams on @socket.
+By default, this is 1, meaning that multicast packets will not leave
+the local network.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="ttl">
+<parameter_description> the time-to-live value for all multicast datagrams on @socket
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_timeout">
+<description>
+Sets the time in seconds after which I/O operations on @socket will
+time out if they have not yet completed.
+
+On a blocking socket, this means that any blocking #GSocket
+operation will time out after @timeout seconds of inactivity,
+returning %G_IO_ERROR_TIMED_OUT.
+
+On a non-blocking socket, calls to g_socket_condition_wait() will
+also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources
+created with g_socket_create_source() will trigger after
+ timeout seconds of inactivity, with the requested condition
+set, at which point calling g_socket_receive(), g_socket_send(),
+g_socket_check_connect_result(), etc, will fail with
+%G_IO_ERROR_TIMED_OUT.
+
+If @timeout is 0 (the default), operations will never time out
+on their own.
+
+Note that if an I/O operation is interrupted by a signal, this may
+cause the timeout to be reset.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the timeout for @socket, in seconds, or 0 for none
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_set_ttl">
+<description>
+Sets the time-to-live for outgoing unicast packets on @socket.
+By default the platform-specific default value is used.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket.
+</parameter_description>
+</parameter>
+<parameter name="ttl">
+<parameter_description> the time-to-live value for all unicast packets on @socket
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_socket_shutdown">
+<description>
+Shut down part of a full-duplex connection.
+
+If @shutdown_read is %TRUE then the receiving side of the connection
+is shut down, and further reading is disallowed.
+
+If @shutdown_write is %TRUE then the sending side of the connection
+is shut down, and further writing is disallowed.
+
+It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
+
+One example where this is used is graceful disconnect for TCP connections
+where you close the sending side, then wait for the other side to close
+the connection, thus ensuring that the other side saw all sent data.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+<parameter name="shutdown_read">
+<parameter_description> whether to shut down the read side
+</parameter_description>
+</parameter>
+<parameter name="shutdown_write">
+<parameter_description> whether to shut down the write side
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE on error
+
+</return>
+</function>
+
+<function name="g_socket_speaks_ipv4">
+<description>
+Checks if a socket is capable of speaking IPv4.
+
+IPv4 sockets are capable of speaking IPv4. On some operating systems
+and under some combinations of circumstances IPv6 sockets are also
+capable of speaking IPv4. See RFC 3493 section 3.7 for more
+information.
+
+No other types of sockets are currently considered as being capable
+of speaking IPv4.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="socket">
+<parameter_description> a #GSocket
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if this socket can be used with IPv4.
+
+</return>
+</function>
+
+<function name="g_srv_target_copy">
+<description>
+Copies @target
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> a copy of @target
+
+</return>
+</function>
+
+<function name="g_srv_target_free">
+<description>
+Frees @target
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_srv_target_get_hostname">
+<description>
+Gets @target's hostname (in ASCII form; if you are going to present
+this to the user, you should use g_hostname_is_ascii_encoded() to
+check if it contains encoded Unicode segments, and use
+g_hostname_to_unicode() to convert it if it does.)
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> @target's hostname
+
+</return>
+</function>
+
+<function name="g_srv_target_get_port">
+<description>
+Gets @target's port
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> @target's port
+
+</return>
+</function>
+
+<function name="g_srv_target_get_priority">
+<description>
+Gets @target's priority. You should not need to look at this;
+#GResolver already sorts the targets according to the algorithm in
+RFC 2782.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> @target's priority
+
+</return>
+</function>
+
+<function name="g_srv_target_get_weight">
+<description>
+Gets @target's weight. You should not need to look at this;
+#GResolver already sorts the targets according to the algorithm in
+RFC 2782.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="target">
+<parameter_description> a #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> @target's weight
+
+</return>
+</function>
+
+<function name="g_srv_target_list_sort">
+<description>
+Sorts @targets in place according to the algorithm in RFC 2782.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="targets">
+<parameter_description> a #GList of #GSrvTarget
+</parameter_description>
+</parameter>
+</parameters>
+<return> the head of the sorted list.
+
+</return>
+</function>
+
+<function name="g_srv_target_new">
+<description>
+Creates a new #GSrvTarget with the given parameters.
+
+You should not need to use this; normally #GSrvTarget<!-- -->s are
+created by #GResolver.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="hostname">
+<parameter_description> the host that the service is running on
+</parameter_description>
+</parameter>
+<parameter name="port">
+<parameter_description> the port that the service is running on
+</parameter_description>
+</parameter>
+<parameter name="priority">
+<parameter_description> the target's priority
+</parameter_description>
+</parameter>
+<parameter name="weight">
+<parameter_description> the target's weight
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSrvTarget.
+
+</return>
+</function>
+
+<function name="g_static_resource_fini">
+<description>
+Finalized a GResource initialized by g_static_resource_init ().
+
+This is normally used by code generated by
+<link linkend="glib-compile-resources">glib-compile-resources</link> and is
+not typically used by other code.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="static_resource">
+<parameter_description> pointer to a static #GStaticResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_static_resource_get_resource">
+<description>
+Gets the GResource that was registred by a call to g_static_resource_init ().
+
+This is normally used by code generated by
+<link linkend="glib-compile-resources">glib-compile-resources</link> and is
+not typically used by other code.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="static_resource">
+<parameter_description> pointer to a static #GStaticResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GResource.
+
+</return>
+</function>
+
+<function name="g_static_resource_init">
+<description>
+Initializes a GResource from static data using a
+GStaticResource.
+
+This is normally used by code generated by
+<link linkend="glib-compile-resources">glib-compile-resources</link> and is
+not typically used by other code.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="static_resource">
+<parameter_description> pointer to a static #GStaticResource.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_tcp_connection_get_graceful_disconnect">
+<description>
+Checks if graceful disconnects are used. See
+g_tcp_connection_set_graceful_disconnect().
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GTcpConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if graceful disconnect is used on close, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="g_tcp_connection_set_graceful_disconnect">
+<description>
+This enabled graceful disconnects on close. A graceful disconnect
+means that we signal the receiving end that the connection is terminated
+and wait for it to close the connection before closing the connection.
+
+A graceful disconnect means that we can be sure that we successfully sent
+all the outstanding data to the other end, or get an error reported.
+However, it also means we have to wait for all the data to reach the
+other side and for it to acknowledge this by closing the socket, which may
+take a while. For this reason it is disabled by default.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> a #GTcpConnection
+</parameter_description>
+</parameter>
+<parameter name="graceful_disconnect">
+<parameter_description> Whether to do graceful disconnects or not
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_tcp_wrapper_connection_get_base_io_stream">
+<description>
+Get's @conn's base #GIOStream
+
+
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> a #GTcpWrapperConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> @conn's base #GIOStream
+</return>
+</function>
+
+<function name="g_tcp_wrapper_connection_new">
+<description>
+Wraps @base_io_stream and @socket together as a #GSocketConnection.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="base_io_stream">
+<parameter_description> the #GIOStream to wrap
+</parameter_description>
+</parameter>
+<parameter name="socket">
+<parameter_description> the #GSocket associated with @base_io_stream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GSocketConnection.
+
+</return>
+</function>
+
+<function name="g_themed_icon_append_name">
+<description>
+Append a name to the list of icons from within @icon.
+
+<note><para>
+Note that doing so invalidates the hash computed by prior calls
+to g_icon_hash().
+</para></note>
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GThemedIcon
+</parameter_description>
+</parameter>
+<parameter name="iconname">
+<parameter_description> name of icon to append to list of icons from within @icon.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_themed_icon_get_names">
+<description>
+Gets the names of icons from within @icon.
+
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GThemedIcon.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a list of icon names.
+</return>
+</function>
+
+<function name="g_themed_icon_new">
+<description>
+Creates a new themed icon for @iconname.
+
+
+</description>
+<parameters>
+<parameter name="iconname">
+<parameter_description> a string containing an icon name.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GThemedIcon.
+</return>
+</function>
+
+<function name="g_themed_icon_new_from_names">
+<description>
+Creates a new themed icon for @iconnames.
+
+
+</description>
+<parameters>
+<parameter name="iconnames">
+<parameter_description> an array of strings containing icon names.
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the length of the @iconnames array, or -1 if @iconnames is
+%NULL-terminated
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GThemedIcon
+</return>
+</function>
+
+<function name="g_themed_icon_new_with_default_fallbacks">
+<description>
+Creates a new themed icon for @iconname, and all the names
+that can be created by shortening @iconname at '-' characters.
+
+In the following example, @icon1 and @icon2 are equivalent:
+|[
+const char *names[] = {
+"gnome-dev-cdrom-audio",
+"gnome-dev-cdrom",
+"gnome-dev",
+"gnome"
+};
+
+icon1 = g_themed_icon_new_from_names (names, 4);
+icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
+]|
+
+
+</description>
+<parameters>
+<parameter name="iconname">
+<parameter_description> a string containing an icon name
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GThemedIcon.
+</return>
+</function>
+
+<function name="g_themed_icon_prepend_name">
+<description>
+Prepend a name to the list of icons from within @icon.
+
+<note><para>
+Note that doing so invalidates the hash computed by prior calls
+to g_icon_hash().
+</para></note>
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> a #GThemedIcon
+</parameter_description>
+</parameter>
+<parameter name="iconname">
+<parameter_description> name of icon to prepend to list of icons from within @icon.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_threaded_socket_service_new">
+<description>
+Creates a new #GThreadedSocketService with no listeners. Listeners
+must be added with one of the #GSocketListener "add" methods.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="max_threads">
+<parameter_description> the maximal number of threads to execute concurrently
+handling incoming clients, -1 means no limit
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GSocketService.
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_certificate_type">
+<description>
+Gets the #GType of @backend's #GTlsCertificate implementation.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GType of @backend's #GTlsCertificate
+implementation.
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_client_connection_type">
+<description>
+Gets the #GType of @backend's #GTlsClientConnection implementation.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GType of @backend's #GTlsClientConnection
+implementation.
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_default">
+<description>
+Gets the default #GTlsBackend for the system.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> a #GTlsBackend
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_default_database">
+<description>
+Gets the default #GTlsDatabase used to verify TLS connections.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the default database, which should be
+unreffed when done.
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_file_database_type">
+<description>
+Gets the #GTyep of @backend's #GTlsFileDatabase implementation.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GType of backend's #GTlsFileDatabase implementation.
+
+</return>
+</function>
+
+<function name="g_tls_backend_get_server_connection_type">
+<description>
+Gets the #GType of @backend's #GTlsServerConnection implementation.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GType of @backend's #GTlsServerConnection
+implementation.
+
+</return>
+</function>
+
+<function name="g_tls_backend_supports_tls">
+<description>
+Checks if TLS is supported; if this returns %FALSE for the default
+#GTlsBackend, it means no "real" TLS backend is available.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="backend">
+<parameter_description> the #GTlsBackend
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether or not TLS is supported
+
+</return>
+</function>
+
+<function name="g_tls_certificate_get_issuer">
+<description>
+Gets the #GTlsCertificate representing @cert's issuer, if known
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="cert">
+<parameter_description> a #GTlsCertificate
+</parameter_description>
+</parameter>
+</parameters>
+<return> The certificate of @cert's issuer,
+or %NULL if @cert is self-signed or signed with an unknown
+certificate.
+
+</return>
+</function>
+
+<function name="g_tls_certificate_list_new_from_file">
+<description>
+Creates one or more #GTlsCertificate<!-- -->s from the PEM-encoded
+data in @file. If @file cannot be read or parsed, the function will
+return %NULL and set @error. If @file does not contain any
+PEM-encoded certificates, this will return an empty list and not
+set @error.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> file containing PEM-encoded certificates to import
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a
+#GList containing #GTlsCertificate objects. You must free the list
+and its contents when you are done with it.
+
+</return>
+</function>
+
+<function name="g_tls_certificate_new_from_file">
+<description>
+Creates a #GTlsCertificate from the PEM-encoded data in @file. If
+ file cannot be read or parsed, the function will return %NULL and
+set @error. Otherwise, this behaves like
+g_tls_certificate_new_from_pem().
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> file containing a PEM-encoded certificate to import
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new certificate, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_tls_certificate_new_from_files">
+<description>
+Creates a #GTlsCertificate from the PEM-encoded data in @cert_file
+and @key_file. If either file cannot be read or parsed, the
+function will return %NULL and set @error. Otherwise, this behaves
+like g_tls_certificate_new_from_pem().
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="cert_file">
+<parameter_description> file containing a PEM-encoded certificate to import
+</parameter_description>
+</parameter>
+<parameter name="key_file">
+<parameter_description> file containing a PEM-encoded private key to import
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new certificate, or %NULL on error
+
+</return>
+</function>
+
+<function name="g_tls_certificate_new_from_pem">
+<description>
+Creates a new #GTlsCertificate from the PEM-encoded data in @data.
+If @data includes both a certificate and a private key, then the
+returned certificate will include the private key data as well. (See
+the #GTlsCertificate:private-key-pem property for information about
+supported formats.)
+
+If @data includes multiple certificates, only the first one will be
+parsed.
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> PEM-encoded certificate data
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @data, or -1 if it's 0-terminated.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new certificate, or %NULL if @data is invalid
+
+</return>
+</function>
+
+<function name="g_tls_certificate_verify">
+<description>
+This verifies @cert and returns a set of #GTlsCertificateFlags
+indicating any problems found with it. This can be used to verify a
+certificate outside the context of making a connection, or to
+check a certificate against a CA that is not part of the system
+CA database.
+
+If @identity is not %NULL, @cert's name(s) will be compared against
+it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
+value if it does not match. If @identity is %NULL, that bit will
+never be set in the return value.
+
+If @trusted_ca is not %NULL, then @cert (or one of the certificates
+in its chain) must be signed by it, or else
+%G_TLS_CERTIFICATE_UNKNOWN_CA will be set in the return value. If
+ trusted_ca is %NULL, that bit will never be set in the return
+value.
-All sockets are created in blocking mode. However, note that the
-platform level socket is always non-blocking, and blocking mode
-is a GSocket level feature.
+(All other #GTlsCertificateFlags values will always be set or unset
+as appropriate.)
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
+<parameter name="cert">
+<parameter_description> a #GTlsCertificate
</parameter_description>
</parameter>
-<parameter name="blocking">
-<parameter_description> Whether to use blocking I/O or not.
+<parameter name="identity">
+<parameter_description> the expected peer identity
+</parameter_description>
+</parameter>
+<parameter name="trusted_ca">
+<parameter_description> the certificate of a trusted authority
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the appropriate #GTlsCertificateFlags
+
+</return>
</function>
-<function name="g_socket_set_keepalive">
+<function name="g_tls_client_connection_get_accepted_cas">
<description>
-Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
-this flag is set on a socket, the system will attempt to verify that the
-remote socket endpoint is still present if a sufficiently long period of
-time passes with no data being exchanged. If the system is unable to
-verify the presence of the remote endpoint, it will automatically close
-the connection.
-
-This option is only functional on certain kinds of sockets. (Notably,
-%G_SOCKET_PROTOCOL_TCP sockets.)
+Gets the list of distinguished names of the Certificate Authorities
+that the server will accept certificates from. This will be set
+during the TLS handshake if the server requests a certificate.
+Otherwise, it will be %NULL.
-The exact time between pings is system- and protocol-dependent, but will
-normally be at least two hours. Most commonly, you would set this flag
-on a server socket if you want to allow clients to remain idle for long
-periods of time, but also want to ensure that connections are eventually
-garbage-collected if clients crash or become unreachable.
+Each item in the list is a #GByteArray which contains the complete
+subject DN of the certificate authority.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
-</parameter_description>
-</parameter>
-<parameter name="keepalive">
-<parameter_description> Value for the keepalive flag
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the list of
+CA DNs. You should unref each element with g_byte_array_unref() and then
+the free the list with g_list_free().
+
+</return>
</function>
-<function name="g_socket_set_listen_backlog">
+<function name="g_tls_client_connection_get_server_identity">
<description>
-Sets the maximum number of outstanding connections allowed
-when listening on this socket. If more clients than this are
-connecting to the socket and the application is not handling them
-on time then the new connections will be refused.
-
-Note that this must be called before g_socket_listen() and has no
-effect if called after that.
+Gets @conn's expected server identity
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
-</parameter_description>
-</parameter>
-<parameter name="backlog">
-<parameter_description> the maximum number of pending connections.
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GSocketConnectable describing the
+expected server identity, or %NULL if the expected identity is not
+known.
+
+</return>
</function>
-<function name="g_socket_set_timeout">
+<function name="g_tls_client_connection_get_use_ssl3">
<description>
-Sets the time in seconds after which I/O operations on @socket will
-time out if they have not yet completed.
-
-On a blocking socket, this means that any blocking #GSocket
-operation will time out after @timeout seconds of inactivity,
-returning %G_IO_ERROR_TIMED_OUT.
-
-On a non-blocking socket, calls to g_socket_condition_wait() will
-also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources
-created with g_socket_create_source() will trigger after
- timeout seconds of inactivity, with the requested condition
-set, at which point calling g_socket_receive(), g_socket_send(),
-g_socket_check_connect_result(), etc, will fail with
-%G_IO_ERROR_TIMED_OUT.
-
-If @timeout is 0 (the default), operations will never time out
-on their own.
-
-Note that if an I/O operation is interrupted by a signal, this may
-cause the timeout to be reset.
+Gets whether @conn will use SSL 3.0 rather than the
+highest-supported version of TLS; see
+g_tls_client_connection_set_use_ssl3().
-Since: 2.26
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket.
-</parameter_description>
-</parameter>
-<parameter name="timeout">
-<parameter_description> the timeout for @socket, in seconds, or 0 for none
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> whether @conn will use SSL 3.0
+
+</return>
</function>
-<function name="g_socket_shutdown">
+<function name="g_tls_client_connection_get_validation_flags">
<description>
-Shut down part of a full-duplex connection.
+Gets @conn's validation flags
-If @shutdown_read is %TRUE then the recieving side of the connection
-is shut down, and further reading is disallowed.
+Since: 2.28
-If @shutdown_write is %TRUE then the sending side of the connection
-is shut down, and further writing is disallowed.
+</description>
+<parameters>
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
+</parameter_description>
+</parameter>
+</parameters>
+<return> the validation flags
-It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
+</return>
+</function>
-One example where this is used is graceful disconnect for TCP connections
-where you close the sending side, then wait for the other side to close
-the connection, thus ensuring that the other side saw all sent data.
+<function name="g_tls_client_connection_new">
+<description>
+Creates a new #GTlsClientConnection wrapping @base_io_stream (which
+must have pollable input and output streams) which is assumed to
+communicate with the server identified by @server_identity.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
-</parameter_description>
-</parameter>
-<parameter name="shutdown_read">
-<parameter_description> whether to shut down the read side
+<parameter name="base_io_stream">
+<parameter_description> the #GIOStream to wrap
</parameter_description>
</parameter>
-<parameter name="shutdown_write">
-<parameter_description> whether to shut down the write side
+<parameter name="server_identity">
+<parameter_description> the expected identity of the server
</parameter_description>
</parameter>
<parameter name="error">
@@ -28965,1300 +52125,1541 @@ Since: 2.22
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on error
+<return> the new
+#GTlsClientConnection, or %NULL on error
</return>
</function>
-<function name="g_socket_speaks_ipv4">
+<function name="g_tls_client_connection_set_server_identity">
<description>
-Checks if a socket is capable of speaking IPv4.
-
-IPv4 sockets are capable of speaking IPv4. On some operating systems
-and under some combinations of circumstances IPv6 sockets are also
-capable of speaking IPv4. See RFC 3493 section 3.7 for more
-information.
-
-No other types of sockets are currently considered as being capable
-of speaking IPv4.
+Sets @conn's expected server identity, which is used both to tell
+servers on virtual hosts which certificate to present, and also
+to let @conn know what name to look for in the certificate when
+performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="socket">
-<parameter_description> a #GSocket
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
+</parameter_description>
+</parameter>
+<parameter name="identity">
+<parameter_description> a #GSocketConnectable describing the expected server identity
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if this socket can be used with IPv4.
-
-</return>
+<return></return>
</function>
-<function name="g_srv_target_copy">
+<function name="g_tls_client_connection_set_use_ssl3">
<description>
-Copies @target
+If @use_ssl3 is %TRUE, this forces @conn to use SSL 3.0 rather than
+trying to properly negotiate the right version of TLS or SSL to use.
+This can be used when talking to servers that do not implement the
+fallbacks correctly and which will therefore fail to handshake with
+a "modern" TLS handshake attempt.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
+</parameter_description>
+</parameter>
+<parameter name="use_ssl3">
+<parameter_description> whether to use SSL 3.0
</parameter_description>
</parameter>
</parameters>
-<return> a copy of @target
-
-</return>
+<return></return>
</function>
-<function name="g_srv_target_free">
+<function name="g_tls_client_connection_set_validation_flags">
<description>
-Frees @target
+Sets @conn's validation flags, to override the default set of
+checks performed when validating a server certificate. By default,
+%G_TLS_CERTIFICATE_VALIDATE_ALL is used.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> the #GTlsClientConnection
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the #GTlsCertificateFlags to use
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_srv_target_get_hostname">
+<function name="g_tls_connection_emit_accept_certificate">
<description>
-Gets @target's hostname (in ASCII form; if you are going to present
-this to the user, you should use g_hostname_is_ascii_encoded() to
-check if it contains encoded Unicode segments, and use
-g_hostname_to_unicode() to convert it if it does.)
+Used by #GTlsConnection implementations to emit the
+#GTlsConnection::accept-certificate signal.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="peer_cert">
+<parameter_description> the peer's #GTlsCertificate
+</parameter_description>
+</parameter>
+<parameter name="errors">
+<parameter_description> the problems with @peer_cert
</parameter_description>
</parameter>
</parameters>
-<return> @target's hostname
+<return> %TRUE if one of the signal handlers has returned
+%TRUE to accept @peer_cert
</return>
</function>
-<function name="g_srv_target_get_port">
+<function name="g_tls_connection_get_certificate">
<description>
-Gets @target's port
+Gets @conn's certificate, as set by
+g_tls_connection_set_certificate().
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> @target's port
+<return> @conn's certificate, or %NULL
</return>
</function>
-<function name="g_srv_target_get_priority">
+<function name="g_tls_connection_get_database">
<description>
-Gets @target's priority. You should not need to look at this;
-#GResolver already sorts the targets according to the algorithm in
-RFC 2782.
+Gets the certificate database that @conn uses to verify
+peer certificates. See g_tls_connection_set_database().
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> @target's priority
+<return> the certificate database that @conn uses or %NULL
</return>
</function>
-<function name="g_srv_target_get_weight">
+<function name="g_tls_connection_get_interaction">
<description>
-Gets @target's weight. You should not need to look at this;
-#GResolver already sorts the targets according to the algorithm in
-RFC 2782.
+Get the object that will be used to interact with the user. It will be used
+for things like prompting the user for passwords. If %NULL is returned, then
+no user interaction will occur for this connection.
-Since: 2.22
+Since: 2.30
</description>
<parameters>
-<parameter name="target">
-<parameter_description> a #GSrvTarget
+<parameter name="conn">
+<parameter_description> a connection
</parameter_description>
</parameter>
</parameters>
-<return> @target's weight
+<return> The interaction object.
</return>
</function>
-<function name="g_srv_target_list_sort">
+<function name="g_tls_connection_get_peer_certificate">
<description>
-Sorts @targets in place according to the algorithm in RFC 2782.
+Gets @conn's peer's certificate after the handshake has completed.
+(It is not set during the emission of
+#GTlsConnection::accept-certificate.)
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="targets">
-<parameter_description> a #GList of #GSrvTarget
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> the head of the sorted list.
+<return> @conn's peer's certificate, or %NULL
</return>
</function>
-<function name="g_srv_target_new">
+<function name="g_tls_connection_get_peer_certificate_errors">
<description>
-Creates a new #GSrvTarget with the given parameters.
-
-You should not need to use this; normally #GSrvTarget<!-- -->s are
-created by #GResolver.
+Gets the errors associated with validating @conn's peer's
+certificate, after the handshake has completed. (It is not set
+during the emission of #GTlsConnection::accept-certificate.)
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="hostname">
-<parameter_description> the host that the service is running on
-</parameter_description>
-</parameter>
-<parameter name="port">
-<parameter_description> the port that the service is running on
-</parameter_description>
-</parameter>
-<parameter name="priority">
-<parameter_description> the target's priority
-</parameter_description>
-</parameter>
-<parameter name="weight">
-<parameter_description> the target's weight
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> a new #GSrvTarget.
+<return> @conn's peer's certificate errors
</return>
</function>
-<function name="g_tcp_connection_get_graceful_disconnect">
+<function name="g_tls_connection_get_rehandshake_mode">
<description>
-Checks if graceful disconnects are used. See
-g_tcp_connection_set_graceful_disconnect().
+Gets @conn rehandshaking mode. See
+g_tls_connection_set_rehandshake_mode() for details.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GTcpConnection
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if graceful disconnect is used on close, %FALSE otherwise
+<return> @conn's rehandshaking mode
</return>
</function>
-<function name="g_tcp_connection_set_graceful_disconnect">
+<function name="g_tls_connection_get_require_close_notify">
<description>
-This enabled graceful disconnects on close. A graceful disconnect
-means that we signal the recieving end that the connection is terminated
-and wait for it to close the connection before closing the connection.
-
-A graceful disconnect means that we can be sure that we successfully sent
-all the outstanding data to the other end, or get an error reported.
-However, it also means we have to wait for all the data to reach the
-other side and for it to acknowledge this by closing the socket, which may
-take a while. For this reason it is disabled by default.
+Tests whether or not @conn expects a proper TLS close notification
+when the connection is closed. See
+g_tls_connection_set_require_close_notify() for details.
-Since: 2.22
+Since: 2.28
</description>
<parameters>
-<parameter name="connection">
-<parameter_description> a #GTcpConnection
-</parameter_description>
-</parameter>
-<parameter name="graceful_disconnect">
-<parameter_description> Whether to do graceful disconnects or not
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE if @conn requires a proper TLS close
+notification.
+
+</return>
</function>
-<function name="g_tcp_wrapper_connection_get_base_io_stream">
+<function name="g_tls_connection_get_use_system_certdb">
<description>
-Get's @conn's base #GIOStream
+Gets whether @conn uses the system certificate database to verify
+peer certificates. See g_tls_connection_set_use_system_certdb().
+Deprecated: 2.30: Use g_tls_connection_get_database() instead
</description>
<parameters>
<parameter name="conn">
-<parameter_description> a #GTcpWrapperConnection
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
</parameters>
-<return> @conn's base #GIOStream
+<return> whether @conn uses the system certificate database
+
</return>
</function>
-<function name="g_tcp_wrapper_connection_new">
+<function name="g_tls_connection_handshake">
<description>
-Wraps @base_io_stream and @socket together as a #GSocketConnection.
+Attempts a TLS handshake on @conn.
+
+On the client side, it is never necessary to call this method;
+although the connection needs to perform a handshake after
+connecting (or after sending a "STARTTLS"-type command) and may
+need to rehandshake later if the server requests it,
+#GTlsConnection will handle this for you automatically when you try
+to send or receive data on the connection. However, you can call
+g_tls_connection_handshake() manually if you want to know for sure
+whether the initial handshake succeeded or failed (as opposed to
+just immediately trying to write to @conn's output stream, in which
+case if it fails, it may not be possible to tell if it failed
+before or after completing the handshake).
+
+Likewise, on the server side, although a handshake is necessary at
+the beginning of the communication, you do not need to call this
+function explicitly unless you want clearer error reporting.
+However, you may call g_tls_connection_handshake() later on to
+renegotiate parameters (encryption methods, etc) with the client.
+
+#GTlsConnection::accept_certificate may be emitted during the
+handshake.
Since: 2.28
</description>
<parameters>
-<parameter name="base_io_stream">
-<parameter_description> the #GIOStream to wrap
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
-<parameter name="socket">
-<parameter_description> the #GSocket associated with @base_io_stream
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the new #GSocketConnection.
+<return> success or failure
</return>
</function>
-<function name="g_themed_icon_append_name">
+<function name="g_tls_connection_handshake_async">
<description>
-Append a name to the list of icons from within @icon.
+Asynchronously performs a TLS handshake on @conn. See
+g_tls_connection_handshake() for more information.
-<note><para>
-Note that doing so invalidates the hash computed by prior calls
-to g_icon_hash().
-</para></note>
+Since: 2.28
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GThemedIcon
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
-<parameter name="iconname">
-<parameter_description> name of icon to append to list of icons from within @icon.
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the handshake is complete
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_themed_icon_get_names">
+<function name="g_tls_connection_handshake_finish">
<description>
-Gets the names of icons from within @icon.
+Finish an asynchronous TLS handshake operation. See
+g_tls_connection_handshake() for more information.
+Since: 2.28
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GThemedIcon.
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
-</parameters>
-<return> a list of icon names.
-</return>
-</function>
-
-<function name="g_themed_icon_new">
-<description>
-Creates a new themed icon for @iconname.
-
-
-</description>
-<parameters>
-<parameter name="iconname">
-<parameter_description> a string containing an icon name.
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GThemedIcon.
+<return> %TRUE on success, %FALSE on failure, in which
+case @error will be set.
+
</return>
</function>
-<function name="g_themed_icon_new_from_names">
+<function name="g_tls_connection_set_certificate">
<description>
-Creates a new themed icon for @iconnames.
+This sets the certificate that @conn will present to its peer
+during the TLS handshake. For a #GTlsServerConnection, it is
+mandatory to set this, and that will normally be done at construct
+time.
+
+For a #GTlsClientConnection, this is optional. If a handshake fails
+with %G_TLS_ERROR_CERTIFICATE_REQUIRED, that means that the server
+requires a certificate, and if you try connecting again, you should
+call this method first. You can call
+g_tls_client_connection_get_accepted_cas() on the failed connection
+to get a list of Certificate Authorities that the server will
+accept certificates from.
+
+(It is also possible that a server will allow the connection with
+or without a certificate; in that case, if you don't provide a
+certificate, you can tell that the server requested one by the fact
+that g_tls_client_connection_get_accepted_cas() will return
+non-%NULL.)
+Since: 2.28
</description>
<parameters>
-<parameter name="iconnames">
-<parameter_description> an array of strings containing icon names.
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
</parameter_description>
</parameter>
-<parameter name="len">
-<parameter_description> the length of the @iconnames array, or -1 if @iconnames is
-%NULL-terminated
+<parameter name="certificate">
+<parameter_description> the certificate to use for @conn
</parameter_description>
</parameter>
</parameters>
-<return> a new #GThemedIcon
-</return>
+<return></return>
</function>
-<function name="g_themed_icon_new_with_default_fallbacks">
+<function name="g_tls_connection_set_database">
<description>
-Creates a new themed icon for @iconname, and all the names
-that can be created by shortening @iconname at '-' characters.
-
-In the following example, @icon1 and @icon2 are equivalent:
-|[
-const char *names[] = {
-"gnome-dev-cdrom-audio",
-"gnome-dev-cdrom",
-"gnome-dev",
-"gnome"
-};
-
-icon1 = g_themed_icon_new_from_names (names, 4);
-icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
-]|
+Sets the certificate database that is used to verify peer certificates.
+This is set to the default database by default. See
+g_tls_backend_get_default_database(). If set to %NULL, then
+peer certificate validation will always set the
+%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
+#GTlsConnection::accept-certificate will always be emitted on
+client-side connections, unless that bit is not set in
+#GTlsClientConnection:validation-flags).
+Since: 2.30
</description>
<parameters>
-<parameter name="iconname">
-<parameter_description> a string containing an icon name
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="database">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
</parameters>
-<return> a new #GThemedIcon.
-</return>
+<return></return>
</function>
-<function name="g_themed_icon_prepend_name">
+<function name="g_tls_connection_set_interaction">
<description>
-Prepend a name to the list of icons from within @icon.
+Set the object that will be used to interact with the user. It will be used
+for things like prompting the user for passwords.
-<note><para>
-Note that doing so invalidates the hash computed by prior calls
-to g_icon_hash().
-</para></note>
+The @interaction argument will normally be a derived subclass of
+#GTlsInteraction. %NULL can also be provided if no user interaction
+should occur for this connection.
-Since: 2.18
+Since: 2.30
</description>
<parameters>
-<parameter name="icon">
-<parameter_description> a #GThemedIcon
+<parameter name="conn">
+<parameter_description> a connection
</parameter_description>
</parameter>
-<parameter name="iconname">
-<parameter_description> name of icon to prepend to list of icons from within @icon.
+<parameter name="interaction">
+<parameter_description> an interaction object, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_threaded_socket_service_new">
+<function name="g_tls_connection_set_rehandshake_mode">
<description>
-Creates a new #GThreadedSocketService with no listeners. Listeners
-must be added with g_socket_service_add_listeners().
-
-Since: 2.22
+Sets how @conn behaves with respect to rehandshaking requests.
-</description>
-<parameters>
-<parameter name="max_threads">
-<parameter_description> the maximal number of threads to execute concurrently
-handling incoming clients, -1 means no limit
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GSocketService.
+%G_TLS_REHANDSHAKE_NEVER means that it will never agree to
+rehandshake after the initial handshake is complete. (For a client,
+this means it will refuse rehandshake requests from the server, and
+for a server, this means it will close the connection with an error
+if the client attempts to rehandshake.)
-</return>
-</function>
+%G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a
+rehandshake only if the other end of the connection supports the
+TLS <literal>renegotiation_info</literal> extension. This is the
+default behavior, but means that rehandshaking will not work
+against older implementations that do not support that extension.
-<function name="g_tls_backend_get_certificate_type">
-<description>
-Gets the #GType of @backend's #GTlsCertificate implementation.
+%G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow
+rehandshaking even without the
+<literal>renegotiation_info</literal> extension. On the server side
+in particular, this is not recommended, since it leaves the server
+open to certain attacks. However, this mode is necessary if you
+need to allow renegotiation with older client software.
Since: 2.28
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> the #GTlsBackend
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> the rehandshaking mode
</parameter_description>
</parameter>
</parameters>
-<return> the #GType of @backend's #GTlsCertificate
-implementation.
-
-</return>
+<return></return>
</function>
-<function name="g_tls_backend_get_client_connection_type">
+<function name="g_tls_connection_set_require_close_notify">
<description>
-Gets the #GType of @backend's #GTlsClientConnection implementation.
+Sets whether or not @conn expects a proper TLS close notification
+before the connection is closed. If this is %TRUE (the default),
+then @conn will expect to receive a TLS close notification from its
+peer before the connection is closed, and will return a
+%G_TLS_ERROR_EOF error if the connection is closed without proper
+notification (since this may indicate a network error, or
+man-in-the-middle attack).
+
+In some protocols, the application will know whether or not the
+connection was closed cleanly based on application-level data
+(because the application-level data includes a length field, or is
+somehow self-delimiting); in this case, the close notify is
+redundant and sometimes omitted. (TLS 1.1 explicitly allows this;
+in TLS 1.0 it is technically an error, but often done anyway.) You
+can use g_tls_connection_set_require_close_notify() to tell @conn
+to allow an "unannounced" connection close, in which case the close
+will show up as a 0-length read, as in a non-TLS
+#GSocketConnection, and it is up to the application to check that
+the data has been fully received.
+
+Note that this only affects the behavior when the peer closes the
+connection; when the application calls g_io_stream_close() itself
+on @conn, this will send a close notification regardless of the
+setting of this property. If you explicitly want to do an unclean
+close, you can close @conn's #GTlsConnection:base-io-stream rather
+than closing @conn itself.
Since: 2.28
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> the #GTlsBackend
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="require_close_notify">
+<parameter_description> whether or not to require close notification
</parameter_description>
</parameter>
</parameters>
-<return> the #GType of @backend's #GTlsClientConnection
-implementation.
-
-</return>
+<return></return>
</function>
-<function name="g_tls_backend_get_default">
+<function name="g_tls_connection_set_use_system_certdb">
<description>
-Gets the default #GTlsBackend for the system.
+Sets whether @conn uses the system certificate database to verify
+peer certificates. This is %TRUE by default. If set to %FALSE, then
+peer certificate validation will always set the
+%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
+#GTlsConnection::accept-certificate will always be emitted on
+client-side connections, unless that bit is not set in
+#GTlsClientConnection:validation-flags).
-Since: 2.28
+Deprecated: 2.30: Use g_tls_connection_set_database() instead
</description>
<parameters>
+<parameter name="conn">
+<parameter_description> a #GTlsConnection
+</parameter_description>
+</parameter>
+<parameter name="use_system_certdb">
+<parameter_description> whether to use the system certificate database
+</parameter_description>
+</parameter>
</parameters>
-<return> a #GTlsBackend
-
-</return>
+<return></return>
</function>
-<function name="g_tls_backend_get_server_connection_type">
+<function name="g_tls_database_create_certificate_handle">
<description>
-Gets the #GType of @backend's #GTlsServerConnection implementation.
+Create a handle string for the certificate. The database will only be able
+to create a handle for certificates that originate from the database. In
+cases where the database cannot create a handle for a certificate, %NULL
+will be returned.
-Since: 2.28
+This handle should be stable across various instances of the application,
+and between applications. If a certificate is modified in the database,
+then it is not guaranteed that this handle will continue to point to it.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> the #GTlsBackend
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="certificate">
+<parameter_description> certificate for which to create a handle.
</parameter_description>
</parameter>
</parameters>
-<return> the #GType of @backend's #GTlsServerConnection
-implementation.
-
+<return> a newly allocated string containing the handle.
</return>
</function>
-<function name="g_tls_backend_supports_tls">
+<function name="g_tls_database_lookup_certificate_for_handle">
<description>
-Checks if TLS is supported; if this returns %FALSE for the default
-#GTlsBackend, it means no "real" TLS backend is available.
+Lookup a certificate by its handle.
-Since: 2.28
+The handle should have been created by calling g_tls_database_create_handle()
+on a #GTlsDatabase object of the same TLS backend. The handle is designed
+to remain valid across instantiations of the database.
+
+If the handle is no longer valid, or does not point to a certificate in
+this database, then %NULL will be returned.
+
+This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform
+the lookup operation asynchronously.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="backend">
-<parameter_description> the #GTlsBackend
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="handle">
+<parameter_description> a certificate handle
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags which affect the lookup.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> whether or not TLS is supported
+<return> a newly allocated
+#GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate.
</return>
</function>
-<function name="g_tls_certificate_get_issuer">
+<function name="g_tls_database_lookup_certificate_for_handle_async">
<description>
-Gets the #GTlsCertificate representing @cert's issuer, if known
+Asynchronously lookup a certificate by its handle in the database. See
+g_tls_database_lookup_handle() for more information.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cert">
-<parameter_description> a #GTlsCertificate
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="handle">
+<parameter_description> a certificate handle
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags which affect the lookup.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the operation completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
</parameter_description>
</parameter>
</parameters>
-<return> The certificate of @cert's issuer,
-or %NULL if @cert is self-signed or signed with an unknown
-certificate.
-
-</return>
+<return></return>
</function>
-<function name="g_tls_certificate_list_new_from_file">
+<function name="g_tls_database_lookup_certificate_for_handle_finish">
<description>
-Creates one or more #GTlsCertificate<!-- -->s from the PEM-encoded
-data in @file. If @file cannot be read or parsed, the function will
-return %NULL and set @error. If @file does not contain any
-PEM-encoded certificates, this will return an empty list and not
-set @error.
+Finish an asynchronous lookup of a certificate by its handle. See
+g_tls_database_lookup_handle() for more information.
-Since: 2.28
+If the handle is no longer valid, or does not point to a certificate in
+this database, then %NULL will be returned.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="file">
-<parameter_description> file containing PEM-encoded certificates to import
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> a #GError pointer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a
-#GList containing #GTlsCertificate objects. You must free the list
-and its contents when you are done with it.
+<return> a newly allocated #GTlsCertificate object.
+Use g_object_unref() to release the certificate.
</return>
</function>
-<function name="g_tls_certificate_new_from_file">
+<function name="g_tls_database_lookup_certificate_issuer">
<description>
-Creates a #GTlsCertificate from the PEM-encoded data in @file. If
- file cannot be read or parsed, the function will return %NULL and
-set @error. Otherwise, this behaves like g_tls_certificate_new().
+Lookup the issuer of @certificate in the database.
-Since: 2.28
+The %issuer property
+of @certificate is not modified, and the two certificates are not hooked
+into a chain.
+
+This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform
+the lookup operation asynchronously.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="file">
-<parameter_description> file containing a PEM-encoded certificate to import
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="certificate">
+<parameter_description> a #GTlsCertificate
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags which affect the lookup operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the new certificate, or %NULL on error
+<return> a newly allocated issuer #GTlsCertificate,
+or %NULL. Use g_object_unref() to release the certificate.
</return>
</function>
-<function name="g_tls_certificate_new_from_files">
+<function name="g_tls_database_lookup_certificate_issuer_async">
<description>
-Creates a #GTlsCertificate from the PEM-encoded data in @cert_file
-and @key_file. If either file cannot be read or parsed, the
-function will return %NULL and set @error. Otherwise, this behaves
-like g_tls_certificate_new().
+Asynchronously lookup the issuer of @certificate in the database. See
+g_tls_database_lookup_certificate_issuer() for more information.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cert_file">
-<parameter_description> file containing a PEM-encoded certificate to import
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
-<parameter name="key_file">
-<parameter_description> file containing a PEM-encoded private key to import
+<parameter name="certificate">
+<parameter_description> a #GTlsCertificate
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags which affect the lookup operation
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the operation completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
</parameter_description>
</parameter>
</parameters>
-<return> the new certificate, or %NULL on error
-
-</return>
+<return></return>
</function>
-<function name="g_tls_certificate_new_from_pem">
+<function name="g_tls_database_lookup_certificate_issuer_finish">
<description>
-Creates a new #GTlsCertificate from the PEM-encoded data in @data.
-If @data includes both a certificate and a private key, then the
-returned certificate will include the private key data as well.
-
-If @data includes multiple certificates, only the first one will be
-parsed.
+Finish an asynchronous lookup issuer operation. See
+g_tls_database_lookup_certificate_issuer() for more information.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="data">
-<parameter_description> PEM-encoded certificate data
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> the length of @data, or -1 if it's 0-terminated.
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter_description> a #GError pointer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the new certificate, or %NULL if @data is invalid
+<return> a newly allocated issuer #GTlsCertificate,
+or %NULL. Use g_object_unref() to release the certificate.
</return>
</function>
-<function name="g_tls_certificate_verify">
+<function name="g_tls_database_lookup_certificates_issued_by">
<description>
-This verifies @cert and returns a set of #GTlsCertificateFlags
-indicating any problems found with it. This can be used to verify a
-certificate outside the context of making a connection, or to
-check a certificate against a CA that is not part of the system
-CA database.
+Lookup certificates issued by this issuer in the database.
-If @identity is not %NULL, @cert's name(s) will be compared against
-it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
-value if it does not match. If @identity is %NULL, that bit will
-never be set in the return value.
-
-If @trusted_ca is not %NULL, then @cert (or one of the certificates
-in its chain) must be signed by it, or else
-%G_TLS_CERTIFICATE_UNKNOWN_CA will be set in the return value. If
- trusted_ca is %NULL, that bit will never be set in the return
-value.
-
-(All other #GTlsCertificateFlags values will always be set or unset
-as appropriate.)
+This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform
+the lookup operation asynchronously.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="cert">
-<parameter_description> a #GTlsCertificate
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
-<parameter name="identity">
-<parameter_description> the expected peer identity
+<parameter name="issuer_raw_dn">
+<parameter_description> a #GByteArray which holds the DER encoded issuer DN.
</parameter_description>
</parameter>
-<parameter name="trusted_ca">
-<parameter_description> the certificate of a trusted authority
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags which affect the lookup operation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate #GTlsCertificateFlags
+<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>
-<function name="g_tls_client_connection_get_accepted_cas">
+<function name="g_tls_database_lookup_certificates_issued_by_async">
<description>
-Gets the list of distinguished names of the Certificate Authorities
-that the server will accept certificates from. This will be set
-during the TLS handshake if the server requests a certificate.
-Otherwise, it will be %NULL.
+Asynchronously lookup certificates issued by this issuer in the database. See
+g_tls_database_lookup_certificates_issued_by() for more information.
-Each item in the list is a #GByteArray which contains the complete
-subject DN of the certificate authority.
+The database may choose to hold a reference to the issuer byte array for the duration
+of of this asynchronous operation. The byte array should not be modified during
+this time.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="issuer_raw_dn">
+<parameter_description> a #GByteArray which holds the DER encoded issuer DN.
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Flags which affect the lookup operation.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the operation completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
</parameter_description>
</parameter>
</parameters>
-<return> the list of
-CA DNs. You should unref each element with g_byte_array_unref() and then
-the free the list with g_list_free().
-
-</return>
+<return></return>
</function>
-<function name="g_tls_client_connection_get_server_identity">
+<function name="g_tls_database_lookup_certificates_issued_by_finish">
<description>
-Gets @conn's expected server identity
+Finish an asynchronous lookup of certificates. See
+g_tls_database_lookup_certificates_issued_by() for more information.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a #GSocketConnectable describing the
-expected server identity, or %NULL if the expected identity is not
-known.
+<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>
-<function name="g_tls_client_connection_get_use_ssl3">
+<function name="g_tls_database_verify_chain">
<description>
-Gets whether @conn will use SSL 3.0 rather than the
-highest-supported version of TLS; see
-g_tls_client_connection_set_use_ssl3().
+Verify's a certificate chain after looking up and adding any missing
+certificates to the chain.
-Since: 2.28
+ chain is a chain of #GTlsCertificate objects each pointing to the next
+certificate in the chain by its %issuer property. The chain may initially
+consist of one or more certificates. After the verification process is
+complete, @chain may be modified by adding missing certificates, or removing
+extra certificates. If a certificate anchor was found, then it is added to
+the @chain.
-</description>
-<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
-</parameter_description>
-</parameter>
-</parameters>
-<return> whether @conn will use SSL 3.0
+ purpose describes the purpose (or usage) for which the certificate
+is being used. Typically @purpose will be set to #G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER
+which means that the certificate is being used to authenticate a server
+(and we are acting as the client).
-</return>
-</function>
+The @identity is used to check for pinned certificates (trust exceptions)
+in the database. These will override the normal verification process on a
+host by host basis.
-<function name="g_tls_client_connection_get_validation_flags">
-<description>
-Gets @conn's validation flags
+Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
+used.
-Since: 2.28
+This function can block, use g_tls_database_verify_chain_async() to perform
+the verification operation asynchronously.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
+</parameter_description>
+</parameter>
+<parameter name="chain">
+<parameter_description> a #GTlsCertificate chain
+</parameter_description>
+</parameter>
+<parameter name="purpose">
+<parameter_description> the purpose that this certificate chain will be used for.
+</parameter_description>
+</parameter>
+<parameter name="identity">
+<parameter_description> the expected peer identity
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> additional verify flags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the validation flags
+<return> the appropriate #GTlsCertificateFlags which represents the
+result of verification.
</return>
</function>
-<function name="g_tls_client_connection_new">
+<function name="g_tls_database_verify_chain_async">
<description>
-Creates a new #GTlsClientConnection wrapping @base_io_stream (which
-must have pollable input and output streams) which is assumed to
-communicate with the server identified by @server_identity.
+Asynchronously verify's a certificate chain after looking up and adding
+any missing certificates to the chain. See g_tls_database_verify_chain()
+for more information.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="base_io_stream">
-<parameter_description> the #GIOStream to wrap
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
-<parameter name="server_identity">
-<parameter_description> the expected identity of the server
+<parameter name="chain">
+<parameter_description> a #GTlsCertificate chain
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> #GError for error reporting, or %NULL to ignore.
+<parameter name="purpose">
+<parameter_description> the purpose that this certificate chain will be used for.
+</parameter_description>
+</parameter>
+<parameter name="identity">
+<parameter_description> the expected peer identity
+</parameter_description>
+</parameter>
+<parameter name="interaction">
+<parameter_description> used to interact with the user if necessary
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> additional verify flags
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the operation completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
</parameter_description>
</parameter>
</parameters>
-<return> the new #GTlsClientConnection, or %NULL on error
-
-</return>
+<return></return>
</function>
-<function name="g_tls_client_connection_set_server_identity">
+<function name="g_tls_database_verify_chain_finish">
<description>
-Sets @conn's expected server identity, which is used both to tell
-servers on virtual hosts which certificate to present, and also
-to let @conn know what name to look for in the certificate when
-performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.
-
-Since: 2.28
+Finish an asynchronous verify chain operation. See
+g_tls_database_verify_chain() for more information. *
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
+<parameter name="self">
+<parameter_description> a #GTlsDatabase
</parameter_description>
</parameter>
-<parameter name="identity">
-<parameter_description> a #GSocketConnectable describing the expected server identity
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError pointer, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the appropriate #GTlsCertificateFlags which represents the
+result of verification.
+
+</return>
</function>
-<function name="g_tls_client_connection_set_use_ssl3">
+<function name="g_tls_error_quark">
<description>
-If @use_ssl3 is %TRUE, this forces @conn to use SSL 3.0 rather than
-trying to properly negotiate the right version of TLS or SSL to use.
-This can be used when talking to servers that do not implement the
-fallbacks correctly and which will therefore fail to handshake with
-a "modern" TLS handshake attempt.
+Gets the TLS error quark.
Since: 2.28
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
-</parameter_description>
-</parameter>
-<parameter name="use_ssl3">
-<parameter_description> whether to use SSL 3.0
-</parameter_description>
-</parameter>
</parameters>
-<return></return>
+<return> a #GQuark.
+
+</return>
</function>
-<function name="g_tls_client_connection_set_validation_flags">
+<function name="g_tls_file_database_new">
<description>
-Sets @conn's validation flags, to override the default set of
-checks performed when validating a server certificate. By default,
-%G_TLS_CERTIFICATE_VALIDATE_ALL is used.
+Creates a new #GTlsFileDatabase which uses anchor certificate authorities
+in @anchors to verify certificate chains.
-Since: 2.28
+The certificates in @anchors must be PEM encoded.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> the #GTlsClientConnection
+<parameter name="anchors">
+<parameter_description> filename of anchor certificate authorities.
</parameter_description>
</parameter>
-<parameter name="flags">
-<parameter_description> the #GTlsCertificateFlags to use
+<parameter name="error">
+<parameter_description> #GError for error reporting, or %NULL to ignore.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the new
+#GTlsFileDatabase, or %NULL on error
+
+</return>
</function>
-<function name="g_tls_connection_emit_accept_certificate">
+<function name="g_tls_interaction_ask_password">
<description>
-Used by #GTlsConnection implementations to emit the
-#GTlsConnection::accept-certificate signal.
+Run synchronous interaction to ask the user for a password. In general,
+g_tls_interaction_invoke_ask_password() should be used instead of this
+function.
-Since: 2.28
+Derived subclasses usually implement a password prompt, although they may
+also choose to provide a password from elsewhere. The @password value will
+be filled in and then @callback will be called. Alternatively the user may
+abort this password request, which will usually abort the TLS connection.
+
+If the interaction is cancelled by the cancellation object, or by the
+user then %G_TLS_INTERACTION_FAILED will be returned with an error that
+contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
+not support immediate cancellation.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="interaction">
+<parameter_description> a #GTlsInteraction object
</parameter_description>
</parameter>
-<parameter name="peer_cert">
-<parameter_description> the peer's #GTlsCertificate
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="errors">
-<parameter_description> the problems with @peer_cert
+<parameter name="cancellable">
+<parameter_description> an optional #GCancellable cancellation object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> an optional location to place an error on failure
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if one of the signal handlers has returned
-%TRUE to accept @peer_cert
+<return> The status of the ask password interaction.
</return>
</function>
-<function name="g_tls_connection_get_certificate">
+<function name="g_tls_interaction_ask_password_async">
<description>
-Gets @conn's certificate, as set by
-g_tls_connection_set_certificate().
+Run asynchronous interaction to ask the user for a password. In general,
+g_tls_interaction_invoke_ask_password() should be used instead of this
+function.
-Since: 2.28
+Derived subclasses usually implement a password prompt, although they may
+also choose to provide a password from elsewhere. The @password value will
+be filled in and then @callback will be called. Alternatively the user may
+abort this password request, which will usually abort the TLS connection.
+
+If the interaction is cancelled by the cancellation object, or by the
+user then %G_TLS_INTERACTION_FAILED will be returned with an error that
+contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
+not support immediate cancellation.
+
+Certain implementations may not support immediate cancellation.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="interaction">
+<parameter_description> a #GTlsInteraction object
+</parameter_description>
+</parameter>
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> an optional #GCancellable cancellation object
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> will be called when the interaction completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to the @callback
</parameter_description>
</parameter>
</parameters>
-<return> @conn's certificate, or %NULL
-
-</return>
+<return></return>
</function>
-<function name="g_tls_connection_get_peer_certificate">
+<function name="g_tls_interaction_ask_password_finish">
<description>
-Gets @conn's peer's certificate after the handshake has completed.
-(It is not set during the emission of
-#GTlsConnection::accept-certificate.)
+Complete an ask password user interaction request. This should be once
+the g_tls_interaction_ask_password_async() completion callback is called.
-Since: 2.28
+If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsPassword passed
+to g_tls_interaction_ask_password() will have its password filled in.
+
+If the interaction is cancelled by the cancellation object, or by the
+user then %G_TLS_INTERACTION_FAILED will be returned with an error that
+contains a %G_IO_ERROR_CANCELLED error code.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="interaction">
+<parameter_description> a #GTlsInteraction object
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to the callback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> an optional location to place an error on failure
</parameter_description>
</parameter>
</parameters>
-<return> @conn's peer's certificate, or %NULL
+<return> The status of the ask password interaction.
</return>
</function>
-<function name="g_tls_connection_get_peer_certificate_errors">
+<function name="g_tls_interaction_invoke_ask_password">
<description>
-Gets the errors associated with validating @conn's peer's
-certificate, after the handshake has completed. (It is not set
-during the emission of #GTlsConnection::accept-certificate.)
+Invoke the interaction to ask the user for a password. It invokes this
+interaction in the main loop, specifically the #GMainContext returned by
+g_main_context_get_thread_default() when the interaction is created. This
+is called by called by #GTlsConnection or #GTlsDatabase to ask the user
+for a password.
-Since: 2.28
+Derived subclasses usually implement a password prompt, although they may
+also choose to provide a password from elsewhere. The @password value will
+be filled in and then @callback will be called. Alternatively the user may
+abort this password request, which will usually abort the TLS connection.
+
+The implementation can either be a synchronous (eg: modal dialog) or an
+asynchronous one (eg: modeless dialog). This function will take care of
+calling which ever one correctly.
+
+If the interaction is cancelled by the cancellation object, or by the
+user then %G_TLS_INTERACTION_FAILED will be returned with an error that
+contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
+not support immediate cancellation.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="interaction">
+<parameter_description> a #GTlsInteraction object
+</parameter_description>
+</parameter>
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> an optional #GCancellable cancellation object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> an optional location to place an error on failure
</parameter_description>
</parameter>
</parameters>
-<return> @conn's peer's certificate errors
+<return> The status of the ask password interaction.
</return>
</function>
-<function name="g_tls_connection_get_rehandshake_mode">
+<function name="g_tls_password_get_description">
<description>
-Gets @conn rehandshaking mode. See
-g_tls_connection_set_rehandshake() for details.
+Get a description string about what the password will be used for.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
</parameters>
-<return> @conn's rehandshaking mode
+<return> The description of the password.
</return>
</function>
-<function name="g_tls_connection_get_require_close_notify">
+<function name="g_tls_password_get_flags">
<description>
-Tests whether or not @conn expects a proper TLS close notification
-when the connection is closed. See
-g_tls_connection_set_require_close_notify() for details.
+Get flags about the password.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @conn requires a proper TLS close
-notification.
+<return> The flags about the password.
</return>
</function>
-<function name="g_tls_connection_get_use_system_certdb">
+<function name="g_tls_password_get_value">
<description>
-Gets whether @conn uses the system certificate database to verify
-peer certificates. See g_tls_connection_set_use_system_certdb().
+Get the password value. If @length is not %NULL then it will be
+filled in with the length of the password value. (Note that the
+password value is not nul-terminated, so you can only pass %NULL
+for @length in contexts where you know the password will have a
+certain fixed length.)
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> location to place the length of the password.
</parameter_description>
</parameter>
</parameters>
-<return> whether @conn uses the system certificate database
+<return> The password value (owned by the password object).
</return>
</function>
-<function name="g_tls_connection_handshake">
+<function name="g_tls_password_get_warning">
<description>
-Attempts a TLS handshake on @conn.
-
-On the client side, it is never necessary to call this method;
-although the connection needs to perform a handshake after
-connecting (or after sending a "STARTTLS"-type command) and may
-need to rehandshake later if the server requests it,
-#GTlsConnection will handle this for you automatically when you try
-to send or receive data on the connection. However, you can call
-g_tls_connection_handshake() manually if you want to know for sure
-whether the initial handshake succeeded or failed (as opposed to
-just immediately trying to write to @conn's output stream, in which
-case if it fails, it may not be possible to tell if it failed
-before or after completing the handshake).
-
-Likewise, on the server side, although a handshake is necessary at
-the beginning of the communication, you do not need to call this
-function explicitly unless you want clearer error reporting.
-However, you may call g_tls_connection_handshake() later on to
-renegotiate parameters (encryption methods, etc) with the client.
-
-#GTlsConnection::accept_certificate may be emitted during the
-handshake.
+Get a user readable translated warning. Usually this warning is a
+representation of the password flags returned from
+g_tls_password_get_flags().
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> a #GError, or %NULL
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
</parameters>
-<return> success or failure
+<return> The warning.
</return>
</function>
-<function name="g_tls_connection_handshake_async">
+<function name="g_tls_password_new">
<description>
-Asynchronously performs a TLS handshake on @conn. See
-g_tls_connection_handshake() for more information.
+Create a new #GTlsPassword object.
-Since: 2.28
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
-</parameter_description>
-</parameter>
-<parameter name="io_priority">
-<parameter_description> the <link linkend="io-priority">I/O priority</link>
-of the request.
-</parameter_description>
-</parameter>
-<parameter name="cancellable">
-<parameter_description> a #GCancellable, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="callback">
-<parameter_description> callback to call when the handshake is complete
+<parameter name="flags">
+<parameter_description> the password flags
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> the data to pass to the callback function
+<parameter name="description">
+<parameter_description> description of what the password is for
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> The newly allocated password object
+</return>
</function>
-<function name="g_tls_connection_handshake_finish">
+<function name="g_tls_password_set_description">
<description>
-Finish an asynchronous TLS handshake operation. See
-g_tls_connection_handshake() for more information.
+Set a description string about what the password will be used for.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
-</parameter_description>
-</parameter>
-<parameter name="result">
-<parameter_description> a #GAsyncResult.
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> a #GError pointer, or %NULL
+<parameter name="description">
+<parameter_description> The description of the password
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE on failure, in which
-case @error will be set.
-
-</return>
+<return></return>
</function>
-<function name="g_tls_connection_set_certificate">
+<function name="g_tls_password_set_flags">
<description>
-This sets the certificate that @conn will present to its peer
-during the TLS handshake. For a #GTlsServerConnection, it is
-mandatory to set this, and that will normally be done at construct
-time.
-
-For a #GTlsClientConnection, this is optional. If a handshake fails
-with %G_TLS_ERROR_CERTIFICATE_REQUIRED, that means that the server
-requires a certificate, and if you try connecting again, you should
-call this method first. You can call
-g_tls_client_connection_get_accepted_cas() on the failed connection
-to get a list of Certificate Authorities that the server will
-accept certificates from.
+Set flags about the password.
-(It is also possible that a server will allow the connection with
-or without a certificate; in that case, if you don't provide a
-certificate, you can tell that the server requested one by the fact
-that g_tls_client_connection_get_accepted_cas() will return
-non-%NULL.)
-
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="certificate">
-<parameter_description> the certificate to use for @conn
+<parameter name="flags">
+<parameter_description> The flags about the password
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_tls_connection_set_rehandshake_mode">
+<function name="g_tls_password_set_value">
<description>
-Sets how @conn behaves with respect to rehandshaking requests.
-
-%G_TLS_REHANDSHAKE_NEVER means that it will never agree to
-rehandshake after the initial handshake is complete. (For a client,
-this means it will refuse rehandshake requests from the server, and
-for a server, this means it will close the connection with an error
-if the client attempts to rehandshake.)
-
-%G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a
-rehandshake only if the other end of the connection supports the
-TLS <literal>renegotiation_info</literal> extension. This is the
-default behavior, but means that rehandshaking will not work
-against older implementations that do not support that extension.
+Set the value for this password. The @value will be copied by the password
+object.
-%G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow
-rehandshaking even without the
-<literal>renegotiation_info</literal> extension. On the server side
-in particular, this is not recommended, since it leaves the server
-open to certain attacks. However, this mode is necessary if you
-need to allow renegotiation with older client software.
+Specify the @length, for a non-nul-terminated password. Pass -1 as
+ length if using a nul-terminated password, and @length will be
+calculated automatically. (Note that the terminating nul is not
+considered part of the password in this case.)
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> the rehandshaking mode
+<parameter name="value">
+<parameter_description> the new password value
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the password, or -1
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_tls_connection_set_require_close_notify">
+<function name="g_tls_password_set_value_full">
<description>
-Sets whether or not @conn expects a proper TLS close notification
-before the connection is closed. If this is %TRUE (the default),
-then @conn will expect to receive a TLS close notification from its
-peer before the connection is closed, and will return a
-%G_TLS_ERROR_EOF error if the connection is closed without proper
-notification (since this may indicate a network error, or
-man-in-the-middle attack).
+Provide the value for this password.
-In some protocols, the application will know whether or not the
-connection was closed cleanly based on application-level data
-(because the application-level data includes a length field, or is
-somehow self-delimiting); in this case, the close notify is
-redundant and sometimes omitted. (TLS 1.1 explicitly allows this;
-in TLS 1.0 it is technically an error, but often done anyway.) You
-can use g_tls_connection_set_require_close_notify() to tell @conn
-to allow an "unannounced" connection close, in which case the close
-will show up as a 0-length read, as in a non-TLS
-#GSocketConnection, and it is up to the application to check that
-the data has been fully received.
+The @value will be owned by the password object, and later freed using
+the @destroy function callback.
-Note that this only affects the behavior when the peer closes the
-connection; when the application calls g_io_stream_close() itself
-on @conn, this will send a close notification regardless of the
-setting of this property. If you explicitly want to do an unclean
-close, you can close @conn's #GTlsConnection:base-io-stream rather
-than closing @conn itself.
+Specify the @length, for a non-nul-terminated password. Pass -1 as
+ length if using a nul-terminated password, and @length will be
+calculated automatically. (Note that the terminating nul is not
+considered part of the password in this case.)
-Since: 2.28
+Virtual: set_value
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="require_close_notify">
-<parameter_description> whether or not to require close notification
+<parameter name="value">
+<parameter_description> the value for the password
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the password, or -1
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> a function to use to free the password.
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_tls_connection_set_use_system_certdb">
+<function name="g_tls_password_set_warning">
<description>
-Sets whether @conn uses the system certificate database to verify
-peer certificates. This is %TRUE by default. If set to %FALSE, then
-peer certificate validation will always set the
-%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
-#GTlsConnection::accept-certificate will always be emitted on
-client-side connections, unless that bit is not set in
-#GTlsClientConnection:validation-flags).
+Set a user readable translated warning. Usually this warning is a
+representation of the password flags returned from
+g_tls_password_get_flags().
-Since: 2.28
+Since: 2.30
</description>
<parameters>
-<parameter name="conn">
-<parameter_description> a #GTlsConnection
+<parameter name="password">
+<parameter_description> a #GTlsPassword object
</parameter_description>
</parameter>
-<parameter name="use_system_certdb">
-<parameter_description> whether to use the system certificate database
+<parameter name="warning">
+<parameter_description> The user readable warning
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_tls_error_quark">
-<description>
-Gets the TLS error quark.
-
-Since: 2.28
-
-</description>
-<parameters>
-</parameters>
-<return> a #GQuark.
-
-</return>
-</function>
-
<function name="g_tls_server_connection_new">
<description>
Creates a new #GTlsServerConnection wrapping @base_io_stream (which
@@ -30281,7 +53682,8 @@ Since: 2.28
</parameter_description>
</parameter>
</parameters>
-<return> the new #GTlsServerConnection, or %NULL on error
+<return> the new
+#GTlsServerConnection, or %NULL on error
</return>
</function>
@@ -30322,6 +53724,68 @@ g_object_unref()), %NULL if @error is set.
</return>
</function>
+<function name="g_unix_connection_receive_credentials_async">
+<description>
+Asynchronously receive credentials.
+
+For more details, see g_unix_connection_receive_credentials() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_unix_connection_receive_credentials_finish() to get the result of the operation.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_unix_connection_receive_credentials_finish">
+<description>
+Finishes an asynchronous receive credentials operation started with
+g_unix_connection_receive_credentials_async().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GCredentials, or %NULL on error.
+Free the returned object with g_object_unref().
+
+</return>
+</function>
+
<function name="g_unix_connection_receive_fd">
<description>
Receives a file descriptor from the sending end of the connection.
@@ -30357,7 +53821,7 @@ Since: 2.22
<function name="g_unix_connection_send_credentials">
<description>
Passes the credentials of the current user the receiving side
-of the connection. The recieving end has to call
+of the connection. The receiving end has to call
g_unix_connection_receive_credentials() (or similar) to accept the
credentials.
@@ -30390,10 +53854,71 @@ Since: 2.26
</return>
</function>
+<function name="g_unix_connection_send_credentials_async">
+<description>
+Asynchronously send credentials.
+
+For more details, see g_unix_connection_send_credentials() which is
+the synchronous version of this call.
+
+When the operation is finished, @callback will be called. You can then call
+g_unix_connection_send_credentials_finish() to get the result of the operation.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_unix_connection_send_credentials_finish">
+<description>
+Finishes an asynchronous send credentials operation started with
+g_unix_connection_send_credentials_async().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GUnixConnection.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the operation was successful, otherwise %FALSE.
+
+</return>
+</function>
+
<function name="g_unix_connection_send_fd">
<description>
-Passes a file descriptor to the recieving side of the
-connection. The recieving end has to call g_unix_connection_receive_fd()
+Passes a file descriptor to the receiving side of the
+connection. The receiving end has to call g_unix_connection_receive_fd()
to accept the file descriptor.
As well as sending the fd this also writes a single byte to the
@@ -30446,7 +53971,7 @@ Since: 2.26
<function name="g_unix_credentials_message_is_supported">
<description>
-Checks if passing a #GCredential on a #GSocket is supported on this platform.
+Checks if passing #GCredentials on a #GSocket is supported on this platform.
Since: 2.26
@@ -31255,6 +54780,24 @@ Gets the mount path for a unix mount point.
</return>
</function>
+<function name="g_unix_mount_point_get_options">
+<description>
+Gets the options for the mount point.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mount_point">
+<parameter_description> a #GUnixMountPoint.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a string containing the options.
+
+</return>
+</function>
+
<function name="g_unix_mount_point_guess_can_eject">
<description>
Guesses whether a Unix mount point can be ejected.
@@ -31374,7 +54917,7 @@ Checks if the unix mount points have changed since a given unix time.
Gets a #GList of #GUnixMountPoint containing the unix mount points.
If @time_read is set, it will be filled with the mount timestamp,
allowing for checking if the mounts have changed with
-g_unix_mounts_points_changed_since().
+g_unix_mount_points_changed_since().
</description>
@@ -31893,7 +55436,7 @@ Deprecated: 2.22: Use g_volume_eject_with_operation() instead.
<function name="g_volume_eject_finish">
<description>
-Finishes ejecting a volume. If any errors occured during the operation,
+Finishes ejecting a volume. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
Deprecated: 2.22: Use g_volume_eject_with_operation_finish() instead.
@@ -31975,7 +55518,7 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError location to store the error occuring, or %NULL to
+<parameter_description> a #GError location to store the error occurring, or %NULL to
ignore.
</parameter_description>
</parameter>
@@ -32146,6 +55689,24 @@ be freed with g_free() when no longer needed.
</return>
</function>
+<function name="g_volume_get_sort_key">
+<description>
+Gets the sort key for @volume, if any.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="volume">
+<parameter_description> A #GVolume.
+</parameter_description>
+</parameter>
+</parameters>
+<return> Sorting key for @volume or %NULL if no such key is available.
+
+</return>
+</function>
+
<function name="g_volume_get_uuid">
<description>
Gets the UUID for the @volume. The reference is typically based on
@@ -32192,7 +55753,7 @@ One is when implementing a user space file system driver that reads
blocks of a block device that is already represented by the native
volume monitor (for example a CD Audio file system driver). Such
a driver will generate its own #GMount object that needs to be
-assoicated with the #GVolume object that represents the volume.
+associated with the #GVolume object that represents the volume.
The other is for implementing a #GVolumeMonitor whose sole purpose
is to return #GVolume objects representing entries in the users
@@ -32369,7 +55930,7 @@ Virtual: mount_fn
<function name="g_volume_mount_finish">
<description>
-Finishes mounting a volume. If any errors occured during the operation,
+Finishes mounting a volume. If any errors occurred during the operation,
@error will be set to contain the errors and %FALSE will be returned.
If the mount operation succeeded, g_volume_get_mount() on @volume
@@ -32452,7 +56013,7 @@ Since: 2.26
<function name="g_win32_input_stream_new">
<description>
-Creates a new #GWin32InputStream for the given @fd.
+Creates a new #GWin32InputStream for the given @handle.
If @close_handle is %TRUE, the handle will be closed
when the stream is closed.
@@ -32467,7 +56028,7 @@ as used in the Windows C libraries.
<parameter_description> a Win32 file handle
</parameter_description>
</parameter>
-<parameter name="close_fd">
+<parameter name="close_handle">
<parameter_description> %TRUE to close the handle when done
</parameter_description>
</parameter>
@@ -32895,6 +56456,47 @@ longer require it.
</return>
</function>
+<function name="gvdb_table_new_from_data">
+<description>
+Creates a new #GvdbTable from the data in @data.
+
+An empty or otherwise corrupted data is considered to be a valid
+#GvdbTable with no entries.
+
+You should call gvdb_table_unref() on the return result when you no
+longer require it.
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> the data
+</parameter_description>
+</parameter>
+<parameter name="data_len">
+<parameter_description> the length of @data in bytes
+</parameter_description>
+</parameter>
+<parameter name="trusted">
+<parameter_description> if the contents of @data are trusted
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> User supplied data that owns @data
+</parameter_description>
+</parameter>
+<parameter name="ref">
+<parameter_description> Ref function for @user_data
+</parameter_description>
+</parameter>
+<parameter name="unref">
+<parameter_description> Unref function for @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GvdbTable
+</return>
+</function>
+
<function name="gvdb_table_ref">
<description>
Increases the reference count on @file.
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index dbbb027..c46b3ca 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -1,4 +1,38 @@
<root>
+<signal name="GObject::notify">
+<description>
+The notify signal is emitted on an object when one of its
+properties has been changed. Note that getting this signal
+doesn't guarantee that the value of the property has actually
+changed, it may also be emitted when the setter for the property
+is called to reinstate the previous value.
+
+This signal is typically used to obtain change notification for a
+single property, by specifying the property name as a detail in the
+g_signal_connect() call, like this:
+|[
+g_signal_connect (text_view->buffer, "notify::paste-target-list",
+G_CALLBACK (gtk_text_view_target_list_notify),
+text_view)
+]|
+It is important to note that you must use
+<link linkend="canonical-parameter-name">canonical</link> parameter names as
+detail strings for the notify signal.
+
+</description>
+<parameters>
+<parameter name="gobject">
+<parameter_description> the object which received the signal.
+</parameter_description>
+</parameter>
+<parameter name="pspec">
+<parameter_description> the #GParamSpec of the property which changed.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
<function name="g_access">
<description>
A wrapper for the POSIX access() function. This function is used to
@@ -34,51 +68,6 @@ error.
</return>
</function>
-<function name="g_allocator_free">
-<description>
-Frees all of the memory allocated by the #GAllocator.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="allocator">
-<parameter_description> a #GAllocator.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_allocator_new">
-<description>
-Creates a new #GAllocator.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="name">
-<parameter_description> the name of the #GAllocator. This name is used to set the
-name of the #GMemChunk used by the #GAllocator, and is only
-used for debugging.
-</parameter_description>
-</parameter>
-<parameter name="n_preallocs">
-<parameter_description> the number of elements in each block of memory
-allocated. Larger blocks mean less calls to
-g_malloc(), but some memory may be wasted. (GLib uses
-128 elements per block by default.) The value must be
-between 1 and 65535.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a new #GAllocator.
-</return>
-</function>
-
<function name="g_array_append_val">
<description>
Adds the value on to the end of the array. The array will grow in
@@ -429,6 +418,34 @@ Since: 2.4
</return>
</function>
+<function name="g_array_set_clear_func">
+<description>
+Sets a function to clear an element of @array.
+
+The @clear_func will be called when an element in the array
+data segment is removed and when the array is freed and data
+segment is deallocated as well.
+
+Note that in contrast with other uses of #GDestroyNotify
+functions, @clear_func is expected to clear the contents of
+the array element it is given, but not free the element itself.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> A #GArray
+</parameter_description>
+</parameter>
+<parameter name="clear_func">
+<parameter_description> a function to clear an element of @array
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_array_set_size">
<description>
Sets the size of the array, expanding it if necessary. If the array
@@ -489,8 +506,8 @@ than second arg, zero for equal, greater zero if first arg is
greater than second arg).
If two array elements compare equal, their order in the sorted array
-is undefined. If you want equal elements to keep their order &#8211; i.e.
-you want a stable sort &#8211; you can write a comparison function that,
+is undefined. If you want equal elements to keep their order (i.e.
+you want a stable sort) you can write a comparison function that,
if two elements would otherwise compare equal, compares them by
their addresses.
@@ -636,6 +653,257 @@ code to use for converting.
</return>
</function>
+<function name="g_ascii_isalnum">
+<description>
+Determines whether a character is alphanumeric.
+
+Unlike the standard C library isalnum() function, this only
+recognizes standard ASCII letters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII alphanumeric character
+</return>
+</function>
+
+<function name="g_ascii_isalpha">
+<description>
+Determines whether a character is alphabetic (i.e. a letter).
+
+Unlike the standard C library isalpha() function, this only
+recognizes standard ASCII letters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII alphabetic character
+</return>
+</function>
+
+<function name="g_ascii_iscntrl">
+<description>
+Determines whether a character is a control character.
+
+Unlike the standard C library iscntrl() function, this only
+recognizes standard ASCII control characters and ignores the
+locale, returning %FALSE for all non-ASCII characters. Also,
+unlike the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII control character.
+</return>
+</function>
+
+<function name="g_ascii_isdigit">
+<description>
+Determines whether a character is digit (0-9).
+
+Unlike the standard C library isdigit() function, this takes
+a <type>char</type>, not an <type>int</type>, so don't call it
+on <literal>EOF</literal>, but no need to cast to #guchar before passing a possibly
+non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII digit.
+</return>
+</function>
+
+<function name="g_ascii_isgraph">
+<description>
+Determines whether a character is a printing character and not a space.
+
+Unlike the standard C library isgraph() function, this only
+recognizes standard ASCII characters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need
+to cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII printing character other than space.
+</return>
+</function>
+
+<function name="g_ascii_islower">
+<description>
+Determines whether a character is an ASCII lower case letter.
+
+Unlike the standard C library islower() function, this only
+recognizes standard ASCII letters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need
+to worry about casting to #guchar before passing a possibly
+non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII lower case letter
+</return>
+</function>
+
+<function name="g_ascii_isprint">
+<description>
+Determines whether a character is a printing character.
+
+Unlike the standard C library isprint() function, this only
+recognizes standard ASCII characters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need
+to cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII printing character.
+</return>
+</function>
+
+<function name="g_ascii_ispunct">
+<description>
+Determines whether a character is a punctuation character.
+
+Unlike the standard C library ispunct() function, this only
+recognizes standard ASCII letters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII punctuation character.
+</return>
+</function>
+
+<function name="g_ascii_isspace">
+<description>
+Determines whether a character is a white-space character.
+
+Unlike the standard C library isspace() function, this only
+recognizes standard ASCII white-space and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+cast to #guchar before passing a possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII white-space character
+</return>
+</function>
+
+<function name="g_ascii_isupper">
+<description>
+Determines whether a character is an ASCII upper case letter.
+
+Unlike the standard C library isupper() function, this only
+recognizes standard ASCII letters and ignores the locale,
+returning %FALSE for all non-ASCII characters. Also, unlike
+the standard library function, this takes a <type>char</type>,
+not an <type>int</type>, so don't call it on <literal>EOF</literal>, but no need to
+worry about casting to #guchar before passing a possibly non-ASCII
+character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII upper case letter
+</return>
+</function>
+
+<function name="g_ascii_isxdigit">
+<description>
+Determines whether a character is a hexadecimal-digit character.
+
+Unlike the standard C library isxdigit() function, this takes
+a <type>char</type>, not an <type>int</type>, so don't call it
+on <literal>EOF</literal>, but no need to cast to #guchar before passing a
+possibly non-ASCII character in.
+
+
+</description>
+<parameters>
+<parameter name="c">
+<parameter_description> any character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @c is an ASCII hexadecimal-digit character.
+</return>
+</function>
+
<function name="g_ascii_strcasecmp">
<description>
Compare two strings, ignoring the case of ASCII characters.
@@ -745,12 +1013,12 @@ locale-sensitive system strtod() function.
To convert from a #gdouble to a string in a locale-insensitive
way, use g_ascii_dtostr().
-If the correct value would cause overflow, plus or minus %HUGE_VAL
-is returned (according to the sign of the value), and %ERANGE is
-stored in %errno. If the correct value would cause underflow,
-zero is returned and %ERANGE is stored in %errno.
+If the correct value would cause overflow, plus or minus <literal>HUGE_VAL</literal>
+is returned (according to the sign of the value), and <literal>ERANGE</literal> is
+stored in <literal>errno</literal>. If the correct value would cause underflow,
+zero is returned and <literal>ERANGE</literal> is stored in <literal>errno</literal>.
-This function resets %errno before calling strtod() so that
+This function resets <literal>errno</literal> before calling strtod() so that
you can reliably detect overflow and underflow.
@@ -784,10 +1052,11 @@ To handle input from the user you should normally use the
locale-sensitive system strtoll() function.
If the correct value would cause overflow, %G_MAXINT64 or %G_MININT64
-is returned, and %ERANGE is stored in %errno. If the base is
-outside the valid range, zero is returned, and %EINVAL is stored
-in %errno. If the string conversion fails, zero is returned, and
- endptr returns @nptr (if @endptr is non-%NULL).
+is returned, and <literal>ERANGE</literal> is stored in <literal>errno</literal>.
+If the base is outside the valid range, zero is returned, and
+<literal>EINVAL</literal> is stored in <literal>errno</literal>. If the
+string conversion fails, zero is returned, and @endptr returns @nptr
+(if @endptr is non-%NULL).
Since: 2.12
@@ -826,10 +1095,11 @@ To handle input from the user you should normally use the
locale-sensitive system strtoull() function.
If the correct value would cause overflow, %G_MAXUINT64
-is returned, and %ERANGE is stored in %errno. If the base is
-outside the valid range, zero is returned, and %EINVAL is stored
-in %errno. If the string conversion fails, zero is returned, and
- endptr returns @nptr (if @endptr is non-%NULL).
+is returned, and <literal>ERANGE</literal> is stored in <literal>errno</literal>.
+If the base is outside the valid range, zero is returned, and
+<literal>EINVAL</literal> is stored in <literal>errno</literal>.
+If the string conversion fails, zero is returned, and @endptr returns
+ nptr (if @endptr is non-%NULL).
Since: 2.2
@@ -887,7 +1157,7 @@ recognizes standard ASCII letters and ignores the locale, returning
all non-ASCII characters unchanged, even if they are lower case
letters in a particular character set. Also unlike the standard
library function, this takes and returns a char, not an int, so
-don't call it on %EOF but no need to worry about casting to #guchar
+don't call it on <literal>EOF</literal> but no need to worry about casting to #guchar
before passing a possibly non-ASCII character in.
@@ -913,7 +1183,7 @@ recognizes standard ASCII letters and ignores the locale, returning
all non-ASCII characters unchanged, even if they are upper case
letters in a particular character set. Also unlike the standard
library function, this takes and returns a char, not an int, so
-don't call it on %EOF but no need to worry about casting to #guchar
+don't call it on <literal>EOF</literal> but no need to worry about casting to #guchar
before passing a possibly non-ASCII character in.
@@ -950,15 +1220,265 @@ g_ascii_isxdigit()), its numeric value. Otherwise, -1.
</return>
</function>
+<function name="g_assert">
+<description>
+Debugging macro to terminate the application if the assertion
+fails. If the assertion fails (i.e. the expression is not true),
+an error message is logged and the application is terminated.
+
+The macro can be turned off in final releases of code by defining
+<envar>G_DISABLE_ASSERT</envar> when compiling the application.
+
+</description>
+<parameters>
+<parameter name="expr">
+<parameter_description> the expression to check
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_cmpfloat">
+<description>
+Debugging macro to terminate the application with a warning
+message if a floating point number comparison fails.
+
+The effect of <literal>g_assert_cmpfloat (n1, op, n2)</literal> is
+the same as <literal>g_assert (n1 op n2)</literal>. The advantage
+of this macro is that it can produce a message that includes the
+actual values of @n1 and @n2.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="n1">
+<parameter_description> an floating point number
+</parameter_description>
+</parameter>
+<parameter name="cmp">
+<parameter_description> The comparison operator to use.
+One of ==, !=, <, >, <=, >=.
+</parameter_description>
+</parameter>
+<parameter name="n2">
+<parameter_description> another floating point number
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_cmphex">
+<description>
+Debugging macro to terminate the application with a warning
+message if an unsigned integer comparison fails.
+
+This is a variant of g_assert_cmpuint() that displays the numbers
+in hexadecimal notation in the message.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="n1">
+<parameter_description> an unsigned integer
+</parameter_description>
+</parameter>
+<parameter name="cmp">
+<parameter_description> The comparison operator to use.
+One of ==, !=, <, >, <=, >=.
+</parameter_description>
+</parameter>
+<parameter name="n2">
+<parameter_description> another unsigned integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_cmpint">
+<description>
+Debugging macro to terminate the application with a warning
+message if an integer comparison fails.
+
+The effect of <literal>g_assert_cmpint (n1, op, n2)</literal> is
+the same as <literal>g_assert (n1 op n2)</literal>. The advantage
+of this macro is that it can produce a message that includes the
+actual values of @n1 and @n2.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="n1">
+<parameter_description> an integer
+</parameter_description>
+</parameter>
+<parameter name="cmp">
+<parameter_description> The comparison operator to use.
+One of ==, !=, <, >, <=, >=.
+</parameter_description>
+</parameter>
+<parameter name="n2">
+<parameter_description> another integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_cmpstr">
+<description>
+Debugging macro to terminate the application with a warning
+message if a string comparison fails. The strings are compared
+using g_strcmp0().
+
+The effect of <literal>g_assert_cmpstr (s1, op, s2)</literal> is
+the same as <literal>g_assert (g_strcmp0 (s1, s2) op 0)</literal>.
+The advantage of this macro is that it can produce a message that
+includes the actual values of @s1 and @s2.
+
+|[
+g_assert_cmpstr (mystring, ==, "fubar");
+]|
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="s1">
+<parameter_description> a string (may be %NULL)
+</parameter_description>
+</parameter>
+<parameter name="cmp">
+<parameter_description> The comparison operator to use.
+One of ==, !=, <, >, <=, >=.
+</parameter_description>
+</parameter>
+<parameter name="s2">
+<parameter_description> another string (may be %NULL)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_cmpuint">
+<description>
+Debugging macro to terminate the application with a warning
+message if an unsigned integer comparison fails.
+
+The effect of <literal>g_assert_cmpuint (n1, op, n2)</literal> is
+the same as <literal>g_assert (n1 op n2)</literal>. The advantage
+of this macro is that it can produce a message that includes the
+actual values of @n1 and @n2.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="n1">
+<parameter_description> an unsigned integer
+</parameter_description>
+</parameter>
+<parameter name="cmp">
+<parameter_description> The comparison operator to use.
+One of ==, !=, <, >, <=, >=.
+</parameter_description>
+</parameter>
+<parameter name="n2">
+<parameter_description> another unsigned integer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_error">
+<description>
+Debugging macro to terminate the application with a warning
+message if a method has not returned the correct #GError.
+
+The effect of <literal>g_assert_error (err, dom, c)</literal> is
+the same as <literal>g_assert (err != NULL && err->domain
+== dom && err->code == c)</literal>. The advantage of this
+macro is that it can produce a message that includes the incorrect
+error message and code.
+
+This can only be used to test for a specific error. If you want to
+test that @err is set, but don't care what it's set to, just use
+<literal>g_assert (err != NULL)</literal>
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="err">
+<parameter_description> a #GError, possibly %NULL
+</parameter_description>
+</parameter>
+<parameter name="dom">
+<parameter_description> the expected error domain (a #GQuark)
+</parameter_description>
+</parameter>
+<parameter name="c">
+<parameter_description> the expected error code
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_no_error">
+<description>
+Debugging macro to terminate the application with a warning
+message if a method has returned a #GError.
+
+The effect of <literal>g_assert_no_error (err)</literal> is
+the same as <literal>g_assert (err == NULL)</literal>. The advantage
+of this macro is that it can produce a message that includes
+the error message and code.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="err">
+<parameter_description> a #GError, possibly %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_assert_not_reached">
+<description>
+Debugging macro to terminate the application if it is ever
+reached. If it is reached, an error message is logged and the
+application is terminated.
+
+The macro can be turned off in final releases of code by defining
+<envar>G_DISABLE_ASSERT</envar> when compiling the application.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_async_queue_length">
<description>
-Returns the length of the queue, negative values mean waiting
-threads, positive values mean available entries in the
- queue Actually this function returns the number of data items in
-the queue minus the number of waiting threads. Thus a return value
-of 0 could mean 'n' entries in the queue and 'n' thread waiting.
-That can happen due to locking of the queue or due to
-scheduling.
+Returns the length of the queue.
+
+Actually this function returns the number of data items in
+the queue minus the number of waiting threads, so a negative
+value means waiting threads, and a positive value means available
+entries in the @queue. A return value of 0 could mean n entries
+in the queue and n threads waiting. This can happen due to locking
+of the queue or due to scheduling.
</description>
@@ -968,26 +1488,28 @@ scheduling.
</parameter_description>
</parameter>
</parameters>
-<return> the length of the @queue.
+<return> the length of the @queue
</return>
</function>
<function name="g_async_queue_length_unlocked">
<description>
-Returns the length of the queue, negative values mean waiting
-threads, positive values mean available entries in the
- queue Actually this function returns the number of data items in
-the queue minus the number of waiting threads. Thus a return value
-of 0 could mean 'n' entries in the queue and 'n' thread waiting.
-That can happen due to locking of the queue or due to
-scheduling. This function must be called while holding the @queue's
-lock.
+Returns the length of the queue.
+
+Actually this function returns the number of data items in
+the queue minus the number of waiting threads, so a negative
+value means waiting threads, and a positive value means available
+entries in the @queue. A return value of 0 could mean n entries
+in the queue and n threads waiting. This can happen due to locking
+of the queue or due to scheduling.
+
+This function must be called while holding the @queue's lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -997,14 +1519,20 @@ lock.
<function name="g_async_queue_lock">
<description>
-Acquires the @queue's lock. After that you can only call the
-<function>g_async_queue_*_unlocked()</function> function variants on that
- queue Otherwise it will deadlock.
+Acquires the @queue's lock. If another thread is already
+holding the lock, this call will block until the lock
+becomes available.
+
+Call g_async_queue_unlock() to drop the lock again.
+
+While holding the lock, you can only call the
+<function>g_async_queue_*_unlocked()</function> functions
+on @queue. Otherwise, deadlock may occur.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1013,21 +1541,21 @@ Acquires the @queue's lock. After that you can only call the
<function name="g_async_queue_new">
<description>
-Creates a new asynchronous queue with the initial reference count of 1.
+Creates a new asynchronous queue.
</description>
<parameters>
</parameters>
-<return> the new #GAsyncQueue.
+<return> a new #GAsyncQueue. Free with g_async_queue_unref()
</return>
</function>
<function name="g_async_queue_new_full">
<description>
-Creates a new asynchronous queue with an initial reference count of 1 and
-sets up a destroy notify function that is used to free any remaining
-queue items when the queue is destroyed after the final unref.
+Creates a new asynchronous queue and sets up a destroy notify
+function that is used to free any remaining queue items when
+the queue is destroyed after the final unref.
Since: 2.16
@@ -1038,39 +1566,40 @@ Since: 2.16
</parameter_description>
</parameter>
</parameters>
-<return> the new #GAsyncQueue.
+<return> a new #GAsyncQueue. Free with g_async_queue_unref()
</return>
</function>
<function name="g_async_queue_pop">
<description>
-Pops data from the @queue. This function blocks until data become
-available.
+Pops data from the @queue. If @queue is empty, this function
+blocks until data becomes available.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
-<return> data from the queue.
+<return> data from the queue
</return>
</function>
<function name="g_async_queue_pop_unlocked">
<description>
-Pops data from the @queue. This function blocks until data become
-available. This function must be called while holding the @queue's
-lock.
+Pops data from the @queue. If @queue is empty, this function
+blocks until data becomes available.
+
+This function must be called while holding the @queue's lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1085,11 +1614,11 @@ Pushes the @data into the @queue. @data must not be %NULL.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> @data to push into the @queue.
+<parameter_description> @data to push into the @queue
</parameter_description>
</parameter>
</parameters>
@@ -1099,15 +1628,15 @@ Pushes the @data into the @queue. @data must not be %NULL.
<function name="g_async_queue_push_sorted">
<description>
Inserts @data into @queue using @func to determine the new
-position.
+position.
This function requires that the @queue is sorted before pushing on
-new elements.
+new elements, see g_async_queue_sort().
This function will lock @queue before it sorts the queue and unlock
it when it is finished.
-For an example of @func see g_async_queue_sort().
+For an example of @func see g_async_queue_sort().
Since: 2.10
@@ -1122,11 +1651,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GCompareDataFunc is used to sort @queue. This function
-is passed two elements of the @queue. The function should return
-0 if they are equal, a negative value if the first element
-should be higher in the @queue or a positive value if the first
-element should be lower in the @queue than the second element.
+<parameter_description> the #GCompareDataFunc is used to sort @queue
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -1142,12 +1667,18 @@ element should be lower in the @queue than the second element.
Inserts @data into @queue using @func to determine the new
position.
+The sort function @func is passed two elements of the @queue.
+It should return 0 if they are equal, a negative value if the
+first element should be higher in the @queue or a positive value
+if the first element should be lower in the @queue than the second
+element.
+
This function requires that the @queue is sorted before pushing on
-new elements.
+new elements, see g_async_queue_sort().
-This function is called while holding the @queue's lock.
+This function must be called while holding the @queue's lock.
-For an example of @func see g_async_queue_sort().
+For an example of @func see g_async_queue_sort().
Since: 2.10
@@ -1162,11 +1693,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GCompareDataFunc is used to sort @queue. This function
-is passed two elements of the @queue. The function should return
-0 if they are equal, a negative value if the first element
-should be higher in the @queue or a positive value if the first
-element should be lower in the @queue than the second element.
+<parameter_description> the #GCompareDataFunc is used to sort @queue
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -1179,17 +1706,18 @@ element should be lower in the @queue than the second element.
<function name="g_async_queue_push_unlocked">
<description>
-Pushes the @data into the @queue. @data must not be %NULL. This
-function must be called while holding the @queue's lock.
+Pushes the @data into the @queue. @data must not be %NULL.
+
+This function must be called while holding the @queue's lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> @data to push into the @queue.
+<parameter_description> @data to push into the @queue
</parameter_description>
</parameter>
</parameters>
@@ -1198,14 +1726,14 @@ function must be called while holding the @queue's lock.
<function name="g_async_queue_ref">
<description>
-Increases the reference count of the asynchronous @queue by 1. You
-do not need to hold the lock to call this function.
+Increases the reference count of the asynchronous @queue by 1.
+You do not need to hold the lock to call this function.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1224,7 +1752,7 @@ lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1233,7 +1761,13 @@ lock.
<function name="g_async_queue_sort">
<description>
-Sorts @queue using @func.
+Sorts @queue using @func.
+
+The sort function @func is passed two elements of the @queue.
+It should return 0 if they are equal, a negative value if the
+first element should be higher in the @queue or a positive value
+if the first element should be lower in the @queue than the second
+element.
This function will lock @queue before it sorts the queue and unlock
it when it is finished.
@@ -1259,12 +1793,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GCompareDataFunc is used to sort @queue. This
-function is passed two elements of the @queue. The function
-should return 0 if they are equal, a negative value if the
-first element should be higher in the @queue or a positive
-value if the first element should be lower in the @queue than
-the second element.
+<parameter_description> the #GCompareDataFunc is used to sort @queue
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -1277,9 +1806,15 @@ the second element.
<function name="g_async_queue_sort_unlocked">
<description>
-Sorts @queue using @func.
+Sorts @queue using @func.
-This function is called while holding the @queue's lock.
+The sort function @func is passed two elements of the @queue.
+It should return 0 if they are equal, a negative value if the
+first element should be higher in the @queue or a positive value
+if the first element should be lower in the @queue than the second
+element.
+
+This function must be called while holding the @queue's lock.
Since: 2.10
@@ -1290,12 +1825,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GCompareDataFunc is used to sort @queue. This
-function is passed two elements of the @queue. The function
-should return 0 if they are equal, a negative value if the
-first element should be higher in the @queue or a positive
-value if the first element should be lower in the @queue than
-the second element.
+<parameter_description> the #GCompareDataFunc is used to sort @queue
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -1308,65 +1838,124 @@ the second element.
<function name="g_async_queue_timed_pop">
<description>
-Pops data from the @queue. If no data is received before @end_time,
-%NULL is returned.
+Pops data from the @queue. If the queue is empty, blocks until
+ end_time or until data becomes available.
+
+If no data is received before @end_time, %NULL is returned.
-To easily calculate @end_time a combination of g_get_current_time()
+To easily calculate @end_time, a combination of g_get_current_time()
and g_time_val_add() can be used.
+Deprecated: use g_async_queue_timeout_pop().
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
<parameter name="end_time">
-<parameter_description> a #GTimeVal, determining the final time.
+<parameter_description> a #GTimeVal, determining the final time
</parameter_description>
</parameter>
</parameters>
<return> data from the queue or %NULL, when no data is
received before @end_time.
+
</return>
</function>
<function name="g_async_queue_timed_pop_unlocked">
<description>
-Pops data from the @queue. If no data is received before @end_time,
-%NULL is returned. This function must be called while holding the
- queue's lock.
+Pops data from the @queue. If the queue is empty, blocks until
+ end_time or until data becomes available.
-To easily calculate @end_time a combination of g_get_current_time()
+If no data is received before @end_time, %NULL is returned.
+
+To easily calculate @end_time, a combination of g_get_current_time()
and g_time_val_add() can be used.
+This function must be called while holding the @queue's lock.
+
+Deprecated: use g_async_queue_timeout_pop_unlocked().
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
<parameter name="end_time">
-<parameter_description> a #GTimeVal, determining the final time.
+<parameter_description> a #GTimeVal, determining the final time
</parameter_description>
</parameter>
</parameters>
<return> data from the queue or %NULL, when no data is
received before @end_time.
+
+</return>
+</function>
+
+<function name="g_async_queue_timeout_pop">
+<description>
+Pops data from the @queue. If the queue is empty, blocks for
+ timeout microseconds, or until data becomes available.
+
+If no data is received before the timeout, %NULL is returned.
+
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a #GAsyncQueue
+</parameter_description>
+</parameter>
+<parameter name="timeout">
+<parameter_description> the number of microseconds to wait
+</parameter_description>
+</parameter>
+</parameters>
+<return> data from the queue or %NULL, when no data is
+received before the timeout.
+</return>
+</function>
+
+<function name="g_async_queue_timeout_pop_unlocked">
+<description>
+Pops data from the @queue. If the queue is empty, blocks for
+ timeout microseconds, or until data becomes available.
+
+If no data is received before the timeout, %NULL is returned.
+
+This function must be called while holding the @queue's lock.
+
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a #GAsyncQueue
+</parameter_description>
+</parameter>
+<parameter name="time">
+<parameter_description> the number of microseconds to wait
+</parameter_description>
+</parameter>
+</parameters>
+<return> data from the queue or %NULL, when no data is
+received before the timeout.
</return>
</function>
<function name="g_async_queue_try_pop">
<description>
-Tries to pop data from the @queue. If no data is available, %NULL is
-returned.
+Tries to pop data from the @queue. If no data is available,
+%NULL is returned.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1377,15 +1966,16 @@ available immediately.
<function name="g_async_queue_try_pop_unlocked">
<description>
-Tries to pop data from the @queue. If no data is available, %NULL is
-returned. This function must be called while holding the @queue's
-lock.
+Tries to pop data from the @queue. If no data is available,
+%NULL is returned.
+
+This function must be called while holding the @queue's lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1398,10 +1988,14 @@ available immediately.
<description>
Releases the queue's lock.
+Calling this function when you have not acquired
+the with g_async_queue_lock() leads to undefined
+behaviour.
+
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1410,11 +2004,12 @@ Releases the queue's lock.
<function name="g_async_queue_unref">
<description>
-Decreases the reference count of the asynchronous @queue by 1. If
-the reference count went to 0, the @queue will be destroyed and the
-memory allocated will be freed. So you are not allowed to use the
- queue afterwards, as it might have disappeared. You do not need to
-hold the lock to call this function.
+Decreases the reference count of the asynchronous @queue by 1.
+
+If the reference count went to 0, the @queue will be destroyed
+and the memory allocated will be freed. So you are not allowed
+to use the @queue afterwards, as it might have disappeared.
+You do not need to hold the lock to call this function.
</description>
<parameters>
@@ -1428,10 +2023,10 @@ hold the lock to call this function.
<function name="g_async_queue_unref_and_unlock">
<description>
-Decreases the reference count of the asynchronous @queue by 1 and
-releases the lock. This function must be called while holding the
- queue's lock. If the reference count went to 0, the @queue will be
-destroyed and the memory allocated will be freed.
+Decreases the reference count of the asynchronous @queue by 1
+and releases the lock. This function must be called while holding
+the @queue's lock. If the reference count went to 0, the @queue
+will be destroyed and the memory allocated will be freed.
@Deprecated: Since 2.8, reference counting is done atomically
so g_async_queue_unref() can be used regardless of the @queue's
@@ -1440,7 +2035,7 @@ lock.
</description>
<parameters>
<parameter name="queue">
-<parameter_description> a #GAsyncQueue.
+<parameter_description> a #GAsyncQueue
</parameter_description>
</parameter>
</parameters>
@@ -1480,6 +2075,8 @@ As can be seen from the above, for portability it's best to avoid
calling g_atexit() (or atexit()) except in the main executable of a
program.
+Deprecated:2.32: It is best to avoid g_atexit().
+
</description>
<parameters>
<parameter name="func">
@@ -1499,6 +2096,9 @@ Think of this operation as an atomic version of
This call acts as a full compiler and hardware memory barrier.
+Before version 2.30, this function did not return a value
+(but g_atomic_int_exchange_and_add() did, and had the same meaning).
+
Since: 2.4
</description>
@@ -2104,6 +2704,9 @@ non-zero state). If you enable line-breaking you will need at least:
@break_lines is typically used when putting base64-encoded data in emails.
It breaks the lines at 72 columns instead of putting all of the text on
the same line. This avoids problems with long lines in the email system.
+Note however that it breaks the lines with <literal>LF</literal>
+characters, not <literal>CR LF</literal> sequences, so the result cannot
+be passed directly to SMTP or certain other protocols.
Since: 2.12
@@ -2141,21 +2744,24 @@ Since: 2.12
<function name="g_basename">
<description>
-Gets the name of the file without any leading directory components.
-It returns a pointer into the given file name string.
+Gets the name of the file without any leading directory
+components. It returns a pointer into the given file name
+string.
-Deprecated:2.2: Use g_path_get_basename() instead, but notice that
-g_path_get_basename() allocates new memory for the returned string, unlike
-this function which returns a pointer into the argument.
+Deprecated:2.2: Use g_path_get_basename() instead, but notice
+that g_path_get_basename() allocates new memory for the
+returned string, unlike this function which returns a pointer
+into the argument.
</description>
<parameters>
<parameter name="file_name">
-<parameter_description> the name of the file.
+<parameter_description> the name of the file
</parameter_description>
</parameter>
</parameters>
-<return> the name of the file without any leading directory components.
+<return> the name of the file without any leading
+directory components
</return>
</function>
@@ -2377,6 +2983,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if the lock was acquired
+
</return>
</function>
@@ -2406,19 +3013,6 @@ Since: 2.24
<return></return>
</function>
-<function name="g_blow_chunks">
-<description>
-Calls g_mem_chunk_clean() on all #GMemChunk objects.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_bookmark_file_add_application">
<description>
Adds the application with @name and @exec to the list of
@@ -2434,7 +3028,7 @@ time the application registered this bookmark.
If @name is %NULL, the name of the application will be the
same returned by g_get_application_name(); if @exec is %NULL, the
command line will be a composition of the program name as
-returned by g_get_prgname() and the "%u" modifier, which will be
+returned by g_get_prgname() and the "\%u" modifier, which will be
expanded to the bookmark's URI.
This function will automatically take care of updating the
@@ -3083,7 +3677,7 @@ of the file, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a key file could be loaded, %FALSE othewise
+<return> %TRUE if a key file could be loaded, %FALSE otherwise
</return>
</function>
@@ -3305,9 +3899,9 @@ and g_bookmark_file_remove_application() instead.
@name can be any UTF-8 encoded string used to identify an
application.
- exec can have one of these two modifiers: "%f", which will
+ exec can have one of these two modifiers: "\%f", which will
be expanded as the local file name retrieved from the bookmark's
-URI; "%u", which will be expanded as the bookmark's URI.
+URI; "\%u", which will be expanded as the bookmark's URI.
The expansion is done automatically when retrieving the stored
command line using the g_bookmark_file_get_app_info() function.
@count is the number of times the application has registered the
@@ -3893,6 +4487,32 @@ the size of @array will be set to zero.
</return>
</function>
+<function name="g_byte_array_free_to_bytes">
+<description>
+Transfers the data from the #GByteArray into a new immutable #GBytes.
+
+The #GByteArray is freed unless the reference count of @array is greater
+than one, the #GByteArray wrapper is preserved but the size of @array
+will be set to zero.
+
+This is identical to using g_bytes_new_take() and g_byte_array_free()
+together.
+
+Since: 2.32
+
+
+</description>
+<parameters>
+<parameter name="array">
+<parameter_description> a #GByteArray
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new immutable #GBytes representing same byte
+data that was in the array
+</return>
+</function>
+
<function name="g_byte_array_new">
<description>
Creates a new #GByteArray with a reference count of 1.
@@ -3904,6 +4524,29 @@ Creates a new #GByteArray with a reference count of 1.
</return>
</function>
+<function name="g_byte_array_new_take">
+<description>
+Create byte array containing the data. The data will be owned by the array
+and will be freed with g_free(), i.e. it could be allocated using g_strdup().
+
+Since: 2.32
+
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> byte data for the array
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> length of @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GByteArray
+</return>
+</function>
+
<function name="g_byte_array_prepend">
<description>
Adds the given data to the start of the #GByteArray. The array will
@@ -4060,8 +4703,8 @@ arg is less than second arg, zero for equal, greater than zero if
first arg is greater than second arg).
If two array elements compare equal, their order in the sorted array
-is undefined. If you want equal elements to keep their order &#8211; i.e.
-you want a stable sort &#8211; you can write a comparison function that,
+is undefined. If you want equal elements to keep their order (i.e.
+you want a stable sort) you can write a comparison function that,
if two elements would otherwise compare equal, compares them by
their addresses.
@@ -4121,6 +4764,355 @@ Since: 2.22
<return></return>
</function>
+<function name="g_bytes_compare">
+<description>
+Compares the two #GBytes values.
+
+This function can be used to sort GBytes instances in lexographical order.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes1">
+<parameter_description> a pointer to a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="bytes2">
+<parameter_description> a pointer to a #GBytes to compare with @bytes1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a negative value if bytes2 is lesser, a positive value if bytes2 is
+greater, and zero if bytes2 is equal to bytes1
+
+</return>
+</function>
+
+<function name="g_bytes_equal">
+<description>
+Compares the two #GBytes values being pointed to and returns
+%TRUE if they are equal.
+
+This function can be passed to g_hash_table_new() as the @key_equal_func
+parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes1">
+<parameter_description> a pointer to a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="bytes2">
+<parameter_description> a pointer to a #GBytes to compare with @bytes1
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the two keys match.
+
+</return>
+</function>
+
+<function name="g_bytes_get_data">
+<description>
+Get the byte data in the #GBytes. This data should not be modified.
+
+This function will always return the same pointer for a given #GBytes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> location to return size of byte data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the byte data
+
+</return>
+</function>
+
+<function name="g_bytes_get_size">
+<description>
+Get the size of the byte data in the #GBytes.
+
+This function will always return the same value for a given #GBytes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> the size
+
+</return>
+</function>
+
+<function name="g_bytes_hash">
+<description>
+Creates an integer hash code for the byte data in the #GBytes.
+
+This function can be passed to g_hash_table_new() as the @key_equal_func
+parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a pointer to a #GBytes key
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hash value corresponding to the key.
+
+</return>
+</function>
+
+<function name="g_bytes_new">
+<description>
+Creates a new #GBytes from @data.
+
+ data is copied.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> the data to be used for the bytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_new_from_bytes">
+<description>
+Creates a #GBytes which is a subsection of another #GBytes. The @offset +
+ length may not be longer than the size of @bytes.
+
+A reference to @bytes will be held by the newly created #GBytes until
+the byte data is no longer needed.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="offset">
+<parameter_description> offset which subsection starts at
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of subsection
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_new_static">
+<description>
+Creates a new #GBytes from static data.
+
+ data must be static (ie: never modified or freed).
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> the data to be used for the bytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_new_take">
+<description>
+Creates a new #GBytes from @data.
+
+After this call, @data belongs to the bytes and may no longer be
+modified by the caller. g_free() will be called on @data when the
+bytes is no longer in use. Because of this @data must have been created by
+a call to g_malloc(), g_malloc0() or g_realloc() or by one of the many
+functions that wrap these calls (such as g_new(), g_strdup(), etc).
+
+For creating #GBytes with memory from other allocators, see
+g_bytes_new_with_free_func().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> the data to be used for the bytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_new_with_free_func">
+<description>
+Creates a #GBytes from @data.
+
+When the last reference is dropped, @free_func will be called with the
+ user_data argument.
+
+ data must not be modified after this call is made until @free_func has
+been called to indicate that the bytes is no longer in use.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> the data to be used for the bytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> the size of @data
+</parameter_description>
+</parameter>
+<parameter name="free_func">
+<parameter_description> the function to call to release the data
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @free_func
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_ref">
+<description>
+Increase the reference count on @bytes.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GBytes
+
+</return>
+</function>
+
+<function name="g_bytes_unref">
+<description>
+Releases a reference on @bytes. This may result in the bytes being
+freed.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_bytes_unref_to_array">
+<description>
+Unreferences the bytes, and returns a new mutable #GByteArray containing
+the same byte data.
+
+As an optimization, the byte data is transferred to the array without copying
+if this was the last reference to bytes and bytes was created with
+g_bytes_new(), g_bytes_new_take() or g_byte_array_free_to_bytes(). In all
+other cases the data is copied.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new mutable #GByteArray containing the same byte data
+
+</return>
+</function>
+
+<function name="g_bytes_unref_to_data">
+<description>
+Unreferences the bytes, and returns a pointer the same byte data
+contents.
+
+As an optimization, the byte data is returned without copying if this was
+the last reference to bytes and bytes was created with g_bytes_new(),
+g_bytes_new_take() or g_byte_array_free_to_bytes(). In all other cases the
+data is copied.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="size">
+<parameter_description> location to place the length of the returned data
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the same byte data, which should
+be freed with g_free()
+
+</return>
+</function>
+
<function name="g_cache_destroy">
<description>
Frees the memory allocated for the #GCache.
@@ -4128,10 +5120,12 @@ Frees the memory allocated for the #GCache.
Note that it does not destroy the keys and values which were
contained in the #GCache.
+Deprecated:2.32: Use a #GHashTable instead
+
</description>
<parameters>
<parameter name="cache">
-<parameter_description> a #GCache.
+<parameter_description> a #GCache
</parameter_description>
</parameter>
</parameters>
@@ -4149,18 +5143,21 @@ exist, if is created by calling the @value_new_func. The key is
duplicated by calling @key_dup_func and the duplicated key and value
are inserted into the #GCache.
+Deprecated:2.32: Use a #GHashTable instead
+
</description>
<parameters>
<parameter name="cache">
-<parameter_description> a #GCache.
+<parameter_description> a #GCache
</parameter_description>
</parameter>
<parameter name="key">
-<parameter_description> a key describing a #GCache object.
+<parameter_description> a key describing a #GCache object
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to a #GCache value.
+<return> a pointer to a #GCache value
+
</return>
</function>
@@ -4173,18 +5170,20 @@ entry and the @user_data. The order of value and key is different
from the order in which g_hash_table_foreach() passes key-value
pairs to its callback function !
+Deprecated:2.32: Use a #GHashTable instead
+
</description>
<parameters>
<parameter name="cache">
-<parameter_description> a #GCache.
+<parameter_description> a #GCache
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the function to call with each #GCache key.
+<parameter_description> the function to call with each #GCache key
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
@@ -4195,48 +5194,51 @@ pairs to its callback function !
<description>
Creates a new #GCache.
+Deprecated:2.32: Use a #GHashTable instead
+
</description>
<parameters>
<parameter name="value_new_func">
<parameter_description> a function to create a new object given a key.
This is called by g_cache_insert() if an object
-with the given key does not already exist.
+with the given key does not already exist
</parameter_description>
</parameter>
<parameter name="value_destroy_func">
<parameter_description> a function to destroy an object. It is called
by g_cache_remove() when the object is no
longer needed (i.e. its reference count drops
-to 0).
+to 0)
</parameter_description>
</parameter>
<parameter name="key_dup_func">
<parameter_description> a function to copy a key. It is called by
g_cache_insert() if the key does not already exist in
-the #GCache.
+the #GCache
</parameter_description>
</parameter>
<parameter name="key_destroy_func">
<parameter_description> a function to destroy a key. It is called by
g_cache_remove() when the object is no longer
-needed (i.e. its reference count drops to 0).
+needed (i.e. its reference count drops to 0)
</parameter_description>
</parameter>
<parameter name="hash_key_func">
-<parameter_description> a function to create a hash value from a key.
+<parameter_description> a function to create a hash value from a key
</parameter_description>
</parameter>
<parameter name="hash_value_func">
-<parameter_description> a function to create a hash value from a value.
+<parameter_description> a function to create a hash value from a value
</parameter_description>
</parameter>
<parameter name="key_equal_func">
<parameter_description> a function to compare two keys. It should return
-%TRUE if the two keys are equivalent.
+%TRUE if the two keys are equivalent
</parameter_description>
</parameter>
</parameters>
-<return> a new #GCache.
+<return> a new #GCache
+
</return>
</function>
@@ -4246,14 +5248,16 @@ Decreases the reference count of the given value. If it drops to 0
then the value and its corresponding key are destroyed, using the
@value_destroy_func and @key_destroy_func passed to g_cache_new().
+Deprecated:2.32: Use a #GHashTable instead
+
</description>
<parameters>
<parameter name="cache">
-<parameter_description> a #GCache.
+<parameter_description> a #GCache
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> the value to remove.
+<parameter_description> the value to remove
</parameter_description>
</parameter>
</parameters>
@@ -4265,21 +5269,20 @@ then the value and its corresponding key are destroyed, using the
Calls the given function for each of the values in the #GCache.
Deprecated:2.10: The reason is that it passes pointers to internal
-data structures to @func; use g_cache_key_foreach()
-instead
+data structures to @func; use g_cache_key_foreach() instead
</description>
<parameters>
<parameter name="cache">
-<parameter_description> a #GCache.
+<parameter_description> a #GCache
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the function to call with each #GCache value.
+<parameter_description> the function to call with each #GCache value
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
@@ -5602,77 +6605,6 @@ Since: 2.8
</return>
</function>
-<function name="g_chunk_free">
-<description>
-A convenience macro to free an atom of memory from a #GMemChunk. It
-simply switches the arguments and calls g_mem_chunk_free() It is
-included simply to complement the other convenience macros,
-g_chunk_new() and g_chunk_new0().
-
-Deprecated:2.10: Use g_slice_free() instead
-
-</description>
-<parameters>
-<parameter name="mem">
-<parameter_description> a pointer to the atom to be freed.
-</parameter_description>
-</parameter>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_chunk_new">
-<description>
-A convenience macro to allocate an atom of memory from a #GMemChunk.
-It calls g_mem_chunk_alloc() and casts the returned atom to a
-pointer to the given type, avoiding a type cast in the source code.
-
-Deprecated:2.10: Use g_slice_new() instead
-
-</description>
-<parameters>
-<parameter name="type">
-<parameter_description> the type of the #GMemChunk atoms, typically a structure name.
-</parameter_description>
-</parameter>
-<parameter name="chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a pointer to the allocated atom, cast to a pointer to
- type
-</return>
-</function>
-
-<function name="g_chunk_new0">
-<description>
-A convenience macro to allocate an atom of memory from a #GMemChunk.
-It calls g_mem_chunk_alloc0() and casts the returned atom to a
-pointer to the given type, avoiding a type cast in the source code.
-
-Deprecated:2.10: Use g_slice_new0() instead
-
-</description>
-<parameters>
-<parameter name="type">
-<parameter_description> the type of the #GMemChunk atoms, typically a structure name.
-</parameter_description>
-</parameter>
-<parameter name="chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a pointer to the allocated atom, cast to a pointer to
- type
-</return>
-</function>
-
<function name="g_clear_error">
<description>
If @err is %NULL, does nothing. If @err is non-%NULL,
@@ -5838,8 +6770,9 @@ Invokes the closure, i.e. executes the callback represented by the @closure.
</parameter_description>
</parameter>
<parameter name="return_value">
-<parameter_description> a #GValue to store the return value. May be %NULL if the
-callback of @closure doesn't return a value.
+<parameter_description> a #GValue to store the return
+value. May be %NULL if the callback of @closure
+doesn't return a value.
</parameter_description>
</parameter>
<parameter name="n_param_values">
@@ -6075,7 +7008,7 @@ means that the initial reference count is not owned by any caller.
g_closure_sink() checks to see if the object is still floating, and
if so, unsets the floating state and decreases the reference
count. If the closure is not floating, g_closure_sink() does
-nothing. The reason for the existance of the floating state is to
+nothing. The reason for the existence of the floating state is to
prevent cumbersome code sequences like:
|[
closure = g_cclosure_new (cb_func, cb_data);
@@ -6376,19 +7309,116 @@ should be freed with g_free() when done using it.
</return>
</function>
+<function name="g_compute_hmac_for_data">
+<description>
+Computes the HMAC for a binary @data of @length. This is a
+convenience wrapper for g_hmac_new(), g_hmac_get_string()
+and g_hmac_unref().
+
+The hexadecimal string returned will be in lower case.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="digest_type">
+<parameter_description> a #GChecksumType to use for the HMAC
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to use in the HMAC
+</parameter_description>
+</parameter>
+<parameter name="key_len">
+<parameter_description> the length of the key
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> binary blob to compute the HMAC of
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> the HMAC of the binary data as a string in hexadecimal.
+The returned string should be freed with g_free() when done using it.
+
+</return>
+</function>
+
+<function name="g_compute_hmac_for_string">
+<description>
+Computes the HMAC for a string.
+
+The hexadecimal string returned will be in lower case.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="digest_type">
+<parameter_description> a #GChecksumType to use for the HMAC
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to use in the HMAC
+</parameter_description>
+</parameter>
+<parameter name="key_len">
+<parameter_description> the length of the key
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> the string to compute the HMAC for
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the string, or -1 if the string is nul-terminated
+</parameter_description>
+</parameter>
+</parameters>
+<return> the HMAC as a hexadecimal string.
+The returned string should be freed with g_free()
+when done using it.
+
+</return>
+</function>
+
<function name="g_cond_broadcast">
<description>
-If threads are waiting for @cond, all of them are woken up. It is
-good practice to lock the same mutex as the waiting threads, while
-calling this function, though not required.
+If threads are waiting for @cond, all of them are unblocked.
+If no threads are waiting for @cond, this function has no effect.
+It is good practice to lock the same mutex as the waiting threads
+while calling this function, though not required.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will do nothing.
+</description>
+<parameters>
+<parameter name="cond">
+<parameter_description> a #GCond
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_cond_clear">
+<description>
+Frees the resources allocated to a #GCond with g_cond_init().
+
+This function should not be used with a #GCond that has been
+statically allocated.
+
+Calling g_cond_clear() for a #GCond on which threads are
+blocking leads to undefined behaviour.
+
+Since: 2.32
</description>
<parameters>
<parameter name="cond">
-<parameter_description> a #GCond.
+<parameter_description> an initialised #GCond
</parameter_description>
</parameter>
</parameters>
@@ -6397,12 +7427,44 @@ called, and, in that case, will do nothing.
<function name="g_cond_free">
<description>
-Destroys the #GCond.
+Destroys a #GCond that has been created with g_cond_new().
+
+Calling g_cond_free() for a #GCond on which threads are
+blocking leads to undefined behaviour.
+
+Deprecated:3.32:GCond can now be statically allocated, or embedded
+in structures and initialised with g_cond_init().
</description>
<parameters>
<parameter name="cond">
-<parameter_description> a #GCond.
+<parameter_description> a #GCond
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_cond_init">
+<description>
+Initialises a #GCond so that it can be used.
+
+This function is useful to initialise a #GCond that has been
+allocated as part of a larger structure. It is not necessary to
+initialise a #GCond that has been statically allocated.
+
+To undo the effect of g_cond_init() when a #GCond is no longer
+needed, use g_cond_clear().
+
+Calling g_cond_init() on an already-initialised #GCond leads
+to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="cond">
+<parameter_description> an uninitialized #GCond
</parameter_description>
</parameter>
</parameters>
@@ -6411,29 +7473,30 @@ Destroys the #GCond.
<function name="g_cond_new">
<description>
-Creates a new #GCond. This function will abort, if g_thread_init()
-has not been called yet.
+Allocates and initializes a new #GCond.
+
+Deprecated:3.32:GCond can now be statically allocated, or embedded
+in structures and initialised with g_cond_init().
</description>
<parameters>
</parameters>
-<return> a new #GCond.
+<return> a newly allocated #GCond. Free with g_cond_free()
+
</return>
</function>
<function name="g_cond_signal">
<description>
-If threads are waiting for @cond, exactly one of them is woken up.
+If threads are waiting for @cond, at least one of them is unblocked.
+If no threads are waiting for @cond, this function has no effect.
It is good practice to hold the same lock as the waiting thread
while calling this function, though not required.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will do nothing.
-
</description>
<parameters>
<parameter name="cond">
-<parameter_description> a #GCond.
+<parameter_description> a #GCond
</parameter_description>
</parameter>
</parameters>
@@ -6454,192 +7517,134 @@ called, and, in that case, will immediately return %TRUE.
To easily calculate @abs_time a combination of g_get_current_time()
and g_time_val_add() can be used.
+Deprecated:2.32: Use g_cond_wait_until() instead.
+
</description>
<parameters>
<parameter name="cond">
-<parameter_description> a #GCond.
+<parameter_description> a #GCond
</parameter_description>
</parameter>
<parameter name="mutex">
-<parameter_description> a #GMutex that is currently locked.
+<parameter_description> a #GMutex that is currently locked
</parameter_description>
</parameter>
<parameter name="abs_time">
-<parameter_description> a #GTimeVal, determining the final time.
+<parameter_description> a #GTimeVal, determining the final time
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @cond was signalled, or %FALSE on timeout.
+<return> %TRUE if @cond was signalled, or %FALSE on timeout
</return>
</function>
<function name="g_cond_wait">
<description>
-Waits until this thread is woken up on @cond. The @mutex is unlocked
-before falling asleep and locked again before resuming.
+Atomically releases @mutex and waits until @cond is signalled.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will immediately return.
+When using condition variables, it is possible that a spurious wakeup
+may occur (ie: g_cond_wait() returns even though g_cond_signal() was
+not called). It's also possible that a stolen wakeup may occur.
+This is when g_cond_signal() is called, but another thread acquires
+ mutex before this thread and modifies the state of the program in
+such a way that when g_cond_wait() is able to return, the expected
+condition is no longer met.
+
+For this reason, g_cond_wait() must always be used in a loop. See
+the documentation for #GCond for a complete example.
</description>
<parameters>
<parameter name="cond">
-<parameter_description> a #GCond.
+<parameter_description> a #GCond
</parameter_description>
</parameter>
<parameter name="mutex">
-<parameter_description> a #GMutex, that is currently locked.
+<parameter_description> a #GMutex that is currently locked
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_convert">
+<function name="g_cond_wait_until">
<description>
-Converts a string from one character set to another.
+Waits until either @cond is signalled or @end_time has passed.
-Note that you should use g_iconv() for streaming
-conversions<footnoteref linkend="streaming-state"/>.
+As with g_cond_wait() it is possible that a spurious or stolen wakeup
+could occur. For that reason, waiting on a condition variable should
+always be in a loop, based on an explicitly-checked predicate.
+%TRUE is returned if the condition variable was signalled (or in the
+case of a spurious wakeup). %FALSE is returned if @end_time has
+passed.
-</description>
-<parameters>
-<parameter name="str">
-<parameter_description> the string to convert
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> the length of the string, or -1 if the string is
-nul-terminated<footnote id="nul-unsafe">
- <para>
- Note that some encodings may allow nul bytes to
- occur inside strings. In that case, using -1 for
- the @len parameter is unsafe.
- </para>
- </footnote>.
-</parameter_description>
-</parameter>
-<parameter name="to_codeset">
-<parameter_description> name of character set into which to convert @str
-</parameter_description>
-</parameter>
-<parameter name="from_codeset">
-<parameter_description> character set of @str.
-</parameter_description>
-</parameter>
-<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
-input string that were successfully converted, or %NULL.
-Even if the conversion was successful, this may be
-less than @len if there were partial characters
-at the end of the input. If the error
-#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
-stored will the byte offset after the last valid
-input sequence.
-</parameter_description>
-</parameter>
-<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
-</parameter_description>
-</parameter>
-</parameters>
-<return> If the conversion was successful, a newly allocated
-nul-terminated string, which must be freed with
-g_free(). Otherwise %NULL and @error will be set.
-</return>
-</function>
+The following code shows how to correctly perform a timed wait on a
+condition variable (extended the example presented in the
+documentation for #GCond):
-<function name="g_convert_with_fallback">
-<description>
-Converts a string from one character set to another, possibly
-including fallback sequences for characters not representable
-in the output. Note that it is not guaranteed that the specification
-for the fallback sequences in @fallback will be honored. Some
-systems may do an approximate conversion from @from_codeset
-to @to_codeset in their iconv() functions,
-in which case GLib will simply return that approximate conversion.
+|[
+gpointer
+pop_data_timed (void)
+{
+gint64 end_time;
+gpointer data;
-Note that you should use g_iconv() for streaming
-conversions<footnoteref linkend="streaming-state"/>.
+g_mutex_lock (&data_mutex);
+
+end_time = g_get_monotonic_time () + 5 * G_TIME_SPAN_SECOND;
+while (!current_data)
+if (!g_cond_wait_until (&data_cond, &data_mutex, end_time))
+{
+// timeout has passed.
+g_mutex_unlock (&data_mutex);
+return NULL;
+}
+
+// there is data for us
+data = current_data;
+current_data = NULL;
+g_mutex_unlock (&data_mutex);
+
+return data;
+}
+]|
+
+Notice that the end time is calculated once, before entering the
+loop and reused. This is the motivation behind the use of absolute
+time on this API -- if a relative time of 5 seconds were passed
+directly to the call and a spurious wakeup occurred, the program would
+have to start over waiting again (which would lead to a total wait
+time of more than 5 seconds).
+
+Since: 2.32
</description>
<parameters>
-<parameter name="str">
-<parameter_description> the string to convert
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> the length of the string, or -1 if the string is
-nul-terminated<footnoteref linkend="nul-unsafe"/>.
-</parameter_description>
-</parameter>
-<parameter name="to_codeset">
-<parameter_description> name of character set into which to convert @str
-</parameter_description>
-</parameter>
-<parameter name="from_codeset">
-<parameter_description> character set of @str.
-</parameter_description>
-</parameter>
-<parameter name="fallback">
-<parameter_description> UTF-8 string to use in place of character not
-present in the target encoding. (The string must be
-representable in the target encoding).
- If %NULL, characters not in the target encoding will
- be represented as Unicode escapes \uxxxx or \Uxxxxyyyy.
-</parameter_description>
-</parameter>
-<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
-input string that were successfully converted, or %NULL.
-Even if the conversion was successful, this may be
-less than @len if there were partial characters
-at the end of the input.
+<parameter name="cond">
+<parameter_description> a #GCond
</parameter_description>
</parameter>
-<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
+<parameter name="mutex">
+<parameter_description> a #GMutex that is currently locked
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
+<parameter name="end_time">
+<parameter_description> the monotonic time to wait until
</parameter_description>
</parameter>
</parameters>
-<return> If the conversion was successful, a newly allocated
-nul-terminated string, which must be freed with
-g_free(). Otherwise %NULL and @error will be set.
+<return> %TRUE on a signal, %FALSE on a timeout
</return>
</function>
-<function name="g_convert_with_iconv">
+<function name="g_convert">
<description>
-Converts a string from one character set to another.
+Converts a string from one character set to another.
Note that you should use g_iconv() for streaming
-conversions<footnote id="streaming-state">
-<para>
-Despite the fact that @byes_read can return information about partial
-characters, the <literal>g_convert_...</literal> functions
-are not generally suitable for streaming. If the underlying converter
-being used maintains internal state, then this won't be preserved
-across successive calls to g_convert(), g_convert_with_iconv() or
-g_convert_with_fallback(). (An example of this is the GNU C converter
-for CP1255 which does not emit a base character until it knows that
-the next character is not a mark that could combine with the base
-character.)
-</para>
-</footnote>.
+conversions<footnoteref linkend="streaming-state"/>.
</description>
@@ -6650,15 +7655,25 @@ character.)
</parameter>
<parameter name="len">
<parameter_description> the length of the string, or -1 if the string is
-nul-terminated<footnoteref linkend="nul-unsafe"/>.
+nul-terminated<footnote id="nul-unsafe">
+ <para>
+ Note that some encodings may allow nul bytes to
+ occur inside strings. In that case, using -1 for
+ the @len parameter is unsafe.
+ </para>
+ </footnote>.
</parameter_description>
</parameter>
-<parameter name="converter">
-<parameter_description> conversion descriptor from g_iconv_open()
+<parameter name="to_codeset">
+<parameter_description> name of character set into which to convert @str
+</parameter_description>
+</parameter>
+<parameter name="from_codeset">
+<parameter_description> character set of @str.
</parameter_description>
</parameter>
<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
+<parameter_description> location to store the number of bytes in the
input string that were successfully converted, or %NULL.
Even if the conversion was successful, this may be
less than @len if there were partial characters
@@ -6674,7 +7689,136 @@ including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> If the conversion was successful, a newly allocated
+nul-terminated string, which must be freed with
+g_free(). Otherwise %NULL and @error will be set.
+</return>
+</function>
+
+<function name="g_convert_with_fallback">
+<description>
+Converts a string from one character set to another, possibly
+including fallback sequences for characters not representable
+in the output. Note that it is not guaranteed that the specification
+for the fallback sequences in @fallback will be honored. Some
+systems may do an approximate conversion from @from_codeset
+to @to_codeset in their iconv() functions,
+in which case GLib will simply return that approximate conversion.
+
+Note that you should use g_iconv() for streaming
+conversions<footnoteref linkend="streaming-state"/>.
+
+
+</description>
+<parameters>
+<parameter name="str">
+<parameter_description> the string to convert
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the length of the string, or -1 if the string is
+nul-terminated<footnoteref linkend="nul-unsafe"/>.
+</parameter_description>
+</parameter>
+<parameter name="to_codeset">
+<parameter_description> name of character set into which to convert @str
+</parameter_description>
+</parameter>
+<parameter name="from_codeset">
+<parameter_description> character set of @str.
+</parameter_description>
+</parameter>
+<parameter name="fallback">
+<parameter_description> UTF-8 string to use in place of character not
+present in the target encoding. (The string must be
+representable in the target encoding).
+ If %NULL, characters not in the target encoding will
+ be represented as Unicode escapes \uxxxx or \Uxxxxyyyy.
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> location to store the number of bytes in the
+input string that were successfully converted, or %NULL.
+Even if the conversion was successful, this may be
+less than @len if there were partial characters
+at the end of the input.
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> the number of bytes stored in the output buffer (not
+including the terminating nul).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> If the conversion was successful, a newly allocated
+nul-terminated string, which must be freed with
+g_free(). Otherwise %NULL and @error will be set.
+</return>
+</function>
+
+<function name="g_convert_with_iconv">
+<description>
+Converts a string from one character set to another.
+
+Note that you should use g_iconv() for streaming
+conversions<footnote id="streaming-state">
+<para>
+Despite the fact that @byes_read can return information about partial
+characters, the <literal>g_convert_...</literal> functions
+are not generally suitable for streaming. If the underlying converter
+being used maintains internal state, then this won't be preserved
+across successive calls to g_convert(), g_convert_with_iconv() or
+g_convert_with_fallback(). (An example of this is the GNU C converter
+for CP1255 which does not emit a base character until it knows that
+the next character is not a mark that could combine with the base
+character.)
+</para>
+</footnote>.
+
+
+</description>
+<parameters>
+<parameter name="str">
+<parameter_description> the string to convert
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the length of the string, or -1 if the string is
+nul-terminated<footnoteref linkend="nul-unsafe"/>.
+</parameter_description>
+</parameter>
+<parameter name="converter">
+<parameter_description> conversion descriptor from g_iconv_open()
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> location to store the number of bytes in the
+input string that were successfully converted, or %NULL.
+Even if the conversion was successful, this may be
+less than @len if there were partial characters
+at the end of the input. If the error
+#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
+stored will the byte offset after the last valid
+input sequence.
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> the number of bytes stored in the output buffer (not
+including the terminating nul).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError may occur.
</parameter_description>
</parameter>
@@ -6726,6 +7870,30 @@ return value can be used exactly like the return value from creat().
</return>
</function>
+<function name="g_critical">
+<description>
+Logs a "critical warning" (#G_LOG_LEVEL_CRITICAL).
+It's more or less application-defined what constitutes
+a critical vs. a regular warning. You could call
+g_log_set_always_fatal() to make critical warnings exit
+the program, then use g_critical() for fatal errors, for
+example.
+
+You can also make critical warnings fatal at runtime by
+setting the <envar>G_DEBUG</envar> environment variable (see
+<ulink url="glib-running.html">Running GLib Applications</ulink>).
+
+</description>
+<parameters>
+<parameter name="Varargs">
+<parameter_description> format string, followed by parameters to insert
+into the format string (as with printf())
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_datalist_clear">
<description>
Frees all the data elements of the datalist.
@@ -6771,16 +7939,16 @@ not be called.
<function name="g_datalist_get_data">
<description>
-Gets a data element, using its string identifer. This is slower than
+Gets a data element, using its string identifier. This is slower than
g_datalist_id_get_data() because it compares strings.
</description>
<parameters>
-<parameter name="dl">
+<parameter name="datalist">
<parameter_description> a datalist.
</parameter_description>
</parameter>
-<parameter name="k">
+<parameter name="key">
<parameter_description> the string identifying a data element.
</parameter_description>
</parameter>
@@ -7346,820 +8514,837 @@ free any memory allocated for it.
<return></return>
</function>
-<function name="g_date_get_iso8601_week_of_year">
+<function name="g_date_add_days">
<description>
-Returns the week of the year, where weeks are interpreted according
-to ISO 8601.
-
-Since: 2.6
+Increments a date some number of days.
+To move forward by weeks, add weeks*7 days.
+The date must be valid.
</description>
<parameters>
<parameter name="date">
-<parameter_description> a valid #GDate
+<parameter_description> a #GDate to increment
+</parameter_description>
+</parameter>
+<parameter name="n_days">
+<parameter_description> number of days to move the date forward
</parameter_description>
</parameter>
</parameters>
-<return> ISO 8601 week number of the year.
-
-</return>
+<return></return>
</function>
-<function name="g_date_set_time">
+<function name="g_date_add_months">
<description>
-Sets the value of a date from a #GTime value.
-The time to date conversion is done using the user's current timezone.
-
-Deprecated: 2.10: Use g_date_set_time_t() instead.
+Increments a date by some number of months.
+If the day of the month is greater than 28,
+this routine may change the day of the month
+(because the destination month may not have
+the current day in it). The date must be valid.
</description>
<parameters>
<parameter name="date">
-<parameter_description> a #GDate.
+<parameter_description> a #GDate to increment
</parameter_description>
</parameter>
-<parameter name="time_">
-<parameter_description> #GTime value to set.
+<parameter name="n_months">
+<parameter_description> number of months to move forward
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_date_set_time_t">
+<function name="g_date_add_years">
<description>
-Sets the value of a date to the date corresponding to a time
-specified as a time_t. The time to date conversion is done using
-the user's current timezone.
-
-To set the value of a date to the current day, you could write:
-|[
-g_date_set_time_t (date, time (NULL));
-]|
-
-Since: 2.10
+Increments a date by some number of years.
+If the date is February 29, and the destination
+year is not a leap year, the date will be changed
+to February 28. The date must be valid.
</description>
<parameters>
<parameter name="date">
-<parameter_description> a #GDate
+<parameter_description> a #GDate to increment
</parameter_description>
</parameter>
-<parameter name="timet">
-<parameter_description> <type>time_t</type> value to set
+<parameter name="n_years">
+<parameter_description> number of years to move forward
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_date_set_time_val">
+<function name="g_date_clamp">
<description>
-Sets the value of a date from a #GTimeVal value. Note that the
- tv_usec member is ignored, because #GDate can't make use of the
-additional precision.
-
-The time to date conversion is done using the user's current timezone.
-
-Since: 2.10
+If @date is prior to @min_date, sets @date equal to @min_date.
+If @date falls after @max_date, sets @date equal to @max_date.
+Otherwise, @date is unchanged.
+Either of @min_date and @max_date may be %NULL.
+All non-%NULL dates must be valid.
</description>
<parameters>
<parameter name="date">
-<parameter_description> a #GDate
+<parameter_description> a #GDate to clamp
</parameter_description>
</parameter>
-<parameter name="timeval">
-<parameter_description> #GTimeVal value to set
+<parameter name="min_date">
+<parameter_description> minimum accepted value for @date
+</parameter_description>
+</parameter>
+<parameter name="max_date">
+<parameter_description> maximum accepted value for @date
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_date_time_add">
+<function name="g_date_clear">
<description>
-Creates a copy of @datetime and adds the specified timespan to the copy.
-
-Since: 2.26
+Initializes one or more #GDate structs to a sane but invalid
+state. The cleared dates will not represent an existing date, but will
+not contain garbage. Useful to init a date declared on the stack.
+Validity can be tested with g_date_valid().
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> pointer to one or more dates to clear
</parameter_description>
</parameter>
-<parameter name="timespan">
-<parameter_description> a #GTimeSpan
+<parameter name="n_dates">
+<parameter_description> number of dates to clear
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_add_days">
+<function name="g_date_compare">
<description>
-Creates a copy of @datetime and adds the specified number of days to the
-copy.
+qsort()-style comparison function for dates.
+Both dates must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="lhs">
+<parameter_description> first date to compare
</parameter_description>
</parameter>
-<parameter name="days">
-<parameter_description> the number of days
+<parameter name="rhs">
+<parameter_description> second date to compare
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> 0 for equal, less than zero if @lhs is less than @rhs,
+greater than zero if @lhs is greater than @rhs
</return>
</function>
-<function name="g_date_time_add_full">
+<function name="g_date_days_between">
<description>
-Creates a new #GDateTime adding the specified values to the current date and
-time in @datetime.
+Computes the number of days between two dates.
+If @date2 is prior to @date1, the returned value is negative.
+Both dates must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date1">
+<parameter_description> the first date
</parameter_description>
</parameter>
-<parameter name="years">
-<parameter_description> the number of years to add
+<parameter name="date2">
+<parameter_description> the second date
</parameter_description>
</parameter>
-<parameter name="months">
-<parameter_description> the number of months to add
+</parameters>
+<return> the number of days between @date1 and @date2
+</return>
+</function>
+
+<function name="g_date_free">
+<description>
+Frees a #GDate returned from g_date_new().
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate to free
</parameter_description>
</parameter>
-<parameter name="days">
-<parameter_description> the number of days to add
+</parameters>
+<return></return>
+</function>
+
+<function name="g_date_get_day">
+<description>
+Returns the day of the month. The date must be valid.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate to extract the day of the month from
</parameter_description>
</parameter>
-<parameter name="hours">
-<parameter_description> the number of hours to add
+</parameters>
+<return> day of the month
+</return>
+</function>
+
+<function name="g_date_get_day_of_year">
+<description>
+Returns the day of the year, where Jan 1 is the first day of the
+year. The date must be valid.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate to extract day of year from
</parameter_description>
</parameter>
-<parameter name="minutes">
-<parameter_description> the number of minutes to add
+</parameters>
+<return> day of the year
+</return>
+</function>
+
+<function name="g_date_get_days_in_month">
+<description>
+Returns the number of days in a month, taking leap
+years into account.
+
+
+</description>
+<parameters>
+<parameter name="month">
+<parameter_description> month
</parameter_description>
</parameter>
-<parameter name="seconds">
-<parameter_description> the number of seconds to add
+<parameter name="year">
+<parameter_description> year
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime that should be freed with
-g_date_time_unref().
-
+<return> number of days in @month during the @year
</return>
</function>
-<function name="g_date_time_add_hours">
+<function name="g_date_get_iso8601_week_of_year">
<description>
-Creates a copy of @datetime and adds the specified number of hours
+Returns the week of the year, where weeks are interpreted according
+to ISO 8601.
-Since: 2.26
+Since: 2.6
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
-</parameter_description>
-</parameter>
-<parameter name="hours">
-<parameter_description> the number of hours to add
+<parameter name="date">
+<parameter_description> a valid #GDate
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
+<return> ISO 8601 week number of the year.
</return>
</function>
-<function name="g_date_time_add_minutes">
+<function name="g_date_get_julian">
<description>
-Creates a copy of @datetime adding the specified number of minutes.
+Returns the Julian day or "serial number" of the #GDate. The
+Julian day is simply the number of days since January 1, Year 1; i.e.,
+January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,
+etc. The date must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
-</parameter_description>
-</parameter>
-<parameter name="minutes">
-<parameter_description> the number of minutes to add
+<parameter name="date">
+<parameter_description> a #GDate to extract the Julian day from
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> Julian day
</return>
</function>
-<function name="g_date_time_add_months">
+<function name="g_date_get_monday_week_of_year">
<description>
-Creates a copy of @datetime and adds the specified number of months to the
-copy.
+Returns the week of the year, where weeks are understood to start on
+Monday. If the date is before the first Monday of the year, return
+0. The date must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
-<parameter name="months">
-<parameter_description> the number of months
+</parameters>
+<return> week of the year
+</return>
+</function>
+
+<function name="g_date_get_monday_weeks_in_year">
+<description>
+Returns the number of weeks in the year, where weeks
+are taken to start on Monday. Will be 52 or 53. The
+date must be valid. (Years always have 52 7-day periods,
+plus 1 or 2 extra days depending on whether it's a leap
+year. This function is basically telling you how many
+Mondays are in the year, i.e. there are 53 Mondays if
+one of the extra days happens to be a Monday.)
+
+
+</description>
+<parameters>
+<parameter name="year">
+<parameter_description> a year
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> number of Mondays in the year
</return>
</function>
-<function name="g_date_time_add_seconds">
+<function name="g_date_get_month">
<description>
-Creates a copy of @datetime and adds the specified number of seconds.
+Returns the month of the year. The date must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate to get the month from
</parameter_description>
</parameter>
-<parameter name="seconds">
-<parameter_description> the number of seconds to add
+</parameters>
+<return> month of the year as a #GDateMonth
+</return>
+</function>
+
+<function name="g_date_get_sunday_week_of_year">
+<description>
+Returns the week of the year during which this date falls, if weeks
+are understood to being on Sunday. The date must be valid. Can return
+0 if the day is before the first Sunday of the year.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> week number
</return>
</function>
-<function name="g_date_time_add_weeks">
+<function name="g_date_get_sunday_weeks_in_year">
<description>
-Creates a copy of @datetime and adds the specified number of weeks to the
-copy.
+Returns the number of weeks in the year, where weeks
+are taken to start on Sunday. Will be 52 or 53. The
+date must be valid. (Years always have 52 7-day periods,
+plus 1 or 2 extra days depending on whether it's a leap
+year. This function is basically telling you how many
+Sundays are in the year, i.e. there are 53 Sundays if
+one of the extra days happens to be a Sunday.)
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="year">
+<parameter_description> year to count weeks in
</parameter_description>
</parameter>
-<parameter name="weeks">
-<parameter_description> the number of weeks
+</parameters>
+<return> the number of weeks in @year
+</return>
+</function>
+
+<function name="g_date_get_weekday">
+<description>
+Returns the day of the week for a #GDate. The date must be valid.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> day of the week as a #GDateWeekday.
</return>
</function>
-<function name="g_date_time_add_years">
+<function name="g_date_get_year">
<description>
-Creates a copy of @datetime and adds the specified number of years to the
-copy.
+Returns the year of a #GDate. The date must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
-<parameter name="years">
-<parameter_description> the number of years
+</parameters>
+<return> year in which the date falls
+</return>
+</function>
+
+<function name="g_date_is_first_of_month">
+<description>
+Returns %TRUE if the date is on the first of a month.
+The date must be valid.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate to check
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime which should be freed with
-g_date_time_unref().
-
+<return> %TRUE if the date is the first of the month
</return>
</function>
-<function name="g_date_time_compare">
+<function name="g_date_is_last_of_month">
<description>
-A comparison function for #GDateTimes that is suitable
-as a #GCompareFunc. Both #GDateTimes must be non-%NULL.
+Returns %TRUE if the date is the last day of the month.
+The date must be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="dt1">
-<parameter_description> first #GDateTime to compare
+<parameter name="date">
+<parameter_description> a #GDate to check
</parameter_description>
</parameter>
-<parameter name="dt2">
-<parameter_description> second #GDateTime to compare
+</parameters>
+<return> %TRUE if the date is the last day of the month
+</return>
+</function>
+
+<function name="g_date_is_leap_year">
+<description>
+Returns %TRUE if the year is a leap year.
+<footnote><para>For the purposes of this function,
+leap year is every year divisible by 4 unless that year
+is divisible by 100. If it is divisible by 100 it would
+be a leap year only if that year is also divisible
+by 400.</para></footnote>
+
+
+</description>
+<parameters>
+<parameter name="year">
+<parameter_description> year to check
</parameter_description>
</parameter>
</parameters>
-<return> -1, 0 or 1 if @dt1 is less than, equal to or greater
-than @dt2.
+<return> %TRUE if the year is a leap year
+</return>
+</function>
+
+<function name="g_date_new">
+<description>
+Allocates a #GDate and initializes
+it to a sane state. The new date will
+be cleared (as if you'd called g_date_clear()) but invalid (it won't
+represent an existing day). Free the return value with g_date_free().
+
+</description>
+<parameters>
+</parameters>
+<return> a newly-allocated #GDate
</return>
</function>
-<function name="g_date_time_difference">
+<function name="g_date_new_dmy">
<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).
+Like g_date_new(), but also sets the value of the date. Assuming the
+day-month-year triplet you pass in represents an existing day, the
+returned date will be valid.
-Since: 2.26
</description>
<parameters>
-<parameter name="end">
-<parameter_description> a #GDateTime
+<parameter name="day">
+<parameter_description> day of the month
</parameter_description>
</parameter>
-<parameter name="begin">
-<parameter_description> a #GDateTime
+<parameter name="month">
+<parameter_description> month of the year
+</parameter_description>
+</parameter>
+<parameter name="year">
+<parameter_description> year
</parameter_description>
</parameter>
</parameters>
-<return> the difference between the two #GDateTime, as a time
-span expressed in microseconds.
+<return> a newly-allocated #GDate initialized with @day, @month, and @year
+</return>
+</function>
+
+<function name="g_date_new_julian">
+<description>
+Like g_date_new(), but also sets the value of the date. Assuming the
+Julian day number you pass in is valid (greater than 0, less than an
+unreasonably large number), the returned date will be valid.
+
+</description>
+<parameters>
+<parameter name="julian_day">
+<parameter_description> days since January 1, Year 1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated #GDate initialized with @julian_day
</return>
</function>
-<function name="g_date_time_equal">
+<function name="g_date_order">
<description>
-Checks to see if @dt1 and @dt2 are equal.
+Checks if @date1 is less than or equal to @date2,
+and swap the values if this is not the case.
-Equal here means that they represent the same moment after converting
-them to the same time zone.
+</description>
+<parameters>
+<parameter name="date1">
+<parameter_description> the first date
+</parameter_description>
+</parameter>
+<parameter name="date2">
+<parameter_description> the second date
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-Since: 2.26
+<function name="g_date_set_day">
+<description>
+Sets the day of the month for a #GDate. If the resulting
+day-month-year triplet is invalid, the date will be invalid.
</description>
<parameters>
-<parameter name="dt1">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
-<parameter name="dt2">
-<parameter_description> a #GDateTime
+<parameter name="day">
+<parameter_description> day to set
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @dt1 and @dt2 are equal
+<return></return>
+</function>
-</return>
+<function name="g_date_set_dmy">
+<description>
+Sets the value of a #GDate from a day, month, and year.
+The day-month-year triplet must be valid; if you aren't
+sure it is, call g_date_valid_dmy() to check before you
+set it.
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate
+</parameter_description>
+</parameter>
+<parameter name="day">
+<parameter_description> day
+</parameter_description>
+</parameter>
+<parameter name="month">
+<parameter_description> month
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> year
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
</function>
-<function name="g_date_time_format">
+<function name="g_date_set_julian">
<description>
-Creates a newly allocated string representing the requested @format.
+Sets the value of a #GDate from a Julian day number.
-The format strings understood by this function are a subset of the
-strftime() format language. In contrast to strftime(), this function
-always produces a UTF-8 string, regardless of the current locale.
-Note that the rendering of many formats is locale-dependent and may
-not match the strftime() output exactly.
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate
+</parameter_description>
+</parameter>
+<parameter name="julian_date">
+<parameter_description> Julian day number (days since January 1, Year 1)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-The following format specifiers are supported:
-
-<variablelist>
-<varlistentry><term>
-<literal>%%a</literal>:
-</term><listitem><simpara>
-the abbreviated weekday name according to the current locale
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%A</literal>:
-</term><listitem><simpara>
-the full weekday name according to the current locale
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%b</literal>:
-</term><listitem><simpara>
-the abbreviated month name according to the current locale
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%B</literal>:
-</term><listitem><simpara>
-the full month name according to the current locale
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%d</literal>:
-</term><listitem><simpara>
-the day of the month as a decimal number (range 01 to 31)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%e</literal>:
-</term><listitem><simpara>
-the day of the month as a decimal number (range 1 to 31)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%F</literal>:
-</term><listitem><simpara>
-equivalent to <literal>%%Y-%%m-%%d</literal> (the ISO 8601 date
-format)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%h</literal>:
-</term><listitem><simpara>
-equivalent to <literal>%%b</literal>
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%H</literal>:
-</term><listitem><simpara>
-the hour as a decimal number using a 24-hour clock (range 00 to
-23)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%I</literal>:
-</term><listitem><simpara>
-the hour as a decimal number using a 12-hour clock (range 01 to
-12)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%j</literal>:
-</term><listitem><simpara>
-the day of the year as a decimal number (range 001 to 366)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%k</literal>:
-</term><listitem><simpara>
-the hour (24-hour clock) as a decimal number (range 0 to 23);
-single digits are preceded by a blank
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%l</literal>:
-</term><listitem><simpara>
-the hour (12-hour clock) as a decimal number (range 1 to 12);
-single digits are preceded by a blank
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%m</literal>:
-</term><listitem><simpara>
-the month as a decimal number (range 01 to 12)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%M</literal>:
-</term><listitem><simpara>
-the minute as a decimal number (range 00 to 59)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%N</literal>:
-</term><listitem><simpara>
-the micro-seconds as a decimal number
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%p</literal>:
-</term><listitem><simpara>
-either "AM" or "PM" according to the given time value, or the
-corresponding strings for the current locale. Noon is treated as
-"PM" and midnight as "AM".
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%P</literal>:
-</term><listitem><simpara>
-like %%p but lowercase: "am" or "pm" or a corresponding string for
-the current locale
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%r</literal>:
-</term><listitem><simpara>
-the time in a.m. or p.m. notation
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%R</literal>:
-</term><listitem><simpara>
-the time in 24-hour notation (<literal>%%H:%%M</literal>)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%s</literal>:
-</term><listitem><simpara>
-the number of seconds since the Epoch, that is, since 1970-01-01
-00:00:00 UTC
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%S</literal>:
-</term><listitem><simpara>
-the second as a decimal number (range 00 to 60)
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%t</literal>:
-</term><listitem><simpara>
-a tab character
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%u</literal>:
-</term><listitem><simpara>
-the day of the week as a decimal, range 1 to 7, Monday being 1
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%W</literal>:
-</term><listitem><simpara>
-the week number of the current year as a decimal number
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%x</literal>:
-</term><listitem><simpara>
-the preferred date representation for the current locale without
-the time
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%X</literal>:
-</term><listitem><simpara>
-the preferred time representation for the current locale without
-the date
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%y</literal>:
-</term><listitem><simpara>
-the year as a decimal number without the century
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%Y</literal>:
-</term><listitem><simpara>
-the year as a decimal number including the century
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%z</literal>:
-</term><listitem><simpara>
-the time-zone as hour offset from UTC
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%Z</literal>:
-</term><listitem><simpara>
-the time zone or name or abbreviation
-</simpara></listitem></varlistentry>
-<varlistentry><term>
-<literal>%%%</literal>:
-</term><listitem><simpara>
-a literal <literal>%%</literal> character
-</simpara></listitem></varlistentry>
-</variablelist>
-
-Some conversion specifications can be modified by preceding the
-conversion specifier by one or more modifier characters. The
-following modifiers are supported for many of the numeric
-conversions:
-<variablelist>
-<varlistentry>
-<term>O</term>
-<listitem>
-Use alternative numeric symbols, if the current locale
-supports those.
-</listitem>
-</varlistentry>
-<varlistentry>
-<term>_</term>
-<listitem>
-Pad a numeric result with spaces.
-This overrides the default padding for the specifier.
-</listitem>
-</varlistentry>
-<varlistentry>
-<term>-</term>
-<listitem>
-Do not pad a numeric result.
-This overrides the default padding for the specifier.
-</listitem>
-</varlistentry>
-<varlistentry>
-<term>0</term>
-<listitem>
-Pad a numeric result with zeros.
-This overrides the default padding for the specifier.
-</listitem>
-</varlistentry>
-</variablelist>
-
-Since: 2.26
+<function name="g_date_set_month">
+<description>
+Sets the month of the year for a #GDate. If the resulting
+day-month-year triplet is invalid, the date will be invalid.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> A #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> a valid UTF-8 string, containing the format for the
-#GDateTime
+<parameter name="month">
+<parameter_description> month to set
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string formatted to the requested format
-or %NULL in the case that there was an error. The string
-should be freed with g_free().
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_day_of_month">
+<function name="g_date_set_parse">
<description>
-Retrieves the day of the month represented by @datetime in the gregorian
-calendar.
+Parses a user-inputted string @str, and try to figure out what date it
+represents, taking the <link linkend="setlocale">current locale</link>
+into account. If the string is successfully parsed, the date will be
+valid after the call. Otherwise, it will be invalid. You should check
+using g_date_valid() to see whether the parsing succeeded.
-Since: 2.26
+This function is not appropriate for file formats and the like; it
+isn't very precise, and its exact behavior varies with the locale.
+It's intended to be a heuristic routine that guesses what the user
+means by a given string (and it does work pretty well in that
+capacity).
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate to fill in
+</parameter_description>
+</parameter>
+<parameter name="str">
+<parameter_description> string to parse
</parameter_description>
</parameter>
</parameters>
-<return> the day of the month
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_day_of_week">
+<function name="g_date_set_time">
<description>
-Retrieves the ISO 8601 day of the week on which @datetime falls (1 is
-Monday, 2 is Tuesday... 7 is Sunday).
+Sets the value of a date from a #GTime value.
+The time to date conversion is done using the user's current timezone.
-Since: 2.26
+Deprecated: 2.10: Use g_date_set_time_t() instead.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate.
+</parameter_description>
+</parameter>
+<parameter name="time_">
+<parameter_description> #GTime value to set.
</parameter_description>
</parameter>
</parameters>
-<return> the day of the week
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_day_of_year">
+<function name="g_date_set_time_t">
<description>
-Retrieves the day of the year represented by @datetime in the Gregorian
-calendar.
+Sets the value of a date to the date corresponding to a time
+specified as a time_t. The time to date conversion is done using
+the user's current timezone.
-Since: 2.26
+To set the value of a date to the current day, you could write:
+|[
+g_date_set_time_t (date, time (NULL));
+]|
+
+Since: 2.10
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
+</parameter_description>
+</parameter>
+<parameter name="timet">
+<parameter_description> <type>time_t</type> value to set
</parameter_description>
</parameter>
</parameters>
-<return> the day of the year
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_hour">
+<function name="g_date_set_time_val">
<description>
-Retrieves the hour of the day represented by @datetime
+Sets the value of a date from a #GTimeVal value. Note that the
+ tv_usec member is ignored, because #GDate can't make use of the
+additional precision.
-Since: 2.26
+The time to date conversion is done using the user's current timezone.
+
+Since: 2.10
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
+</parameter_description>
+</parameter>
+<parameter name="timeval">
+<parameter_description> #GTimeVal value to set
</parameter_description>
</parameter>
</parameters>
-<return> the hour of the day
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_microsecond">
+<function name="g_date_set_year">
<description>
-Retrieves the microsecond of the date represented by @datetime
-
-Since: 2.26
+Sets the year for a #GDate. If the resulting day-month-year
+triplet is invalid, the date will be invalid.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate
+</parameter_description>
+</parameter>
+<parameter name="year">
+<parameter_description> year to set
</parameter_description>
</parameter>
</parameters>
-<return> the microsecond of the second
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_minute">
+<function name="g_date_strftime">
<description>
-Retrieves the minute of the hour represented by @datetime
+Generates a printed representation of the date, in a
+<link linkend="setlocale">locale</link>-specific way.
+Works just like the platform's C library strftime() function,
+but only accepts date-related formats; time-related formats
+give undefined results. Date must be valid. Unlike strftime()
+(which uses the locale encoding), works on a UTF-8 format
+string and stores a UTF-8 result.
+
+This function does not provide any conversion specifiers in
+addition to those implemented by the platform's C library.
+For example, don't expect that using g_date_strftime() would
+make the \%F provided by the C99 strftime() work on Windows
+where the C library only complies to C89.
-Since: 2.26
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="s">
+<parameter_description> destination buffer
+</parameter_description>
+</parameter>
+<parameter name="slen">
+<parameter_description> buffer size
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> format string
+</parameter_description>
+</parameter>
+<parameter name="date">
+<parameter_description> valid #GDate
</parameter_description>
</parameter>
</parameters>
-<return> the minute of the hour
-
+<return> number of characters written to the buffer, or 0 the buffer was too small
</return>
</function>
-<function name="g_date_time_get_month">
+<function name="g_date_subtract_days">
<description>
-Retrieves the month of the year represented by @datetime in the Gregorian
-calendar.
-
-Since: 2.26
+Moves a date some number of days into the past.
+To move by weeks, just move by weeks*7 days.
+The date must be valid.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate to decrement
+</parameter_description>
+</parameter>
+<parameter name="n_days">
+<parameter_description> number of days to move
</parameter_description>
</parameter>
</parameters>
-<return> the month represented by @datetime
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_second">
+<function name="g_date_subtract_months">
<description>
-Retrieves the second of the minute represented by @datetime
-
-Since: 2.26
+Moves a date some number of months into the past.
+If the current day of the month doesn't exist in
+the destination month, the day of the month
+may change. The date must be valid.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate to decrement
+</parameter_description>
+</parameter>
+<parameter name="n_months">
+<parameter_description> number of months to move
</parameter_description>
</parameter>
</parameters>
-<return> the second represented by @datetime
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_seconds">
+<function name="g_date_subtract_years">
<description>
-Retrieves the number of seconds since the start of the last minute,
-including the fractional part.
-
-Since: 2.26
+Moves a date some number of years into the past.
+If the current day doesn't exist in the destination
+year (i.e. it's February 29 and you move to a non-leap-year)
+then the day is changed to February 29. The date
+must be valid.
</description>
<parameters>
-<parameter name="datetime">
-<parameter_description> a #GDateTime
+<parameter name="date">
+<parameter_description> a #GDate to decrement
+</parameter_description>
+</parameter>
+<parameter name="n_years">
+<parameter_description> number of years to move
</parameter_description>
</parameter>
</parameters>
-<return> the number of seconds
-
-</return>
+<return></return>
</function>
-<function name="g_date_time_get_timezone_abbreviation">
+<function name="g_date_time_add">
<description>
-Determines the time zone abbreviation to be used at the time and in
-the time zone of @datetime.
-
-For example, in Toronto this is currently "EST" during the winter
-months and "EDT" during the summer months when daylight savings
-time is in effect.
+Creates a copy of @datetime and adds the specified timespan to the copy.
Since: 2.26
@@ -8169,24 +9354,21 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="timespan">
+<parameter_description> a #GTimeSpan
+</parameter_description>
+</parameter>
</parameters>
-<return> the time zone abbreviation. The returned
-string is owned by the #GDateTime and it should not be
-modified or freed
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_get_utc_offset">
+<function name="g_date_time_add_days">
<description>
-Determines the offset to UTC in effect at the time and in the time
-zone of @datetime.
-
-The offset is the number of microseconds that you add to UTC time to
-arrive at local time for the time zone (ie: negative numbers for time
-zones west of GMT, positive numbers for east).
-
-If @datetime represents UTC time, then the offset is always zero.
+Creates a copy of @datetime and adds the specified number of days to the
+copy.
Since: 2.26
@@ -8196,46 +9378,21 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="days">
+<parameter_description> the number of days
+</parameter_description>
+</parameter>
</parameters>
-<return> the number of microseconds that should be added to UTC to
-get the local time
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_get_week_numbering_year">
+<function name="g_date_time_add_full">
<description>
-Returns the ISO 8601 week-numbering year in which the week containing
- datetime falls.
-
-This function, taken together with g_date_time_get_week_of_year() and
-g_date_time_get_day_of_week() can be used to determine the full ISO
-week date on which @datetime falls.
-
-This is usually equal to the normal Gregorian year (as returned by
-g_date_time_get_year()), except as detailed below:
-
-For Thursday, the week-numbering year is always equal to the usual
-calendar year. For other days, the number is such that every day
-within a complete week (Monday to Sunday) is contained within the
-same week-numbering year.
-
-For Monday, Tuesday and Wednesday occuring near the end of the year,
-this may mean that the week-numbering year is one greater than the
-calendar year (so that these days have the same week-numbering year
-as the Thursday occuring early in the next year).
-
-For Friday, Saturaday and Sunday occuring near the start of the year,
-this may mean that the week-numbering year is one less than the
-calendar year (so that these days have the same week-numbering year
-as the Thursday occuring late in the previous year).
-
-An equivalent description is that the week-numbering year is equal to
-the calendar year containing the majority of the days in the current
-week (Monday to Sunday).
-
-Note that January 1 0001 in the proleptic Gregorian calendar is a
-Monday, so this function never returns 0.
+Creates a new #GDateTime adding the specified values to the current date and
+time in @datetime.
Since: 2.26
@@ -8245,29 +9402,40 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="years">
+<parameter_description> the number of years to add
+</parameter_description>
+</parameter>
+<parameter name="months">
+<parameter_description> the number of months to add
+</parameter_description>
+</parameter>
+<parameter name="days">
+<parameter_description> the number of days to add
+</parameter_description>
+</parameter>
+<parameter name="hours">
+<parameter_description> the number of hours to add
+</parameter_description>
+</parameter>
+<parameter name="minutes">
+<parameter_description> the number of minutes to add
+</parameter_description>
+</parameter>
+<parameter name="seconds">
+<parameter_description> the number of seconds to add
+</parameter_description>
+</parameter>
</parameters>
-<return> the ISO 8601 week-numbering year for @datetime
+<return> the newly created #GDateTime that should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_get_week_of_year">
+<function name="g_date_time_add_hours">
<description>
-Returns the ISO 8601 week number for the week containing @datetime.
-The ISO 8601 week number is the same for every day of the week (from
-Moday through Sunday). That can produce some unusual results
-(described below).
-
-The first week of the year is week 1. This is the week that contains
-the first Thursday of the year. Equivalently, this is the first week
-that has more than 4 of its days falling within the calendar year.
-
-The value 0 is never returned by this function. Days contained
-within a year but occuring before the first ISO 8601 week of that
-year are considered as being contained in the last week of the
-previous year. Similarly, the final days of a calendar year may be
-considered as being part of the first ISO 8601 week of the next year
-if 4 or more days of that week are contained within the new year.
+Creates a copy of @datetime and adds the specified number of hours
Since: 2.26
@@ -8277,61 +9445,67 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="hours">
+<parameter_description> the number of hours to add
+</parameter_description>
+</parameter>
</parameters>
-<return> the ISO 8601 week number for @datetime.
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_get_year">
+<function name="g_date_time_add_minutes">
<description>
-Retrieves the year represented by @datetime in the Gregorian calendar.
+Creates a copy of @datetime adding the specified number of minutes.
Since: 2.26
</description>
<parameters>
<parameter name="datetime">
-<parameter_description> A #GDateTime
+<parameter_description> a #GDateTime
+</parameter_description>
+</parameter>
+<parameter name="minutes">
+<parameter_description> the number of minutes to add
</parameter_description>
</parameter>
</parameters>
-<return> the year represented by @datetime
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_get_ymd">
+<function name="g_date_time_add_months">
<description>
-Retrieves the Gregorian day, month, and year of a given #GDateTime.
+Creates a copy of @datetime and adds the specified number of months to the
+copy.
Since: 2.26
</description>
<parameters>
<parameter name="datetime">
-<parameter_description> a #GDateTime.
-</parameter_description>
-</parameter>
-<parameter name="year">
-<parameter_description> the return location for the gregorian year, or %NULL.
-</parameter_description>
-</parameter>
-<parameter name="month">
-<parameter_description> the return location for the month of the year, or %NULL.
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="day">
-<parameter_description> the return location for the day of the month, or %NULL.
+<parameter name="months">
+<parameter_description> the number of months
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
+
+</return>
</function>
-<function name="g_date_time_hash">
+<function name="g_date_time_add_seconds">
<description>
-Hashes @datetime into a #guint, suitable for use within #GHashTable.
+Creates a copy of @datetime and adds the specified number of seconds.
Since: 2.26
@@ -8341,16 +9515,21 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="seconds">
+<parameter_description> the number of seconds to add
+</parameter_description>
+</parameter>
</parameters>
-<return> a #guint containing the hash
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_is_daylight_savings">
+<function name="g_date_time_add_weeks">
<description>
-Determines if daylight savings time is in effect at the time and in
-the time zone of @datetime.
+Creates a copy of @datetime and adds the specified number of weeks to the
+copy.
Since: 2.26
@@ -8360,341 +9539,490 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
+<parameter name="weeks">
+<parameter_description> the number of weeks
+</parameter_description>
+</parameter>
</parameters>
-<return> %TRUE if daylight savings time is in effect
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_new">
+<function name="g_date_time_add_years">
<description>
-Creates a new #GDateTime corresponding to the given date and time in
-the time zone @tz.
-
-The @year must be between 1 and 9999, @month between 1 and 12 and @day
-between 1 and 28, 29, 30 or 31 depending on the month and the year.
-
- hour must be between 0 and 23 and @minute must be between 0 and 59.
-
- seconds must be at least 0.0 and must be strictly less than 60.0.
-It will be rounded down to the nearest microsecond.
-
-If the given time is not representable in the given time zone (for
-example, 02:30 on March 14th 2010 in Toronto, due to daylight savings
-time) then the time will be rounded up to the nearest existing time
-(in this case, 03:00). If this matters to you then you should verify
-the return value for containing the same as the numbers you gave.
-
-In the case that the given time is ambiguous in the given time zone
-(for example, 01:30 on November 7th 2010 in Toronto, due to daylight
-savings time) then the time falling within standard (ie:
-non-daylight) time is taken.
-
-It not considered a programmer error for the values to this function
-to be out of range, but in the case that they are, the function will
-return %NULL.
-
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+Creates a copy of @datetime and adds the specified number of years to the
+copy.
Since: 2.26
</description>
<parameters>
-<parameter name="tz">
-<parameter_description> a #GTimeZone
-</parameter_description>
-</parameter>
-<parameter name="year">
-<parameter_description> the year component of the date
-</parameter_description>
-</parameter>
-<parameter name="month">
-<parameter_description> the month component of the date
-</parameter_description>
-</parameter>
-<parameter name="day">
-<parameter_description> the day component of the date
-</parameter_description>
-</parameter>
-<parameter name="hour">
-<parameter_description> the hour component of the date
-</parameter_description>
-</parameter>
-<parameter name="minute">
-<parameter_description> the minute component of the date
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="seconds">
-<parameter_description> the number of seconds past the minute
+<parameter name="years">
+<parameter_description> the number of years
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the newly created #GDateTime which should be freed with
+g_date_time_unref().
</return>
</function>
-<function name="g_date_time_new_from_timeval_local">
+<function name="g_date_time_compare">
<description>
-Creates a #GDateTime corresponding to the given #GTimeVal @tv in the
-local time zone.
-
-The time contained in a #GTimeVal is always stored in the form of
-seconds elapsed since 1970-01-01 00:00:00 UTC, regardless of the
-local time offset.
-
-This call can fail (returning %NULL) if @tv represents a time outside
-of the supported range of #GDateTime.
-
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+A comparison function for #GDateTimes that is suitable
+as a #GCompareFunc. Both #GDateTimes must be non-%NULL.
Since: 2.26
</description>
<parameters>
-<parameter name="tv">
-<parameter_description> a #GTimeVal
+<parameter name="dt1">
+<parameter_description> first #GDateTime to compare
+</parameter_description>
+</parameter>
+<parameter name="dt2">
+<parameter_description> second #GDateTime to compare
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> -1, 0 or 1 if @dt1 is less than, equal to or greater
+than @dt2.
</return>
</function>
-<function name="g_date_time_new_from_timeval_utc">
+<function name="g_date_time_difference">
<description>
-Creates a #GDateTime corresponding to the given #GTimeVal @tv in UTC.
-
-The time contained in a #GTimeVal is always stored in the form of
-seconds elapsed since 1970-01-01 00:00:00 UTC.
-
-This call can fail (returning %NULL) if @tv represents a time outside
-of the supported range of #GDateTime.
-
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+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).
Since: 2.26
</description>
<parameters>
-<parameter name="tv">
-<parameter_description> a #GTimeVal
+<parameter name="end">
+<parameter_description> a #GDateTime
+</parameter_description>
+</parameter>
+<parameter name="begin">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the difference between the two #GDateTime, as a time
+span expressed in microseconds.
</return>
</function>
-<function name="g_date_time_new_from_unix_local">
+<function name="g_date_time_equal">
<description>
-Creates a #GDateTime corresponding to the given Unix time @t in the
-local time zone.
-
-Unix time is the number of seconds that have elapsed since 1970-01-01
-00:00:00 UTC, regardless of the local time offset.
-
-This call can fail (returning %NULL) if @t represents a time outside
-of the supported range of #GDateTime.
+Checks to see if @dt1 and @dt2 are equal.
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+Equal here means that they represent the same moment after converting
+them to the same time zone.
Since: 2.26
</description>
<parameters>
-<parameter name="t">
-<parameter_description> the Unix time
+<parameter name="dt1">
+<parameter_description> a #GDateTime
+</parameter_description>
+</parameter>
+<parameter name="dt2">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> %TRUE if @dt1 and @dt2 are equal
</return>
</function>
-<function name="g_date_time_new_from_unix_utc">
+<function name="g_date_time_format">
<description>
-Creates a #GDateTime corresponding to the given Unix time @t in UTC.
+Creates a newly allocated string representing the requested @format.
-Unix time is the number of seconds that have elapsed since 1970-01-01
-00:00:00 UTC.
+The format strings understood by this function are a subset of the
+strftime() format language as specified by C99. The \%D, \%U and \%W
+conversions are not supported, nor is the 'E' modifier. The GNU
+extensions \%k, \%l, \%s and \%P are supported, however, as are the
+'0', '_' and '-' modifiers.
-This call can fail (returning %NULL) if @t represents a time outside
-of the supported range of #GDateTime.
+In contrast to strftime(), this function always produces a UTF-8
+string, regardless of the current locale. Note that the rendering of
+many formats is locale-dependent and may not match the strftime()
+output exactly.
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+The following format specifiers are supported:
+
+<variablelist>
+<varlistentry><term>
+<literal>\%a</literal>:
+</term><listitem><simpara>
+the abbreviated weekday name according to the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%A</literal>:
+</term><listitem><simpara>
+the full weekday name according to the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%b</literal>:
+</term><listitem><simpara>
+the abbreviated month name according to the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%B</literal>:
+</term><listitem><simpara>
+the full month name according to the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%c</literal>:
+</term><listitem><simpara>
+the preferred date and time representation for the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%C</literal>:
+</term><listitem><simpara>
+The century number (year/100) as a 2-digit integer (00-99)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%d</literal>:
+</term><listitem><simpara>
+the day of the month as a decimal number (range 01 to 31)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%e</literal>:
+</term><listitem><simpara>
+the day of the month as a decimal number (range 1 to 31)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%F</literal>:
+</term><listitem><simpara>
+equivalent to <literal>\%Y-\%m-\%d</literal> (the ISO 8601 date
+format)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%g</literal>:
+</term><listitem><simpara>
+the last two digits of the ISO 8601 week-based year as a decimal
+number (00-99). This works well with \%V and \%u.
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%G</literal>:
+</term><listitem><simpara>
+the ISO 8601 week-based year as a decimal number. This works well
+with \%V and \%u.
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%h</literal>:
+</term><listitem><simpara>
+equivalent to <literal>\%b</literal>
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%H</literal>:
+</term><listitem><simpara>
+the hour as a decimal number using a 24-hour clock (range 00 to
+23)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%I</literal>:
+</term><listitem><simpara>
+the hour as a decimal number using a 12-hour clock (range 01 to
+12)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%j</literal>:
+</term><listitem><simpara>
+the day of the year as a decimal number (range 001 to 366)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%k</literal>:
+</term><listitem><simpara>
+the hour (24-hour clock) as a decimal number (range 0 to 23);
+single digits are preceded by a blank
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%l</literal>:
+</term><listitem><simpara>
+the hour (12-hour clock) as a decimal number (range 1 to 12);
+single digits are preceded by a blank
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%m</literal>:
+</term><listitem><simpara>
+the month as a decimal number (range 01 to 12)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%M</literal>:
+</term><listitem><simpara>
+the minute as a decimal number (range 00 to 59)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%p</literal>:
+</term><listitem><simpara>
+either "AM" or "PM" according to the given time value, or the
+corresponding strings for the current locale. Noon is treated as
+"PM" and midnight as "AM".
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%P</literal>:
+</term><listitem><simpara>
+like \%p but lowercase: "am" or "pm" or a corresponding string for
+the current locale
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%r</literal>:
+</term><listitem><simpara>
+the time in a.m. or p.m. notation
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%R</literal>:
+</term><listitem><simpara>
+the time in 24-hour notation (<literal>\%H:\%M</literal>)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%s</literal>:
+</term><listitem><simpara>
+the number of seconds since the Epoch, that is, since 1970-01-01
+00:00:00 UTC
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%S</literal>:
+</term><listitem><simpara>
+the second as a decimal number (range 00 to 60)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%t</literal>:
+</term><listitem><simpara>
+a tab character
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%T</literal>:
+</term><listitem><simpara>
+the time in 24-hour notation with seconds (<literal>\%H:\%M:\%S</literal>)
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%u</literal>:
+</term><listitem><simpara>
+the ISO 8601 standard day of the week as a decimal, range 1 to 7,
+Monday being 1. This works well with \%G and \%V.
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%V</literal>:
+</term><listitem><simpara>
+the ISO 8601 standard week number of the current year as a decimal
+number, range 01 to 53, where week 1 is the first week that has at
+least 4 days in the new year. See g_date_time_get_week_of_year().
+This works well with \%G and \%u.
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%w</literal>:
+</term><listitem><simpara>
+the day of the week as a decimal, range 0 to 6, Sunday being 0.
+This is not the ISO 8601 standard format -- use \%u instead.
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%x</literal>:
+</term><listitem><simpara>
+the preferred date representation for the current locale without
+the time
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%X</literal>:
+</term><listitem><simpara>
+the preferred time representation for the current locale without
+the date
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%y</literal>:
+</term><listitem><simpara>
+the year as a decimal number without the century
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%Y</literal>:
+</term><listitem><simpara>
+the year as a decimal number including the century
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%z</literal>:
+</term><listitem><simpara>
+the time-zone as hour offset from UTC
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%Z</literal>:
+</term><listitem><simpara>
+the time zone or name or abbreviation
+</simpara></listitem></varlistentry>
+<varlistentry><term>
+<literal>\%\%</literal>:
+</term><listitem><simpara>
+a literal <literal>\%</literal> character
+</simpara></listitem></varlistentry>
+</variablelist>
+
+Some conversion specifications can be modified by preceding the
+conversion specifier by one or more modifier characters. The
+following modifiers are supported for many of the numeric
+conversions:
+<variablelist>
+<varlistentry>
+<term>O</term>
+<listitem>
+Use alternative numeric symbols, if the current locale
+supports those.
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>_</term>
+<listitem>
+Pad a numeric result with spaces.
+This overrides the default padding for the specifier.
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>-</term>
+<listitem>
+Do not pad a numeric result.
+This overrides the default padding for the specifier.
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>0</term>
+<listitem>
+Pad a numeric result with zeros.
+This overrides the default padding for the specifier.
+</listitem>
+</varlistentry>
+</variablelist>
Since: 2.26
</description>
<parameters>
-<parameter name="t">
-<parameter_description> the Unix time
+<parameter name="datetime">
+<parameter_description> A #GDateTime
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a valid UTF-8 string, containing the format for the
+#GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> a newly allocated string formatted to the requested format
+or %NULL in the case that there was an error. The string
+should be freed with g_free().
</return>
</function>
-<function name="g_date_time_new_local">
+<function name="g_date_time_get_day_of_month">
<description>
-Creates a new #GDateTime corresponding to the given date and time in
-the local time zone.
-
-This call is equivalent to calling g_date_time_new() with the time
-zone returned by g_time_zone_new_local().
+Retrieves the day of the month represented by @datetime in the gregorian
+calendar.
-Since: 2.26.
+Since: 2.26
</description>
<parameters>
-<parameter name="year">
-<parameter_description> the year component of the date
-</parameter_description>
-</parameter>
-<parameter name="month">
-<parameter_description> the month component of the date
-</parameter_description>
-</parameter>
-<parameter name="day">
-<parameter_description> the day component of the date
-</parameter_description>
-</parameter>
-<parameter name="hour">
-<parameter_description> the hour component of the date
-</parameter_description>
-</parameter>
-<parameter name="minute">
-<parameter_description> the minute component of the date
-</parameter_description>
-</parameter>
-<parameter name="seconds">
-<parameter_description> the number of seconds past the minute
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a #GDateTime, or %NULL
+<return> the day of the month
</return>
</function>
-<function name="g_date_time_new_now">
+<function name="g_date_time_get_day_of_week">
<description>
-Creates a #GDateTime corresponding to this exact instant in the given
-time zone @tz. The time is as accurate as the system allows, to a
-maximum accuracy of 1 microsecond.
-
-This function will always succeed unless the system clock is set to
-truly insane values (or unless GLib is still being used after the
-year 9999).
-
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+Retrieves the ISO 8601 day of the week on which @datetime falls (1 is
+Monday, 2 is Tuesday... 7 is Sunday).
Since: 2.26
</description>
<parameters>
-<parameter name="tz">
-<parameter_description> a #GTimeZone
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the day of the week
</return>
</function>
-<function name="g_date_time_new_now_local">
+<function name="g_date_time_get_day_of_year">
<description>
-Creates a #GDateTime corresponding to this exact instant in the local
-time zone.
-
-This is equivalent to calling g_date_time_new_now() with the time
-zone returned by g_time_zone_new_local().
+Retrieves the day of the year represented by @datetime in the Gregorian
+calendar.
Since: 2.26
</description>
<parameters>
+<parameter name="datetime">
+<parameter_description> a #GDateTime
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the day of the year
</return>
</function>
-<function name="g_date_time_new_now_utc">
+<function name="g_date_time_get_hour">
<description>
-Creates a #GDateTime corresponding to this exact instant in UTC.
-
-This is equivalent to calling g_date_time_new_now() with the time
-zone returned by g_time_zone_new_utc().
+Retrieves the hour of the day represented by @datetime
Since: 2.26
</description>
<parameters>
+<parameter name="datetime">
+<parameter_description> a #GDateTime
+</parameter_description>
+</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the hour of the day
</return>
</function>
-<function name="g_date_time_new_utc">
+<function name="g_date_time_get_microsecond">
<description>
-Creates a new #GDateTime corresponding to the given date and time in
-UTC.
-
-This call is equivalent to calling g_date_time_new() with the time
-zone returned by g_time_zone_new_utc().
+Retrieves the microsecond of the date represented by @datetime
-Since: 2.26.
+Since: 2.26
</description>
<parameters>
-<parameter name="year">
-<parameter_description> the year component of the date
-</parameter_description>
-</parameter>
-<parameter name="month">
-<parameter_description> the month component of the date
-</parameter_description>
-</parameter>
-<parameter name="day">
-<parameter_description> the day component of the date
-</parameter_description>
-</parameter>
-<parameter name="hour">
-<parameter_description> the hour component of the date
-</parameter_description>
-</parameter>
-<parameter name="minute">
-<parameter_description> the minute component of the date
-</parameter_description>
-</parameter>
-<parameter name="seconds">
-<parameter_description> the number of seconds past the minute
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a #GDateTime, or %NULL
+<return> the microsecond of the second
</return>
</function>
-<function name="g_date_time_ref">
+<function name="g_date_time_get_minute">
<description>
-Atomically increments the reference count of @datetime by one.
+Retrieves the minute of the hour represented by @datetime
Since: 2.26
@@ -8705,18 +10033,15 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the #GDateTime with the reference count increased
+<return> the minute of the hour
</return>
</function>
-<function name="g_date_time_to_local">
+<function name="g_date_time_get_month">
<description>
-Creates a new #GDateTime corresponding to the same instant in time as
- datetime, but in the local time zone.
-
-This call is equivalent to calling g_date_time_to_timezone() with the
-time zone returned by g_time_zone_new_local().
+Retrieves the month of the year represented by @datetime in the Gregorian
+calendar.
Since: 2.26
@@ -8727,26 +10052,14 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime
+<return> the month represented by @datetime
</return>
</function>
-<function name="g_date_time_to_timeval">
+<function name="g_date_time_get_second">
<description>
-Stores the instant in time that @datetime represents into @tv.
-
-The time contained in a #GTimeVal is always stored in the form of
-seconds elapsed since 1970-01-01 00:00:00 UTC, regardless of the time
-zone associated with @datetime.
-
-On systems where 'long' is 32bit (ie: all 32bit systems and all
-Windows systems), a #GTimeVal is incapable of storing the entire
-range of values that #GDateTime is capable of expressing. On those
-systems, this function returns %FALSE to indicate that the time is
-out of range.
-
-On systems where 'long' is 64bit, this function never fails.
+Retrieves the second of the minute represented by @datetime
Since: 2.26
@@ -8756,27 +10069,16 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="tv">
-<parameter_description> a #GTimeVal to modify
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE if successful, else %FALSE
+<return> the second represented by @datetime
</return>
</function>
-<function name="g_date_time_to_timezone">
+<function name="g_date_time_get_seconds">
<description>
-Create a new #GDateTime corresponding to the same instant in time as
- datetime, but in the time zone @tz.
-
-This call can fail in the case that the time goes out of bounds. For
-example, converting 0001-01-01 00:00:00 UTC to a time zone west of
-Greenwich will fail (due to the year 0 being out of range).
-
-You should release the return value by calling g_date_time_unref()
-when you are done with it.
+Retrieves the number of seconds since the start of the last minute,
+including the fractional part.
Since: 2.26
@@ -8786,23 +10088,20 @@ Since: 2.26
<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="tz">
-<parameter_description> the new #GTimeZone
-</parameter_description>
-</parameter>
</parameters>
-<return> a new #GDateTime, or %NULL
+<return> the number of seconds
</return>
</function>
-<function name="g_date_time_to_unix">
+<function name="g_date_time_get_timezone_abbreviation">
<description>
-Gives the Unix time corresponding to @datetime, rounding down to the
-nearest second.
+Determines the time zone abbreviation to be used at the time and in
+the time zone of @datetime.
-Unix time is the number of seconds that have elapsed since 1970-01-01
-00:00:00 UTC, regardless of the time zone associated with @datetime.
+For example, in Toronto this is currently "EST" during the winter
+months and "EDT" during the summer months when daylight savings
+time is in effect.
Since: 2.26
@@ -8813,18 +10112,23 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the Unix time corresponding to @datetime
+<return> the time zone abbreviation. The returned
+string is owned by the #GDateTime and it should not be
+modified or freed
</return>
</function>
-<function name="g_date_time_to_utc">
+<function name="g_date_time_get_utc_offset">
<description>
-Creates a new #GDateTime corresponding to the same instant in time as
- datetime, but in UTC.
+Determines the offset to UTC in effect at the time and in the time
+zone of @datetime.
-This call is equivalent to calling g_date_time_to_timezone() with the
-time zone returned by g_time_zone_new_utc().
+The offset is the number of microseconds that you add to UTC time to
+arrive at local time for the time zone (ie: negative numbers for time
+zones west of GMT, positive numbers for east).
+
+If @datetime represents UTC time, then the offset is always zero.
Since: 2.26
@@ -8835,17 +10139,45 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the newly created #GDateTime
+<return> the number of microseconds that should be added to UTC to
+get the local time
</return>
</function>
-<function name="g_date_time_unref">
+<function name="g_date_time_get_week_numbering_year">
<description>
-Atomically decrements the reference count of @datetime by one.
+Returns the ISO 8601 week-numbering year in which the week containing
+ datetime falls.
-When the reference count reaches zero, the resources allocated by
- datetime are freed
+This function, taken together with g_date_time_get_week_of_year() and
+g_date_time_get_day_of_week() can be used to determine the full ISO
+week date on which @datetime falls.
+
+This is usually equal to the normal Gregorian year (as returned by
+g_date_time_get_year()), except as detailed below:
+
+For Thursday, the week-numbering year is always equal to the usual
+calendar year. For other days, the number is such that every day
+within a complete week (Monday to Sunday) is contained within the
+same week-numbering year.
+
+For Monday, Tuesday and Wednesday occurring near the end of the year,
+this may mean that the week-numbering year is one greater than the
+calendar year (so that these days have the same week-numbering year
+as the Thursday occurring early in the next year).
+
+For Friday, Saturaday and Sunday occurring near the start of the year,
+this may mean that the week-numbering year is one less than the
+calendar year (so that these days have the same week-numbering year
+as the Thursday occurring late in the previous year).
+
+An equivalent description is that the week-numbering year is equal to
+the calendar year containing the majority of the days in the current
+week (Monday to Sunday).
+
+Note that January 1 0001 in the proleptic Gregorian calendar is a
+Monday, so this function never returns 0.
Since: 2.26
@@ -8856,761 +10188,902 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the ISO 8601 week-numbering year for @datetime
+
+</return>
</function>
-<function name="g_dcgettext">
+<function name="g_date_time_get_week_of_year">
<description>
-This is a variant of g_dgettext() that allows specifying a locale
-category instead of always using %LC_MESSAGES. See g_dgettext() for
-more information about how this functions differs from calling
-dcgettext() directly.
+Returns the ISO 8601 week number for the week containing @datetime.
+The ISO 8601 week number is the same for every day of the week (from
+Moday through Sunday). That can produce some unusual results
+(described below).
+
+The first week of the year is week 1. This is the week that contains
+the first Thursday of the year. Equivalently, this is the first week
+that has more than 4 of its days falling within the calendar year.
+
+The value 0 is never returned by this function. Days contained
+within a year but occurring before the first ISO 8601 week of that
+year are considered as being contained in the last week of the
+previous year. Similarly, the final days of a calendar year may be
+considered as being part of the first ISO 8601 week of the next year
+if 4 or more days of that week are contained within the new year.
Since: 2.26
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain to use, or %NULL to use
-the domain set with textdomain()
-</parameter_description>
-</parameter>
-<parameter name="msgid">
-<parameter_description> message to translate
-</parameter_description>
-</parameter>
-<parameter name="category">
-<parameter_description> a locale category
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> the translated string for the given locale category
+<return> the ISO 8601 week number for @datetime.
</return>
</function>
-<function name="g_dgettext">
+<function name="g_date_time_get_year">
<description>
-This function is a wrapper of dgettext() which does not translate
-the message if the default domain as set with textdomain() has no
-translations for the current locale.
+Retrieves the year represented by @datetime in the Gregorian calendar.
-The advantage of using this function over dgettext() proper is that
-libraries using this function (like GTK+) will not use translations
-if the application using the library does not have translations for
-the current locale. This results in a consistent English-only
-interface instead of one having partial translations. For this
-feature to work, the call to textdomain() and setlocale() should
-precede any g_dgettext() invocations. For GTK+, it means calling
-textdomain() before gtk_init or its variants.
+Since: 2.26
-This function disables translations if and only if upon its first
-call all the following conditions hold:
-<itemizedlist>
-<listitem>@domain is not %NULL</listitem>
-<listitem>textdomain() has been called to set a default text domain</listitem>
-<listitem>there is no translations available for the default text domain
-and the current locale</listitem>
-<listitem>current locale is not "C" or any English locales (those
-starting with "en_")</listitem>
-</itemizedlist>
+</description>
+<parameters>
+<parameter name="datetime">
+<parameter_description> A #GDateTime
+</parameter_description>
+</parameter>
+</parameters>
+<return> the year represented by @datetime
-Note that this behavior may not be desired for example if an application
-has its untranslated messages in a language other than English. In those
-cases the application should call textdomain() after initializing GTK+.
+</return>
+</function>
-Applications should normally not use this function directly,
-but use the _() macro for translations.
+<function name="g_date_time_get_ymd">
+<description>
+Retrieves the Gregorian day, month, and year of a given #GDateTime.
-Since: 2.18
+Since: 2.26
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain to use, or %NULL to use
-the domain set with textdomain()
+<parameter name="datetime">
+<parameter_description> a #GDateTime.
</parameter_description>
</parameter>
-<parameter name="msgid">
-<parameter_description> message to translate
+<parameter name="year">
+<parameter_description> the return location for the gregorian year, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="month">
+<parameter_description> the return location for the month of the year, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="day">
+<parameter_description> the return location for the day of the month, or %NULL.
</parameter_description>
</parameter>
</parameters>
-<return> The translated string
-
-</return>
+<return></return>
</function>
-<function name="g_dir_close">
+<function name="g_date_time_hash">
<description>
-Closes the directory and deallocates all related resources.
+Hashes @datetime into a #guint, suitable for use within #GHashTable.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="dir">
-<parameter_description> a #GDir* created by g_dir_open()
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #guint containing the hash
+
+</return>
</function>
-<function name="g_dir_open">
+<function name="g_date_time_is_daylight_savings">
<description>
-Opens a directory for reading. The names of the files in the
-directory can then be retrieved using g_dir_read_name(). Note
-that the ordering is not defined.
+Determines if daylight savings time is in effect at the time and in
+the time zone of @datetime.
+Since: 2.26
</description>
<parameters>
-<parameter name="path">
-<parameter_description> the path to the directory you are interested in. On Unix
-in the on-disk encoding. On Windows in UTF-8
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> Currently must be set to 0. Reserved for future use.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
-If non-%NULL, an error will be set if and only if
-g_dir_open() fails.
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GDir on success, %NULL on failure.
-If non-%NULL, you must free the result with g_dir_close()
-when you are finished with it.
+<return> %TRUE if daylight savings time is in effect
+
</return>
</function>
-<function name="g_dir_read_name">
+<function name="g_date_time_new">
<description>
-Retrieves the name of another entry in the directory, or %NULL.
-The order of entries returned from this function is not defined,
-and may vary by file system or other operating-system dependent
-factors.
+Creates a new #GDateTime corresponding to the given date and time in
+the time zone @tz.
-On Unix, the '.' and '..' entries are omitted, and the returned
-name is in the on-disk encoding.
+The @year must be between 1 and 9999, @month between 1 and 12 and @day
+between 1 and 28, 29, 30 or 31 depending on the month and the year.
-On Windows, as is true of all GLib functions which operate on
-filenames, the returned name is in UTF-8.
+ hour must be between 0 and 23 and @minute must be between 0 and 59.
+
+ seconds must be at least 0.0 and must be strictly less than 60.0.
+It will be rounded down to the nearest microsecond.
+
+If the given time is not representable in the given time zone (for
+example, 02:30 on March 14th 2010 in Toronto, due to daylight savings
+time) then the time will be rounded up to the nearest existing time
+(in this case, 03:00). If this matters to you then you should verify
+the return value for containing the same as the numbers you gave.
+
+In the case that the given time is ambiguous in the given time zone
+(for example, 01:30 on November 7th 2010 in Toronto, due to daylight
+savings time) then the time falling within standard (ie:
+non-daylight) time is taken.
+It not considered a programmer error for the values to this function
+to be out of range, but in the case that they are, the function will
+return %NULL.
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="dir">
-<parameter_description> a #GDir* created by g_dir_open()
+<parameter name="tz">
+<parameter_description> a #GTimeZone
+</parameter_description>
+</parameter>
+<parameter name="year">
+<parameter_description> the year component of the date
+</parameter_description>
+</parameter>
+<parameter name="month">
+<parameter_description> the month component of the date
+</parameter_description>
+</parameter>
+<parameter name="day">
+<parameter_description> the day component of the date
+</parameter_description>
+</parameter>
+<parameter name="hour">
+<parameter_description> the hour component of the date
+</parameter_description>
+</parameter>
+<parameter name="minute">
+<parameter_description> the minute component of the date
+</parameter_description>
+</parameter>
+<parameter name="seconds">
+<parameter_description> the number of seconds past the minute
</parameter_description>
</parameter>
</parameters>
-<return> The entry's name or %NULL if there are no
-more entries. The return value is owned by GLib and
-must not be modified or freed.
+<return> a new #GDateTime, or %NULL
+
</return>
</function>
-<function name="g_dir_rewind">
+<function name="g_date_time_new_from_timeval_local">
<description>
-Resets the given directory. The next call to g_dir_read_name()
-will return the first entry again.
+Creates a #GDateTime corresponding to the given #GTimeVal @tv in the
+local time zone.
+
+The time contained in a #GTimeVal is always stored in the form of
+seconds elapsed since 1970-01-01 00:00:00 UTC, regardless of the
+local time offset.
+
+This call can fail (returning %NULL) if @tv represents a time outside
+of the supported range of #GDateTime.
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="dir">
-<parameter_description> a #GDir* created by g_dir_open()
+<parameter name="tv">
+<parameter_description> a #GTimeVal
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GDateTime, or %NULL
+
+</return>
</function>
-<function name="g_direct_equal">
+<function name="g_date_time_new_from_timeval_utc">
<description>
-Compares two #gpointer arguments and returns %TRUE if they are equal.
-It can be passed to g_hash_table_new() as the @key_equal_func
-parameter, when using pointers as keys in a #GHashTable.
+Creates a #GDateTime corresponding to the given #GTimeVal @tv in UTC.
+
+The time contained in a #GTimeVal is always stored in the form of
+seconds elapsed since 1970-01-01 00:00:00 UTC.
+
+This call can fail (returning %NULL) if @tv represents a time outside
+of the supported range of #GDateTime.
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+Since: 2.26
</description>
<parameters>
-<parameter name="v1">
-<parameter_description> a key.
-</parameter_description>
-</parameter>
-<parameter name="v2">
-<parameter_description> a key to compare with @v1.
+<parameter name="tv">
+<parameter_description> a #GTimeVal
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the two keys match.
+<return> a new #GDateTime, or %NULL
+
</return>
</function>
-<function name="g_direct_hash">
+<function name="g_date_time_new_from_unix_local">
<description>
-Converts a gpointer to a hash value.
-It can be passed to g_hash_table_new() as the @hash_func parameter,
-when using pointers as keys in a #GHashTable.
+Creates a #GDateTime corresponding to the given Unix time @t in the
+local time zone.
+Unix time is the number of seconds that have elapsed since 1970-01-01
+00:00:00 UTC, regardless of the local time offset.
+
+This call can fail (returning %NULL) if @t represents a time outside
+of the supported range of #GDateTime.
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="v">
-<parameter_description> a #gpointer key
+<parameter name="t">
+<parameter_description> the Unix time
</parameter_description>
</parameter>
</parameters>
-<return> a hash value corresponding to the key.
+<return> a new #GDateTime, or %NULL
+
</return>
</function>
-<function name="g_dirname">
+<function name="g_date_time_new_from_unix_utc">
<description>
-Gets the directory components of a file name.
-If the file name has no directory components "." is returned.
-The returned string should be freed when no longer needed.
+Creates a #GDateTime corresponding to the given Unix time @t in UTC.
-Deprecated: use g_path_get_dirname() instead
+Unix time is the number of seconds that have elapsed since 1970-01-01
+00:00:00 UTC.
+
+This call can fail (returning %NULL) if @t represents a time outside
+of the supported range of #GDateTime.
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="file_name">
-<parameter_description> the name of the file
+<parameter name="t">
+<parameter_description> the Unix time
</parameter_description>
</parameter>
</parameters>
-<return> the directory components of the file
+<return> a new #GDateTime, or %NULL
</return>
</function>
-<function name="g_dngettext">
+<function name="g_date_time_new_local">
<description>
-This function is a wrapper of dngettext() which does not translate
-the message if the default domain as set with textdomain() has no
-translations for the current locale.
+Creates a new #GDateTime corresponding to the given date and time in
+the local time zone.
-See g_dgettext() for details of how this differs from dngettext()
-proper.
+This call is equivalent to calling g_date_time_new() with the time
+zone returned by g_time_zone_new_local().
-Since: 2.18
+Since: 2.26.
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain to use, or %NULL to use
-the domain set with textdomain()
+<parameter name="year">
+<parameter_description> the year component of the date
</parameter_description>
</parameter>
-<parameter name="msgid">
-<parameter_description> message to translate
+<parameter name="month">
+<parameter_description> the month component of the date
</parameter_description>
</parameter>
-<parameter name="msgid_plural">
-<parameter_description> plural form of the message
+<parameter name="day">
+<parameter_description> the day component of the date
</parameter_description>
</parameter>
-<parameter name="n">
-<parameter_description> the quantity for which translation is needed
+<parameter name="hour">
+<parameter_description> the hour component of the date
+</parameter_description>
+</parameter>
+<parameter name="minute">
+<parameter_description> the minute component of the date
+</parameter_description>
+</parameter>
+<parameter name="seconds">
+<parameter_description> the number of seconds past the minute
</parameter_description>
</parameter>
</parameters>
-<return> The translated string
+<return> a #GDateTime, or %NULL
</return>
</function>
-<function name="g_double_equal">
+<function name="g_date_time_new_now">
<description>
-Compares the two #gdouble values being pointed to and returns
-%TRUE if they are equal.
-It can be passed to g_hash_table_new() as the @key_equal_func
-parameter, when using pointers to doubles as keys in a #GHashTable.
+Creates a #GDateTime corresponding to this exact instant in the given
+time zone @tz. The time is as accurate as the system allows, to a
+maximum accuracy of 1 microsecond.
-Since: 2.22
+This function will always succeed unless the system clock is set to
+truly insane values (or unless GLib is still being used after the
+year 9999).
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+
+Since: 2.26
</description>
<parameters>
-<parameter name="v1">
-<parameter_description> a pointer to a #gdouble key.
-</parameter_description>
-</parameter>
-<parameter name="v2">
-<parameter_description> a pointer to a #gdouble key to compare with @v1.
+<parameter name="tz">
+<parameter_description> a #GTimeZone
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the two keys match.
+<return> a new #GDateTime, or %NULL
</return>
</function>
-<function name="g_double_hash">
+<function name="g_date_time_new_now_local">
<description>
-Converts a pointer to a #gdouble to a hash value.
-It can be passed to g_hash_table_new() as the @hash_func parameter,
-when using pointers to doubles as keys in a #GHashTable.
+Creates a #GDateTime corresponding to this exact instant in the local
+time zone.
-Since: 2.22
+This is equivalent to calling g_date_time_new_now() with the time
+zone returned by g_time_zone_new_local().
+
+Since: 2.26
</description>
<parameters>
-<parameter name="v">
-<parameter_description> a pointer to a #gdouble key
-</parameter_description>
-</parameter>
</parameters>
-<return> a hash value corresponding to the key.
+<return> a new #GDateTime, or %NULL
</return>
</function>
-<function name="g_dpgettext">
+<function name="g_date_time_new_now_utc">
<description>
-This function is a variant of g_dgettext() which supports
-a disambiguating message context. GNU gettext uses the
-'\004' character to separate the message context and
-message id in @msgctxtid.
-If 0 is passed as @msgidoffset, this function will fall back to
-trying to use the deprecated convention of using "|" as a separation
-character.
-
-This uses g_dgettext() internally. See that functions for differences
-with dgettext() proper.
+Creates a #GDateTime corresponding to this exact instant in UTC.
-Applications should normally not use this function directly,
-but use the C_() macro for translations with context.
+This is equivalent to calling g_date_time_new_now() with the time
+zone returned by g_time_zone_new_utc().
-Since: 2.16
+Since: 2.26
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain to use, or %NULL to use
-the domain set with textdomain()
-</parameter_description>
-</parameter>
-<parameter name="msgctxtid">
-<parameter_description> a combined message context and message id, separated
-by a \004 character
-</parameter_description>
-</parameter>
-<parameter name="msgidoffset">
-<parameter_description> the offset of the message id in @msgctxid
-</parameter_description>
-</parameter>
</parameters>
-<return> The translated string
+<return> a new #GDateTime, or %NULL
</return>
</function>
-<function name="g_dpgettext2">
+<function name="g_date_time_new_utc">
<description>
-This function is a variant of g_dgettext() which supports
-a disambiguating message context. GNU gettext uses the
-'\004' character to separate the message context and
-message id in @msgctxtid.
-
-This uses g_dgettext() internally. See that functions for differences
-with dgettext() proper.
+Creates a new #GDateTime corresponding to the given date and time in
+UTC.
-This function differs from C_() in that it is not a macro and
-thus you may use non-string-literals as context and msgid arguments.
+This call is equivalent to calling g_date_time_new() with the time
+zone returned by g_time_zone_new_utc().
-Since: 2.18
+Since: 2.26.
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain to use, or %NULL to use
-the domain set with textdomain()
+<parameter name="year">
+<parameter_description> the year component of the date
</parameter_description>
</parameter>
-<parameter name="context">
-<parameter_description> the message context
+<parameter name="month">
+<parameter_description> the month component of the date
</parameter_description>
</parameter>
-<parameter name="msgid">
-<parameter_description> the message
+<parameter name="day">
+<parameter_description> the day component of the date
+</parameter_description>
+</parameter>
+<parameter name="hour">
+<parameter_description> the hour component of the date
+</parameter_description>
+</parameter>
+<parameter name="minute">
+<parameter_description> the minute component of the date
+</parameter_description>
+</parameter>
+<parameter name="seconds">
+<parameter_description> the number of seconds past the minute
</parameter_description>
</parameter>
</parameters>
-<return> The translated string
+<return> a #GDateTime, or %NULL
</return>
</function>
-<function name="g_enum_complete_type_info">
+<function name="g_date_time_ref">
<description>
-This function is meant to be called from the complete_type_info()
-function of a #GTypePlugin implementation, as in the following
-example:
-
-|[
-static void
-my_enum_complete_type_info (GTypePlugin *plugin,
-GType g_type,
-GTypeInfo *info,
-GTypeValueTable *value_table)
-{
-static const GEnumValue values[] = {
-{ MY_ENUM_FOO, "MY_ENUM_FOO", "foo" },
-{ MY_ENUM_BAR, "MY_ENUM_BAR", "bar" },
-{ 0, NULL, NULL }
-};
+Atomically increments the reference count of @datetime by one.
-g_enum_complete_type_info (type, info, values);
-}
-]|
+Since: 2.26
</description>
<parameters>
-<parameter name="g_enum_type">
-<parameter_description> the type identifier of the type being completed
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> the #GTypeInfo struct to be filled in
-</parameter_description>
-</parameter>
-<parameter name="const_values">
-<parameter_description> An array of #GEnumValue structs for the possible
-enumeration values. The array is terminated by a struct with all
-members being 0.
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #GDateTime with the reference count increased
+
+</return>
</function>
-<function name="g_enum_get_value">
+<function name="g_date_time_to_local">
<description>
-Returns the #GEnumValue for a value.
+Creates a new #GDateTime corresponding to the same instant in time as
+ datetime, but in the local time zone.
+
+This call is equivalent to calling g_date_time_to_timezone() with the
+time zone returned by g_time_zone_new_local().
+Since: 2.26
</description>
<parameters>
-<parameter name="enum_class">
-<parameter_description> a #GEnumClass
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> the value to look up
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> the #GEnumValue for @value, or %NULL if @value is not a
-member of the enumeration
+<return> the newly created #GDateTime
+
</return>
</function>
-<function name="g_enum_get_value_by_name">
+<function name="g_date_time_to_timeval">
<description>
-Looks up a #GEnumValue by name.
+Stores the instant in time that @datetime represents into @tv.
+
+The time contained in a #GTimeVal is always stored in the form of
+seconds elapsed since 1970-01-01 00:00:00 UTC, regardless of the time
+zone associated with @datetime.
+
+On systems where 'long' is 32bit (ie: all 32bit systems and all
+Windows systems), a #GTimeVal is incapable of storing the entire
+range of values that #GDateTime is capable of expressing. On those
+systems, this function returns %FALSE to indicate that the time is
+out of range.
+
+On systems where 'long' is 64bit, this function never fails.
+Since: 2.26
</description>
<parameters>
-<parameter name="enum_class">
-<parameter_description> a #GEnumClass
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name to look up
+<parameter name="tv">
+<parameter_description> a #GTimeVal to modify
</parameter_description>
</parameter>
</parameters>
-<return> the #GEnumValue with name @name, or %NULL if the
-enumeration doesn't have a member with that name
+<return> %TRUE if successful, else %FALSE
+
</return>
</function>
-<function name="g_enum_get_value_by_nick">
+<function name="g_date_time_to_timezone">
<description>
-Looks up a #GEnumValue by nickname.
+Create a new #GDateTime corresponding to the same instant in time as
+ datetime, but in the time zone @tz.
+
+This call can fail in the case that the time goes out of bounds. For
+example, converting 0001-01-01 00:00:00 UTC to a time zone west of
+Greenwich will fail (due to the year 0 being out of range).
+
+You should release the return value by calling g_date_time_unref()
+when you are done with it.
+Since: 2.26
</description>
<parameters>
-<parameter name="enum_class">
-<parameter_description> a #GEnumClass
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
-<parameter name="nick">
-<parameter_description> the nickname to look up
+<parameter name="tz">
+<parameter_description> the new #GTimeZone
</parameter_description>
</parameter>
</parameters>
-<return> the #GEnumValue with nickname @nick, or %NULL if the
-enumeration doesn't have a member with that nickname
+<return> a new #GDateTime, or %NULL
+
</return>
</function>
-<function name="g_enum_register_static">
+<function name="g_date_time_to_unix">
<description>
-Registers a new static enumeration type with the name @name.
+Gives the Unix time corresponding to @datetime, rounding down to the
+nearest second.
-It is normally more convenient to let <link
-linkend="glib-mkenums">glib-mkenums</link> generate a
-my_enum_get_type() function from a usual C enumeration definition
-than to write one yourself using g_enum_register_static().
+Unix time is the number of seconds that have elapsed since 1970-01-01
+00:00:00 UTC, regardless of the time zone associated with @datetime.
+Since: 2.26
</description>
<parameters>
-<parameter name="name">
-<parameter_description> A nul-terminated string used as the name of the new type.
-</parameter_description>
-</parameter>
-<parameter name="const_static_values">
-<parameter_description> An array of #GEnumValue structs for the possible
-enumeration values. The array is terminated by a struct with all
-members being 0. GObject keeps a reference to the data, so it cannot
-be stack-allocated.
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> The new type identifier.
+<return> the Unix time corresponding to @datetime
+
</return>
</function>
-<function name="g_error_copy">
+<function name="g_date_time_to_utc">
<description>
-Makes a copy of @error.
+Creates a new #GDateTime corresponding to the same instant in time as
+ datetime, but in UTC.
+This call is equivalent to calling g_date_time_to_timezone() with the
+time zone returned by g_time_zone_new_utc().
+
+Since: 2.26
</description>
<parameters>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
-<return> a new #GError
+<return> the newly created #GDateTime
+
</return>
</function>
-<function name="g_error_free">
+<function name="g_date_time_unref">
<description>
-Frees a #GError and associated resources.
+Atomically decrements the reference count of @datetime by one.
+
+When the reference count reaches zero, the resources allocated by
+ datetime are freed
+
+Since: 2.26
</description>
<parameters>
-<parameter name="error">
-<parameter_description> a #GError
+<parameter name="datetime">
+<parameter_description> a #GDateTime
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_error_matches">
+<function name="g_date_to_struct_tm">
<description>
-Returns %TRUE if @error matches @domain and @code, %FALSE
-otherwise. In particular, when @error is %NULL, %FALSE will
-be returned.
-
+Fills in the date-related bits of a <structname>struct tm</structname>
+using the @date value. Initializes the non-date parts with something
+sane but meaningless.
</description>
<parameters>
-<parameter name="error">
-<parameter_description> a #GError or %NULL
+<parameter name="date">
+<parameter_description> a #GDate to set the <structname>struct tm</structname> from
</parameter_description>
</parameter>
-<parameter name="domain">
-<parameter_description> an error domain
+<parameter name="tm">
+<parameter_description> <structname>struct tm</structname> to fill
</parameter_description>
</parameter>
-<parameter name="code">
-<parameter_description> an error code
+</parameters>
+<return></return>
+</function>
+
+<function name="g_date_valid">
+<description>
+Returns %TRUE if the #GDate represents an existing day. The date must not
+contain garbage; it should have been initialized with g_date_clear()
+if it wasn't allocated by one of the g_date_new() variants.
+
+
+</description>
+<parameters>
+<parameter name="date">
+<parameter_description> a #GDate to check
</parameter_description>
</parameter>
</parameters>
-<return> whether @error has @domain and @code
+<return> Whether the date is valid
</return>
</function>
-<function name="g_error_new">
+<function name="g_date_valid_day">
<description>
-Creates a new #GError with the given @domain and @code,
-and a message formatted with @format.
+Returns %TRUE if the day of the month is valid (a day is valid if it's
+between 1 and 31 inclusive).
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> error domain
+<parameter name="day">
+<parameter_description> day to check
</parameter_description>
</parameter>
-<parameter name="code">
-<parameter_description> error code
+</parameters>
+<return> %TRUE if the day is valid
+</return>
+</function>
+
+<function name="g_date_valid_dmy">
+<description>
+Returns %TRUE if the day-month-year triplet forms a valid, existing day
+in the range of days #GDate understands (Year 1 or later, no more than
+a few thousand years in the future).
+
+
+</description>
+<parameters>
+<parameter name="day">
+<parameter_description> day
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format for error message
+<parameter name="month">
+<parameter_description> month
</parameter_description>
</parameter>
-<parameter name="Varargs">
-<parameter_description> parameters for message format
+<parameter name="year">
+<parameter_description> year
</parameter_description>
</parameter>
</parameters>
-<return> a new #GError
+<return> %TRUE if the date is a valid one
</return>
</function>
-<function name="g_error_new_literal">
+<function name="g_date_valid_julian">
<description>
-Creates a new #GError; unlike g_error_new(), @message is
-not a printf()-style format string. Use this function if
- message contains text you don't have control over,
-that could include printf() escape sequences.
+Returns %TRUE if the Julian day is valid. Anything greater than zero
+is basically a valid Julian, though there is a 32-bit limit.
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> error domain
+<parameter name="julian_date">
+<parameter_description> Julian day to check
</parameter_description>
</parameter>
-<parameter name="code">
-<parameter_description> error code
+</parameters>
+<return> %TRUE if the Julian day is valid
+</return>
+</function>
+
+<function name="g_date_valid_month">
+<description>
+Returns %TRUE if the month value is valid. The 12 #GDateMonth
+enumeration values are the only valid months.
+
+
+</description>
+<parameters>
+<parameter name="month">
+<parameter_description> month
</parameter_description>
</parameter>
-<parameter name="message">
-<parameter_description> error message
+</parameters>
+<return> %TRUE if the month is valid
+</return>
+</function>
+
+<function name="g_date_valid_weekday">
+<description>
+Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration
+values are the only valid weekdays.
+
+
+</description>
+<parameters>
+<parameter name="weekday">
+<parameter_description> weekday
</parameter_description>
</parameter>
</parameters>
-<return> a new #GError
+<return> %TRUE if the weekday is valid
</return>
</function>
-<function name="g_error_new_valist">
+<function name="g_date_valid_year">
<description>
-Creates a new #GError with the given @domain and @code,
-and a message formatted with @format.
+Returns %TRUE if the year is valid. Any year greater than 0 is valid,
+though there is a 16-bit limit to what #GDate will understand.
-Since: 2.22
</description>
<parameters>
-<parameter name="domain">
-<parameter_description> error domain
+<parameter name="year">
+<parameter_description> year
</parameter_description>
</parameter>
-<parameter name="code">
-<parameter_description> error code
+</parameters>
+<return> %TRUE if the year is valid
+</return>
+</function>
+
+<function name="g_dcgettext">
+<description>
+This is a variant of g_dgettext() that allows specifying a locale
+category instead of always using <envar>LC_MESSAGES</envar>. See g_dgettext() for
+more information about how this functions differs from calling
+dcgettext() directly.
+
+Since: 2.26
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
</parameter_description>
</parameter>
-<parameter name="format">
-<parameter_description> printf()-style format for error message
+<parameter name="msgid">
+<parameter_description> message to translate
</parameter_description>
</parameter>
-<parameter name="args">
-<parameter_description> #va_list of parameters for the message format
+<parameter name="category">
+<parameter_description> a locale category
</parameter_description>
</parameter>
</parameters>
-<return> a new #GError
+<return> the translated string for the given locale category
</return>
</function>
-<function name="g_file_error_from_errno">
+<function name="g_debug">
<description>
-Gets a #GFileError constant based on the passed-in @errno.
-For example, if you pass in %EEXIST this function returns
-#G_FILE_ERROR_EXIST. Unlike @errno values, you can portably
-assume that all #GFileError values will exist.
-
-Normally a #GFileError value goes into a #GError returned
-from a function that manipulates files. So you would use
-g_file_error_from_errno() when constructing a #GError.
+A convenience function/macro to log a debug message.
+Since: 2.6
</description>
<parameters>
-<parameter name="err_no">
-<parameter_description> an "errno" value
+<parameter name="Varargs">
+<parameter_description> format string, followed by parameters to insert
+into the format string (as with printf())
</parameter_description>
</parameter>
</parameters>
-<return> #GFileError corresponding to the given @errno
-</return>
+<return></return>
</function>
-<function name="g_file_get_contents">
+<function name="g_dgettext">
<description>
-Reads an entire file into allocated memory, with good error
-checking.
+This function is a wrapper of dgettext() which does not translate
+the message if the default domain as set with textdomain() has no
+translations for the current locale.
-If the call was successful, it returns %TRUE and sets @contents to the file
-contents and @length to the length of the file contents in bytes. The string
-stored in @contents will be nul-terminated, so for text files you can pass
-%NULL for the @length argument. If the call was not successful, it returns
-%FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error
-codes are those in the #GFileError enumeration. In the error case,
- contents is set to %NULL and @length is set to zero.
+The advantage of using this function over dgettext() proper is that
+libraries using this function (like GTK+) will not use translations
+if the application using the library does not have translations for
+the current locale. This results in a consistent English-only
+interface instead of one having partial translations. For this
+feature to work, the call to textdomain() and setlocale() should
+precede any g_dgettext() invocations. For GTK+, it means calling
+textdomain() before gtk_init or its variants.
+
+This function disables translations if and only if upon its first
+call all the following conditions hold:
+<itemizedlist>
+<listitem>@domain is not %NULL</listitem>
+<listitem>textdomain() has been called to set a default text domain</listitem>
+<listitem>there is no translations available for the default text domain
+and the current locale</listitem>
+<listitem>current locale is not "C" or any English locales (those
+starting with "en_")</listitem>
+</itemizedlist>
+
+Note that this behavior may not be desired for example if an application
+has its untranslated messages in a language other than English. In those
+cases the application should call textdomain() after initializing GTK+.
+
+Applications should normally not use this function directly,
+but use the _() macro for translations.
+Since: 2.18
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> name of a file to read contents from, in the GLib file name encoding
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> location to store an allocated string, use g_free() to free
-the returned string
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
</parameter_description>
</parameter>
-<parameter name="length">
-<parameter_description> location to store length in bytes of the contents, or %NULL
+<parameter name="msgid">
+<parameter_description> message to translate
</parameter_description>
</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+</parameters>
+<return> The translated string
+
+</return>
+</function>
+
+<function name="g_dir_close">
+<description>
+Closes the directory and deallocates all related resources.
+
+</description>
+<parameters>
+<parameter name="dir">
+<parameter_description> a #GDir* created by g_dir_open()
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE on success, %FALSE if an error occurred
-</return>
+<return></return>
</function>
-<function name="g_file_open_tmp">
+<function name="g_dir_make_tmp">
<description>
-Opens a file for writing in the preferred directory for temporary
-files (as returned by g_get_tmp_dir()).
+Creates a subdirectory in the preferred directory for temporary
+files (as returned by g_get_tmp_dir()).
- tmpl should be a string in the GLib file name encoding containing
+ tmpl should be a string in the GLib file name encoding containing
a sequence of six 'X' characters, as the parameter to g_mkstemp().
However, unlike these functions, the template should only be a
basename, no directory components are allowed. If template is
%NULL, a default template is used.
-Note that in contrast to g_mkstemp() (and mkstemp())
- tmpl is not modified, and might thus be a read-only literal string.
-
-The actual name used is returned in @name_used if non-%NULL. This
-string should be freed with g_free() when not needed any longer.
-The returned name is in the GLib file name encoding.
+Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not
+modified, and might thus be a read-only literal string.
+Since: 2.30
</description>
<parameters>
<parameter name="tmpl">
-<parameter_description> Template for file name, as in g_mkstemp(), basename only,
-or %NULL, to a default template
-</parameter_description>
-</parameter>
-<parameter name="name_used">
-<parameter_description> location to store actual name used, or %NULL
+<parameter_description> Template for directory name,
+as in g_mkdtemp(), basename only, or %NULL for a default template
</parameter_description>
</parameter>
<parameter name="error">
@@ -9618,1890 +11091,3586 @@ or %NULL, to a default template
</parameter_description>
</parameter>
</parameters>
-<return> A file handle (as from open()) to
-the file opened for reading and writing. The file is opened in binary
-mode on platforms where there is a difference. The file handle should be
-closed with close(). In case of errors, -1 is returned
-and @error will be set.
+<return> The actual name used. This string
+should be freed with g_free() when not needed any longer and is
+is in the GLib file name encoding. In case of errors, %NULL is
+returned and @error will be set.
+
</return>
</function>
-<function name="g_file_read_link">
+<function name="g_dir_open">
<description>
-Reads the contents of the symbolic link @filename like the POSIX
-readlink() function. The returned string is in the encoding used
-for filenames. Use g_filename_to_utf8() to convert it to UTF-8.
+Opens a directory for reading. The names of the files in the
+directory can then be retrieved using g_dir_read_name(). Note
+that the ordering is not defined.
-Since: 2.4
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> the symbolic link
+<parameter name="path">
+<parameter_description> the path to the directory you are interested in. On Unix
+in the on-disk encoding. On Windows in UTF-8
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> Currently must be set to 0. Reserved for future use.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError
+<parameter_description> return location for a #GError, or %NULL.
+If non-%NULL, an error will be set if and only if
+g_dir_open() fails.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-allocated string with the contents of the symbolic link,
-or %NULL if an error occurred.
+<return> a newly allocated #GDir on success, %NULL on failure.
+If non-%NULL, you must free the result with g_dir_close()
+when you are finished with it.
+</return>
+</function>
+
+<function name="g_dir_read_name">
+<description>
+Retrieves the name of another entry in the directory, or %NULL.
+The order of entries returned from this function is not defined,
+and may vary by file system or other operating-system dependent
+factors.
+
+On Unix, the '.' and '..' entries are omitted, and the returned
+name is in the on-disk encoding.
+
+On Windows, as is true of all GLib functions which operate on
+filenames, the returned name is in UTF-8.
+
+</description>
+<parameters>
+<parameter name="dir">
+<parameter_description> a #GDir* created by g_dir_open()
+</parameter_description>
+</parameter>
+</parameters>
+<return> The entry's name or %NULL if there are no
+more entries. The return value is owned by GLib and
+must not be modified or freed.
</return>
</function>
-<function name="g_file_set_contents">
+<function name="g_dir_rewind">
<description>
-Writes all of @contents to a file named @filename, with good error checking.
-If a file called @filename already exists it will be overwritten.
+Resets the given directory. The next call to g_dir_read_name()
+will return the first entry again.
-This write is atomic in the sense that it is first written to a temporary
-file which is then renamed to the final name. Notes:
-<itemizedlist>
-<listitem>
-On Unix, if @filename already exists hard links to @filename will break.
-Also since the file is recreated, existing permissions, access control
-lists, metadata etc. may be lost. If @filename is a symbolic link,
-the link itself will be replaced, not the linked file.
-</listitem>
-<listitem>
-On Windows renaming a file will not remove an existing file with the
-new name, so on Windows there is a race condition between the existing
-file being removed and the temporary file being renamed.
-</listitem>
-<listitem>
-On Windows there is no way to remove a file that is open to some
-process, or mapped into memory. Thus, this function will fail if
- filename already exists and is open.
-</listitem>
-</itemizedlist>
+</description>
+<parameters>
+<parameter name="dir">
+<parameter_description> a #GDir* created by g_dir_open()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
-If the call was sucessful, it returns %TRUE. If the call was not successful,
-it returns %FALSE and sets @error. The error domain is #G_FILE_ERROR.
-Possible error codes are those in the #GFileError enumeration.
+<function name="g_direct_equal">
+<description>
+Compares two #gpointer arguments and returns %TRUE if they are equal.
+It can be passed to g_hash_table_new() as the @key_equal_func
+parameter, when using opaque pointers compared by pointer value as keys
+in a #GHashTable.
+
+This equality function is also appropriate for keys that are integers stored
+in pointers, such as <literal>GINT_TO_POINTER (n)</literal>.
+
+
+</description>
+<parameters>
+<parameter name="v1">
+<parameter_description> a key
+</parameter_description>
+</parameter>
+<parameter name="v2">
+<parameter_description> a key to compare with @v1
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the two keys match.
+</return>
+</function>
+
+<function name="g_direct_hash">
+<description>
+Converts a gpointer to a hash value.
+It can be passed to g_hash_table_new() as the @hash_func parameter,
+when using opaque pointers compared by pointer value as keys in a
+#GHashTable.
+
+This hash function is also appropriate for keys that are integers stored
+in pointers, such as <literal>GINT_TO_POINTER (n)</literal>.
+
+
+</description>
+<parameters>
+<parameter name="v">
+<parameter_description> a #gpointer key
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hash value corresponding to the key.
+</return>
+</function>
+
+<function name="g_dirname">
+<description>
+Gets the directory components of a file name.
+
+If the file name has no directory components "." is returned.
+The returned string should be freed when no longer needed.
+
+Deprecated: use g_path_get_dirname() instead
+
+</description>
+<parameters>
+<parameter name="file_name">
+<parameter_description> the name of the file
+</parameter_description>
+</parameter>
+</parameters>
+<return> the directory components of the file
+
+</return>
+</function>
+
+<function name="g_dngettext">
+<description>
+This function is a wrapper of dngettext() which does not translate
+the message if the default domain as set with textdomain() has no
+translations for the current locale.
+
+See g_dgettext() for details of how this differs from dngettext()
+proper.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
+</parameter_description>
+</parameter>
+<parameter name="msgid">
+<parameter_description> message to translate
+</parameter_description>
+</parameter>
+<parameter name="msgid_plural">
+<parameter_description> plural form of the message
+</parameter_description>
+</parameter>
+<parameter name="n">
+<parameter_description> the quantity for which translation is needed
+</parameter_description>
+</parameter>
+</parameters>
+<return> The translated string
+
+</return>
+</function>
+
+<function name="g_double_equal">
+<description>
+Compares the two #gdouble values being pointed to and returns
+%TRUE if they are equal.
+It can be passed to g_hash_table_new() as the @key_equal_func
+parameter, when using non-%NULL pointers to doubles as keys in a
+#GHashTable.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="v1">
+<parameter_description> a pointer to a #gdouble key
+</parameter_description>
+</parameter>
+<parameter name="v2">
+<parameter_description> a pointer to a #gdouble key to compare with @v1
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the two keys match.
+
+</return>
+</function>
+
+<function name="g_double_hash">
+<description>
+Converts a pointer to a #gdouble to a hash value.
+It can be passed to g_hash_table_new() as the @hash_func parameter,
+It can be passed to g_hash_table_new() as the @hash_func parameter,
+when using non-%NULL pointers to doubles as keys in a #GHashTable.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="v">
+<parameter_description> a pointer to a #gdouble key
+</parameter_description>
+</parameter>
+</parameters>
+<return> a hash value corresponding to the key.
+
+</return>
+</function>
+
+<function name="g_dpgettext">
+<description>
+This function is a variant of g_dgettext() which supports
+a disambiguating message context. GNU gettext uses the
+'\004' character to separate the message context and
+message id in @msgctxtid.
+If 0 is passed as @msgidoffset, this function will fall back to
+trying to use the deprecated convention of using "|" as a separation
+character.
+
+This uses g_dgettext() internally. See that functions for differences
+with dgettext() proper.
+
+Applications should normally not use this function directly,
+but use the C_() macro for translations with context.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
+</parameter_description>
+</parameter>
+<parameter name="msgctxtid">
+<parameter_description> a combined message context and message id, separated
+by a \004 character
+</parameter_description>
+</parameter>
+<parameter name="msgidoffset">
+<parameter_description> the offset of the message id in @msgctxid
+</parameter_description>
+</parameter>
+</parameters>
+<return> The translated string
+
+</return>
+</function>
+
+<function name="g_dpgettext2">
+<description>
+This function is a variant of g_dgettext() which supports
+a disambiguating message context. GNU gettext uses the
+'\004' character to separate the message context and
+message id in @msgctxtid.
+
+This uses g_dgettext() internally. See that functions for differences
+with dgettext() proper.
+
+This function differs from C_() in that it is not a macro and
+thus you may use non-string-literals as context and msgid arguments.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> the translation domain to use, or %NULL to use
+the domain set with textdomain()
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> the message context
+</parameter_description>
+</parameter>
+<parameter name="msgid">
+<parameter_description> the message
+</parameter_description>
+</parameter>
+</parameters>
+<return> The translated string
+
+</return>
+</function>
+
+<function name="g_enum_complete_type_info">
+<description>
+This function is meant to be called from the <literal>complete_type_info</literal>
+function of a #GTypePlugin implementation, as in the following
+example:
+
+|[
+static void
+my_enum_complete_type_info (GTypePlugin *plugin,
+GType g_type,
+GTypeInfo *info,
+GTypeValueTable *value_table)
+{
+static const GEnumValue values[] = {
+{ MY_ENUM_FOO, "MY_ENUM_FOO", "foo" },
+{ MY_ENUM_BAR, "MY_ENUM_BAR", "bar" },
+{ 0, NULL, NULL }
+};
+
+g_enum_complete_type_info (type, info, values);
+}
+]|
+
+</description>
+<parameters>
+<parameter name="g_enum_type">
+<parameter_description> the type identifier of the type being completed
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> the #GTypeInfo struct to be filled in
+</parameter_description>
+</parameter>
+<parameter name="const_values">
+<parameter_description> An array of #GEnumValue structs for the possible
+enumeration values. The array is terminated by a struct with all
+members being 0.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_enum_get_value">
+<description>
+Returns the #GEnumValue for a value.
+
+
+</description>
+<parameters>
+<parameter name="enum_class">
+<parameter_description> a #GEnumClass
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GEnumValue for @value, or %NULL if @value is not a
+member of the enumeration
+</return>
+</function>
+
+<function name="g_enum_get_value_by_name">
+<description>
+Looks up a #GEnumValue by name.
+
+
+</description>
+<parameters>
+<parameter name="enum_class">
+<parameter_description> a #GEnumClass
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GEnumValue with name @name, or %NULL if the
+enumeration doesn't have a member with that name
+</return>
+</function>
+
+<function name="g_enum_get_value_by_nick">
+<description>
+Looks up a #GEnumValue by nickname.
+
+
+</description>
+<parameters>
+<parameter name="enum_class">
+<parameter_description> a #GEnumClass
+</parameter_description>
+</parameter>
+<parameter name="nick">
+<parameter_description> the nickname to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GEnumValue with nickname @nick, or %NULL if the
+enumeration doesn't have a member with that nickname
+</return>
+</function>
+
+<function name="g_enum_register_static">
+<description>
+Registers a new static enumeration type with the name @name.
+
+It is normally more convenient to let <link
+linkend="glib-mkenums">glib-mkenums</link> generate a
+my_enum_get_type() function from a usual C enumeration definition
+than to write one yourself using g_enum_register_static().
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> A nul-terminated string used as the name of the new type.
+</parameter_description>
+</parameter>
+<parameter name="const_static_values">
+<parameter_description> An array of #GEnumValue structs for the possible
+enumeration values. The array is terminated by a struct with all
+members being 0. GObject keeps a reference to the data, so it cannot
+be stack-allocated.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The new type identifier.
+</return>
+</function>
+
+<function name="g_environ_getenv">
+<description>
+Returns the value of the environment variable @variable in the
+provided list @envp.
+
+The name and value are in the GLib file name encoding.
+On UNIX, this means the actual bytes which might or might not
+be in some consistent character set and encoding. On Windows,
+it is in UTF-8. On Windows, in case the environment variable's
+value contains references to other environment variables, they
+are expanded.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="envp">
+<parameter_description> an environment
+list (eg, as returned from g_get_environ())
+</parameter_description>
+</parameter>
+<parameter name="variable">
+<parameter_description> the environment variable to get, in the GLib file name
+encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of the environment variable, or %NULL if
+the environment variable is not set in @envp. The returned
+string is owned by @envp, and will be freed if @variable is
+set or unset again.
+
+</return>
+</function>
+
+<function name="g_environ_setenv">
+<description>
+Sets the environment variable @variable in the provided list
+ envp to @value.
+
+Both the variable's name and value should be in the GLib
+file name encoding. On UNIX, this means that they can be
+arbitrary byte strings. On Windows, they should be in UTF-8.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="envp">
+<parameter_description> an environment
+list (eg, as returned from g_get_environ())
+</parameter_description>
+</parameter>
+<parameter name="variable">
+<parameter_description> the environment variable to set, must not contain '='
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value for to set the variable to
+</parameter_description>
+</parameter>
+<parameter name="overwrite">
+<parameter_description> whether to change the variable if it already exists
+</parameter_description>
+</parameter>
+</parameters>
+<return> the
+updated environment
+
+</return>
+</function>
+
+<function name="g_environ_unsetenv">
+<description>
+Removes the environment variable @variable from the provided
+environment @envp.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="envp">
+<parameter_description> an environment
+list (eg, as returned from g_get_environ())
+</parameter_description>
+</parameter>
+<parameter name="variable">
+<parameter_description> the environment variable to remove, must not contain '='
+</parameter_description>
+</parameter>
+</parameters>
+<return> the
+updated environment
+
+</return>
+</function>
+
+<function name="g_error">
+<description>
+A convenience function/macro to log an error message.
+
+Error messages are always fatal, resulting in a call to
+abort() to terminate the application. This function will
+result in a core dump; don't use it for errors you expect.
+Using this function indicates a bug in your program, i.e.
+an assertion failure.
+
+
+</description>
+<parameters>
+<parameter name="Varargs">
+<parameter_description> format string, followed by parameters to insert
+into the format string (as with printf())
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_error_copy">
+<description>
+Makes a copy of @error.
+
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GError
+</return>
+</function>
+
+<function name="g_error_free">
+<description>
+Frees a #GError and associated resources.
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_error_matches">
+<description>
+Returns %TRUE if @error matches @domain and @code, %FALSE
+otherwise. In particular, when @error is %NULL, %FALSE will
+be returned.
+
+
+</description>
+<parameters>
+<parameter name="error">
+<parameter_description> a #GError or %NULL
+</parameter_description>
+</parameter>
+<parameter name="domain">
+<parameter_description> an error domain
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> an error code
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @error has @domain and @code
+</return>
+</function>
+
+<function name="g_error_new">
+<description>
+Creates a new #GError with the given @domain and @code,
+and a message formatted with @format.
+
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> error domain
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> error code
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format for error message
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> parameters for message format
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GError
+</return>
+</function>
+
+<function name="g_error_new_literal">
+<description>
+Creates a new #GError; unlike g_error_new(), @message is
+not a printf()-style format string. Use this function if
+ message contains text you don't have control over,
+that could include printf() escape sequences.
+
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> error domain
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> error code
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> error message
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GError
+</return>
+</function>
+
+<function name="g_error_new_valist">
+<description>
+Creates a new #GError with the given @domain and @code,
+and a message formatted with @format.
+
+Since: 2.22
+
+</description>
+<parameters>
+<parameter name="domain">
+<parameter_description> error domain
+</parameter_description>
+</parameter>
+<parameter name="code">
+<parameter_description> error code
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> printf()-style format for error message
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> #va_list of parameters for the message format
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GError
+
+</return>
+</function>
+
+<function name="g_file_error_from_errno">
+<description>
+Gets a #GFileError constant based on the passed-in @err_no.
+For example, if you pass in <literal>EEXIST</literal> this function returns
+#G_FILE_ERROR_EXIST. Unlike <literal>errno</literal> values, you can portably
+assume that all #GFileError values will exist.
+
+Normally a #GFileError value goes into a #GError returned
+from a function that manipulates files. So you would use
+g_file_error_from_errno() when constructing a #GError.
+
+
+</description>
+<parameters>
+<parameter name="err_no">
+<parameter_description> an "errno" value
+</parameter_description>
+</parameter>
+</parameters>
+<return> #GFileError corresponding to the given @errno
+</return>
+</function>
+
+<function name="g_file_get_contents">
+<description>
+Reads an entire file into allocated memory, with good error
+checking.
+
+If the call was successful, it returns %TRUE and sets @contents to the file
+contents and @length to the length of the file contents in bytes. The string
+stored in @contents will be nul-terminated, so for text files you can pass
+%NULL for the @length argument. If the call was not successful, it returns
+%FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error
+codes are those in the #GFileError enumeration. In the error case,
+ contents is set to %NULL and @length is set to zero.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> name of a file to read contents from, in the GLib file name encoding
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> location to store an allocated string, use g_free() to free
+the returned string
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> location to store length in bytes of the contents, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if an error occurred
+</return>
+</function>
+
+<function name="g_file_open_tmp">
+<description>
+Opens a file for writing in the preferred directory for temporary
+files (as returned by g_get_tmp_dir()).
+
+ tmpl should be a string in the GLib file name encoding containing
+a sequence of six 'X' characters, as the parameter to g_mkstemp().
+However, unlike these functions, the template should only be a
+basename, no directory components are allowed. If template is
+%NULL, a default template is used.
+
+Note that in contrast to g_mkstemp() (and mkstemp()) @tmpl is not
+modified, and might thus be a read-only literal string.
+
+Upon success, and if @name_used is non-%NULL, the actual name used
+is returned in @name_used. This string should be freed with g_free()
+when not needed any longer. The returned name is in the GLib file
+name encoding.
+
+
+</description>
+<parameters>
+<parameter name="tmpl">
+<parameter_description> Template for file name, as in
+g_mkstemp(), basename only, or %NULL for a default template
+</parameter_description>
+</parameter>
+<parameter name="name_used">
+<parameter_description> location to store actual name used,
+or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> A file handle (as from open()) to the file opened for
+reading and writing. The file is opened in binary mode on platforms
+where there is a difference. The file handle should be closed with
+close(). In case of errors, -1 is returned and @error will be set.
+</return>
+</function>
+
+<function name="g_file_read_link">
+<description>
+Reads the contents of the symbolic link @filename like the POSIX
+readlink() function. The returned string is in the encoding used
+for filenames. Use g_filename_to_utf8() to convert it to UTF-8.
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> the symbolic link
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError
+</parameter_description>
+</parameter>
+</parameters>
+<return> A newly-allocated string with the contents of the symbolic link,
+or %NULL if an error occurred.
+
+</return>
+</function>
+
+<function name="g_file_set_contents">
+<description>
+Writes all of @contents to a file named @filename, with good error checking.
+If a file called @filename already exists it will be overwritten.
+
+This write is atomic in the sense that it is first written to a temporary
+file which is then renamed to the final name. Notes:
+<itemizedlist>
+<listitem>
+On Unix, if @filename already exists hard links to @filename will break.
+Also since the file is recreated, existing permissions, access control
+lists, metadata etc. may be lost. If @filename is a symbolic link,
+the link itself will be replaced, not the linked file.
+</listitem>
+<listitem>
+On Windows renaming a file will not remove an existing file with the
+new name, so on Windows there is a race condition between the existing
+file being removed and the temporary file being renamed.
+</listitem>
+<listitem>
+On Windows there is no way to remove a file that is open to some
+process, or mapped into memory. Thus, this function will fail if
+ filename already exists and is open.
+</listitem>
+</itemizedlist>
+
+If the call was successful, it returns %TRUE. If the call was not successful,
+it returns %FALSE and sets @error. The error domain is #G_FILE_ERROR.
+Possible error codes are those in the #GFileError enumeration.
Note that the name for the temporary file is constructed by appending up
to 7 characters to @filename.
-Since: 2.8
+Since: 2.8
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> name of a file to write @contents to, in the GLib file name
+encoding
+</parameter_description>
+</parameter>
+<parameter name="contents">
+<parameter_description> string to write to the file
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> length of @contents, or -1 if @contents is a nul-terminated string
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if an error occurred
+
+</return>
+</function>
+
+<function name="g_file_test">
+<description>
+Returns %TRUE if any of the tests in the bitfield @test are
+%TRUE. For example, <literal>(G_FILE_TEST_EXISTS |
+G_FILE_TEST_IS_DIR)</literal> will return %TRUE if the file exists;
+the check whether it's a directory doesn't matter since the existence
+test is %TRUE. With the current set of available tests, there's no point
+passing in more than one test at a time.
+
+Apart from %G_FILE_TEST_IS_SYMLINK all tests follow symbolic links,
+so for a symbolic link to a regular file g_file_test() will return
+%TRUE for both %G_FILE_TEST_IS_SYMLINK and %G_FILE_TEST_IS_REGULAR.
+
+Note, that for a dangling symbolic link g_file_test() will return
+%TRUE for %G_FILE_TEST_IS_SYMLINK and %FALSE for all other flags.
+
+You should never use g_file_test() to test whether it is safe
+to perform an operation, because there is always the possibility
+of the condition changing before you actually perform the operation.
+For example, you might think you could use %G_FILE_TEST_IS_SYMLINK
+to know whether it is safe to write to a file without being
+tricked into writing into a different location. It doesn't work!
+|[
+/ * DON'T DO THIS * /
+if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK))
+{
+fd = g_open (filename, O_WRONLY);
+/ * write to fd * /
+}
+]|
+
+Another thing to note is that %G_FILE_TEST_EXISTS and
+%G_FILE_TEST_IS_EXECUTABLE are implemented using the access()
+system call. This usually doesn't matter, but if your program
+is setuid or setgid it means that these tests will give you
+the answer for the real user ID and group ID, rather than the
+effective user ID and group ID.
+
+On Windows, there are no symlinks, so testing for
+%G_FILE_TEST_IS_SYMLINK will always return %FALSE. Testing for
+%G_FILE_TEST_IS_EXECUTABLE will just check that the file exists and
+its name indicates that it is executable, checking for well-known
+extensions and those listed in the <envar>PATHEXT</envar> environment variable.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a filename to test in the GLib file name encoding
+</parameter_description>
+</parameter>
+<parameter name="test">
+<parameter_description> bitfield of #GFileTest flags
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether a test was %TRUE
+</return>
+</function>
+
+<function name="g_filename_display_basename">
+<description>
+Returns the display basename for the particular filename, guaranteed
+to be valid UTF-8. The display name might not be identical to the filename,
+for instance there might be problems converting it to UTF-8, and some files
+can be translated in the display.
+
+If GLib cannot make sense of the encoding of @filename, as a last resort it
+replaces unknown characters with U+FFFD, the Unicode replacement character.
+You can search the result for the UTF-8 encoding of this character (which is
+"\357\277\275" in octal notation) to find out if @filename was in an invalid
+encoding.
+
+You must pass the whole absolute pathname to this functions so that
+translation of well known locations can be done.
+
+This function is preferred over g_filename_display_name() if you know the
+whole path, as it allows translation.
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> an absolute pathname in the GLib file name encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing
+a rendition of the basename of the filename in valid UTF-8
+
+</return>
+</function>
+
+<function name="g_filename_display_name">
+<description>
+Converts a filename into a valid UTF-8 string. The conversion is
+not necessarily reversible, so you should keep the original around
+and use the return value of this function only for display purposes.
+Unlike g_filename_to_utf8(), the result is guaranteed to be non-%NULL
+even if the filename actually isn't in the GLib file name encoding.
+
+If GLib cannot make sense of the encoding of @filename, as a last resort it
+replaces unknown characters with U+FFFD, the Unicode replacement character.
+You can search the result for the UTF-8 encoding of this character (which is
+"\357\277\275" in octal notation) to find out if @filename was in an invalid
+encoding.
+
+If you know the whole pathname of the file you should use
+g_filename_display_basename(), since that allows location-based
+translation of filenames.
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a pathname hopefully in the GLib file name encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string containing
+a rendition of the filename in valid UTF-8
+
+</return>
+</function>
+
+<function name="g_filename_from_uri">
+<description>
+Converts an escaped ASCII-encoded URI to a local filename in the
+encoding used for filenames.
+
+
+</description>
+<parameters>
+<parameter name="uri">
+<parameter_description> a uri describing a filename (escaped, encoded in ASCII).
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> Location to store hostname for the URI, or %NULL.
+If there is no hostname in the URI, %NULL will be
+stored in this location.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated string holding the resulting
+filename, or %NULL on an error.
+</return>
+</function>
+
+<function name="g_filename_from_utf8">
+<description>
+Converts a string from UTF-8 to the encoding GLib uses for
+filenames. Note that on Windows GLib uses UTF-8 for filenames;
+on other platforms, this function indirectly depends on the
+<link linkend="setlocale">current locale</link>.
+
+
+</description>
+<parameters>
+<parameter name="utf8string">
+<parameter_description> a UTF-8 encoded string.
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the length of the string, or -1 if the string is
+nul-terminated.
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> location to store the number of bytes in the
+input string that were successfully converted, or %NULL.
+Even if the conversion was successful, this may be
+less than @len if there were partial characters
+at the end of the input. If the error
+#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
+stored will the byte offset after the last valid
+input sequence.
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> the number of bytes stored in the output buffer (not
+including the terminating nul).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The converted string, or %NULL on an error.
+</return>
+</function>
+
+<function name="g_filename_to_uri">
+<description>
+Converts an absolute filename to an escaped ASCII-encoded URI, with the path
+component following Section 3.3. of RFC 2396.
+
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> an absolute filename specified in the GLib file name encoding,
+which is the on-disk file name bytes on Unix, and UTF-8 on
+Windows
+</parameter_description>
+</parameter>
+<parameter name="hostname">
+<parameter_description> A UTF-8 encoded hostname, or %NULL for none.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated string holding the resulting
+URI, or %NULL on an error.
+</return>
+</function>
+
+<function name="g_filename_to_utf8">
+<description>
+Converts a string which is in the encoding used by GLib for
+filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
+for filenames; on other platforms, this function indirectly depends on
+the <link linkend="setlocale">current locale</link>.
+
+
+</description>
+<parameters>
+<parameter name="opsysstring">
+<parameter_description> a string in the encoding for filenames
+</parameter_description>
+</parameter>
+<parameter name="len">
+<parameter_description> the length of the string, or -1 if the string is
+nul-terminated<footnoteref linkend="nul-unsafe"/>.
+</parameter_description>
+</parameter>
+<parameter name="bytes_read">
+<parameter_description> location to store the number of bytes in the
+input string that were successfully converted, or %NULL.
+Even if the conversion was successful, this may be
+less than @len if there were partial characters
+at the end of the input. If the error
+#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
+stored will the byte offset after the last valid
+input sequence.
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> the number of bytes stored in the output buffer (not
+including the terminating nul).
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+errors. Any of the errors in #GConvertError may occur.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The converted string, or %NULL on an error.
+</return>
+</function>
+
+<function name="g_find_program_in_path">
+<description>
+Locates the first executable named @program in the user's path, in the
+same way that execvp() would locate it. Returns an allocated string
+with the absolute path name, or %NULL if the program is not found in
+the path. If @program is already an absolute path, returns a copy of
+ program if @program exists and is executable, and %NULL otherwise.
+
+On Windows, if @program does not have a file type suffix, tries
+with the suffixes .exe, .cmd, .bat and .com, and the suffixes in
+the <envar>PATHEXT</envar> environment variable.
+
+On Windows, it looks for the file in the same way as CreateProcess()
+would. This means first in the directory where the executing
+program was loaded from, then in the current directory, then in the
+Windows 32-bit system directory, then in the Windows directory, and
+finally in the directories in the <envar>PATH</envar> environment
+variable. If the program is found, the return value contains the
+full name including the type suffix.
+
+
+</description>
+<parameters>
+<parameter name="program">
+<parameter_description> a program name in the GLib file name encoding
+</parameter_description>
+</parameter>
+</parameters>
+<return> absolute path, or %NULL
+</return>
+</function>
+
+<function name="g_flags_complete_type_info">
+<description>
+This function is meant to be called from the complete_type_info()
+function of a #GTypePlugin implementation, see the example for
+g_enum_complete_type_info() above.
+
+</description>
+<parameters>
+<parameter name="g_flags_type">
+<parameter_description> the type identifier of the type being completed
+</parameter_description>
+</parameter>
+<parameter name="info">
+<parameter_description> the #GTypeInfo struct to be filled in
+</parameter_description>
+</parameter>
+<parameter name="const_values">
+<parameter_description> An array of #GFlagsValue structs for the possible
+enumeration values. The array is terminated by a struct with all
+members being 0.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_flags_get_first_value">
+<description>
+Returns the first #GFlagsValue which is set in @value.
+
+
+</description>
+<parameters>
+<parameter name="flags_class">
+<parameter_description> a #GFlagsClass
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value
+</parameter_description>
+</parameter>
+</parameters>
+<return> the first #GFlagsValue which is set in @value, or %NULL if
+none is set
+</return>
+</function>
+
+<function name="g_flags_get_value_by_name">
+<description>
+Looks up a #GFlagsValue by name.
+
+
+</description>
+<parameters>
+<parameter name="flags_class">
+<parameter_description> a #GFlagsClass
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GFlagsValue with name @name, or %NULL if there is no
+flag with that name
+</return>
+</function>
+
+<function name="g_flags_get_value_by_nick">
+<description>
+Looks up a #GFlagsValue by nickname.
+
+
+</description>
+<parameters>
+<parameter name="flags_class">
+<parameter_description> a #GFlagsClass
+</parameter_description>
+</parameter>
+<parameter name="nick">
+<parameter_description> the nickname to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GFlagsValue with nickname @nick, or %NULL if there is
+no flag with that nickname
+</return>
+</function>
+
+<function name="g_flags_register_static">
+<description>
+Registers a new static flags type with the name @name.
+
+It is normally more convenient to let <link
+linkend="glib-mkenums">glib-mkenums</link> generate a
+my_flags_get_type() function from a usual C enumeration definition
+than to write one yourself using g_flags_register_static().
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> A nul-terminated string used as the name of the new type.
+</parameter_description>
+</parameter>
+<parameter name="const_static_values">
+<parameter_description> An array of #GFlagsValue structs for the possible
+flags values. The array is terminated by a struct with all members being 0.
+GObject keeps a reference to the data, so it cannot be stack-allocated.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The new type identifier.
+</return>
+</function>
+
+<function name="g_fopen">
+<description>
+A wrapper for the stdio fopen() function. The fopen() function
+opens a file and associates a new stream with it.
+
+Because file descriptors are specific to the C library on Windows,
+and a file descriptor is partof the <type>FILE</type> struct, the
+<type>FILE</type> pointer returned by this function makes sense
+only to functions in the same C library. Thus if the GLib-using
+code uses a different C library than GLib does, the
+<type>FILE</type> pointer returned by this function cannot be
+passed to C library functions like fprintf() or fread().
+
+See your C library manual for more details about fopen().
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> a string describing the mode in which the file should be
+opened
+</parameter_description>
+</parameter>
+</parameters>
+<return> A <type>FILE</type> pointer if the file was successfully
+opened, or %NULL if an error occurred
+
+</return>
+</function>
+
+<function name="g_format_size">
+<description>
+Formats a size (for example the size of a file) into a human readable
+string. Sizes are rounded to the nearest size prefix (kB, MB, GB)
+and are displayed rounded to the nearest tenth. E.g. the file size
+3292528 bytes will be converted into the string "3.2 MB".
+
+The prefix units base is 1000 (i.e. 1 kB is 1000 bytes).
+
+This string should be freed with g_free() when not needed any longer.
+
+See g_format_size_full() for more options about how the size might be
+formatted.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="size">
+<parameter_description> a size in bytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated formatted string containing a human readable
+file size
+
+</return>
+</function>
+
+<function name="g_format_size_for_display">
+<description>
+Formats a size (for example the size of a file) into a human
+readable string. Sizes are rounded to the nearest size prefix
+(KB, MB, GB) and are displayed rounded to the nearest tenth.
+E.g. the file size 3292528 bytes will be converted into the
+string "3.1 MB".
+
+The prefix units base is 1024 (i.e. 1 KB is 1024 bytes).
+
+This string should be freed with g_free() when not needed any longer.
+
+Since: 2.16
+
+Deprecated:2.30: This function is broken due to its use of SI
+suffixes to denote IEC units. Use g_format_size() instead.
+
+</description>
+<parameters>
+<parameter name="size">
+<parameter_description> a size in bytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated formatted string containing a human
+readable file size
+
+</return>
+</function>
+
+<function name="g_format_size_full">
+<description>
+Formats a size.
+
+This function is similar to g_format_size() but allows for flags
+that modify the output. See #GFormatSizeFlags.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="size">
+<parameter_description> a size in bytes
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> #GFormatSizeFlags to modify the output
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated formatted string containing a human
+readable file size
+
+</return>
+</function>
+
+<function name="g_fprintf">
+<description>
+An implementation of the standard fprintf() function which supports
+positional parameters, as specified in the Single Unix Specification.
+
+Since: 2.2
+
+</description>
+<parameters>
+<parameter name="file">
+<parameter_description> the stream to write to.
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> a standard printf() format string, but notice
+<link linkend="string-precision">string precision pitfalls</link>.
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the arguments to insert in the output.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes printed.
+
+</return>
+</function>
+
+<function name="g_free">
+<description>
+Frees the memory pointed to by @mem.
+If @mem is %NULL it simply returns.
+
+</description>
+<parameters>
+<parameter name="mem">
+<parameter_description> the memory to free
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_freopen">
+<description>
+A wrapper for the POSIX freopen() function. The freopen() function
+opens a file and associates it with an existing stream.
+
+See your C library manual for more details about freopen().
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> a string describing the mode in which the file should be
+opened
+</parameter_description>
+</parameter>
+<parameter name="stream">
+<parameter_description> an existing stream which will be reused, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A <literal>FILE</literal> pointer if the file was successfully
+opened, or %NULL if an error occurred.
+
+</return>
+</function>
+
+<function name="g_get_application_name">
+<description>
+Gets a human-readable name for the application, as set by
+g_set_application_name(). This name should be localized if
+possible, and is intended for display to the user. Contrast with
+g_get_prgname(), which gets a non-localized name. If
+g_set_application_name() has not been called, returns the result of
+g_get_prgname() (which may be %NULL if g_set_prgname() has also not
+been called).
+
+Since: 2.2
+
+</description>
+<parameters>
+</parameters>
+<return> human-readable application name. may return %NULL
+
+</return>
+</function>
+
+<function name="g_get_charset">
+<description>
+Obtains the character set for the <link linkend="setlocale">current
+locale</link>; you might use this character set as an argument to
+g_convert(), to convert from the current locale's encoding to some
+other encoding. (Frequently g_locale_to_utf8() and g_locale_from_utf8()
+are nice shortcuts, though.)
+
+On Windows the character set returned by this function is the
+so-called system default ANSI code-page. That is the character set
+used by the "narrow" versions of C library and Win32 functions that
+handle file names. It might be different from the character set
+used by the C library's current locale.
+
+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.
+
+
+</description>
+<parameters>
+<parameter name="charset">
+<parameter_description> return location for character set name
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the returned charset is UTF-8
+</return>
+</function>
+
+<function name="g_get_codeset">
+<description>
+Gets the character set for the current locale.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a newly allocated string containing the name
+of the character set. This string must be freed with g_free().
+</return>
+</function>
+
+<function name="g_get_current_dir">
+<description>
+Gets the current directory.
+
+The returned string should be freed when no longer needed.
+The encoding of the returned string is system defined.
+On Windows, it is always UTF-8.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the current directory
+</return>
+</function>
+
+<function name="g_get_current_time">
+<description>
+Equivalent to the UNIX gettimeofday() function, but portable.
+
+You may find g_get_real_time() to be more convenient.
+
+</description>
+<parameters>
+<parameter name="result">
+<parameter_description> #GTimeVal structure in which to store current time.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_get_environ">
+<description>
+Gets the list of environment variables for the current process.
+
+The list is %NULL terminated and each item in the list is of the
+form 'NAME=VALUE'.
+
+This is equivalent to direct access to the 'environ' global variable,
+except portable.
+
+The return value is freshly allocated and it should be freed with
+g_strfreev() when it is no longer needed.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> the list of
+environment variables
+
+</return>
+</function>
+
+<function name="g_get_filename_charsets">
+<description>
+Determines the preferred character sets used for filenames.
+The first character set from the @charsets is the filename encoding, the
+subsequent character sets are used when trying to generate a displayable
+representation of a filename, see g_filename_display_name().
+
+On Unix, the character sets are determined by consulting the
+environment variables <envar>G_FILENAME_ENCODING</envar> and
+<envar>G_BROKEN_FILENAMES</envar>. On Windows, the character set
+used in the GLib API is always UTF-8 and said environment variables
+have no effect.
+
+<envar>G_FILENAME_ENCODING</envar> may be set to a comma-separated list
+of character set names. The special token "@locale" is taken to
+mean the character set for the <link linkend="setlocale">current
+locale</link>. If <envar>G_FILENAME_ENCODING</envar> is not set, but
+<envar>G_BROKEN_FILENAMES</envar> is, the character set of the current
+locale is taken as the filename encoding. If neither environment variable
+is set, UTF-8 is taken as the filename encoding, but the character
+set of the current locale is also put in the list of encodings.
+
+The returned @charsets belong to GLib and must not be freed.
+
+Note that on Unix, regardless of the locale character set or
+<envar>G_FILENAME_ENCODING</envar> value, the actual file names present
+on a system might be in any random encoding or just gibberish.
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="charsets">
+<parameter_description> return location for the %NULL-terminated list of encoding names
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the filename encoding is UTF-8.
+
+</return>
+</function>
+
+<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 (<!-- -->);
+]|
+
+
+</description>
+<parameters>
+</parameters>
+<return> the current user's home directory
+</return>
+</function>
+
+<function name="g_get_host_name">
+<description>
+Return a name for the machine.
+
+The returned name is not necessarily a fully-qualified domain name,
+or even present in DNS or some other name service at all. It need
+not even be unique on your local network or site, but usually it
+is. Callers should not rely on the return value having any specific
+properties like uniqueness for security purposes. Even if the name
+of the machine is changed while an application is running, the
+return value from this function does not change. The returned
+string is owned by GLib and should not be modified or freed. If no
+name can be determined, a default fixed string "localhost" is
+returned.
+
+Since: 2.8
+
+</description>
+<parameters>
+</parameters>
+<return> the host name of the machine.
+
+</return>
+</function>
+
+<function name="g_get_language_names">
+<description>
+Computes a list of applicable locale names, which can be used to
+e.g. construct locale-dependent filenames or search paths. The returned
+list is sorted from most desirable to least desirable and always contains
+the default locale "C".
+
+For example, if LANGUAGE=de:en_US, then the returned list is
+"de", "en_US", "en", "C".
+
+This function consults the environment variables <envar>LANGUAGE</envar>,
+<envar>LC_ALL</envar>, <envar>LC_MESSAGES</envar> and <envar>LANG</envar>
+to find the list of locales specified by the user.
+
+Since: 2.6
+
+</description>
+<parameters>
+</parameters>
+<return> a %NULL-terminated array of strings owned by GLib
+that must not be modified or freed.
+
+</return>
+</function>
+
+<function name="g_get_locale_variants">
+<description>
+Returns a list of derived variants of @locale, which can be used to
+e.g. construct locale-dependent filenames or search paths. The returned
+list is sorted from most desirable to least desirable.
+This function handles territory, charset and extra locale modifiers.
+
+For example, if @locale is "fr_BE", then the returned list
+is "fr_BE", "fr".
+
+If you need the list of variants for the <emphasis>current locale</emphasis>,
+use g_get_language_names().
+
+Since: 2.28
+
+</description>
+<parameters>
+<parameter name="locale">
+<parameter_description> a locale identifier
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly
+allocated array of newly allocated strings with the locale variants. Free with
+g_strfreev().
+
+</return>
+</function>
+
+<function name="g_get_monotonic_time">
+<description>
+Queries the system monotonic time, if available.
+
+On POSIX systems with clock_gettime() and <literal>CLOCK_MONOTONIC</literal> this call
+is a very shallow wrapper for that. Otherwise, we make a best effort
+that probably involves returning the wall clock time (with at least
+microsecond accuracy, subject to the limitations of the OS kernel).
+
+It's important to note that POSIX <literal>CLOCK_MONOTONIC</literal> does
+not count time spent while the machine is suspended.
+
+On Windows, "limitations of the OS kernel" is a rather substantial
+statement. Depending on the configuration of the system, the wall
+clock time is updated as infrequently as 64 times a second (which
+is approximately every 16ms). Also, on XP (but not on Vista or later)
+the monotonic clock is locally monotonic, but may differ in exact
+value between processes due to timer wrap handling.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> the monotonic time, in microseconds
+
+</return>
+</function>
+
+<function name="g_get_prgname">
+<description>
+Gets the name of the program. This name should <emphasis>not</emphasis>
+be localized, contrast with g_get_application_name().
+(If you are using GDK or GTK+ the program name is set in gdk_init(),
+which is called by gtk_init(). The program name is found by taking
+the last component of <literal>argv[0]</literal>.)
+
+
+</description>
+<parameters>
+</parameters>
+<return> the name of the program. The returned string belongs
+to GLib and must not be modified or freed.
+</return>
+</function>
+
+<function name="g_get_real_name">
+<description>
+Gets the real name of the user. This usually comes from the user's entry
+in the <filename>passwd</filename> file. The encoding of the returned
+string is system-defined. (On Windows, it is, however, always UTF-8.)
+If the real user name cannot be determined, the string "Unknown" is
+returned.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the user's real name.
+</return>
+</function>
+
+<function name="g_get_real_time">
+<description>
+Queries the system wall-clock time.
+
+This call is functionally equivalent to g_get_current_time() except
+that the return value is often more convenient than dealing with a
+#GTimeVal.
+
+You should only use this call if you are actually interested in the real
+wall-clock time. g_get_monotonic_time() is probably more useful for
+measuring intervals.
+
+Since: 2.28
+
+</description>
+<parameters>
+</parameters>
+<return> the number of microseconds since January 1, 1970 UTC.
+
+</return>
+</function>
+
+<function name="g_get_system_config_dirs">
+<description>
+Returns an ordered list of base directories in which to access
+system-wide configuration information.
+
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>.
+In this case the list of directories retrieved will be XDG_CONFIG_DIRS.
+
+On Windows is the directory that contains application data for all users.
+A typical path is C:\Documents and Settings\All Users\Application Data.
+This folder is used for application data that is not user specific.
+For example, an application can store a spell-check dictionary, a database
+of clip art, or a log file in the CSIDL_COMMON_APPDATA folder.
+This information will not roam and is available to anyone using the computer.
+
+Since: 2.6
+
+</description>
+<parameters>
+</parameters>
+<return> a %NULL-terminated array of strings owned by GLib that must
+not be modified or freed.
+</return>
+</function>
+
+<function name="g_get_system_data_dirs">
+<description>
+Returns an ordered list of base directories in which to access
+system-wide application data.
+
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>
+In this case the list of directories retrieved will be XDG_DATA_DIRS.
+
+On Windows the first elements in the list are the Application Data
+and Documents folders for All Users. (These can be determined only
+on Windows 2000 or later and are not present in the list on other
+Windows versions.) See documentation for CSIDL_COMMON_APPDATA and
+CSIDL_COMMON_DOCUMENTS.
+
+Then follows the "share" subfolder in the installation folder for
+the package containing the DLL that calls this function, if it can
+be determined.
+
+Finally the list contains the "share" subfolder in the installation
+folder for GLib, and in the installation folder for the package the
+application's .exe file belongs to.
+
+The installation folders above are determined by looking up the
+folder where the module (DLL or EXE) in question is located. If the
+folder's name is "bin", its parent is used, otherwise the folder
+itself.
+
+Note that on Windows the returned list can vary depending on where
+this function is called.
+
+Since: 2.6
+
+</description>
+<parameters>
+</parameters>
+<return> a %NULL-terminated array of strings owned by GLib that must
+not be modified or freed.
+</return>
+</function>
+
+<function name="g_get_tmp_dir">
+<description>
+Gets the directory to use for temporary files. This is found from
+inspecting the environment variables <envar>TMPDIR</envar>,
+<envar>TMP</envar>, and <envar>TEMP</envar> in that order. If none
+of those are defined "/tmp" is returned on UNIX and "C:\" on Windows.
+The encoding of the returned string is system-defined. On Windows,
+it is always UTF-8. The return value is never %NULL or the empty string.
+
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> name of a file to write @contents to, in the GLib file name
-encoding
-</parameter_description>
-</parameter>
-<parameter name="contents">
-<parameter_description> string to write to the file
-</parameter_description>
-</parameter>
-<parameter name="length">
-<parameter_description> length of @contents, or -1 if @contents is a nul-terminated string
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
-</parameter_description>
-</parameter>
</parameters>
-<return> %TRUE on success, %FALSE if an error occurred
-
+<return> the directory to use for temporary files.
</return>
</function>
-<function name="g_file_test">
+<function name="g_get_user_cache_dir">
<description>
-Returns %TRUE if any of the tests in the bitfield @test are
-%TRUE. For example, <literal>(G_FILE_TEST_EXISTS |
-G_FILE_TEST_IS_DIR)</literal> will return %TRUE if the file exists;
-the check whether it's a directory doesn't matter since the existence
-test is %TRUE. With the current set of available tests, there's no point
-passing in more than one test at a time.
-
-Apart from %G_FILE_TEST_IS_SYMLINK all tests follow symbolic links,
-so for a symbolic link to a regular file g_file_test() will return
-%TRUE for both %G_FILE_TEST_IS_SYMLINK and %G_FILE_TEST_IS_REGULAR.
-
-Note, that for a dangling symbolic link g_file_test() will return
-%TRUE for %G_FILE_TEST_IS_SYMLINK and %FALSE for all other flags.
-
-You should never use g_file_test() to test whether it is safe
-to perform an operation, because there is always the possibility
-of the condition changing before you actually perform the operation.
-For example, you might think you could use %G_FILE_TEST_IS_SYMLINK
-to know whether it is safe to write to a file without being
-tricked into writing into a different location. It doesn't work!
-|[
-/ * DON'T DO THIS * /
-if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK))
-{
-fd = g_open (filename, O_WRONLY);
-/ * write to fd * /
-}
-]|
+Returns a base directory in which to store non-essential, cached
+data specific to particular user.
-Another thing to note is that %G_FILE_TEST_EXISTS and
-%G_FILE_TEST_IS_EXECUTABLE are implemented using the access()
-system call. This usually doesn't matter, but if your program
-is setuid or setgid it means that these tests will give you
-the answer for the real user ID and group ID, rather than the
-effective user ID and group ID.
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_CACHE_HOME.
-On Windows, there are no symlinks, so testing for
-%G_FILE_TEST_IS_SYMLINK will always return %FALSE. Testing for
-%G_FILE_TEST_IS_EXECUTABLE will just check that the file exists and
-its name indicates that it is executable, checking for well-known
-extensions and those listed in the %PATHEXT environment variable.
+On Windows is the directory that serves as a common repository for
+temporary Internet files. A typical path is
+C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
+See documentation for CSIDL_INTERNET_CACHE.
+Since: 2.6
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> a filename to test in the GLib file name encoding
-</parameter_description>
-</parameter>
-<parameter name="test">
-<parameter_description> bitfield of #GFileTest flags
-</parameter_description>
-</parameter>
</parameters>
-<return> whether a test was %TRUE
+<return> a string owned by GLib that must not be modified
+or freed.
</return>
</function>
-<function name="g_filename_display_basename">
+<function name="g_get_user_config_dir">
<description>
-Returns the display basename for the particular filename, guaranteed
-to be valid UTF-8. The display name might not be identical to the filename,
-for instance there might be problems converting it to UTF-8, and some files
-can be translated in the display.
-
-If GLib cannot make sense of the encoding of @filename, as a last resort it
-replaces unknown characters with U+FFFD, the Unicode replacement character.
-You can search the result for the UTF-8 encoding of this character (which is
-"\357\277\275" in octal notation) to find out if @filename was in an invalid
-encoding.
+Returns a base directory in which to store user-specific application
+configuration information such as user preferences and settings.
-You must pass the whole absolute pathname to this functions so that
-translation of well known locations can be done.
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_CONFIG_HOME.
-This function is preferred over g_filename_display_name() if you know the
-whole path, as it allows translation.
+On Windows this is the folder to use for local (as opposed to
+roaming) application data. See documentation for
+CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
+what g_get_user_data_dir() returns.
Since: 2.6
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> an absolute pathname in the GLib file name encoding
-</parameter_description>
-</parameter>
</parameters>
-<return> a newly allocated string containing
-a rendition of the basename of the filename in valid UTF-8
-
+<return> a string owned by GLib that must not be modified
+or freed.
</return>
</function>
-<function name="g_filename_display_name">
+<function name="g_get_user_data_dir">
<description>
-Converts a filename into a valid UTF-8 string. The conversion is
-not necessarily reversible, so you should keep the original around
-and use the return value of this function only for display purposes.
-Unlike g_filename_to_utf8(), the result is guaranteed to be non-%NULL
-even if the filename actually isn't in the GLib file name encoding.
+Returns a base directory in which to access application data such
+as icons that is customized for a particular user.
-If GLib cannot make sense of the encoding of @filename, as a last resort it
-replaces unknown characters with U+FFFD, the Unicode replacement character.
-You can search the result for the UTF-8 encoding of this character (which is
-"\357\277\275" in octal notation) to find out if @filename was in an invalid
-encoding.
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>.
+In this case the directory retrieved will be XDG_DATA_HOME.
-If you know the whole pathname of the file you should use
-g_filename_display_basename(), since that allows location-based
-translation of filenames.
+On Windows this is the folder to use for local (as opposed to
+roaming) application data. See documentation for
+CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
+what g_get_user_config_dir() returns.
Since: 2.6
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> a pathname hopefully in the GLib file name encoding
-</parameter_description>
-</parameter>
</parameters>
-<return> a newly allocated string containing
-a rendition of the filename in valid UTF-8
-
+<return> a string owned by GLib that must not be modified
+or freed.
</return>
</function>
-<function name="g_filename_from_uri">
+<function name="g_get_user_name">
<description>
-Converts an escaped ASCII-encoded URI to a local filename in the
-encoding used for filenames.
+Gets the user name of the current user. The encoding of the returned
+string is system-defined. On UNIX, it might be the preferred file name
+encoding, or something else, and there is no guarantee that it is even
+consistent on a machine. On Windows, it is always UTF-8.
</description>
<parameters>
-<parameter name="uri">
-<parameter_description> a uri describing a filename (escaped, encoded in ASCII).
-</parameter_description>
-</parameter>
-<parameter name="hostname">
-<parameter_description> Location to store hostname for the URI, or %NULL.
-If there is no hostname in the URI, %NULL will be
-stored in this location.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
-</parameter_description>
-</parameter>
</parameters>
-<return> a newly-allocated string holding the resulting
-filename, or %NULL on an error.
+<return> the user name of the current user.
</return>
</function>
-<function name="g_filename_from_utf8">
+<function name="g_get_user_runtime_dir">
<description>
-Converts a string from UTF-8 to the encoding GLib uses for
-filenames. Note that on Windows GLib uses UTF-8 for filenames;
-on other platforms, this function indirectly depends on the
-<link linkend="setlocale">current locale</link>.
+Returns a directory that is unique to the current user on the local
+system.
+
+On UNIX platforms this is determined using the mechanisms described in
+the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
+XDG Base Directory Specification</ulink>. This is the directory
+specified in the <envar>XDG_RUNTIME_DIR</envar> environment variable.
+In the case that this variable is not set, GLib will issue a warning
+message to stderr and return the value of g_get_user_cache_dir().
+On Windows this is the folder to use for local (as opposed to
+roaming) application data. See documentation for
+CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
+what g_get_user_config_dir() returns.
+
+Since: 2.28
</description>
<parameters>
-<parameter name="utf8string">
-<parameter_description> a UTF-8 encoded string.
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> the length of the string, or -1 if the string is
-nul-terminated.
-</parameter_description>
-</parameter>
-<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
-input string that were successfully converted, or %NULL.
-Even if the conversion was successful, this may be
-less than @len if there were partial characters
-at the end of the input. If the error
-#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
-stored will the byte offset after the last valid
-input sequence.
-</parameter_description>
-</parameter>
-<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
-</parameter_description>
-</parameter>
</parameters>
-<return> The converted string, or %NULL on an error.
+<return> a string owned by GLib that must not be modified or freed.
+
</return>
</function>
-<function name="g_filename_to_uri">
+<function name="g_get_user_special_dir">
<description>
-Converts an absolute filename to an escaped ASCII-encoded URI, with the path
-component following Section 3.3. of RFC 2396.
+Returns the full path of a special directory using its logical id.
+
+On Unix this is done using the XDG special user directories.
+For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP
+falls back to <filename>$HOME/Desktop</filename> when XDG special
+user directories have not been set up.
+Depending on the platform, the user might be able to change the path
+of the special directory without requiring the session to restart; GLib
+will not reflect any change once the special directories are loaded.
+
+Since: 2.14
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> an absolute filename specified in the GLib file name encoding,
-which is the on-disk file name bytes on Unix, and UTF-8 on
-Windows
-</parameter_description>
-</parameter>
-<parameter name="hostname">
-<parameter_description> A UTF-8 encoded hostname, or %NULL for none.
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
+<parameter name="directory">
+<parameter_description> the logical id of special directory
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string holding the resulting
-URI, or %NULL on an error.
+<return> the path to the specified special directory, or %NULL
+if the logical id was not found. The returned string is owned by
+GLib and should not be modified or freed.
+
</return>
</function>
-<function name="g_filename_to_utf8">
+<function name="g_getenv">
<description>
-Converts a string which is in the encoding used by GLib for
-filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8
-for filenames; on other platforms, this function indirectly depends on
-the <link linkend="setlocale">current locale</link>.
+Returns the value of an environment variable.
+
+The name and value are in the GLib file name encoding. On UNIX,
+this means the actual bytes which might or might not be in some
+consistent character set and encoding. On Windows, it is in UTF-8.
+On Windows, in case the environment variable's value contains
+references to other environment variables, they are expanded.
</description>
<parameters>
-<parameter name="opsysstring">
-<parameter_description> a string in the encoding for filenames
-</parameter_description>
-</parameter>
-<parameter name="len">
-<parameter_description> the length of the string, or -1 if the string is
-nul-terminated<footnoteref linkend="nul-unsafe"/>.
-</parameter_description>
-</parameter>
-<parameter name="bytes_read">
-<parameter_description> location to store the number of bytes in the
-input string that were successfully converted, or %NULL.
-Even if the conversion was successful, this may be
-less than @len if there were partial characters
-at the end of the input. If the error
-#G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
-stored will the byte offset after the last valid
-input sequence.
-</parameter_description>
-</parameter>
-<parameter name="bytes_written">
-<parameter_description> the number of bytes stored in the output buffer (not
-including the terminating nul).
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
-errors. Any of the errors in #GConvertError may occur.
+<parameter name="variable">
+<parameter_description> the environment variable to get, in the GLib file name
+encoding
</parameter_description>
</parameter>
</parameters>
-<return> The converted string, or %NULL on an error.
+<return> the value of the environment variable, or %NULL if
+the environment variable is not found. The returned string
+may be overwritten by the next call to g_getenv(), g_setenv()
+or g_unsetenv().
</return>
</function>
-<function name="g_find_program_in_path">
+<function name="g_hash_table_add">
<description>
-Locates the first executable named @program in the user's path, in the
-same way that execvp() would locate it. Returns an allocated string
-with the absolute path name, or %NULL if the program is not found in
-the path. If @program is already an absolute path, returns a copy of
- program if @program exists and is executable, and %NULL otherwise.
-
-On Windows, if @program does not have a file type suffix, tries
-with the suffixes .exe, .cmd, .bat and .com, and the suffixes in
-the <envar>PATHEXT</envar> environment variable.
+This is a convenience function for using a #GHashTable as a set. It
+is equivalent to calling g_hash_table_replace() with @key as both the
+key and the value.
-On Windows, it looks for the file in the same way as CreateProcess()
-would. This means first in the directory where the executing
-program was loaded from, then in the current directory, then in the
-Windows 32-bit system directory, then in the Windows directory, and
-finally in the directories in the <envar>PATH</envar> environment
-variable. If the program is found, the return value contains the
-full name including the type suffix.
+When a hash table only ever contains keys that have themselves as the
+corresponding value it is able to be stored more efficiently. See
+the discussion in the section description.
+Since: 2.32
</description>
<parameters>
-<parameter name="program">
-<parameter_description> a program name in the GLib file name encoding
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key to insert
</parameter_description>
</parameter>
</parameters>
-<return> absolute path, or %NULL
-</return>
+<return></return>
</function>
-<function name="g_flags_complete_type_info">
+<function name="g_hash_table_contains">
<description>
-This function is meant to be called from the complete_type_info()
-function of a #GTypePlugin implementation, see the example for
-g_enum_complete_type_info() above.
+Checks if @key is in @hash_table.
+
+Since: 2.32
</description>
<parameters>
-<parameter name="g_flags_type">
-<parameter_description> the type identifier of the type being completed
-</parameter_description>
-</parameter>
-<parameter name="info">
-<parameter_description> the #GTypeInfo struct to be filled in
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="const_values">
-<parameter_description> An array of #GFlagsValue structs for the possible
-enumeration values. The array is terminated by a struct with all
-members being 0.
+<parameter name="key">
+<parameter_description> a key to check
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_flags_get_first_value">
+<function name="g_hash_table_destroy">
<description>
-Returns the first #GFlagsValue which is set in @value.
-
+Destroys all keys and values in the #GHashTable and decrements its
+reference count by 1. If keys and/or values are dynamically allocated,
+you should either free them first or create the #GHashTable with destroy
+notifiers using g_hash_table_new_full(). In the latter case the destroy
+functions you supplied will be called on all keys and values during the
+destruction phase.
</description>
<parameters>
-<parameter name="flags_class">
-<parameter_description> a #GFlagsClass
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> the value
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
</parameters>
-<return> the first #GFlagsValue which is set in @value, or %NULL if
-none is set
-</return>
+<return></return>
</function>
-<function name="g_flags_get_value_by_name">
+<function name="g_hash_table_find">
<description>
-Looks up a #GFlagsValue by name.
+Calls the given function for key/value pairs in the #GHashTable
+until @predicate returns %TRUE. The function is passed the key
+and value of each pair, and the given @user_data parameter. The
+hash table may not be modified while iterating over it (you can't
+add/remove items).
+
+Note, that hash tables are really only optimized for forward
+lookups, i.e. g_hash_table_lookup(). So code that frequently issues
+g_hash_table_find() or g_hash_table_foreach() (e.g. in the order of
+once per every entry in a hash table) should probably be reworked
+to use additional or different data structures for reverse lookups
+(keep in mind that an O(n) find/foreach operation issued for all n
+values in a hash table ends up needing O(n*n) operations).
+Since: 2.4
</description>
<parameters>
-<parameter name="flags_class">
-<parameter_description> a #GFlagsClass
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the name to look up
+<parameter name="predicate">
+<parameter_description> function to test the key/value pairs for a certain property
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
-<return> the #GFlagsValue with name @name, or %NULL if there is no
-flag with that name
+<return> The value of the first key/value pair is returned,
+for which @predicate evaluates to %TRUE. If no pair with the
+requested property is found, %NULL is returned.
+
</return>
</function>
-<function name="g_flags_get_value_by_nick">
+<function name="g_hash_table_foreach">
<description>
-Looks up a #GFlagsValue by nickname.
+Calls the given function for each of the key/value pairs in the
+#GHashTable. The function is passed the key and value of each
+pair, and the given @user_data parameter. The hash table may not
+be modified while iterating over it (you can't add/remove
+items). To remove all items matching a predicate, use
+g_hash_table_foreach_remove().
+See g_hash_table_find() for performance caveats for linear
+order searches in contrast to g_hash_table_lookup().
</description>
<parameters>
-<parameter name="flags_class">
-<parameter_description> a #GFlagsClass
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="nick">
-<parameter_description> the nickname to look up
+<parameter name="func">
+<parameter_description> the function to call for each key/value pair
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
-<return> the #GFlagsValue with nickname @nick, or %NULL if there is
-no flag with that nickname
-</return>
+<return></return>
</function>
-<function name="g_flags_register_static">
+<function name="g_hash_table_foreach_remove">
<description>
-Registers a new static flags type with the name @name.
+Calls the given function for each key/value pair in the
+#GHashTable. If the function returns %TRUE, then the key/value
+pair is removed from the #GHashTable. If you supplied key or
+value destroy functions when creating the #GHashTable, they are
+used to free the memory allocated for the removed keys and values.
-It is normally more convenient to let <link
-linkend="glib-mkenums">glib-mkenums</link> generate a
-my_flags_get_type() function from a usual C enumeration definition
-than to write one yourself using g_flags_register_static().
+See #GHashTableIter for an alternative way to loop over the
+key/value pairs in the hash table.
</description>
<parameters>
-<parameter name="name">
-<parameter_description> A nul-terminated string used as the name of the new type.
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="const_static_values">
-<parameter_description> An array of #GFlagsValue structs for the possible
-flags values. The array is terminated by a struct with all members being 0.
-GObject keeps a reference to the data, so it cannot be stack-allocated.
+<parameter name="func">
+<parameter_description> the function to call for each key/value pair
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
-<return> The new type identifier.
+<return> the number of key/value pairs removed
</return>
</function>
-<function name="g_fopen">
+<function name="g_hash_table_foreach_steal">
<description>
-A wrapper for the stdio fopen() function. The fopen() function
-opens a file and associates a new stream with it.
-
-Because file descriptors are specific to the C library on Windows,
-and a file descriptor is partof the <type>FILE</type> struct, the
-<type>FILE</type> pointer returned by this function makes sense
-only to functions in the same C library. Thus if the GLib-using
-code uses a different C library than GLib does, the
-<type>FILE</type> pointer returned by this function cannot be
-passed to C library functions like fprintf() or fread().
+Calls the given function for each key/value pair in the
+#GHashTable. If the function returns %TRUE, then the key/value
+pair is removed from the #GHashTable, but no key or value
+destroy functions are called.
-See your C library manual for more details about fopen().
+See #GHashTableIter for an alternative way to loop over the
+key/value pairs in the hash table.
-Since: 2.6
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> a string describing the mode in which the file should be
-opened
+<parameter name="func">
+<parameter_description> the function to call for each key/value pair
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
</parameter_description>
</parameter>
</parameters>
-<return> A <type>FILE</type> pointer if the file was successfully
-opened, or %NULL if an error occurred
-
+<return> the number of key/value pairs removed.
</return>
</function>
-<function name="g_format_size_for_display">
+<function name="g_hash_table_freeze">
<description>
-Formats a size (for example the size of a file) into a human readable string.
-Sizes are rounded to the nearest size prefix (KB, MB, GB) and are displayed
-rounded to the nearest tenth. E.g. the file size 3292528 bytes will be
-converted into the string "3.1 MB".
-
-The prefix units base is 1024 (i.e. 1 KB is 1024 bytes).
-
-This string should be freed with g_free() when not needed any longer.
-
-Since: 2.16
+This function is deprecated and will be removed in the next major
+release of GLib. It does nothing.
</description>
<parameters>
-<parameter name="size">
-<parameter_description> a size in bytes.
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated formatted string containing a human readable
-file size.
-
-</return>
+<return></return>
</function>
-<function name="g_fprintf">
+<function name="g_hash_table_get_keys">
<description>
-An implementation of the standard fprintf() function which supports
-positional parameters, as specified in the Single Unix Specification.
+Retrieves every key inside @hash_table. The returned data
+is valid until @hash_table is modified.
-Since: 2.2
+Since: 2.14
</description>
<parameters>
-<parameter name="file">
-<parameter_description> the stream to write to.
-</parameter_description>
-</parameter>
-<parameter name="format">
-<parameter_description> a standard printf() format string, but notice
-<link linkend="string-precision">string precision pitfalls</link>.
-</parameter_description>
-</parameter>
-<parameter name="Varargs">
-<parameter_description> the arguments to insert in the output.
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
</parameters>
-<return> the number of bytes printed.
+<return> a #GList containing all the keys inside the hash
+table. The content of the list is owned by the hash table and
+should not be modified or freed. Use g_list_free() when done
+using the list.
</return>
</function>
-<function name="g_free">
+<function name="g_hash_table_get_values">
<description>
-Frees the memory pointed to by @mem.
-If @mem is %NULL it simply returns.
+Retrieves every value inside @hash_table. The returned data
+is valid until @hash_table is modified.
+
+Since: 2.14
</description>
<parameters>
-<parameter name="mem">
-<parameter_description> the memory to free
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GList containing all the values inside the hash
+table. The content of the list is owned by the hash table and
+should not be modified or freed. Use g_list_free() when done
+using the list.
+
+</return>
</function>
-<function name="g_freopen">
+<function name="g_hash_table_insert">
<description>
-A wrapper for the POSIX freopen() function. The freopen() function
-opens a file and associates it with an existing stream.
-
-See your C library manual for more details about freopen().
+Inserts a new key and value into a #GHashTable.
-Since: 2.6
+If the key already exists in the #GHashTable its current
+value is replaced with the new value. If you supplied a
+ value_destroy_func when creating the #GHashTable, the old
+value is freed using that function. If you supplied a
+ key_destroy_func when creating the #GHashTable, the passed
+key is freed using that function.
</description>
<parameters>
-<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
-<parameter name="mode">
-<parameter_description> a string describing the mode in which the file should be
-opened
+<parameter name="key">
+<parameter_description> a key to insert
</parameter_description>
</parameter>
-<parameter name="stream">
-<parameter_description> an existing stream which will be reused, or %NULL
+<parameter name="value">
+<parameter_description> the value to associate with the key
</parameter_description>
</parameter>
</parameters>
-<return> A <type>FILE</type> pointer if the file was successfully
-opened, or %NULL if an error occurred.
-
-</return>
+<return></return>
</function>
-<function name="g_get_application_name">
+<function name="g_hash_table_iter_get_hash_table">
<description>
-Gets a human-readable name for the application, as set by
-g_set_application_name(). This name should be localized if
-possible, and is intended for display to the user. Contrast with
-g_get_prgname(), which gets a non-localized name. If
-g_set_application_name() has not been called, returns the result of
-g_get_prgname() (which may be %NULL if g_set_prgname() has also not
-been called).
+Returns the #GHashTable associated with @iter.
-Since: 2.2
+Since: 2.16
</description>
<parameters>
+<parameter name="iter">
+<parameter_description> an initialized #GHashTableIter
+</parameter_description>
+</parameter>
</parameters>
-<return> human-readable application name. may return %NULL
+<return> the #GHashTable associated with @iter.
</return>
</function>
-<function name="g_get_charset">
+<function name="g_hash_table_iter_init">
<description>
-Obtains the character set for the <link linkend="setlocale">current
-locale</link>; you might use this character set as an argument to
-g_convert(), to convert from the current locale's encoding to some
-other encoding. (Frequently g_locale_to_utf8() and g_locale_from_utf8()
-are nice shortcuts, though.)
-
-On Windows the character set returned by this function is the
-so-called system default ANSI code-page. That is the character set
-used by the "narrow" versions of C library and Win32 functions that
-handle file names. It might be different from the character set
-used by the C library's current locale.
-
-The return value is %TRUE if the locale's encoding is UTF-8, in that
-case you can perhaps avoid calling g_convert().
+Initializes a key/value pair iterator and associates it with
+ hash_table Modifying the hash table after calling this function
+invalidates the returned iterator.
+|[
+GHashTableIter iter;
+gpointer key, value;
-The string returned in @charset is not allocated, and should not be
-freed.
+g_hash_table_iter_init (&iter, hash_table);
+while (g_hash_table_iter_next (&iter, &key, &value))
+{
+/ * do something with key and value * /
+}
+]|
+Since: 2.16
</description>
<parameters>
-<parameter name="charset">
-<parameter_description> return location for character set name
+<parameter name="iter">
+<parameter_description> an uninitialized #GHashTableIter
+</parameter_description>
+</parameter>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the returned charset is UTF-8
-</return>
+<return></return>
</function>
-<function name="g_get_codeset">
+<function name="g_hash_table_iter_next">
<description>
-Get the codeset for the current locale.
+Advances @iter and retrieves the key and/or value that are now
+pointed to as a result of this advancement. If %FALSE is returned,
+ key and @value are not set, and the iterator becomes invalid.
+Since: 2.16
</description>
<parameters>
+<parameter name="iter">
+<parameter_description> an initialized #GHashTableIter
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a location to store the key, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> a location to store the value, or %NULL
+</parameter_description>
+</parameter>
</parameters>
-<return> a newly allocated string containing the name
-of the codeset. This string must be freed with g_free().
-</return>
-</function>
-
-<function name="g_get_current_dir">
-<description>
-Gets the current directory.
-The returned string should be freed when no longer needed. The encoding
-of the returned string is system defined. On Windows, it is always UTF-8.
-
+<return> %FALSE if the end of the #GHashTable has been reached.
-</description>
-<parameters>
-</parameters>
-<return> the current directory.
</return>
</function>
-<function name="g_get_current_time">
+<function name="g_hash_table_iter_remove">
<description>
-Equivalent to the UNIX gettimeofday() function, but portable.
+Removes the key/value pair currently pointed to by the iterator
+from its associated #GHashTable. Can only be called after
+g_hash_table_iter_next() returned %TRUE, and cannot be called
+more than once for the same key/value pair.
-You may find g_get_real_time() to be more convenient.
+If the #GHashTable was created using g_hash_table_new_full(),
+the key and value are freed using the supplied destroy functions,
+otherwise you have to make sure that any dynamically allocated
+values are freed yourself.
+
+Since: 2.16
</description>
<parameters>
-<parameter name="result">
-<parameter_description> #GTimeVal structure in which to store current time.
+<parameter name="iter">
+<parameter_description> an initialized #GHashTableIter
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_get_environ">
+<function name="g_hash_table_iter_replace">
<description>
-Gets the list of environment variables for the current process. The
-list is %NULL terminated and each item in the list is of the form
-'NAME=VALUE'.
-
-This is equivalent to direct access to the 'environ' global variable,
-except portable.
+Replaces the value currently pointed to by the iterator
+from its associated #GHashTable. Can only be called after
+g_hash_table_iter_next() returned %TRUE.
-The return value is freshly allocated and it should be freed with
-g_strfreev() when it is no longer needed.
+If you supplied a @value_destroy_func when creating the
+#GHashTable, the old value is freed using that function.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
+<parameter name="iter">
+<parameter_description> an initialized #GHashTableIter
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to replace with
+</parameter_description>
+</parameter>
</parameters>
-<return> the list of environment variables
-
-</return>
+<return></return>
</function>
-<function name="g_get_filename_charsets">
+<function name="g_hash_table_iter_steal">
<description>
-Determines the preferred character sets used for filenames.
-The first character set from the @charsets is the filename encoding, the
-subsequent character sets are used when trying to generate a displayable
-representation of a filename, see g_filename_display_name().
-
-On Unix, the character sets are determined by consulting the
-environment variables <envar>G_FILENAME_ENCODING</envar> and
-<envar>G_BROKEN_FILENAMES</envar>. On Windows, the character set
-used in the GLib API is always UTF-8 and said environment variables
-have no effect.
-
-<envar>G_FILENAME_ENCODING</envar> may be set to a comma-separated list
-of character set names. The special token "@locale" is taken to
-mean the character set for the <link linkend="setlocale">current
-locale</link>. If <envar>G_FILENAME_ENCODING</envar> is not set, but
-<envar>G_BROKEN_FILENAMES</envar> is, the character set of the current
-locale is taken as the filename encoding. If neither environment variable
-is set, UTF-8 is taken as the filename encoding, but the character
-set of the current locale is also put in the list of encodings.
-
-The returned @charsets belong to GLib and must not be freed.
-
-Note that on Unix, regardless of the locale character set or
-<envar>G_FILENAME_ENCODING</envar> value, the actual file names present
-on a system might be in any random encoding or just gibberish.
+Removes the key/value pair currently pointed to by the
+iterator from its associated #GHashTable, without calling
+the key and value destroy functions. Can only be called
+after g_hash_table_iter_next() returned %TRUE, and cannot
+be called more than once for the same key/value pair.
-Since: 2.6
+Since: 2.16
</description>
<parameters>
-<parameter name="charsets">
-<parameter_description> return location for the %NULL-terminated list of encoding names
+<parameter name="iter">
+<parameter_description> an initialized #GHashTableIter
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the filename encoding is UTF-8.
-
-</return>
+<return></return>
</function>
-<function name="g_get_home_dir">
+<function name="g_hash_table_lookup">
<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 (<!-- -->);
-]|
+Looks up a key in a #GHashTable. Note that this function cannot
+distinguish between a key that is not present and one which is present
+and has the value %NULL. If you need this distinction, use
+g_hash_table_lookup_extended().
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to look up
+</parameter_description>
+</parameter>
</parameters>
-<return> the current user's home directory
+<return> the associated value, or %NULL if the key is not found
</return>
</function>
-<function name="g_get_host_name">
+<function name="g_hash_table_lookup_extended">
<description>
-Return a name for the machine.
+Looks up a key in the #GHashTable, returning the original key and the
+associated value and a #gboolean which is %TRUE if the key was found. This
+is useful if you need to free the memory allocated for the original key,
+for example before calling g_hash_table_remove().
-The returned name is not necessarily a fully-qualified domain name,
-or even present in DNS or some other name service at all. It need
-not even be unique on your local network or site, but usually it
-is. Callers should not rely on the return value having any specific
-properties like uniqueness for security purposes. Even if the name
-of the machine is changed while an application is running, the
-return value from this function does not change. The returned
-string is owned by GLib and should not be modified or freed. If no
-name can be determined, a default fixed string "localhost" is
-returned.
+You can actually pass %NULL for @lookup_key to test
+whether the %NULL key exists, provided the hash and equal functions
+of @hash_table are %NULL-safe.
-Since: 2.8
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="lookup_key">
+<parameter_description> the key to look up
+</parameter_description>
+</parameter>
+<parameter name="orig_key">
+<parameter_description> return location for the original key, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> return location for the value associated with the key, or %NULL
+</parameter_description>
+</parameter>
</parameters>
-<return> the host name of the machine.
-
+<return> %TRUE if the key was found in the #GHashTable
</return>
</function>
-<function name="g_get_language_names">
+<function name="g_hash_table_new">
<description>
-Computes a list of applicable locale names, which can be used to
-e.g. construct locale-dependent filenames or search paths. The returned
-list is sorted from most desirable to least desirable and always contains
-the default locale "C".
+Creates a new #GHashTable with a reference count of 1.
-For example, if LANGUAGE=de:en_US, then the returned list is
-"de", "en_US", "en", "C".
+Hash values returned by @hash_func are used to determine where keys
+are stored within the #GHashTable data structure. The g_direct_hash(),
+g_int_hash(), g_int64_hash(), g_double_hash() and g_str_hash()
+functions are provided for some common types of keys.
+If @hash_func is %NULL, g_direct_hash() is used.
-This function consults the environment variables <envar>LANGUAGE</envar>,
-<envar>LC_ALL</envar>, <envar>LC_MESSAGES</envar> and <envar>LANG</envar>
-to find the list of locales specified by the user.
+ key_equal_func is used when looking up keys in the #GHashTable.
+The g_direct_equal(), g_int_equal(), g_int64_equal(), g_double_equal()
+and g_str_equal() functions are provided for the most common types
+of keys. If @key_equal_func is %NULL, keys are compared directly in
+a similar fashion to g_direct_equal(), but without the overhead of
+a function call.
-Since: 2.6
</description>
<parameters>
+<parameter name="hash_func">
+<parameter_description> a function to create a hash value from a key
+</parameter_description>
+</parameter>
+<parameter name="key_equal_func">
+<parameter_description> a function to check two keys for equality
+</parameter_description>
+</parameter>
</parameters>
-<return> a %NULL-terminated array of strings owned by GLib
-that must not be modified or freed.
-
+<return> a new #GHashTable
</return>
</function>
-<function name="g_get_locale_variants">
+<function name="g_hash_table_new_full">
<description>
-Returns a list of derived variants of @locale, which can be used to
-e.g. construct locale-dependent filenames or search paths. The returned
-list is sorted from most desirable to least desirable.
-This function handles territory, charset and extra locale modifiers.
-
-For example, if @locale is "fr_BE", then the returned list
-is "fr_BE", "fr".
-
-If you need the list of variants for the <emphasis>current locale</emphasis>,
-use g_get_language_names().
+Creates a new #GHashTable like g_hash_table_new() with a reference
+count of 1 and allows to specify functions to free the memory
+allocated for the key and value that get called when removing the
+entry from the #GHashTable.
-Since: 2.28
</description>
<parameters>
-<parameter name="locale">
-<parameter_description> a locale identifier
+<parameter name="hash_func">
+<parameter_description> a function to create a hash value from a key
+</parameter_description>
+</parameter>
+<parameter name="key_equal_func">
+<parameter_description> a function to check two keys for equality
+</parameter_description>
+</parameter>
+<parameter name="key_destroy_func">
+<parameter_description> a function to free the memory allocated for the key
+used when removing the entry from the #GHashTable, or %NULL
+if you don't want to supply such a function.
+</parameter_description>
+</parameter>
+<parameter name="value_destroy_func">
+<parameter_description> a function to free the memory allocated for the
+value used when removing the entry from the #GHashTable, or %NULL
+if you don't want to supply such a function.
</parameter_description>
</parameter>
</parameters>
-<return> a newly
-allocated array of newly allocated strings with the locale variants. Free with
-g_strfreev().
-
+<return> a new #GHashTable
</return>
</function>
-<function name="g_get_monotonic_time">
+<function name="g_hash_table_ref">
<description>
-Queries the system monotonic time, if available.
-
-On POSIX systems with clock_gettime() and %CLOCK_MONOTONIC this call
-is a very shallow wrapper for that. Otherwise, we make a best effort
-that probably involves returning the wall clock time (with at least
-microsecond accuracy, subject to the limitations of the OS kernel).
-
-Note that, on Windows, "limitations of the OS kernel" is a rather
-substantial statement. Depending on the configuration of the system,
-the wall clock time is updated as infrequently as 64 times a second
-(which is approximately every 16ms).
+Atomically increments the reference count of @hash_table by one.
+This function is MT-safe and may be called from any thread.
-Since: 2.28
+Since: 2.10
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a valid #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> the monotonic time, in microseconds
+<return> the passed in #GHashTable
</return>
</function>
-<function name="g_get_prgname">
+<function name="g_hash_table_remove">
<description>
-Gets the name of the program. This name should <emphasis>not</emphasis>
-be localized, contrast with g_get_application_name().
-(If you are using GDK or GTK+ the program name is set in gdk_init(),
-which is called by gtk_init(). The program name is found by taking
-the last component of <literal>argv[0]</literal>.)
+Removes a key and its associated value from a #GHashTable.
+
+If the #GHashTable was created using g_hash_table_new_full(), the
+key and value are freed using the supplied destroy functions, otherwise
+you have to make sure that any dynamically allocated values are freed
+yourself.
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to remove
+</parameter_description>
+</parameter>
</parameters>
-<return> the name of the program. The returned string belongs
-to GLib and must not be modified or freed.
+<return> %TRUE if the key was found and removed from the #GHashTable
</return>
</function>
-<function name="g_get_real_name">
+<function name="g_hash_table_remove_all">
<description>
-Gets the real name of the user. This usually comes from the user's entry
-in the <filename>passwd</filename> file. The encoding of the returned
-string is system-defined. (On Windows, it is, however, always UTF-8.)
-If the real user name cannot be determined, the string "Unknown" is
-returned.
+Removes all keys and their associated values from a #GHashTable.
+If the #GHashTable was created using g_hash_table_new_full(),
+the keys and values are freed using the supplied destroy functions,
+otherwise you have to make sure that any dynamically allocated
+values are freed yourself.
+
+Since: 2.12
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> the user's real name.
-</return>
+<return></return>
</function>
-<function name="g_get_real_time">
+<function name="g_hash_table_replace">
<description>
-Queries the system wall-clock time.
-
-This call is functionally equivalent to g_get_current_time() except
-that the return value is often more convenient than dealing with a
-#GTimeVal.
-
-You should only use this call if you are actually interested in the real
-wall-clock time. g_get_monotonic_time() is probably more useful for
-measuring intervals.
-
-Since: 2.28
+Inserts a new key and value into a #GHashTable similar to
+g_hash_table_insert(). The difference is that if the key
+already exists in the #GHashTable, it gets replaced by the
+new key. If you supplied a @value_destroy_func when creating
+the #GHashTable, the old value is freed using that function.
+If you supplied a @key_destroy_func when creating the
+#GHashTable, the old key is freed using that function.
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> a key to insert
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value to associate with the key
+</parameter_description>
+</parameter>
</parameters>
-<return> the number of microseconds since January 1, 1970 UTC.
-
-</return>
+<return></return>
</function>
-<function name="g_get_system_config_dirs">
+<function name="g_hash_table_size">
<description>
-Returns an ordered list of base directories in which to access
-system-wide configuration information.
-
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>.
-In this case the list of directories retrieved will be XDG_CONFIG_DIRS.
-
-On Windows is the directory that contains application data for all users.
-A typical path is C:\Documents and Settings\All Users\Application Data.
-This folder is used for application data that is not user specific.
-For example, an application can store a spell-check dictionary, a database
-of clip art, or a log file in the CSIDL_COMMON_APPDATA folder.
-This information will not roam and is available to anyone using the computer.
+Returns the number of elements contained in the #GHashTable.
-Since: 2.6
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> a %NULL-terminated array of strings owned by GLib that must
-not be modified or freed.
+<return> the number of key/value pairs in the #GHashTable.
</return>
</function>
-<function name="g_get_system_data_dirs">
+<function name="g_hash_table_steal">
<description>
-Returns an ordered list of base directories in which to access
-system-wide application data.
-
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>
-In this case the list of directories retrieved will be XDG_DATA_DIRS.
-
-On Windows the first elements in the list are the Application Data
-and Documents folders for All Users. (These can be determined only
-on Windows 2000 or later and are not present in the list on other
-Windows versions.) See documentation for CSIDL_COMMON_APPDATA and
-CSIDL_COMMON_DOCUMENTS.
-
-Then follows the "share" subfolder in the installation folder for
-the package containing the DLL that calls this function, if it can
-be determined.
-
-Finally the list contains the "share" subfolder in the installation
-folder for GLib, and in the installation folder for the package the
-application's .exe file belongs to.
-
-The installation folders above are determined by looking up the
-folder where the module (DLL or EXE) in question is located. If the
-folder's name is "bin", its parent is used, otherwise the folder
-itself.
-
-Note that on Windows the returned list can vary depending on where
-this function is called.
+Removes a key and its associated value from a #GHashTable without
+calling the key and value destroy functions.
-Since: 2.6
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key to remove
+</parameter_description>
+</parameter>
</parameters>
-<return> a %NULL-terminated array of strings owned by GLib that must
-not be modified or freed.
+<return> %TRUE if the key was found and removed from the #GHashTable
</return>
</function>
-<function name="g_get_tmp_dir">
+<function name="g_hash_table_steal_all">
<description>
-Gets the directory to use for temporary files. This is found from
-inspecting the environment variables <envar>TMPDIR</envar>,
-<envar>TMP</envar>, and <envar>TEMP</envar> in that order. If none
-of those are defined "/tmp" is returned on UNIX and "C:\" on Windows.
-The encoding of the returned string is system-defined. On Windows,
-it is always UTF-8. The return value is never %NULL or the empty string.
+Removes all keys and their associated values from a #GHashTable
+without calling the key and value destroy functions.
+Since: 2.12
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> the directory to use for temporary files.
-</return>
+<return></return>
</function>
-<function name="g_get_user_cache_dir">
+<function name="g_hash_table_thaw">
<description>
-Returns a base directory in which to store non-essential, cached
-data specific to particular user.
-
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>.
-In this case the directory retrieved will be XDG_CACHE_HOME.
-
-On Windows is the directory that serves as a common repository for
-temporary Internet files. A typical path is
-C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
-See documentation for CSIDL_INTERNET_CACHE.
-
-Since: 2.6
+This function is deprecated and will be removed in the next major
+release of GLib. It does nothing.
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> a string owned by GLib that must not be modified
-or freed.
-</return>
+<return></return>
</function>
-<function name="g_get_user_config_dir">
+<function name="g_hash_table_unref">
<description>
-Returns a base directory in which to store user-specific application
-configuration information such as user preferences and settings.
-
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>.
-In this case the directory retrieved will be XDG_CONFIG_HOME.
-
-On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
-what g_get_user_data_dir() returns.
+Atomically decrements the reference count of @hash_table by one.
+If the reference count drops to 0, all keys and values will be
+destroyed, and all memory allocated by the hash table is released.
+This function is MT-safe and may be called from any thread.
-Since: 2.6
+Since: 2.10
</description>
<parameters>
+<parameter name="hash_table">
+<parameter_description> a valid #GHashTable
+</parameter_description>
+</parameter>
</parameters>
-<return> a string owned by GLib that must not be modified
-or freed.
-</return>
+<return></return>
</function>
-<function name="g_get_user_data_dir">
+<function name="g_hmac_copy">
<description>
-Returns a base directory in which to access application data such
-as icons that is customized for a particular user.
-
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>.
-In this case the directory retrieved will be XDG_DATA_HOME.
-
-On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
-what g_get_user_config_dir() returns.
+Copies a #GHmac. If @hmac has been closed, by calling
+g_hmac_get_string() or g_hmac_get_digest(), the copied
+HMAC will be closed as well.
-Since: 2.6
+Since: 2.30
</description>
<parameters>
+<parameter name="hmac">
+<parameter_description> the #GHmac to copy
+</parameter_description>
+</parameter>
</parameters>
-<return> a string owned by GLib that must not be modified
-or freed.
+<return> the copy of the passed #GHmac. Use g_hmac_unref()
+when finished using it.
+
</return>
</function>
-<function name="g_get_user_name">
+<function name="g_hmac_get_digest">
<description>
-Gets the user name of the current user. The encoding of the returned
-string is system-defined. On UNIX, it might be the preferred file name
-encoding, or something else, and there is no guarantee that it is even
-consistent on a machine. On Windows, it is always UTF-8.
+Gets the digest from @checksum as a raw binary array and places it
+into @buffer. The size of the digest depends on the type of checksum.
+
+Once this function has been called, the #GHmac is closed and can
+no longer be updated with g_checksum_update().
+Since: 2.30
</description>
<parameters>
+<parameter name="hmac">
+<parameter_description> a #GHmac
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> output buffer
+</parameter_description>
+</parameter>
+<parameter name="digest_len">
+<parameter_description> an inout parameter. The caller initializes it to the
+size of @buffer. After the call it contains the length of the digest
+</parameter_description>
+</parameter>
</parameters>
-<return> the user name of the current user.
-</return>
+<return></return>
</function>
-<function name="g_get_user_runtime_dir">
+<function name="g_hmac_get_string">
<description>
-Returns a directory that is unique to the current user on the local
-system.
+Gets the HMAC as an hexadecimal string.
-On UNIX platforms this is determined using the mechanisms described in
-the <ulink url="http://www.freedesktop.org/Standards/basedir-spec">
-XDG Base Directory Specification</ulink>. This is the directory
-specified in the <envar>XDG_RUNTIME_DIR</envar> environment variable.
-In the case that this variable is not set, GLib will issue a warning
-message to stderr and return the value of g_get_user_cache_dir().
+Once this function has been called the #GHmac can no longer be
+updated with g_hmac_update().
-On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
-what g_get_user_config_dir() returns.
+The hexadecimal characters will be lower case.
-Since: 2.28
+Since: 2.30
</description>
<parameters>
+<parameter name="hmac">
+<parameter_description> a #GHmac
+</parameter_description>
+</parameter>
</parameters>
-<return> a string owned by GLib that must not be modified or freed.
+<return> the hexadecimal representation of the HMAC. The
+returned string is owned by the HMAC and should not be modified
+or freed.
</return>
</function>
-<function name="g_get_user_special_dir">
+<function name="g_hmac_new">
<description>
-Returns the full path of a special directory using its logical id.
-
-On Unix this is done using the XDG special user directories.
-For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP
-falls back to <filename>$HOME/Desktop</filename> when XDG special
-user directories have not been set up.
+Creates a new #GHmac, using the digest algorithm @digest_type.
+If the @digest_type is not known, %NULL is returned.
+A #GHmac can be used to compute the HMAC of a key and an
+arbitrary binary blob, using different hashing algorithms.
-Depending on the platform, the user might be able to change the path
-of the special directory without requiring the session to restart; GLib
-will not reflect any change once the special directories are loaded.
+A #GHmac works by feeding a binary blob through g_hmac_update()
+until the data is complete; the digest can then be extracted
+using g_hmac_get_string(), which will return the checksum as a
+hexadecimal string; or g_hmac_get_digest(), which will return a
+array of raw bytes. Once either g_hmac_get_string() or
+g_hmac_get_digest() have been called on a #GHmac, the HMAC
+will be closed and it won't be possible to call g_hmac_update()
+on it anymore.
-Since: 2.14
+Since: 2.30
</description>
<parameters>
-<parameter name="directory">
-<parameter_description> the logical id of special directory
+<parameter name="digest_type">
+<parameter_description> the desired type of digest
+</parameter_description>
+</parameter>
+<parameter name="key">
+<parameter_description> the key for the HMAC
+</parameter_description>
+</parameter>
+<parameter name="key_len">
+<parameter_description> the length of the keys
</parameter_description>
</parameter>
</parameters>
-<return> the path to the specified special directory, or %NULL
-if the logical id was not found. The returned string is owned by
-GLib and should not be modified or freed.
+<return> the newly created #GHmac, or %NULL.
+Use g_hmac_unref() to free the memory allocated by it.
</return>
</function>
-<function name="g_getenv">
+<function name="g_hmac_ref">
<description>
-Returns the value of an environment variable. The name and value
-are in the GLib file name encoding. On UNIX, this means the actual
-bytes which might or might not be in some consistent character set
-and encoding. On Windows, it is in UTF-8. On Windows, in case the
-environment variable's value contains references to other
-environment variables, they are expanded.
+Atomically increments the reference count of @hmac by one.
+
+This function is MT-safe and may be called from any thread.
+Since: 2.30
</description>
<parameters>
-<parameter name="variable">
-<parameter_description> the environment variable to get, in the GLib file name encoding.
+<parameter name="hmac">
+<parameter_description> a valid #GHmac
</parameter_description>
</parameter>
</parameters>
-<return> the value of the environment variable, or %NULL if
-the environment variable is not found. The returned string may be
-overwritten by the next call to g_getenv(), g_setenv() or
-g_unsetenv().
+<return> the passed in #GHmac.
+
</return>
</function>
-<function name="g_hash_table_destroy">
+<function name="g_hmac_unref">
<description>
-Destroys all keys and values in the #GHashTable and decrements its
-reference count by 1. If keys and/or values are dynamically allocated,
-you should either free them first or create the #GHashTable with destroy
-notifiers using g_hash_table_new_full(). In the latter case the destroy
-functions you supplied will be called on all keys and values during the
-destruction phase.
+Atomically decrements the reference count of @hmac by one.
+
+If the reference count drops to 0, all keys and values will be
+destroyed, and all memory allocated by the hash table is released.
+This function is MT-safe and may be called from any thread.
+Frees the memory allocated for @hmac.
+
+Since: 2.30
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hmac">
+<parameter_description> a #GHmac
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_hash_table_find">
+<function name="g_hmac_update">
<description>
-Calls the given function for key/value pairs in the #GHashTable until
- predicate returns %TRUE. The function is passed the key and value of
-each pair, and the given @user_data parameter. The hash table may not
-be modified while iterating over it (you can't add/remove items).
+Feeds @data into an existing #GHmac.
-Note, that hash tables are really only optimized for forward lookups,
-i.e. g_hash_table_lookup().
-So code that frequently issues g_hash_table_find() or
-g_hash_table_foreach() (e.g. in the order of once per every entry in a
-hash table) should probably be reworked to use additional or different
-data structures for reverse lookups (keep in mind that an O(n) find/foreach
-operation issued for all n values in a hash table ends up needing O(n*n)
-operations).
+The HMAC must still be open, that is g_hmac_get_string() or
+g_hmac_get_digest() must not have been called on @hmac.
-Since: 2.4
+Since: 2.30
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hmac">
+<parameter_description> a #GHmac
</parameter_description>
</parameter>
-<parameter name="predicate">
-<parameter_description> function to test the key/value pairs for a certain property.
+<parameter name="data">
+<parameter_description> buffer used to compute the checksum
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter name="length">
+<parameter_description> size of the buffer, or -1 if it is a nul-terminated string
</parameter_description>
</parameter>
</parameters>
-<return> The value of the first key/value pair is returned,
-for which @predicate evaluates to %TRUE. If no pair with the
-requested property is found, %NULL is returned.
-
-</return>
+<return></return>
</function>
-<function name="g_hash_table_foreach">
+<function name="g_hook_alloc">
<description>
-Calls the given function for each of the key/value pairs in the
-#GHashTable. The function is passed the key and value of each
-pair, and the given @user_data parameter. The hash table may not
-be modified while iterating over it (you can't add/remove
-items). To remove all items matching a predicate, use
-g_hash_table_foreach_remove().
+Allocates space for a #GHook and initializes it.
-See g_hash_table_find() for performance caveats for linear
-order searches in contrast to g_hash_table_lookup().
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> the function to call for each key/value pair.
-</parameter_description>
-</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a new #GHook
+</return>
</function>
-<function name="g_hash_table_foreach_remove">
+<function name="g_hook_append">
<description>
-Calls the given function for each key/value pair in the #GHashTable.
-If the function returns %TRUE, then the key/value pair is removed from the
-#GHashTable. If you supplied key or value destroy functions when creating
-the #GHashTable, they are used to free the memory allocated for the removed
-keys and values.
-
-See #GHashTableIter for an alternative way to loop over the
-key/value pairs in the hash table.
-
+Appends a #GHook onto the end of a #GHookList.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> the function to call for each key/value pair.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter name="hook">
+<parameter_description> the #GHook to add to the end of @hook_list
</parameter_description>
</parameter>
</parameters>
-<return> the number of key/value pairs removed.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_foreach_steal">
+<function name="g_hook_compare_ids">
<description>
-Calls the given function for each key/value pair in the #GHashTable.
-If the function returns %TRUE, then the key/value pair is removed from the
-#GHashTable, but no key or value destroy functions are called.
-
-See #GHashTableIter for an alternative way to loop over the
-key/value pairs in the hash table.
+Compares the ids of two #GHook elements, returning a negative value
+if the second id is greater than the first.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> the function to call for each key/value pair.
+<parameter name="new_hook">
+<parameter_description> a #GHook
</parameter_description>
</parameter>
-<parameter name="user_data">
-<parameter_description> user data to pass to the function.
+<parameter name="sibling">
+<parameter_description> a #GHook to compare with @new_hook
</parameter_description>
</parameter>
</parameters>
-<return> the number of key/value pairs removed.
+<return> a value <= 0 if the id of @sibling is >= the id of @new_hook
</return>
</function>
-<function name="g_hash_table_get_keys">
+<function name="g_hook_destroy">
<description>
-Retrieves every key inside @hash_table. The returned data is valid
-until @hash_table is modified.
+Destroys a #GHook, given its ID.
-Since: 2.14
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook_id">
+<parameter_description> a hook ID
</parameter_description>
</parameter>
</parameters>
-<return> a #GList containing all the keys inside the hash
-table. The content of the list is owned by the hash table and
-should not be modified or freed. Use g_list_free() when done
-using the list.
-
+<return> %TRUE if the #GHook was found in the #GHookList and destroyed
</return>
</function>
-<function name="g_hash_table_get_values">
+<function name="g_hook_destroy_link">
<description>
-Retrieves every value inside @hash_table. The returned data is
-valid until @hash_table is modified.
-
-Since: 2.14
+Removes one #GHook from a #GHookList, marking it
+inactive and calling g_hook_unref() on it.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook">
+<parameter_description> the #GHook to remove
</parameter_description>
</parameter>
</parameters>
-<return> a #GList containing all the values inside the hash
-table. The content of the list is owned by the hash table and
-should not be modified or freed. Use g_list_free() when done
-using the list.
-
-</return>
+<return></return>
</function>
-<function name="g_hash_table_insert">
+<function name="g_hook_find">
<description>
-Inserts a new key and value into a #GHashTable.
+Finds a #GHook in a #GHookList using the given function to
+test for a match.
-If the key already exists in the #GHashTable its current value is replaced
-with the new value. If you supplied a @value_destroy_func when creating the
-#GHashTable, the old value is freed using that function. If you supplied
-a @key_destroy_func when creating the #GHashTable, the passed key is freed
-using that function.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> a key to insert.
+<parameter name="need_valids">
+<parameter_description> %TRUE if #GHook elements which have been destroyed
+should be skipped
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to associate with the key.
+<parameter name="func">
+<parameter_description> the function to call for each #GHook, which should return
+%TRUE when the #GHook has been found
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> the data to pass to @func
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the found #GHook or %NULL if no matching #GHook is found
+</return>
</function>
-<function name="g_hash_table_iter_get_hash_table">
+<function name="g_hook_find_data">
<description>
-Returns the #GHashTable associated with @iter.
+Finds a #GHook in a #GHookList with the given data.
-Since: 2.16
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> an initialized #GHashTableIter.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="need_valids">
+<parameter_description> %TRUE if #GHook elements which have been destroyed
+should be skipped
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> the data to find
</parameter_description>
</parameter>
</parameters>
-<return> the #GHashTable associated with @iter.
-
+<return> the #GHook with the given @data or %NULL if no matching
+#GHook is found
</return>
</function>
-<function name="g_hash_table_iter_init">
+<function name="g_hook_find_func">
<description>
-Initializes a key/value pair iterator and associates it with
- hash_table Modifying the hash table after calling this function
-invalidates the returned iterator.
-|[
-GHashTableIter iter;
-gpointer key, value;
-
-g_hash_table_iter_init (&iter, hash_table);
-while (g_hash_table_iter_next (&iter, &key, &value))
-{
-/ * do something with key and value * /
-}
-]|
+Finds a #GHook in a #GHookList with the given function.
-Since: 2.16
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> an uninitialized #GHashTableIter.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="need_valids">
+<parameter_description> %TRUE if #GHook elements which have been destroyed
+should be skipped
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> the function to find
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the #GHook with the given @func or %NULL if no matching
+#GHook is found
+</return>
</function>
-<function name="g_hash_table_iter_next">
+<function name="g_hook_find_func_data">
<description>
-Advances @iter and retrieves the key and/or value that are now
-pointed to as a result of this advancement. If %FALSE is returned,
- key and @value are not set, and the iterator becomes invalid.
+Finds a #GHook in a #GHookList with the given function and data.
-Since: 2.16
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> an initialized #GHashTableIter.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> a location to store the key, or %NULL.
+<parameter name="need_valids">
+<parameter_description> %TRUE if #GHook elements which have been destroyed
+should be skipped
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> a location to store the value, or %NULL.
+<parameter name="func">
+<parameter_description> the function to find
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> the data to find
</parameter_description>
</parameter>
</parameters>
-<return> %FALSE if the end of the #GHashTable has been reached.
-
+<return> the #GHook with the given @func and @data or %NULL if
+no matching #GHook is found
</return>
</function>
-<function name="g_hash_table_iter_remove">
+<function name="g_hook_first_valid">
<description>
-Removes the key/value pair currently pointed to by the iterator
-from its associated #GHashTable. Can only be called after
-g_hash_table_iter_next() returned %TRUE, and cannot be called more
-than once for the same key/value pair.
-
-If the #GHashTable was created using g_hash_table_new_full(), the
-key and value are freed using the supplied destroy functions, otherwise
-you have to make sure that any dynamically allocated values are freed
-yourself.
+Returns the first #GHook in a #GHookList which has not been destroyed.
+The reference count for the #GHook is incremented, so you must call
+g_hook_unref() to restore it when no longer needed. (Or call
+g_hook_next_valid() if you are stepping through the #GHookList.)
-Since: 2.16
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> an initialized #GHashTableIter.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="may_be_in_call">
+<parameter_description> %TRUE if hooks which are currently running
+(e.g. in another thread) are considered valid. If set to %FALSE,
+these are skipped
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the first valid #GHook, or %NULL if none are valid
+</return>
</function>
-<function name="g_hash_table_iter_steal">
+<function name="g_hook_free">
<description>
-Removes the key/value pair currently pointed to by the iterator
-from its associated #GHashTable, without calling the key and value
-destroy functions. Can only be called after
-g_hash_table_iter_next() returned %TRUE, and cannot be called more
-than once for the same key/value pair.
-
-Since: 2.16
+Calls the #GHookList @finalize_hook function if it exists,
+and frees the memory allocated for the #GHook.
</description>
<parameters>
-<parameter name="iter">
-<parameter_description> an initialized #GHashTableIter.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook">
+<parameter_description> the #GHook to free
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_hash_table_lookup">
+<function name="g_hook_get">
<description>
-Looks up a key in a #GHashTable. Note that this function cannot
-distinguish between a key that is not present and one which is present
-and has the value %NULL. If you need this distinction, use
-g_hash_table_lookup_extended().
+Returns the #GHook with the given id, or %NULL if it is not found.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to look up.
+<parameter name="hook_id">
+<parameter_description> a hook id
</parameter_description>
</parameter>
</parameters>
-<return> the associated value, or %NULL if the key is not found.
+<return> the #GHook with the given id, or %NULL if it is not found
</return>
</function>
-<function name="g_hash_table_lookup_extended">
+<function name="g_hook_insert_before">
<description>
-Looks up a key in the #GHashTable, returning the original key and the
-associated value and a #gboolean which is %TRUE if the key was found. This
-is useful if you need to free the memory allocated for the original key,
-for example before calling g_hash_table_remove().
-
-You can actually pass %NULL for @lookup_key to test
-whether the %NULL key exists, provided the hash and equal functions
-of @hash_table are %NULL-safe.
-
+Inserts a #GHook into a #GHookList, before a given #GHook.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="lookup_key">
-<parameter_description> the key to look up
-</parameter_description>
-</parameter>
-<parameter name="orig_key">
-<parameter_description> return location for the original key, or %NULL
+<parameter name="sibling">
+<parameter_description> the #GHook to insert the new #GHook before
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> return location for the value associated with the key, or %NULL
+<parameter name="hook">
+<parameter_description> the #GHook to insert
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the key was found in the #GHashTable.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_new">
+<function name="g_hook_insert_sorted">
<description>
-Creates a new #GHashTable with a reference count of 1.
-
+Inserts a #GHook into a #GHookList, sorted by the given function.
</description>
<parameters>
-<parameter name="hash_func">
-<parameter_description> a function to create a hash value from a key.
-Hash values are used to determine where keys are stored within the
-#GHashTable data structure. The g_direct_hash(), g_int_hash(),
-g_int64_hash(), g_double_hash() and g_str_hash() functions are provided
-for some common types of keys.
-If hash_func is %NULL, g_direct_hash() is used.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key_equal_func">
-<parameter_description> a function to check two keys for equality. This is
-used when looking up keys in the #GHashTable. The g_direct_equal(),
-g_int_equal(), g_int64_equal(), g_double_equal() and g_str_equal()
-functions are provided for the most common types of keys.
-If @key_equal_func is %NULL, keys are compared directly in a similar
-fashion to g_direct_equal(), but without the overhead of a function call.
+<parameter name="hook">
+<parameter_description> the #GHook to insert
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> the comparison function used to sort the #GHook elements
</parameter_description>
</parameter>
</parameters>
-<return> a new #GHashTable.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_new_full">
+<function name="g_hook_list_clear">
<description>
-Creates a new #GHashTable like g_hash_table_new() with a reference count
-of 1 and allows to specify functions to free the memory allocated for the
-key and value that get called when removing the entry from the #GHashTable.
-
+Removes all the #GHook elements from a #GHookList.
</description>
<parameters>
-<parameter name="hash_func">
-<parameter_description> a function to create a hash value from a key.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key_equal_func">
-<parameter_description> a function to check two keys for equality.
-</parameter_description>
-</parameter>
-<parameter name="key_destroy_func">
-<parameter_description> a function to free the memory allocated for the key
-used when removing the entry from the #GHashTable or %NULL if you
-don't want to supply such a function.
+</parameters>
+<return></return>
+</function>
+
+<function name="g_hook_list_init">
+<description>
+Initializes a #GHookList.
+This must be called before the #GHookList is used.
+
+</description>
+<parameters>
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="value_destroy_func">
-<parameter_description> a function to free the memory allocated for the
-value used when removing the entry from the #GHashTable or %NULL if
-you don't want to supply such a function.
+<parameter name="hook_size">
+<parameter_description> the size of each element in the #GHookList,
+typically <literal>sizeof (GHook)</literal>
</parameter_description>
</parameter>
</parameters>
-<return> a new #GHashTable.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_ref">
+<function name="g_hook_list_invoke">
<description>
-Atomically increments the reference count of @hash_table by one.
-This function is MT-safe and may be called from any thread.
-
-Since: 2.10
+Calls all of the #GHook functions in a #GHookList.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a valid #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="may_recurse">
+<parameter_description> %TRUE if functions which are already running
+(e.g. in another thread) can be called. If set to %FALSE,
+these are skipped
</parameter_description>
</parameter>
</parameters>
-<return> the passed in #GHashTable.
-
-</return>
+<return></return>
</function>
-<function name="g_hash_table_remove">
+<function name="g_hook_list_invoke_check">
<description>
-Removes a key and its associated value from a #GHashTable.
-
-If the #GHashTable was created using g_hash_table_new_full(), the
-key and value are freed using the supplied destroy functions, otherwise
-you have to make sure that any dynamically allocated values are freed
-yourself.
-
+Calls all of the #GHook functions in a #GHookList.
+Any function which returns %FALSE is removed from the #GHookList.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to remove.
+<parameter name="may_recurse">
+<parameter_description> %TRUE if functions which are already running
+(e.g. in another thread) can be called. If set to %FALSE,
+these are skipped
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the key was found and removed from the #GHashTable.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_remove_all">
+<function name="g_hook_list_marshal">
<description>
-Removes all keys and their associated values from a #GHashTable.
-
-If the #GHashTable was created using g_hash_table_new_full(), the keys
-and values are freed using the supplied destroy functions, otherwise you
-have to make sure that any dynamically allocated values are freed
-yourself.
-
-Since: 2.12
+Calls a function on each valid #GHook.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="may_recurse">
+<parameter_description> %TRUE if hooks which are currently running
+(e.g. in another thread) are considered valid. If set to %FALSE,
+these are skipped
+</parameter_description>
+</parameter>
+<parameter name="marshaller">
+<parameter_description> the function to call for each #GHook
+</parameter_description>
+</parameter>
+<parameter name="marshal_data">
+<parameter_description> data to pass to @marshaller
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_hash_table_replace">
+<function name="g_hook_list_marshal_check">
<description>
-Inserts a new key and value into a #GHashTable similar to
-g_hash_table_insert(). The difference is that if the key already exists
-in the #GHashTable, it gets replaced by the new key. If you supplied a
- value_destroy_func when creating the #GHashTable, the old value is freed
-using that function. If you supplied a @key_destroy_func when creating the
-#GHashTable, the old key is freed using that function.
+Calls a function on each valid #GHook and destroys it if the
+function returns %FALSE.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> a key to insert.
+<parameter name="may_recurse">
+<parameter_description> %TRUE if hooks which are currently running
+(e.g. in another thread) are considered valid. If set to %FALSE,
+these are skipped
</parameter_description>
</parameter>
-<parameter name="value">
-<parameter_description> the value to associate with the key.
+<parameter name="marshaller">
+<parameter_description> the function to call for each #GHook
+</parameter_description>
+</parameter>
+<parameter name="marshal_data">
+<parameter_description> data to pass to @marshaller
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="g_hash_table_size">
+<function name="g_hook_next_valid">
<description>
-Returns the number of elements contained in the #GHashTable.
+Returns the next #GHook in a #GHookList which has not been destroyed.
+The reference count for the #GHook is incremented, so you must call
+g_hook_unref() to restore it when no longer needed. (Or continue to call
+g_hook_next_valid() until %NULL is returned.)
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook">
+<parameter_description> the current #GHook
+</parameter_description>
+</parameter>
+<parameter name="may_be_in_call">
+<parameter_description> %TRUE if hooks which are currently running
+(e.g. in another thread) are considered valid. If set to %FALSE,
+these are skipped
</parameter_description>
</parameter>
</parameters>
-<return> the number of key/value pairs in the #GHashTable.
+<return> the next valid #GHook, or %NULL if none are valid
</return>
</function>
-<function name="g_hash_table_steal">
+<function name="g_hook_prepend">
<description>
-Removes a key and its associated value from a #GHashTable without
-calling the key and value destroy functions.
-
+Prepends a #GHook on the start of a #GHookList.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
</parameter_description>
</parameter>
-<parameter name="key">
-<parameter_description> the key to remove.
+<parameter name="hook">
+<parameter_description> the #GHook to add to the start of @hook_list
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the key was found and removed from the #GHashTable.
-</return>
+<return></return>
</function>
-<function name="g_hash_table_steal_all">
+<function name="g_hook_ref">
<description>
-Removes all keys and their associated values from a #GHashTable
-without calling the key and value destroy functions.
+Increments the reference count for a #GHook.
-Since: 2.12
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook">
+<parameter_description> the #GHook to increment the reference count of
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> the @hook that was passed in (since 2.6)
+</return>
</function>
-<function name="g_hash_table_unref">
+<function name="g_hook_unref">
<description>
-Atomically decrements the reference count of @hash_table by one.
-If the reference count drops to 0, all keys and values will be
-destroyed, and all memory allocated by the hash table is released.
-This function is MT-safe and may be called from any thread.
-
-Since: 2.10
+Decrements the reference count of a #GHook.
+If the reference count falls to 0, the #GHook is removed
+from the #GHookList and g_hook_free() is called to free it.
</description>
<parameters>
-<parameter name="hash_table">
-<parameter_description> a valid #GHashTable.
+<parameter name="hook_list">
+<parameter_description> a #GHookList
+</parameter_description>
+</parameter>
+<parameter name="hook">
+<parameter_description> the #GHook to unref
</parameter_description>
</parameter>
</parameters>
@@ -11623,6 +14792,38 @@ Since: 2.22
</return>
</function>
+<function name="g_htonl">
+<description>
+Converts a 32-bit integer value from host to network byte order.
+
+
+</description>
+<parameters>
+<parameter name="val">
+<parameter_description> a 32-bit integer value in host byte order
+</parameter_description>
+</parameter>
+</parameters>
+<return> @val converted to network byte order
+</return>
+</function>
+
+<function name="g_htons">
+<description>
+Converts a 16-bit integer value from host to network byte order.
+
+
+</description>
+<parameters>
+<parameter name="val">
+<parameter_description> a 16-bit integer value in host byte order
+</parameter_description>
+</parameter>
+</parameters>
+<return> @val converted to network byte order
+</return>
+</function>
+
<function name="g_iconv">
<description>
Same as the standard UNIX routine iconv(), but
@@ -11808,21 +15009,22 @@ have a default priority of %G_PRIORITY_DEFAULT.
<function name="g_int64_equal">
<description>
-Compares the two #gint64 values being pointed to and returns
+Compares the two #gint64 values being pointed to and returns
%TRUE if they are equal.
It can be passed to g_hash_table_new() as the @key_equal_func
-parameter, when using pointers to 64-bit integers as keys in a #GHashTable.
+parameter, when using non-%NULL pointers to 64-bit integers as keys in a
+#GHashTable.
Since: 2.22
</description>
<parameters>
<parameter name="v1">
-<parameter_description> a pointer to a #gint64 key.
+<parameter_description> a pointer to a #gint64 key
</parameter_description>
</parameter>
<parameter name="v2">
-<parameter_description> a pointer to a #gint64 key to compare with @v1.
+<parameter_description> a pointer to a #gint64 key to compare with @v1
</parameter_description>
</parameter>
</parameters>
@@ -11834,8 +15036,10 @@ Since: 2.22
<function name="g_int64_hash">
<description>
Converts a pointer to a #gint64 to a hash value.
-It can be passed to g_hash_table_new() as the @hash_func parameter,
-when using pointers to 64-bit integers values as keys in a #GHashTable.
+
+It can be passed to g_hash_table_new() as the @hash_func parameter,
+when using non-%NULL pointers to 64-bit integer values as keys in a
+#GHashTable.
Since: 2.22
@@ -11853,20 +15057,25 @@ Since: 2.22
<function name="g_int_equal">
<description>
-Compares the two #gint values being pointed to and returns
+Compares the two #gint values being pointed to and returns
%TRUE if they are equal.
It can be passed to g_hash_table_new() as the @key_equal_func
-parameter, when using pointers to integers as keys in a #GHashTable.
+parameter, when using non-%NULL pointers to integers as keys in a
+#GHashTable.
+
+Note that this function acts on pointers to #gint, not on #gint directly:
+if your hash table's keys are of the form
+<literal>GINT_TO_POINTER (n)</literal>, use g_direct_equal() instead.
</description>
<parameters>
<parameter name="v1">
-<parameter_description> a pointer to a #gint key.
+<parameter_description> a pointer to a #gint key
</parameter_description>
</parameter>
<parameter name="v2">
-<parameter_description> a pointer to a #gint key to compare with @v1.
+<parameter_description> a pointer to a #gint key to compare with @v1
</parameter_description>
</parameter>
</parameters>
@@ -11877,8 +15086,12 @@ parameter, when using pointers to integers as keys in a #GHashTable.
<function name="g_int_hash">
<description>
Converts a pointer to a #gint to a hash value.
-It can be passed to g_hash_table_new() as the @hash_func parameter,
-when using pointers to integers values as keys in a #GHashTable.
+It can be passed to g_hash_table_new() as the @hash_func parameter,
+when using non-%NULL pointers to integer values as keys in a #GHashTable.
+
+Note that this function acts on pointers to #gint, not on #gint directly:
+if your hash table's keys are of the form
+<literal>GINT_TO_POINTER (n)</literal>, use g_direct_hash() instead.
</description>
@@ -12028,7 +15241,7 @@ Converts an <literal>errno</literal> error number to a #GIOChannelEr
</description>
<parameters>
<parameter name="en">
-<parameter_description> an <literal>errno</literal> error number, e.g. %EINVAL
+<parameter_description> an <literal>errno</literal> error number, e.g. <literal>EINVAL</literal>
</parameter_description>
</parameter>
</parameters>
@@ -12163,7 +15376,7 @@ owned by GLib and must not be freed.
Gets the current flags for a #GIOChannel, including read-only
flags such as %G_IO_FLAG_IS_READABLE.
-The values of the flags %G_IO_FLAG_IS_READABLE and %G_IO_FLAG_IS_WRITEABLE
+The values of the flags %G_IO_FLAG_IS_READABLE and %G_IO_FLAG_IS_WRITABLE
are cached for internal use by the channel when it is created.
If they should change at some later point (e.g. partial shutdown
of a socket with the UNIX shutdown() function), the user
@@ -12672,7 +15885,7 @@ calling one of the API "read" functions.
<function name="g_io_channel_set_flags">
<description>
-Sets the (writeable) flags in @channel to (@flags & %G_IO_CHANNEL_SET_MASK).
+Sets the (writeable) flags in @channel to (@flags & %G_IO_FLAG_SET_MASK).
</description>
@@ -13021,7 +16234,9 @@ implementation and unavoidable.
<function name="g_key_file_free">
<description>
-Frees a #GKeyFile.
+Clears all keys and groups from @key_file, and decreases the
+reference count by 1. If the reference count reaches zero,
+frees the key file and all its allocated memory.
Since: 2.6
@@ -13107,8 +16322,10 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> the values associated with the key as a list of
-booleans, or %NULL if the key was not found or could not be parsed.
+<return>
+the values associated with the key as a list of booleans, or %NULL if the
+key was not found or could not be parsed. The returned list of booleans
+should be freed with g_free() when no longer needed.
</return>
</function>
@@ -13218,8 +16435,10 @@ Since: 2.12
</parameter_description>
</parameter>
</parameters>
-<return> the values associated with the key as a list of
-doubles, or %NULL if the key was not found or could not be parsed.
+<return>
+the values associated with the key as a list of doubles, or %NULL if the
+key was not found or could not be parsed. The returned list of doubles
+should be freed with g_free() when no longer needed.
</return>
</function>
@@ -13243,7 +16462,7 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated %NULL-terminated array of strings.
+<return> a newly-allocated %NULL-terminated array of strings.
Use g_strfreev() to free it.
</return>
</function>
@@ -13353,8 +16572,10 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> the values associated with the key as a list of
-integers, or %NULL if the key was not found or could not be parsed.
+<return>
+the values associated with the key as a list of integers, or %NULL if
+the key was not found or could not be parsed. The returned list of
+integers should be freed with g_free() when no longer needed.
</return>
</function>
@@ -13388,7 +16609,7 @@ Since: 2.6
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated %NULL-terminated array of strings.
+<return> a newly-allocated %NULL-terminated array of strings.
Use g_strfreev() to free it.
</return>
@@ -13685,8 +16906,8 @@ the return value both carries meaning and signals an error. To use
this function, you must pass a #GError pointer in @error, and check
whether it is not %NULL to see if an error occurred.</note>
-See g_key_file_has_key_full() for a replacement function which does
-follow the #GError rules.
+Language bindings should use g_key_file_get_value() to test whether
+or not a key exists.
Since: 2.6
@@ -13715,43 +16936,6 @@ otherwise.
</return>
</function>
-<function name="g_key_file_has_key_full">
-<description>
-Looks whether the key file has the key @key in the group
- group_name
-
-Since: 2.30
-
-
-</description>
-<parameters>
-<parameter name="key_file">
-<parameter_description> a #GKeyFile
-</parameter_description>
-</parameter>
-<parameter name="group_name">
-<parameter_description> a group name
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> a key name
-</parameter_description>
-</parameter>
-<parameter name="has_key">
-<parameter_description> Return location for whether or not key exists
-</parameter_description>
-</parameter>
-<parameter name="error">
-<parameter_description> return location for a #GError
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if a group with the name @group_name
-exists. Otherwise, @error is set and %FALSE is returned.
-
-</return>
-</function>
-
<function name="g_key_file_load_from_data">
<description>
Loads a key file from memory into an empty #GKeyFile structure.
@@ -13917,6 +17101,24 @@ Since: 2.6
</return>
</function>
+<function name="g_key_file_ref">
+<description>
+Increases the reference count of @key_file.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="key_file">
+<parameter_description> a #GKeyFile
+</parameter_description>
+</parameter>
+</parameters>
+<return> the same @key_file.
+
+</return>
+</function>
+
<function name="g_key_file_remove_comment">
<description>
Removes a comment above @key from @group_name.
@@ -14497,7 +17699,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> return location for the length of the
+<parameter_description> return location for the length of the
returned string, or %NULL
</parameter_description>
</parameter>
@@ -14512,6 +17714,23 @@ the contents of the #GKeyFile
</return>
</function>
+<function name="g_key_file_unref">
+<description>
+Decreases the reference count of @key_file by 1. If the reference count
+reaches zero, frees the key file and all its allocated memory.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="key_file">
+<parameter_description> a #GKeyFile
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_list_alloc">
<description>
Allocates space for one #GList element. It is called by
@@ -15043,24 +18262,6 @@ off the end of the #GList
</return>
</function>
-<function name="g_list_pop_allocator">
-<description>
-Restores the previous #GAllocator, used when allocating #GList
-elements.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated:2.10: It does nothing, since #GList has been converted
-to the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_list_position">
<description>
Gets the position of the given element
@@ -15131,28 +18332,6 @@ elements.
</return>
</function>
-<function name="g_list_push_allocator">
-<description>
-Sets the allocator to use to allocate #GList elements. Use
-g_list_pop_allocator() to restore the previous allocator.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated:2.10: It does nothing, since #GList has been converted
-to the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-<parameter name="allocator">
-<parameter_description> the #GAllocator to use when allocating #GList elements.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_list_remove">
<description>
Removes an element from a #GList.
@@ -15239,7 +18418,8 @@ It simply switches the next and prev pointers of each element.
<function name="g_list_sort">
<description>
-Sorts a #GList using the given comparison function.
+Sorts a #GList using the given comparison function. The algorithm
+used is a stable sort.
</description>
@@ -15290,14 +18470,6 @@ a user data argument.
<description>
Gets the names of all variables set in the environment.
-Since: 2.8
-
-</description>
-<parameters>
-</parameters>
-<return> a %NULL-terminated list of strings which must be freed
-with g_strfreev().
-
Programs that want to be portable to Windows should typically use
this function and g_getenv() instead of using the environ array
from the C library directly. On Windows, the strings in the environ
@@ -15305,6 +18477,14 @@ array are in system codepage encoding, while in most of the typical
use cases for environment variables in GLib-using programs you want
the UTF-8 encoding that this function and g_getenv() provide.
+Since: 2.8
+
+</description>
+<parameters>
+</parameters>
+<return> a %NULL-terminated
+list of strings which must be freed with g_strfreev().
+
</return>
</function>
@@ -15344,7 +18524,7 @@ including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError may occur.
</parameter_description>
</parameter>
@@ -15390,7 +18570,7 @@ including the terminating nul).
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError may occur.
</parameter_description>
</parameter>
@@ -15399,6 +18579,273 @@ errors. Any of the errors in #GConvertError may occur.
</return>
</function>
+<function name="g_log">
+<description>
+Logs an error or debugging message.
+
+If the log level has been set as fatal, the abort()
+function is called to terminate the program.
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain, usually #G_LOG_DOMAIN
+</parameter_description>
+</parameter>
+<parameter name="log_level">
+<parameter_description> the log level, either from #GLogLevelFlags
+or a user-defined level
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_default_handler">
+<description>
+The default log handler set up by GLib; g_log_set_default_handler()
+allows to install an alternate default log handler.
+This is used if no log handler has been set for the particular log
+domain and log level combination. It outputs the message to stderr
+or stdout and if the log level is fatal it calls abort().
+
+The behavior of this log handler can be influenced by a number of
+environment variables:
+<variablelist>
+<varlistentry>
+<term><envar>G_MESSAGES_PREFIXED</envar></term>
+<listitem>
+A :-separated list of log levels for which messages should
+be prefixed by the program name and PID of the aplication.
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><envar>G_MESSAGES_DEBUG</envar></term>
+<listitem>
+A space-separated list of log domains for which debug and
+informational messages are printed. By default these
+messages are not printed.
+</listitem>
+</varlistentry>
+</variablelist>
+
+stderr is used for levels %G_LOG_LEVEL_ERROR, %G_LOG_LEVEL_CRITICAL,
+%G_LOG_LEVEL_WARNING and %G_LOG_LEVEL_MESSAGE. stdout is used for
+the rest.
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain of the message
+</parameter_description>
+</parameter>
+<parameter name="log_level">
+<parameter_description> the level of the message
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> the message
+</parameter_description>
+</parameter>
+<parameter name="unused_data">
+<parameter_description> data passed from g_log() which is unused
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_remove_handler">
+<description>
+Removes the log handler.
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain
+</parameter_description>
+</parameter>
+<parameter name="handler_id">
+<parameter_description> the id of the handler, which was returned
+in g_log_set_handler()
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_set_always_fatal">
+<description>
+Sets the message levels which are always fatal, in any log domain.
+When a message with any of these levels is logged the program terminates.
+You can only set the levels defined by GLib to be fatal.
+%G_LOG_LEVEL_ERROR is always fatal.
+
+You can also make some message levels fatal at runtime by setting
+the <envar>G_DEBUG</envar> environment variable (see
+<ulink url="glib-running.html">Running GLib Applications</ulink>).
+
+
+</description>
+<parameters>
+<parameter name="fatal_mask">
+<parameter_description> the mask containing bits set for each level
+of error which is to be fatal
+</parameter_description>
+</parameter>
+</parameters>
+<return> the old fatal mask
+</return>
+</function>
+
+<function name="g_log_set_default_handler">
+<description>
+Installs a default log handler which is used if no
+log handler has been set for the particular log domain
+and log level combination. By default, GLib uses
+g_log_default_handler() as default log handler.
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="log_func">
+<parameter_description> the log handler function
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data passed to the log handler
+</parameter_description>
+</parameter>
+</parameters>
+<return> the previous default log handler
+
+</return>
+</function>
+
+<function name="g_log_set_fatal_mask">
+<description>
+Sets the log levels which are fatal in the given domain.
+%G_LOG_LEVEL_ERROR is always fatal.
+
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain
+</parameter_description>
+</parameter>
+<parameter name="fatal_mask">
+<parameter_description> the new fatal mask
+</parameter_description>
+</parameter>
+</parameters>
+<return> the old fatal mask for the log domain
+</return>
+</function>
+
+<function name="g_log_set_handler">
+<description>
+Sets the log handler for a domain and a set of log levels.
+To handle fatal and recursive messages the @log_levels parameter
+must be combined with the #G_LOG_FLAG_FATAL and #G_LOG_FLAG_RECURSION
+bit flags.
+
+Note that since the #G_LOG_LEVEL_ERROR log level is always fatal, if
+you want to set a handler for this log level you must combine it with
+#G_LOG_FLAG_FATAL.
+
+<example>
+<title>Adding a log handler for all warning messages in the default
+(application) domain</title>
+<programlisting>
+g_log_set_handler (NULL, G_LOG_LEVEL_WARNING | G_LOG_FLAG_FATAL
+| G_LOG_FLAG_RECURSION, my_log_handler, NULL);
+</programlisting>
+</example>
+
+<example>
+<title>Adding a log handler for all critical messages from GTK+</title>
+<programlisting>
+g_log_set_handler ("Gtk", G_LOG_LEVEL_CRITICAL | G_LOG_FLAG_FATAL
+| G_LOG_FLAG_RECURSION, my_log_handler, NULL);
+</programlisting>
+</example>
+
+<example>
+<title>Adding a log handler for <emphasis>all</emphasis> messages from
+GLib</title>
+<programlisting>
+g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
+| G_LOG_FLAG_RECURSION, my_log_handler, NULL);
+</programlisting>
+</example>
+
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain, or %NULL for the default ""
+application domain
+</parameter_description>
+</parameter>
+<parameter name="log_levels">
+<parameter_description> the log levels to apply the log handler for.
+To handle fatal and recursive messages as well, combine
+the log levels with the #G_LOG_FLAG_FATAL and
+#G_LOG_FLAG_RECURSION bit flags.
+</parameter_description>
+</parameter>
+<parameter name="log_func">
+<parameter_description> the log handler function
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data passed to the log handler
+</parameter_description>
+</parameter>
+</parameters>
+<return> the id of the new handler
+</return>
+</function>
+
+<function name="g_logv">
+<description>
+Logs an error or debugging message.
+
+If the log level has been set as fatal, the abort()
+function is called to terminate the program.
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> the log domain
+</parameter_description>
+</parameter>
+<parameter name="log_level">
+<parameter_description> the log level
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_lstat">
<description>
A wrapper for the POSIX lstat() function. The lstat() function is
@@ -15458,7 +18905,7 @@ this thread is now the owner of @context.
<function name="g_main_context_add_poll">
<description>
Adds a file descriptor to the set of file descriptors polled for
-this context. This will very seldomly be used directly. Instead
+this context. This will very seldom be used directly. Instead
a typical event source will use g_source_add_poll() instead.
</description>
@@ -15498,8 +18945,8 @@ Passes the results of polling back to the main loop.
</parameter_description>
</parameter>
<parameter name="fds">
-<parameter_description> array of #GPollFD's that was passed to the last call to
-g_main_context_query()
+<parameter_description> array of #GPollFD's that was passed to
+the last call to g_main_context_query()
</parameter_description>
</parameter>
<parameter name="n_fds">
@@ -15628,19 +19075,23 @@ Gets the poll function set by g_main_context_set_poll_func().
<description>
Gets the thread-default #GMainContext for this thread. Asynchronous
operations that want to be able to be run in contexts other than
-the default one should call this method to get a #GMainContext to
-add their #GSource<!-- -->s to. (Note that even in single-threaded
+the default one should call this method or
+g_main_context_ref_thread_default() to get a #GMainContext to add
+their #GSource<!-- -->s to. (Note that even in single-threaded
programs applications may sometimes want to temporarily push a
non-default context, so it is not safe to assume that this will
-always return %NULL if threads are not initialized.)
+always return %NULL if you are running in the default thread.)
+
+If you need to hold a reference on the context, use
+g_main_context_ref_thread_default() instead.
Since: 2.22
</description>
<parameters>
</parameters>
-<return> the thread-default #GMainContext, or %NULL if the
-thread-default context is the global default context.
+<return> the thread-default #GMainContext, or
+%NULL if the thread-default context is the global default context.
</return>
</function>
@@ -15732,7 +19183,7 @@ Since: 2.28
<function name="g_main_context_is_owner">
<description>
Determines whether this thread holds the (recursive)
-ownership of this #GMaincontext. This is useful to
+ownership of this #GMainContext. This is useful to
know before waiting on another thread that may be
blocking to get ownership of @context.
@@ -15912,7 +19363,8 @@ Determines information necessary to poll this main loop.
</parameter_description>
</parameter>
<parameter name="fds">
-<parameter_description> location to store #GPollFD records that need to be polled.
+<parameter_description> location to
+store #GPollFD records that need to be polled.
</parameter_description>
</parameter>
<parameter name="n_fds">
@@ -15942,6 +19394,26 @@ Increases the reference count on a #GMainContext object by one.
</return>
</function>
+<function name="g_main_context_ref_thread_default">
+<description>
+Gets the thread-default #GMainContext for this thread, as with
+g_main_context_get_thread_default(), but also adds a reference to
+it with g_main_context_ref(). In addition, unlike
+g_main_context_get_thread_default(), if the thread-default context
+is the global default context, this will return that #GMainContext
+(with a ref added to it) rather than returning %NULL.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return> the thread-default #GMainContext. Unref
+with g_main_context_unref() when you are done with it.
+
+</return>
+</function>
+
<function name="g_main_context_release">
<description>
Releases ownership of a context previously acquired by this thread
@@ -16458,14 +19930,19 @@ Since: 2.8
Maps a file into memory. On UNIX, this is using the mmap() function.
If @writable is %TRUE, the mapped buffer may be modified, otherwise
-it is an error to modify the mapped buffer. Modifications to the buffer
-are not visible to other processes mapping the same file, and are not
+it is an error to modify the mapped buffer. Modifications to the buffer
+are not visible to other processes mapping the same file, and are not
written back to the file.
Note that modifications of the underlying file might affect the contents
-of the #GMappedFile. Therefore, mapping should only be used if the file
+of the #GMappedFile. Therefore, mapping should only be used if the file
will not be modified, or if all modifications of the file are done
-atomically (e.g. using g_file_set_contents()).
+atomically (e.g. using g_file_set_contents()).
+
+If @filename is the name of an empty, regular file, the function
+will successfully return an empty #GMappedFile. In other cases of
+size 0 (e.g. device files such as /dev/null), @error will be set
+to the #GFileError value #G_FILE_ERROR_INVAL.
Since: 2.8
@@ -16490,6 +19967,43 @@ with g_mapped_file_unref(), or %NULL if the mapping failed.
</return>
</function>
+<function name="g_mapped_file_new_from_fd">
+<description>
+Maps a file into memory. On UNIX, this is using the mmap() function.
+
+If @writable is %TRUE, the mapped buffer may be modified, otherwise
+it is an error to modify the mapped buffer. Modifications to the buffer
+are not visible to other processes mapping the same file, and are not
+written back to the file.
+
+Note that modifications of the underlying file might affect the contents
+of the #GMappedFile. Therefore, mapping should only be used if the file
+will not be modified, or if all modifications of the file are done
+atomically (e.g. using g_file_set_contents()).
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="fd">
+<parameter_description> The file descriptor of the file to load
+</parameter_description>
+</parameter>
+<parameter name="writable">
+<parameter_description> whether the mapping should be writable
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GMappedFile which must be unref'd
+with g_mapped_file_unref(), or %NULL if the mapping failed.
+
+</return>
+</function>
+
<function name="g_mapped_file_ref">
<description>
Increments the reference count of @file by one. It is safe to call
@@ -17111,7 +20625,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -17309,14 +20823,15 @@ unchanged
<function name="g_match_info_free">
<description>
-Frees all the memory associated with the #GMatchInfo structure.
+If @match_info is not %NULL, calls g_match_info_unref(); otherwise does
+nothing.
Since: 2.14
</description>
<parameters>
<parameter name="match_info">
-<parameter_description> a #GMatchInfo
+<parameter_description> a #GMatchInfo, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -17474,7 +20989,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -17483,217 +20998,35 @@ Since: 2.14
</return>
</function>
-<function name="g_mem_chunk_alloc">
+<function name="g_match_info_ref">
<description>
-Allocates an atom of memory from a #GMemChunk.
+Increases reference count of @match_info by 1.
-Deprecated:2.10: Use g_slice_alloc() instead
-
-</description>
-<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a pointer to the allocated atom.
-</return>
-</function>
-
-<function name="g_mem_chunk_alloc0">
-<description>
-Allocates an atom of memory from a #GMemChunk, setting the memory to
-0.
-
-Deprecated:2.10: Use g_slice_alloc0() instead
-
-</description>
-<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return> a pointer to the allocated atom.
-</return>
-</function>
-
-<function name="g_mem_chunk_clean">
-<description>
-Frees any blocks in a #GMemChunk which are no longer being used.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_mem_chunk_create">
-<description>
-A convenience macro for creating a new #GMemChunk. It calls
-g_mem_chunk_new(), using the given type to create the #GMemChunk
-name. The atom size is determined using
-<function>sizeof()</function>, and the area size is calculated by
-multiplying the @pre_alloc parameter with the atom size.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="type">
-<parameter_description> the type of the atoms, typically a structure name.
-</parameter_description>
-</parameter>
-<parameter name="pre_alloc">
-<parameter_description> the number of atoms to store in each block of memory.
-</parameter_description>
-</parameter>
-<parameter name="alloc_type">
-<parameter_description> the type of the #GMemChunk. #G_ALLOC_AND_FREE is used
-if the atoms will be freed individually. #G_ALLOC_ONLY
-should be used if atoms will never be freed
-individually. #G_ALLOC_ONLY is quicker, since it does
-not need to track free atoms, but it obviously wastes
-memory if you no longer need many of the atoms.
-</parameter_description>
-</parameter>
-</parameters>
-<return> the new #GMemChunk.
-</return>
-</function>
-
-<function name="g_mem_chunk_destroy">
-<description>
-Frees all of the memory allocated for a #GMemChunk.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_mem_chunk_free">
-<description>
-Frees an atom in a #GMemChunk. This should only be called if the
-#GMemChunk was created with #G_ALLOC_AND_FREE. Otherwise it will
-simply return.
-
-Deprecated:2.10: Use g_slice_free1() instead
+Since: 2.30
</description>
<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-<parameter name="mem">
-<parameter_description> a pointer to the atom to free.
+<parameter name="match_info">
+<parameter_description> a #GMatchInfo
</parameter_description>
</parameter>
</parameters>
-<return></return>
-</function>
-
-<function name="g_mem_chunk_info">
-<description>
-Outputs debugging information for all #GMemChunk objects currently
-in use. It outputs the number of #GMemChunk objects currently
-allocated, and calls g_mem_chunk_print() to output information on
-each one.
+<return> @match_info
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_mem_chunk_new">
-<description>
-Creates a new #GMemChunk.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="name">
-<parameter_description> a string to identify the #GMemChunk. It is not copied so it
-should be valid for the lifetime of the #GMemChunk. It is
-only used in g_mem_chunk_print(), which is used for debugging.
-</parameter_description>
-</parameter>
-<parameter name="atom_size">
-<parameter_description> the size, in bytes, of each element in the #GMemChunk.
-</parameter_description>
-</parameter>
-<parameter name="area_size">
-<parameter_description> the size, in bytes, of each block of memory allocated to
-contain the atoms.
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> the type of the #GMemChunk. #G_ALLOC_AND_FREE is used if the
-atoms will be freed individually. #G_ALLOC_ONLY should be
-used if atoms will never be freed individually.
-#G_ALLOC_ONLY is quicker, since it does not need to track
-free atoms, but it obviously wastes memory if you no longer
-need many of the atoms.
-</parameter_description>
-</parameter>
-</parameters>
-<return> the new #GMemChunk.
</return>
</function>
-<function name="g_mem_chunk_print">
-<description>
-Outputs debugging information for a #GMemChunk. It outputs the name
-of the #GMemChunk (set with g_mem_chunk_new()), the number of bytes
-used, and the number of blocks of memory allocated.
-
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
-
-</description>
-<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
-<function name="g_mem_chunk_reset">
+<function name="g_match_info_unref">
<description>
-Resets a GMemChunk to its initial state. It frees all of the
-currently allocated blocks of memory.
+Decreases reference count of @match_info by 1. When reference count drops
+to zero, it frees all the memory associated with the match_info structure.
-Deprecated:2.10: Use the <link linkend="glib-Memory-Slices">slice
-allocator</link> instead
+Since: 2.30
</description>
<parameters>
-<parameter name="mem_chunk">
-<parameter_description> a #GMemChunk.
+<parameter name="match_info">
+<parameter_description> a #GMatchInfo
</parameter_description>
</parameter>
</parameters>
@@ -17703,7 +21036,7 @@ allocator</link> instead
<function name="g_mem_gc_friendly">
<description>
This variable is %TRUE if the <envar>G_DEBUG</envar> environment variable
-includes the key <link linkend="G_DEBUG">gc-friendly</link>.
+includes the key <literal>gc-friendly</literal>.
</description>
<parameters>
@@ -17822,6 +21155,21 @@ typically simply resolve to memmove() and GLib does not include
<return></return>
</function>
+<function name="g_message">
+<description>
+A convenience function/macro to log a normal message.
+
+</description>
+<parameters>
+<parameter name="Varargs">
+<parameter_description> format string, followed by parameters to insert
+into the format string (as with printf())
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mkdir">
<description>
A wrapper for the POSIX mkdir() function. The mkdir() function
@@ -17873,19 +21221,82 @@ created. Returns -1 if an error occurred, with errno set.
</return>
</function>
+<function name="g_mkdtemp">
+<description>
+Creates a temporary directory. See the mkdtemp() documentation
+on most UNIX-like systems.
+
+The parameter is a string that should follow the rules for
+mkdtemp() templates, i.e. contain the string "XXXXXX".
+g_mkdtemp() is slightly more flexible than mkdtemp() in that the
+sequence does not have to occur at the very end of the template
+and you can pass a @mode and additional @flags. The X string will
+be modified to form the name of a directory that didn't exist.
+The string should be in the GLib file name encoding. Most importantly,
+on Windows it should be in UTF-8.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="tmpl">
+<parameter_description> template directory name
+</parameter_description>
+</parameter>
+</parameters>
+<return> A pointer to @tmpl, which has been modified
+to hold the directory name. In case of errors, %NULL is
+returned and %errno will be set.
+
+</return>
+</function>
+
+<function name="g_mkdtemp_full">
+<description>
+Creates a temporary directory. See the mkdtemp() documentation
+on most UNIX-like systems.
+
+The parameter is a string that should follow the rules for
+mkdtemp() templates, i.e. contain the string "XXXXXX".
+g_mkdtemp() is slightly more flexible than mkdtemp() in that the
+sequence does not have to occur at the very end of the template
+and you can pass a @mode. The X string will be modified to form
+the name of a directory that didn't exist. The string should be
+in the GLib file name encoding. Most importantly, on Windows it
+should be in UTF-8.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="tmpl">
+<parameter_description> template directory name
+</parameter_description>
+</parameter>
+<parameter name="mode">
+<parameter_description> permissions to create the temporary directory with
+</parameter_description>
+</parameter>
+</parameters>
+<return> A pointer to @tmpl, which has been modified
+to hold the directory name. In case of errors, %NULL is
+returned, and %errno will be set.
+
+</return>
+</function>
+
<function name="g_mkstemp">
<description>
Opens a temporary file. See the mkstemp() documentation
-on most UNIX-like systems.
+on most UNIX-like systems.
The parameter is a string that should follow the rules for
-mkstemp() templates, i.e. contain the string "XXXXXX".
-g_mkstemp() is slightly more flexible than mkstemp()
-in that the sequence does not have to occur at the very end of the
-template. The X string will
-be modified to form the name of a file that didn't exist.
-The string should be in the GLib file name encoding. Most importantly,
-on Windows it should be in UTF-8.
+mkstemp() templates, i.e. contain the string "XXXXXX".
+g_mkstemp() is slightly more flexible than mkstemp() in that the
+sequence does not have to occur at the very end of the template.
+The X string will be modified to form the name of a file that
+didn't exist. The string should be in the GLib file name encoding.
+Most importantly, on Windows it should be in UTF-8.
</description>
@@ -17896,9 +21307,10 @@ on Windows it should be in UTF-8.
</parameter>
</parameters>
<return> A file handle (as from open()) to the file
-opened for reading and writing. The file is opened in binary mode
-on platforms where there is a difference. The file handle should be
-closed with close(). In case of errors, -1 is returned.
+opened for reading and writing. The file is opened in binary
+mode on platforms where there is a difference. The file handle
+should be closed with close(). In case of errors, -1 is
+returned and %errno will be set.
</return>
</function>
@@ -17925,33 +21337,247 @@ Since: 2.22
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> flags to pass to an open() call in addition to O_EXCL and
-O_CREAT, which are passed automatically
+<parameter_description> flags to pass to an open() call in addition to O_EXCL
+and O_CREAT, which are passed automatically
</parameter_description>
</parameter>
<parameter name="mode">
-<parameter_description> permissios to create the temporary file with
+<parameter_description> permissions to create the temporary file with
</parameter_description>
</parameter>
</parameters>
<return> A file handle (as from open()) to the file
opened for reading and writing. The file handle should be
-closed with close(). In case of errors, -1 is returned.
+closed with close(). In case of errors, -1 is returned
+and %errno will be set.
+
+</return>
+</function>
+
+<function name="g_module_build_path">
+<description>
+A portable way to build the filename of a module. The platform-specific
+prefix and suffix are added to the filename, if needed, and the result
+is added to the directory, using the correct separator character.
+
+The directory should specify the directory where the module can be found.
+It can be %NULL or an empty string to indicate that the module is in a
+standard platform-specific directory, though this is not recommended
+since the wrong module may be found.
+
+For example, calling g_module_build_path() on a Linux system with a
+ directory of <filename>/lib</filename> and a @module_name of "mylibrary"
+will return <filename>/lib/libmylibrary.so</filename>. On a Windows system,
+using <filename>\Windows</filename> as the directory it will return
+<filename>\Windows\mylibrary.dll</filename>.
+
+
+</description>
+<parameters>
+<parameter name="directory">
+<parameter_description> the directory where the module is. This can be %NULL
+or the empty string to indicate that the standard platform-specific
+directories will be used, though that is not recommended
+</parameter_description>
+</parameter>
+<parameter name="module_name">
+<parameter_description> the name of the module
+</parameter_description>
+</parameter>
+</parameters>
+<return> the complete path of the module, including the standard library
+prefix and suffix. This should be freed when no longer needed
+</return>
+</function>
+
+<function name="g_module_close">
+<description>
+Closes a module.
+
+
+</description>
+<parameters>
+<parameter name="module">
+<parameter_description> a #GModule to close
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success
+</return>
+</function>
+
+<function name="g_module_error">
+<description>
+Gets a string describing the last module error.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a string describing the last module error
+</return>
+</function>
+
+<function name="g_module_name">
+<description>
+Ensures that a module will never be unloaded.
+Any future g_module_close() calls on the module will be ignored.
+
+</description>
+<parameters>
+<parameter name="module">
+<parameter_description> a #GModule to make permanently resident
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_module_open">
+<description>
+Opens a module. If the module has already been opened,
+its reference count is incremented.
+
+First of all g_module_open() tries to open @file_name as a module.
+If that fails and @file_name has the ".la"-suffix (and is a libtool
+archive) it tries to open the corresponding module. If that fails
+and it doesn't have the proper module suffix for the platform
+(#G_MODULE_SUFFIX), this suffix will be appended and the corresponding
+module will be opended. If that fails and @file_name doesn't have the
+".la"-suffix, this suffix is appended and g_module_open() tries to open
+the corresponding module. If eventually that fails as well, %NULL is
+returned.
+
+
+</description>
+<parameters>
+<parameter name="file_name">
+<parameter_description> the name of the file containing the module, or %NULL
+to obtain a #GModule representing the main program itself
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> the flags used for opening the module. This can be the
+logical OR of any of the #GModuleFlags
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GModule on success, or %NULL on failure
+</return>
+</function>
+
+<function name="g_module_supported">
+<description>
+Checks if modules are supported on the current platform.
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if modules are supported
</return>
</function>
+<function name="g_module_symbol">
+<description>
+Gets a symbol pointer from a module, such as one exported
+by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL.
+
+
+</description>
+<parameters>
+<parameter name="module">
+<parameter_description> a #GModule
+</parameter_description>
+</parameter>
+<parameter name="symbol_name">
+<parameter_description> the name of the symbol to find
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> returns the pointer to the symbol value
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success
+</return>
+</function>
+
+<function name="g_mutex_clear">
+<description>
+Frees the resources allocated to a mutex with g_mutex_init().
+
+This function should not be used with a #GMutex that has been
+statically allocated.
+
+Calling g_mutex_clear() on a locked mutex leads to undefined
+behaviour.
+
+Sine: 2.32
+
+</description>
+<parameters>
+<parameter name="mutex">
+<parameter_description> an initialized #GMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_mutex_free">
<description>
-Destroys @mutex.
+Destroys a @mutex that has been created with g_mutex_new().
+
+Calling g_mutex_free() on a locked mutex may result
+in undefined behaviour.
-<note><para>Calling g_mutex_free() on a locked mutex may result in
-undefined behaviour.</para></note>
+Deprecated:3.32:GMutex can now be statically allocated, or embedded
+in structures and initialised with g_mutex_init().
</description>
<parameters>
<parameter name="mutex">
-<parameter_description> a #GMutex.
+<parameter_description> a #GMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_mutex_init">
+<description>
+Initializes a #GMutex so that it can be used.
+
+This function is useful to initialize a mutex that has been
+allocated on the stack, or as part of a larger structure.
+It is not necessary to initialize a mutex that has been
+created that has been statically allocated.
+
+|[
+typedef struct {
+GMutex m;
+...
+} Blob;
+
+Blob *b;
+
+b = g_new (Blob, 1);
+g_mutex_init (&b->m);
+]|
+
+To undo the effect of g_mutex_init() when a mutex is no longer
+needed, use g_mutex_clear().
+
+Calling g_mutex_init() on an already initialized #GMutex leads
+to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="mutex">
+<parameter_description> an uninitialized #GMutex
</parameter_description>
</parameter>
</parameters>
@@ -17964,18 +21590,15 @@ Locks @mutex. If @mutex is already locked by another thread, the
current thread will block until @mutex is unlocked by the other
thread.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will do nothing.
-
-<note><para>#GMutex is neither guaranteed to be recursive nor to be
-non-recursive, i.e. a thread could deadlock while calling
-g_mutex_lock(), if it already has locked @mutex. Use
-#GStaticRecMutex, if you need recursive mutexes.</para></note>
+<note>#GMutex is neither guaranteed to be recursive nor to be
+non-recursive. As such, calling g_mutex_lock() on a #GMutex that has
+already been locked by the same thread results in undefined behaviour
+(including but not limited to deadlocks).</note>
</description>
<parameters>
<parameter name="mutex">
-<parameter_description> a #GMutex.
+<parameter_description> a #GMutex
</parameter_description>
</parameter>
</parameters>
@@ -17984,15 +21607,16 @@ g_mutex_lock(), if it already has locked @mutex. Use
<function name="g_mutex_new">
<description>
-Creates a new #GMutex.
+Allocates and initializes a new #GMutex.
-<note><para>This function will abort if g_thread_init() has not been
-called yet.</para></note>
+Deprecated:3.32:GMutex can now be statically allocated, or embedded
+in structures and initialised with g_mutex_init().
</description>
<parameters>
</parameters>
-<return> a new #GMutex.
+<return> a newly allocated #GMutex. Use g_mutex_free() to free
+
</return>
</function>
@@ -18002,38 +21626,36 @@ Tries to lock @mutex. If @mutex is already locked by another thread,
it immediately returns %FALSE. Otherwise it locks @mutex and returns
%TRUE.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will immediately return %TRUE.
+<note>#GMutex is neither guaranteed to be recursive nor to be
+non-recursive. As such, calling g_mutex_lock() on a #GMutex that has
+already been locked by the same thread results in undefined behaviour
+(including but not limited to deadlocks or arbitrary return values).
+</note>
-<note><para>#GMutex is neither guaranteed to be recursive nor to be
-non-recursive, i.e. the return value of g_mutex_trylock() could be
-both %FALSE or %TRUE, if the current thread already has locked
- mutex Use #GStaticRecMutex, if you need recursive
-mutexes.</para></note>
</description>
<parameters>
<parameter name="mutex">
-<parameter_description> a #GMutex.
+<parameter_description> a #GMutex
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE, if @mutex could be locked.
+<return> %TRUE if @mutex could be locked
</return>
</function>
<function name="g_mutex_unlock">
<description>
Unlocks @mutex. If another thread is blocked in a g_mutex_lock()
-call for @mutex, it will be woken and can lock @mutex itself.
+call for @mutex, it will become unblocked and can lock @mutex itself.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will do nothing.
+Calling g_mutex_unlock() on a mutex that is not locked by the
+current thread leads to undefined behaviour.
</description>
<parameters>
<parameter name="mutex">
-<parameter_description> a #GMutex.
+<parameter_description> a #GMutex
</parameter_description>
</parameter>
</parameters>
@@ -18504,24 +22126,6 @@ too big, %NULL is returned.
</return>
</function>
-<function name="g_node_pop_allocator">
-<description>
-Restores the previous #GAllocator, used when allocating #GNode
-elements.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated:2.10: It does nothing, since #GNode has been converted to
-the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_node_prepend">
<description>
Inserts a #GNode as the first child of the given parent.
@@ -18542,28 +22146,6 @@ Inserts a #GNode as the first child of the given parent.
</return>
</function>
-<function name="g_node_push_allocator">
-<description>
-Sets the allocator to use to allocate #GNode elements. Use
-g_node_pop_allocator() to restore the previous allocator.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated:2.10: It does nothing, since #GNode has been converted to
-the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-<parameter name="dummy">
-<parameter_description> the #GAllocator to use when allocating #GNode elements.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_node_reverse_children">
<description>
Reverses the order of the children of a #GNode.
@@ -18634,6 +22216,38 @@ Unlinks a #GNode from a tree, resulting in two separate trees.
<return></return>
</function>
+<function name="g_ntohl">
+<description>
+Converts a 32-bit integer value from network to host byte order.
+
+
+</description>
+<parameters>
+<parameter name="val">
+<parameter_description> a 32-bit integer value in network byte order
+</parameter_description>
+</parameter>
+</parameters>
+<return> @val converted to host byte order.
+</return>
+</function>
+
+<function name="g_ntohs">
+<description>
+Converts a 16-bit integer value from network to host byte order.
+
+
+</description>
+<parameters>
+<parameter name="val">
+<parameter_description> a 16-bit integer value in network byte order
+</parameter_description>
+</parameter>
+</parameters>
+<return> @val converted to host byte order
+</return>
+</function>
+
<function name="g_nullify_pointer">
<description>
Set the pointer at the specified location to %NULL.
@@ -18670,7 +22284,7 @@ when the reference from @object to the proxy object should be
true) or weak to strong (@is_last_ref false).
Since a (normal) reference must be held to the object before
-calling g_object_toggle_ref(), the initial state of the reverse
+calling g_object_add_toggle_ref(), the initial state of the reverse
link is always strong.
Multiple toggle references may be added to the same gobject,
@@ -18708,6 +22322,11 @@ the pointer located at @weak_pointer_location is only valid during
the lifetime of @object. When the @object is finalized,
@weak_pointer will be set to %NULL.
+Note that as with g_object_weak_ref(), the weak references created by
+this method are not thread-safe: they cannot safely be used in one
+thread if the object's last g_object_unref() might happen in another
+thread. Use #GWeakRef if thread-safety is required.
+
</description>
<parameters>
<parameter name="object">
@@ -19230,7 +22849,7 @@ followed by %NULL
<description>
This function is intended for #GObject implementations to re-enforce a
<link linkend="floating-ref">floating</link> object reference.
-Doing this is seldomly required: all
+Doing this is seldom required: all
#GInitiallyUnowned<!-- -->s are created with a floating reference which
usually just needs to be sunken by calling g_object_ref_sink().
@@ -20123,6 +23742,11 @@ used for notification when an object is finalized. They are called
to an object without calling g_object_ref() (g_object_ref() adds a
strong reference, that is, forces the object to stay alive).
+Note that the weak references created by this method are not
+thread-safe: they cannot safely be used in one thread if the
+object's last g_object_unref() might happen in another thread.
+Use #GWeakRef if thread-safety is required.
+
</description>
<parameters>
<parameter name="object">
@@ -20163,6 +23787,85 @@ Removes a weak reference callback to an object.
<return></return>
</function>
+<function name="g_on_error_query">
+<description>
+Prompts the user with
+<computeroutput>[E]xit, [H]alt, show [S]tack trace or [P]roceed</computeroutput>.
+This function is intended to be used for debugging use only.
+The following example shows how it can be used together with
+the g_log() functions.
+
+|[
+#include <glib.h>
+
+static void
+log_handler (const gchar *log_domain,
+GLogLevelFlags log_level,
+const gchar *message,
+gpointer user_data)
+{
+g_log_default_handler (log_domain, log_level, message, user_data);
+
+g_on_error_query (MY_PROGRAM_NAME);
+}
+
+int
+main (int argc, char *argv[])
+{
+g_log_set_handler (MY_LOG_DOMAIN,
+G_LOG_LEVEL_WARNING |
+G_LOG_LEVEL_ERROR |
+G_LOG_LEVEL_CRITICAL,
+log_handler,
+NULL);
+/ * ... * /
+]|
+
+If [E]xit is selected, the application terminates with a call
+to <literal>_exit(0)</literal>.
+
+If [S]tack trace is selected, g_on_error_stack_trace() is called.
+This invokes <command>gdb</command>, which attaches to the current
+process and shows a stack trace. The prompt is then shown again.
+
+If [P]roceed is selected, the function returns.
+
+This function may cause different actions on non-UNIX platforms.
+
+</description>
+<parameters>
+<parameter name="prg_name">
+<parameter_description> the program name, needed by <command>gdb</command>
+for the [S]tack trace option. If @prg_name is %NULL, g_get_prgname()
+is called to get the program name (which will work correctly if
+gdk_init() or gtk_init() has been called)
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_on_error_stack_trace">
+<description>
+Invokes <command>gdb</command>, which attaches to the current
+process and shows a stack trace. Called by g_on_error_query()
+when the [S]tack trace option is selected. You can get the current
+process's "program name" with g_get_prgname(), assuming that you
+have called gtk_init() or gdk_init().
+
+This function may cause different actions on non-UNIX platforms.
+
+</description>
+<parameters>
+<parameter name="prg_name">
+<parameter_description> the program name, needed by <command>gdb</command>
+for the [S]tack trace option.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_once">
<description>
The first call to this routine by a process with a given #GOnce
@@ -20175,11 +23878,10 @@ For example, a mutex or a thread-specific data key must be created
exactly once. In a threaded environment, calling g_once() ensures
that the initialization is serialized across multiple threads.
-<note><para>Calling g_once() recursively on the same #GOnce struct in
- func will lead to a deadlock.</para></note>
+Calling g_once() recursively on the same #GOnce struct in
+ func will lead to a deadlock.
-<informalexample>
-<programlisting>
+|[
gpointer
get_debug_flags (void)
{
@@ -20189,8 +23891,7 @@ g_once (&my_once, parse_debug_flags, NULL);
return my_once.retval;
}
-</programlisting>
-</informalexample>
+]|
Since: 2.4
@@ -20217,7 +23918,7 @@ its associated #GOnce struct are passed to g_once().
<function name="g_once_init_enter">
<description>
Function to be called when starting a critical initialization
-section. The argument @value_location must point to a static
+section. The argument @location must point to a static
0-initialized variable that will be set to a value other than 0 at
the end of the initialization section. In combination with
g_once_init_leave() and the unique address @value_location, it can
@@ -20226,33 +23927,31 @@ during a program's life time, and that concurrent threads are
blocked until initialization completed. To be used in constructs
like this:
-<informalexample>
-<programlisting>
+|[
static gsize initialization_value = 0;
if (g_once_init_enter (&initialization_value))
{
-gsize setup_value = 42; /<!-- -->* initialization code here *<!-- -->/
+gsize setup_value = 42; / ** initialization code here ** /
g_once_init_leave (&initialization_value, setup_value);
}
-/<!-- -->* use initialization_value here *<!-- -->/
-</programlisting>
-</informalexample>
+/ ** use initialization_value here ** /
+]|
Since: 2.14
</description>
<parameters>
-<parameter name="value_location">
-<parameter_description> location of a static initializable variable
-containing 0.
+<parameter name="location">
+<parameter_description> location of a static initializable variable containing 0
</parameter_description>
</parameter>
</parameters>
<return> %TRUE if the initialization section should be entered,
%FALSE and blocks otherwise
+
</return>
</function>
@@ -20268,13 +23967,12 @@ Since: 2.14
</description>
<parameters>
-<parameter name="value_location">
-<parameter_description> location of a static initializable variable
-containing 0.
+<parameter name="location">
+<parameter_description> location of a static initializable variable containing 0
</parameter_description>
</parameter>
-<parameter name="initialization_value">
-<parameter_description> new non-0 value for * value_location
+<parameter name="result">
+<parameter_description> new non-0 value for * value_location
</parameter_description>
</parameter>
</parameters>
@@ -21281,6 +24979,9 @@ Get the short description of a #GParamSpec.
<description>
Get the name of a #GParamSpec.
+The name is always an "interned" string (as per g_intern_string()).
+This allows for pointer-value comparisons.
+
</description>
<parameters>
@@ -21662,7 +25363,7 @@ See g_param_spec_internal() for details on property names.
<function name="g_param_spec_pointer">
<description>
-Creates a new #GParamSpecPoiner instance specifying a pointer property.
+Creates a new #GParamSpecPointer instance specifying a pointer property.
See g_param_spec_internal() for details on property names.
@@ -22450,13 +26151,17 @@ respectively.
<function name="g_parse_debug_string">
<description>
Parses a string containing debugging options
-into a %guint containing bit flags. This is used
+into a %guint containing bit flags. This is used
within GDK and GTK+ to parse the debug options passed on the
command line or through environment variables.
-If @string is equal to "all", all flags are set. If @string
-is equal to "help", all the available keys in @keys are printed
-out to standard error.
+If @string is equal to <code>"all"</code>, all flags are set. Any flags
+specified along with <code>"all"</code> in @string are inverted; thus,
+<code>"all,foo,bar"</code> or <code>"foo,bar,all"</code> sets all flags
+except those corresponding to <code>"foo"</code> and <code>"bar"</code>.
+
+If @string is equal to <code>"help"</code>, all the available keys in @keys
+are printed out to standard error.
</description>
@@ -22467,7 +26172,7 @@ commas, or %NULL.
</parameter_description>
</parameter>
<parameter name="keys">
-<parameter_description> pointer to an array of #GDebugKey which associate
+<parameter_description> pointer to an array of #GDebugKey which associate
strings with bit flags.
</parameter_description>
</parameter>
@@ -22482,40 +26187,42 @@ strings with bit flags.
<function name="g_path_get_basename">
<description>
-Gets the last component of the filename. If @file_name ends with a
-directory separator it gets the component before the last slash. If
- file_name consists only of directory separators (and on Windows,
-possibly a drive letter), a single separator is returned. If
- file_name is empty, it gets ".".
+Gets the last component of the filename.
+
+If @file_name ends with a directory separator it gets the component
+before the last slash. If @file_name consists only of directory
+separators (and on Windows, possibly a drive letter), a single
+separator is returned. If @file_name is empty, it gets ".".
</description>
<parameters>
<parameter name="file_name">
-<parameter_description> the name of the file.
+<parameter_description> the name of the file
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string containing the last component of
-the filename.
+<return> a newly allocated string containing the last
+component of the filename
</return>
</function>
<function name="g_path_get_dirname">
<description>
-Gets the directory components of a file name. If the file name has no
-directory components "." is returned. The returned string should be
-freed when no longer needed.
+Gets the directory components of a file name.
+
+If the file name has no directory components "." is returned.
+The returned string should be freed when no longer needed.
</description>
<parameters>
<parameter name="file_name">
-<parameter_description> the name of the file.
+<parameter_description> the name of the file
</parameter_description>
</parameter>
</parameters>
-<return> the directory components of the file.
+<return> the directory components of the file
</return>
</function>
@@ -22550,29 +26257,29 @@ Windows-specific code.
</description>
<parameters>
<parameter name="file_name">
-<parameter_description> a file name.
+<parameter_description> a file name
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @file_name is absolute.
+<return> %TRUE if @file_name is absolute
</return>
</function>
<function name="g_path_skip_root">
<description>
-Returns a pointer into @file_name after the root component, i.e. after
-the "/" in UNIX or "C:\" under Windows. If @file_name is not an absolute
-path it returns %NULL.
+Returns a pointer into @file_name after the root component,
+i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name
+is not an absolute path it returns %NULL.
</description>
<parameters>
<parameter name="file_name">
-<parameter_description> a file name.
+<parameter_description> a file name
</parameter_description>
</parameter>
</parameters>
-<return> a pointer into @file_name after the root component.
+<return> a pointer into @file_name after the root component
</return>
</function>
@@ -22759,6 +26466,7 @@ Since: 2.30
</parameter>
</parameters>
<return> %TRUE if the lock was acquired
+
</return>
</function>
@@ -22880,6 +26588,54 @@ Since: 2.16
<return></return>
</function>
+<function name="g_print">
+<description>
+Outputs a formatted message via the print handler.
+The default print handler simply outputs the message to stdout.
+
+g_print() should not be used from within libraries for debugging
+messages, since it may be redirected by applications to special
+purpose message windows or even files. Instead, libraries should
+use g_log(), or the convenience functions g_message(), g_warning()
+and g_error().
+
+</description>
+<parameters>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_printerr">
+<description>
+Outputs a formatted message via the error message handler.
+The default handler simply outputs the message to stderr.
+
+g_printerr() should not be used from within libraries.
+Instead g_log() should be used, or the convenience functions
+g_message(), g_warning() and g_error().
+
+</description>
+<parameters>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_printf">
<description>
An implementation of the standard printf() function which supports
@@ -22904,77 +26660,107 @@ Since: 2.2
</return>
</function>
+<function name="g_printf_string_upper_bound">
+<description>
+Calculates the maximum space needed to store the output
+of the sprintf() function.
+
+
+</description>
+<parameters>
+<parameter name="format">
+<parameter_description> the format string. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description> the parameters to be inserted into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return> the maximum space needed to store the formatted string
+</return>
+</function>
+
<function name="g_private_get">
<description>
-Returns the pointer keyed to @private_key for the current thread. If
-g_private_set() hasn't been called for the current @private_key and
-thread yet, this pointer will be %NULL.
+Returns the current value of the thread local variable @key.
+
+If the value has not yet been set in this thread, %NULL is returned.
+Values are never copied between threads (when a new thread is
+created, for example).
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will return the value of @private_key
-casted to #gpointer. Note however, that private data set
-<emphasis>before</emphasis> g_thread_init() will
-<emphasis>not</emphasis> be retained <emphasis>after</emphasis> the
-call. Instead, %NULL will be returned in all threads directly after
-g_thread_init(), regardless of any g_private_set() calls issued
-before threading system intialization.
</description>
<parameters>
-<parameter name="private_key">
-<parameter_description> a #GPrivate.
+<parameter name="key">
+<parameter_description> a #GPrivate
</parameter_description>
</parameter>
</parameters>
-<return> the corresponding pointer.
+<return> the thread-local value
</return>
</function>
<function name="g_private_new">
<description>
-Creates a new #GPrivate. If @destructor is non-%NULL, it is a
-pointer to a destructor function. Whenever a thread ends and the
-corresponding pointer keyed to this instance of #GPrivate is
-non-%NULL, the destructor is called with this pointer as the
-argument.
+Creates a new #GPrivate.
-<note><para>@destructor is used quite differently from @notify in
-g_static_private_set().</para></note>
+Deprecated:2.32: dynamic allocation of #GPrivate is a bad idea. Use
+static storage and G_PRIVATE_INIT() instead.
-<note><para>A #GPrivate cannot be freed. Reuse it instead, if you
-can, to avoid shortage, or use #GStaticPrivate.</para></note>
-
-<note><para>This function will abort if g_thread_init() has not been
-called yet.</para></note>
</description>
<parameters>
-<parameter name="destructor">
-<parameter_description> a function to destroy the data keyed to #GPrivate when
-a thread ends.
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify
</parameter_description>
</parameter>
</parameters>
-<return> a new #GPrivate.
+<return> a newly allocated #GPrivate (which can never be destroyed)
</return>
</function>
+<function name="g_private_replace">
+<description>
+Sets the thread local variable @key to have the value @value in the
+current thread.
+
+This function differs from g_private_set() in the following way: if
+the previous value was non-%NULL then the #GDestroyNotify handler for
+ key is run on it.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="key">
+<parameter_description> a #GPrivate
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_private_set">
<description>
-Sets the pointer keyed to @private_key for the current thread.
+Sets the thread local variable @key to have the value @value in the
+current thread.
-This function can be used even if g_thread_init() has not yet been
-called, and, in that case, will set @private_key to @data casted to
-#GPrivate*. See g_private_get() for resulting caveats.
+This function differs from g_private_replace() in the following way:
+the #GDestroyNotify for @key is not called on the old value.
</description>
<parameters>
-<parameter name="private_key">
-<parameter_description> a #GPrivate.
+<parameter name="key">
+<parameter_description> a #GPrivate
</parameter_description>
</parameter>
-<parameter name="data">
-<parameter_description> the new pointer.
+<parameter name="value">
+<parameter_description> the new value
</parameter_description>
</parameter>
</parameters>
@@ -23133,6 +26919,34 @@ Creates a new #GPtrArray with a reference count of 1.
</return>
</function>
+<function name="g_ptr_array_new_full">
+<description>
+Creates a new #GPtrArray with @reserved_size pointers preallocated
+and a reference count of 1. This avoids frequent reallocation, if
+you are going to add many pointers to the array. Note however that
+the size of the array is still 0. It also set @element_free_func
+for freeing each element when the array is destroyed either via
+g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment
+set to %TRUE or when removing elements.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="reserved_size">
+<parameter_description> number of pointers preallocated.
+</parameter_description>
+</parameter>
+<parameter name="element_free_func">
+<parameter_description> A function to free elements with destroy @array or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> A new #GPtrArray.
+
+</return>
+</function>
+
<function name="g_ptr_array_new_with_free_func">
<description>
Creates a new #GPtrArray with a reference count of 1 and use @element_free_func
@@ -23366,8 +27180,8 @@ than second arg, zero for equal, greater than zero if irst arg is
greater than second arg).
If two array elements compare equal, their order in the sorted array
-is undefined. If you want equal elements to keep their order &#8211; i.e.
-you want a stable sort &#8211; you can write a comparison function that,
+is undefined. If you want equal elements to keep their order (i.e.
+you want a stable sort) you can write a comparison function that,
if two elements would otherwise compare equal, compares them by
their addresses.
@@ -23689,6 +27503,12 @@ Frees the memory allocated for the #GQueue. Only call this function if
@queue was created with g_queue_new(). If queue elements contain
dynamically-allocated memory, they should be freed first.
+<note><para>
+If queue elements contain dynamically-allocated memory,
+you should either use g_queue_free_full() or free them manually
+first.
+</para></note>
+
</description>
<parameters>
<parameter name="queue">
@@ -23699,6 +27519,27 @@ dynamically-allocated memory, they should be freed first.
<return></return>
</function>
+<function name="g_queue_free_full">
+<description>
+Convenience method, which frees all the memory used by a #GQueue, and
+calls the specified destroy function on every element's data.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="queue">
+<parameter_description> a pointer to a #GQueue
+</parameter_description>
+</parameter>
+<parameter name="free_func">
+<parameter_description> the function to be called to free each element's data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_queue_get_length">
<description>
Returns the number of items in @queue.
@@ -24731,6 +28572,132 @@ Since: 2.24
</return>
</function>
+<function name="g_rec_mutex_clear">
+<description>
+Frees the resources allocated to a recursive mutex with
+g_rec_mutex_init().
+
+This function should not be used with a #GRecMutex that has been
+statically allocated.
+
+Calling g_rec_mutex_clear() on a locked recursive mutex leads
+to undefined behaviour.
+
+Sine: 2.32
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> an initialized #GRecMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rec_mutex_init">
+<description>
+Initializes a #GRecMutex so that it can be used.
+
+This function is useful to initialize a recursive mutex
+that has been allocated on the stack, or as part of a larger
+structure.
+
+It is not necessary to initialise a recursive mutex that has been
+statically allocated.
+
+|[
+typedef struct {
+GRecMutex m;
+...
+} Blob;
+
+Blob *b;
+
+b = g_new (Blob, 1);
+g_rec_mutex_init (&b->m);
+]|
+
+Calling g_rec_mutex_init() on an already initialized #GRecMutex
+leads to undefined behaviour.
+
+To undo the effect of g_rec_mutex_init() when a recursive mutex
+is no longer needed, use g_rec_mutex_clear().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> an uninitialized #GRecMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rec_mutex_lock">
+<description>
+Locks @rec_mutex. If @rec_mutex is already locked by another
+thread, the current thread will block until @rec_mutex is
+unlocked by the other thread. If @rec_mutex is already locked
+by the current thread, the 'lock count' of @rec_mutex is increased.
+The mutex will only become available again when it is unlocked
+as many times as it has been locked.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> a #GRecMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rec_mutex_trylock">
+<description>
+Tries to lock @rec_mutex. If @rec_mutex is already locked
+by another thread, it immediately returns %FALSE. Otherwise
+it locks @rec_mutex and returns %TRUE.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> a #GRecMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @rec_mutex could be locked
+
+</return>
+</function>
+
+<function name="g_rec_mutex_unlock">
+<description>
+Unlocks @rec_mutex. If another thread is blocked in a
+g_rec_mutex_lock() call for @rec_mutex, it will become unblocked
+and can lock @rec_mutex itself.
+
+Calling g_rec_mutex_unlock() on a recursive mutex that is not
+locked by the current thread leads to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rec_mutex">
+<parameter_description> a #GRecMutex
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_regex_check_replacement">
<description>
Checks whether @replacement is a valid replacement string
@@ -24766,6 +28733,32 @@ references in @replacement or %NULL
</return>
</function>
+<function name="g_regex_escape_nul">
+<description>
+Escapes the nul characters in @string to "\x00". It can be used
+to compile a regex with embedded nul characters.
+
+For completeness, @length can be -1 for a nul-terminated string.
+In this case the output string will be of course equal to @string.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> the string to escape
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @string
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated escaped string
+
+</return>
+</function>
+
<function name="g_regex_escape_string">
<description>
Escapes the special characters used for regular expressions
@@ -25025,7 +29018,7 @@ the #GMatchInfo, or %NULL if you do not need it
<function name="g_regex_match_all_full">
<description>
Using the standard algorithm for regular expression matching only
-the longest match in the string is retrieved, it is not possibile
+the longest match in the string is retrieved, it is not possible
to obtain all the available matches. For instance matching
"<a> <b> <c>" against the pattern "<.*>"
you get "<a> <b> <c>".
@@ -25091,7 +29084,7 @@ the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -25182,7 +29175,7 @@ the #GMatchInfo, or %NULL if you do not need it
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -25358,7 +29351,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -25448,7 +29441,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -25497,7 +29490,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore errors
+<parameter_description> location to store the error occurring, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -25994,6 +29987,753 @@ occurred
</return>
</function>
+<function name="g_rw_lock_clear">
+<description>
+Frees the resources allocated to a lock with g_rw_lock_init().
+
+This function should not be used with a #GRWLock that has been
+statically allocated.
+
+Calling g_rw_lock_clear() when any thread holds the lock
+leads to undefined behaviour.
+
+Sine: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> an initialized #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_init">
+<description>
+Initializes a #GRWLock so that it can be used.
+
+This function is useful to initialize a lock that has been
+allocated on the stack, or as part of a larger structure. It is not
+necessary to initialise a reader-writer lock that has been statically
+allocated.
+
+|[
+typedef struct {
+GRWLock l;
+...
+} Blob;
+
+Blob *b;
+
+b = g_new (Blob, 1);
+g_rw_lock_init (&b->l);
+]|
+
+To undo the effect of g_rw_lock_init() when a lock is no longer
+needed, use g_rw_lock_clear().
+
+Calling g_rw_lock_init() on an already initialized #GRWLock leads
+to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> an uninitialized #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<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.
+
+It is implementation-defined how many threads are allowed to
+hold read locks on the same lock simultaneously.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_reader_trylock">
+<description>
+Tries to obtain a read lock on @rw_lock and returns %TRUE if
+the read lock was successfully obtained. Otherwise it
+returns %FALSE.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @rw_lock could be locked
+
+</return>
+</function>
+
+<function name="g_rw_lock_reader_unlock">
+<description>
+Release a read lock on @rw_lock.
+
+Calling g_rw_lock_reader_unlock() on a lock that is not held
+by the current thread leads to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_writer_lock">
+<description>
+Obtain a write lock on @rw_lock. If any thread already holds
+a read or write lock on @rw_lock, the current thread will block
+until all other threads have dropped their locks on @rw_lock.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_rw_lock_writer_trylock">
+<description>
+Tries to obtain a write lock on @rw_lock. If any other thread holds
+a read or write lock on @rw_lock, it immediately returns %FALSE.
+Otherwise it locks @rw_lock and returns %TRUE.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @rw_lock could be locked
+
+</return>
+</function>
+
+<function name="g_rw_lock_writer_unlock">
+<description>
+Release a write lock on @rw_lock.
+
+Calling g_rw_lock_writer_unlock() on a lock that is not held
+by the current thread leads to undefined behaviour.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="rw_lock">
+<parameter_description> a #GRWLock
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_add_symbol">
+<description>
+Adds a symbol to the default scope.
+
+Deprecated: 2.2: Use g_scanner_scope_add_symbol() instead.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to add
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the symbol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_cur_line">
+<description>
+Returns the current line in the input stream (counting
+from 1). This is the line of the last token parsed via
+g_scanner_get_next_token().
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current line
+</return>
+</function>
+
+<function name="g_scanner_cur_position">
+<description>
+Returns the current position in the current line (counting
+from 0). This is the position of the last token parsed via
+g_scanner_get_next_token().
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current position on the line
+</return>
+</function>
+
+<function name="g_scanner_cur_token">
+<description>
+Gets the current token type. This is simply the @token
+field in the #GScanner structure.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current token type
+</return>
+</function>
+
+<function name="g_scanner_cur_value">
+<description>
+Gets the current token value. This is simply the @value
+field in the #GScanner structure.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current token value
+</return>
+</function>
+
+<function name="g_scanner_destroy">
+<description>
+Frees all memory used by the #GScanner.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_eof">
+<description>
+Returns %TRUE if the scanner has reached the end of
+the file or text buffer.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the scanner has reached the end of
+the file or text buffer
+</return>
+</function>
+
+<function name="g_scanner_error">
+<description>
+Outputs an error message, via the #GScanner message handler.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_foreach_symbol">
+<description>
+Calls a function for each symbol in the default scope.
+
+Deprecated: 2.2: Use g_scanner_scope_foreach_symbol() instead.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> the function to call with each symbol
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to the function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_freeze_symbol_table">
+<description>
+There is no reason to use this macro, since it does nothing.
+
+Deprecated: 2.2: This macro does nothing.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_get_next_token">
+<description>
+Parses the next token just like g_scanner_peek_next_token()
+and also removes it from the input stream. The token data is
+placed in the @token, @value, @line, and @position fields of
+the #GScanner structure.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the token
+</return>
+</function>
+
+<function name="g_scanner_input_file">
+<description>
+Prepares to scan a file.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="input_fd">
+<parameter_description> a file descriptor
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_input_text">
+<description>
+Prepares to scan a text buffer.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="text">
+<parameter_description> the text buffer to scan
+</parameter_description>
+</parameter>
+<parameter name="text_len">
+<parameter_description> the length of the text buffer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_lookup_symbol">
+<description>
+Looks up a symbol in the current scope and return its value.
+If the symbol is not bound in the current scope, %NULL is
+returned.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of @symbol in the current scope, or %NULL
+if @symbol is not bound in the current scope
+</return>
+</function>
+
+<function name="g_scanner_new">
+<description>
+Creates a new #GScanner.
+
+The @config_templ structure specifies the initial settings
+of the scanner, which are copied into the #GScanner
+ config field. If you pass %NULL then the default settings
+are used.
+
+
+</description>
+<parameters>
+<parameter name="config_templ">
+<parameter_description> the initial scanner settings
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GScanner
+</return>
+</function>
+
+<function name="g_scanner_peek_next_token">
+<description>
+Parses the next token, without removing it from the input stream.
+The token data is placed in the @next_token, @next_value, @next_line,
+and @next_position fields of the #GScanner structure.
+
+Note that, while the token is not removed from the input stream
+(i.e. the next call to g_scanner_get_next_token() will return the
+same token), it will not be reevaluated. This can lead to surprising
+results when changing scope or the scanner configuration after peeking
+the next token. Getting the next token after switching the scope or
+configuration will return whatever was peeked before, regardless of
+any symbols that may have been added or removed in the new scope.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return> the type of the token
+</return>
+</function>
+
+<function name="g_scanner_remove_symbol">
+<description>
+Removes a symbol from the default scope.
+
+Deprecated: 2.2: Use g_scanner_scope_remove_symbol() instead.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_scope_add_symbol">
+<description>
+Adds a symbol to the given scope.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="scope_id">
+<parameter_description> the scope id
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to add
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> the value of the symbol
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_scope_foreach_symbol">
+<description>
+Calls the given function for each of the symbol/value pairs
+in the given scope of the #GScanner. The function is passed
+the symbol and value of each pair, and the given @user_data
+parameter.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="scope_id">
+<parameter_description> the scope id
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> the function to call for each symbol/value pair
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to the function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_scope_lookup_symbol">
+<description>
+Looks up a symbol in a scope and return its value. If the
+symbol is not bound in the scope, %NULL is returned.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="scope_id">
+<parameter_description> the scope id
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to look up
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of @symbol in the given scope, or %NULL
+if @symbol is not bound in the given scope.
+
+</return>
+</function>
+
+<function name="g_scanner_scope_remove_symbol">
+<description>
+Removes a symbol from a scope.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="scope_id">
+<parameter_description> the scope id
+</parameter_description>
+</parameter>
+<parameter name="symbol">
+<parameter_description> the symbol to remove
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_set_scope">
+<description>
+Sets the current scope.
+
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="scope_id">
+<parameter_description> the new scope id
+</parameter_description>
+</parameter>
+</parameters>
+<return> the old scope id
+</return>
+</function>
+
+<function name="g_scanner_sync_file_offset">
+<description>
+Rewinds the filedescriptor to the current buffer position
+and blows the file read ahead buffer. This is useful for
+third party uses of the scanners filedescriptor, which hooks
+onto the current scanning position.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_thaw_symbol_table">
+<description>
+There is no reason to use this macro, since it does nothing.
+
+Deprecated: 2.2: This macro does nothing.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_unexp_token">
+<description>
+Outputs a message through the scanner's msg_handler,
+resulting from an unexpected token in the input stream.
+Note that you should not call g_scanner_peek_next_token()
+followed by g_scanner_unexp_token() without an intermediate
+call to g_scanner_get_next_token(), as g_scanner_unexp_token()
+evaluates the scanner's current token (not the peeked token)
+to construct part of the message.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="expected_token">
+<parameter_description> the expected token
+</parameter_description>
+</parameter>
+<parameter name="identifier_spec">
+<parameter_description> a string describing how the scanner's user
+refers to identifiers (%NULL defaults to "identifier").
+This is used if @expected_token is %G_TOKEN_IDENTIFIER or
+%G_TOKEN_IDENTIFIER_NULL.
+</parameter_description>
+</parameter>
+<parameter name="symbol_spec">
+<parameter_description> a string describing how the scanner's user refers
+to symbols (%NULL defaults to "symbol"). This is used if
+ expected_token is %G_TOKEN_SYMBOL or any token value greater
+than %G_TOKEN_LAST.
+</parameter_description>
+</parameter>
+<parameter name="symbol_name">
+<parameter_description> the name of the symbol, if the scanner's current
+token is a symbol.
+</parameter_description>
+</parameter>
+<parameter name="message">
+<parameter_description> a message string to output at the end of the
+warning/error, or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="is_error">
+<parameter_description> if %TRUE it is output as an error. If %FALSE it is
+output as a warning.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_scanner_warn">
+<description>
+Outputs a warning message, via the #GScanner message handler.
+
+</description>
+<parameters>
+<parameter name="scanner">
+<parameter_description> a #GScanner
+</parameter_description>
+</parameter>
+<parameter name="format">
+<parameter_description> the message format. See the printf() documentation
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> the parameters to insert into the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_sequence_append">
<description>
Adds a new item to the end of @seq.
@@ -26655,7 +31395,7 @@ Since: 2.14
Removes the item pointed to by @iter. It is an error to pass the
end iterator to this function.
-If the sequnce has a data destroy function associated with it, this
+If the sequence has a data destroy function associated with it, this
function is called on the data for the removed item.
Since: 2.14
@@ -27044,16 +31784,75 @@ thread-safety reasons this function can only be called once.
<return></return>
</function>
+<function name="g_set_print_handler">
+<description>
+Sets the print handler.
+
+Any messages passed to g_print() will be output via
+the new handler. The default handler simply outputs
+the message to stdout. By providing your own handler
+you can redirect the output, to a GTK+ widget or a
+log file for example.
+
+
+</description>
+<parameters>
+<parameter name="func">
+<parameter_description> the new print handler
+</parameter_description>
+</parameter>
+</parameters>
+<return> the old print handler
+</return>
+</function>
+
+<function name="g_set_printerr_handler">
+<description>
+Sets the handler for printing error messages.
+
+Any messages passed to g_printerr() will be output via
+the new handler. The default handler simply outputs the
+message to stderr. By providing your own handler you can
+redirect the output, to a GTK+ widget or a log file for
+example.
+
+
+</description>
+<parameters>
+<parameter name="func">
+<parameter_description> the new error message handler
+</parameter_description>
+</parameter>
+</parameters>
+<return> the old error message handler
+</return>
+</function>
+
<function name="g_setenv">
<description>
Sets an environment variable. Both the variable's name and value
should be in the GLib file name encoding. On UNIX, this means that
-they can be any sequence of bytes. On Windows, they should be in
+they can be arbitrary byte strings. On Windows, they should be in
UTF-8.
-Note that on some systems, when variables are overwritten, the memory
+Note that on some systems, when variables are overwritten, the memory
used for the previous variables and its value isn't reclaimed.
+<warning><para>
+Environment variable handling in UNIX is not thread-safe, and your
+program may crash if one thread calls g_setenv() while another
+thread is calling getenv(). (And note that many functions, such as
+gettext(), call getenv() internally.) This function is only safe to
+use at the very start of your program, before creating any other
+threads (or creating objects that create worker threads of their
+own).
+</para><para>
+If you need to set up the environment for a child process, you can
+use g_get_environ() to get an environment array, modify that with
+g_environ_setenv() and g_environ_unsetenv(), and then pass that
+array directly to execvpe(), g_spawn_async(), or the like.
+</para></warning>
+
Since: 2.4
</description>
@@ -27292,9 +32091,9 @@ g_signal_override_class_handler().
</description>
<parameters>
<parameter name="instance_and_params">
-<parameter_description> the argument list of the signal emission. The first
-element in the array is a #GValue for the instance the signal is being
-emitted on. The rest are any arguments to be passed to the signal.
+<parameter_description> (array) the argument list of the signal emission.
+The first element in the array is a #GValue for the instance the signal
+is being emitted on. The rest are any arguments to be passed to the signal.
</parameter_description>
</parameter>
<parameter name="return_value">
@@ -27477,7 +32276,7 @@ g_signal_handler_disconnect (instance, id);
</parameter_description>
</parameter>
<parameter name="connect_flags">
-<parameter_description> a combination of #GConnnectFlags.
+<parameter_description> a combination of #GConnectFlags.
</parameter_description>
</parameter>
</parameters>
@@ -27584,10 +32383,9 @@ connected, in contrast to g_signal_emit() and g_signal_emit_valist().
</description>
<parameters>
<parameter name="instance_and_params">
-<parameter_description> argument list for the signal emission. The first
-element in the array is a #GValue for the instance the signal is
-being emitted on. The rest are any arguments to be passed to the
-signal.
+<parameter_description> argument list for the signal emission.
+The first element in the array is a #GValue for the instance the signal
+is being emitted on. The rest are any arguments to be passed to the signal.
</parameter_description>
</parameter>
<parameter name="signal_id">
@@ -27618,7 +32416,7 @@ Returns the invocation hint of the innermost signal emission of instance.
</parameter_description>
</parameter>
</parameters>
-<return> the invocation hint of the innermost signal emission.
+<return> the invocation hint of the innermost signal emission.
</return>
</function>
@@ -28026,6 +32824,9 @@ in their <code>class_init</code> method by doing
<code>super_class->signal_handler = my_signal_handler</code>. 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.
+
</description>
<parameters>
@@ -28059,8 +32860,8 @@ not associate a class method slot with this signal.
</parameter_description>
</parameter>
<parameter name="c_marshaller">
-<parameter_description> the function to translate arrays of parameter values to
-signal emissions into C language callback invocations.
+<parameter_description> the function to translate arrays of parameter
+values to signal emissions into C language callback invocations or %NULL.
</parameter_description>
</parameter>
<parameter name="return_type">
@@ -28097,6 +32898,9 @@ g_signal_chain_from_overridden_handler().
See g_signal_new() for information about signal names.
+If c_marshaller is %NULL @g_cclosure_marshal_generic will be used as
+the marshaller for this signal.
+
Since: 2.18
</description>
@@ -28131,8 +32935,8 @@ not associate a class method with this signal.
</parameter_description>
</parameter>
<parameter name="c_marshaller">
-<parameter_description> the function to translate arrays of parameter values to
-signal emissions into C language callback invocations.
+<parameter_description> the function to translate arrays of parameter
+values to signal emissions into C language callback invocations or %NULL.
</parameter_description>
</parameter>
<parameter name="return_type">
@@ -28160,6 +32964,9 @@ Creates a new signal. (This is usually done in the class initializer.)
See g_signal_new() for details on allowed signal names.
+If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as
+the marshaller for this signal.
+
</description>
<parameters>
@@ -28191,8 +32998,8 @@ the default handler is to be invoked. You should at least specify
</parameter_description>
</parameter>
<parameter name="c_marshaller">
-<parameter_description> the function to translate arrays of parameter values to
-signal emissions into C language callback invocations.
+<parameter_description> the function to translate arrays of parameter
+values to signal emissions into C language callback invocations or %NULL.
</parameter_description>
</parameter>
<parameter name="return_type">
@@ -28219,6 +33026,9 @@ Creates a new signal. (This is usually done in the class initializer.)
See g_signal_new() for details on allowed signal names.
+If c_marshaller is %NULL @g_cclosure_marshal_generic will be used as
+the marshaller for this signal.
+
</description>
<parameters>
@@ -28238,7 +33048,8 @@ the default handler is to be invoked. You should at least specify
</parameter_description>
</parameter>
<parameter name="class_closure">
-<parameter_description> The closure to invoke on signal emission; may be %NULL
+<parameter_description> The closure to invoke on signal emission;
+may be %NULL
</parameter_description>
</parameter>
<parameter name="accumulator">
@@ -28250,8 +33061,9 @@ the default handler is to be invoked. You should at least specify
</parameter_description>
</parameter>
<parameter name="c_marshaller">
-<parameter_description> the function to translate arrays of parameter values to
-signal emissions into C language callback invocations
+<parameter_description> the function to translate arrays of
+parameter values to signal emissions into C language callback
+invocations or %NULL
</parameter_description>
</parameter>
<parameter name="return_type">
@@ -28264,7 +33076,8 @@ without a return value
</parameter_description>
</parameter>
<parameter name="param_types">
-<parameter_description> an array of types, one for each parameter
+<parameter_description> an array of types, one for
+each parameter
</parameter_description>
</parameter>
</parameters>
@@ -28382,8 +33195,8 @@ be considered constant and have to be left untouched.
</parameter_description>
</parameter>
<parameter name="query">
-<parameter_description> A user provided structure that is filled in with constant
-values upon success.
+<parameter_description> A user provided structure that is
+filled in with constant values upon success.
</parameter_description>
</parameter>
</parameters>
@@ -28481,6 +33294,278 @@ structure which is to be invoked by the new closure
</return>
</function>
+<function name="g_slice_alloc">
+<description>
+Allocates a block of memory from the slice allocator.
+The block adress handed out can be expected to be aligned
+to at least <literal>1 * sizeof (void*)</literal>,
+though in general slices are 2 * sizeof (void*) bytes aligned,
+if a malloc() fallback implementation is used instead,
+the alignment may be reduced in a libc dependent fashion.
+Note that the underlying slice allocation mechanism can
+be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link>
+environment variable.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="block_size">
+<parameter_description> the number of bytes to allocate
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the allocated memory block
+
+</return>
+</function>
+
+<function name="g_slice_alloc0">
+<description>
+Allocates a block of memory via g_slice_alloc() and initializes
+the returned memory to 0. Note that the underlying slice allocation
+mechanism can be changed with the
+<link linkend="G_SLICE">G_SLICE=always-malloc</link>
+environment variable.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="block_size">
+<parameter_description> the number of bytes to allocate
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the allocated block
+
+</return>
+</function>
+
+<function name="g_slice_copy">
+<description>
+Allocates a block of memory from the slice allocator
+and copies @block_size bytes into it from @mem_block.
+
+Since: 2.14
+
+</description>
+<parameters>
+<parameter name="block_size">
+<parameter_description> the number of bytes to allocate
+</parameter_description>
+</parameter>
+<parameter name="mem_block">
+<parameter_description> the memory to copy
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the allocated memory block
+
+</return>
+</function>
+
+<function name="g_slice_dup">
+<description>
+A convenience macro to duplicate a block of memory using
+the slice allocator.
+
+It calls g_slice_copy() with <literal>sizeof (@type)</literal>
+and casts the returned pointer to a pointer of the given type,
+avoiding a type cast in the source code.
+Note that the underlying slice allocation mechanism can
+be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link>
+environment variable.
+
+Since: 2.14
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> the type to duplicate, typically a structure name
+</parameter_description>
+</parameter>
+<parameter name="mem">
+<parameter_description> the memory to copy into the allocated block
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the allocated block, cast to a pointer to @type
+
+</return>
+</function>
+
+<function name="g_slice_free">
+<description>
+A convenience macro to free a block of memory that has
+been allocated from the slice allocator.
+
+It calls g_slice_free1() using <literal>sizeof (type)</literal>
+as the block size.
+Note that the exact release behaviour can be changed with the
+<link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
+variable, also see <link linkend="G_SLICE">G_SLICE</link> for
+related debugging options.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> the type of the block to free, typically a structure name
+</parameter_description>
+</parameter>
+<parameter name="mem">
+<parameter_description> a pointer to the block to free
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_slice_free1">
+<description>
+Frees a block of memory.
+
+The memory must have been allocated via g_slice_alloc() or
+g_slice_alloc0() and the @block_size has to match the size
+specified upon allocation. Note that the exact release behaviour
+can be changed with the
+<link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
+variable, also see <link linkend="G_SLICE">G_SLICE</link> for
+related debugging options.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="block_size">
+<parameter_description> the size of the block
+</parameter_description>
+</parameter>
+<parameter name="mem_block">
+<parameter_description> a pointer to the block to free
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_slice_free_chain">
+<description>
+Frees a linked list of memory blocks of structure type @type.
+The memory blocks must be equal-sized, allocated via
+g_slice_alloc() or g_slice_alloc0() and linked together by
+a @next pointer (similar to #GSList). The name of the
+ next field in @type is passed as third argument.
+Note that the exact release behaviour can be changed with the
+<link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
+variable, also see <link linkend="G_SLICE">G_SLICE</link> for
+related debugging options.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> the type of the @mem_chain blocks
+</parameter_description>
+</parameter>
+<parameter name="mem_chain">
+<parameter_description> a pointer to the first block of the chain
+</parameter_description>
+</parameter>
+<parameter name="next">
+<parameter_description> the field name of the next pointer in @type
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_slice_free_chain_with_offset">
+<description>
+Frees a linked list of memory blocks of structure type @type.
+
+The memory blocks must be equal-sized, allocated via
+g_slice_alloc() or g_slice_alloc0() and linked together by a
+ next pointer (similar to #GSList). The offset of the @next
+field in each block is passed as third argument.
+Note that the exact release behaviour can be changed with the
+<link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
+variable, also see <link linkend="G_SLICE">G_SLICE</link> for
+related debugging options.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="block_size">
+<parameter_description> the size of the blocks
+</parameter_description>
+</parameter>
+<parameter name="mem_chain">
+<parameter_description> a pointer to the first block of the chain
+</parameter_description>
+</parameter>
+<parameter name="next_offset">
+<parameter_description> the offset of the @next field in the blocks
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_slice_new">
+<description>
+A convenience macro to allocate a block of memory from the
+slice allocator.
+
+It calls g_slice_alloc() with <literal>sizeof (@type)</literal>
+and casts the returned pointer to a pointer of the given type,
+avoiding a type cast in the source code.
+Note that the underlying slice allocation mechanism can
+be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link>
+environment variable.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> the type to allocate, typically a structure name
+</parameter_description>
+</parameter>
+</parameters>
+<return> a pointer to the allocated block, cast to a pointer to @type
+
+</return>
+</function>
+
+<function name="g_slice_new0">
+<description>
+A convenience macro to allocate a block of memory from the
+slice allocator and set the memory to 0.
+
+It calls g_slice_alloc0() with <literal>sizeof (@type)</literal>
+and casts the returned pointer to a pointer of the given type,
+avoiding a type cast in the source code.
+Note that the underlying slice allocation mechanism can
+be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link>
+environment variable.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> the type to allocate, typically a structure name
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_slist_alloc">
<description>
Allocates space for one #GSList element. It is called by the
@@ -28980,24 +34065,6 @@ is off the end of the #GSList
</return>
</function>
-<function name="g_slist_pop_allocator">
-<description>
-Restores the previous #GAllocator, used when allocating #GSList
-elements.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated: 2.10: It does nothing, since #GSList has been converted
-to the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_slist_position">
<description>
Gets the position of the given element
@@ -29052,28 +34119,6 @@ list = g_slist_prepend (list, "first");
</return>
</function>
-<function name="g_slist_push_allocator">
-<description>
-Sets the allocator to use to allocate #GSList elements. Use
-g_slist_pop_allocator() to restore the previous allocator.
-
-Note that this function is not available if GLib has been compiled
-with <option>--disable-mem-pools</option>
-
-Deprecated: 2.10: It does nothing, since #GSList has been converted
-to the <link linkend="glib-Memory-Slices">slice
-allocator</link>
-
-</description>
-<parameters>
-<parameter name="dummy">
-<parameter_description> the #GAllocator to use when allocating #GSList elements.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="g_slist_remove">
<description>
Removes an element from a #GSList.
@@ -29377,19 +34422,16 @@ Calling this function on a destroyed source is an error.
</parameter_description>
</parameter>
</parameters>
-<return> the #GMainContext with which the source is associated,
-or %NULL if the context has not yet been added
-to a source.
+<return> the #GMainContext with which the
+source is associated, or %NULL if the context has not
+yet been added to a source.
</return>
</function>
<function name="g_source_get_current_time">
<description>
-Gets the "current time" to be used when checking
-this source. The advantage of calling this function over
-calling g_get_current_time() directly is that when
-checking multiple sources, GLib can cache a single value
-instead of having to repeatedly get the system time.
+This function ignores @source and is otherwise the same as
+g_get_current_time().
Deprecated: 2.28: use g_source_get_time() instead
@@ -29504,7 +34546,7 @@ GDK_THREADS_ENTER (<!-- -->);
self->idle_id = 0;
GDK_THREADS_LEAVE (<!-- -->);
-return FALSE;
+return G_SOURCE_REMOVE;
}
static void
@@ -29982,7 +35024,7 @@ reference when you don't need it any more.
<note><para>
If you are writing a GTK+ application, and the program you
are spawning is a graphical application, too, then you may
-want to use gdk_spawn_on_screen() instead to ensure that
+want to use gdk_spawn_on_screen() instead to ensure that
the spawned program opens its windows on the right screen.
</para></note>
@@ -30041,6 +35083,10 @@ argument vector for the child. The first string in @argv is of
course the name of the program to execute. By default, the name of
the program must be a full path; the <envar>PATH</envar> shell variable
will only be searched if you pass the %G_SPAWN_SEARCH_PATH flag.
+If the program name is not a full path and %G_SPAWN_SEARCH_PATH flag is not
+used, then the program will be run from the current directory (or
+ working_directory, if specified); this might be unexpected or even
+dangerous in some cases when the current directory is world-writable.
On Windows, note that all the string or string vector arguments to
this function and the other g_spawn*() functions are in UTF-8, the
@@ -30087,16 +35133,15 @@ the child's environment. If @envp is %NULL, the child inherits its
parent's environment.
@flags should be the bitwise OR of any flags you want to affect the
-function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that
-the child will not automatically be reaped; you must use a
-#GChildWatch source to be notified about the death of the child
-process. Eventually you must call g_spawn_close_pid() on the
- child_pid, in order to free resources which may be associated
-with the child process. (On Unix, using a #GChildWatch source is
-equivalent to calling waitpid() or handling the %SIGCHLD signal
-manually. On Windows, calling g_spawn_close_pid() is equivalent
-to calling CloseHandle() on the process handle returned in
- child_pid).
+function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that the
+child will not automatically be reaped; you must use a child watch to
+be notified about the death of the child process. Eventually you must
+call g_spawn_close_pid() on the @child_pid, in order to free
+resources which may be associated with the child process. (On Unix,
+using a child watch is equivalent to calling waitpid() or handling
+the <literal>SIGCHLD</literal> signal manually. On Windows, calling g_spawn_close_pid()
+is equivalent to calling CloseHandle() on the process handle returned
+in @child_pid). See g_child_watch_add().
%G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file
descriptors will be inherited by the child; otherwise all
@@ -30178,7 +35223,7 @@ process reference must be closed using g_spawn_close_pid().
<note><para>
If you are writing a GTK+ application, and the program you
are spawning is a graphical application, too, then you may
-want to use gdk_spawn_on_screen_with_pipes() instead to ensure that
+want to use gdk_spawn_on_screen_with_pipes() instead to ensure that
the spawned program opens its windows on the right screen.
</para></note>
@@ -30490,6 +35535,8 @@ 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()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30506,6 +35553,8 @@ For some operations (like g_cond_wait()) you must have a #GMutex
instead of a #GStaticMutex. This function will return the
corresponding #GMutex for @mutex.
+Deprecated: 2.32: Just use a #GMutex
+
</description>
<parameters>
<parameter name="mutex">
@@ -30519,8 +35568,10 @@ corresponding #GMutex for @mutex.
<function name="g_static_mutex_init">
<description>
-Initializes @mutex. Alternatively you can initialize it with
-#G_STATIC_MUTEX_INIT.
+Initializes @mutex.
+Alternatively you can initialize it with #G_STATIC_MUTEX_INIT.
+
+Deprecated: 2.32: Use g_mutex_init()
</description>
<parameters>
@@ -30536,6 +35587,8 @@ Initializes @mutex. Alternatively you can initialize it with
<description>
Works like g_mutex_lock(), but for a #GStaticMutex.
+Deprecated: 2.32: Use g_mutex_lock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30550,6 +35603,8 @@ Works like g_mutex_lock(), but for a #GStaticMutex.
<description>
Works like g_mutex_trylock(), but for a #GStaticMutex.
+Deprecated: 2.32: Use g_mutex_trylock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30565,6 +35620,8 @@ Works like g_mutex_trylock(), but for a #GStaticMutex.
<description>
Works like g_mutex_unlock(), but for a #GStaticMutex.
+Deprecated: 2.32: Use g_mutex_unlock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30587,7 +35644,7 @@ freed, you should also free the #GStaticPrivate.
</description>
<parameters>
<parameter name="private_key">
-<parameter_description> a #GStaticPrivate to be freed.
+<parameter_description> a #GStaticPrivate to be freed
</parameter_description>
</parameter>
</parameters>
@@ -30600,14 +35657,15 @@ Works like g_private_get() only for a #GStaticPrivate.
This function works even if g_thread_init() has not yet been called.
+
</description>
<parameters>
<parameter name="private_key">
-<parameter_description> a #GStaticPrivate.
+<parameter_description> a #GStaticPrivate
</parameter_description>
</parameter>
</parameters>
-<return> the corresponding pointer.
+<return> the corresponding pointer
</return>
</function>
@@ -30619,7 +35677,7 @@ Initializes @private_key. Alternatively you can initialize it with
</description>
<parameters>
<parameter name="private_key">
-<parameter_description> a #GStaticPrivate to be initialized.
+<parameter_description> a #GStaticPrivate to be initialized
</parameter_description>
</parameter>
</parameters>
@@ -30644,16 +35702,16 @@ g_private_new().</para></note>
</description>
<parameters>
<parameter name="private_key">
-<parameter_description> a #GStaticPrivate.
+<parameter_description> a #GStaticPrivate
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> the new pointer.
+<parameter_description> the new pointer
</parameter_description>
</parameter>
<parameter name="notify">
<parameter_description> a function to be called with the pointer whenever the
-current thread ends or sets this pointer again.
+current thread ends or sets this pointer again
</parameter_description>
</parameter>
</parameters>
@@ -30669,6 +35727,8 @@ unbounded lifetime, i.e. objects declared 'static', but if you have
a #GStaticRecMutex as a member of a structure and the structure is
freed, you should also free the #GStaticRecMutex.
+Deprecated: 2.32: Use g_rec_mutex_clear()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30685,6 +35745,8 @@ A #GStaticRecMutex must be initialized with this function before it
can be used. Alternatively you can initialize it with
#G_STATIC_REC_MUTEX_INIT.
+Deprecated: 2.32: Use g_rec_mutex_init()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30702,6 +35764,8 @@ current thread will block until @mutex is unlocked by the other
thread. If @mutex is already locked by the calling thread, this
functions increases the depth of @mutex and returns immediately.
+Deprecated: 2.32: Use g_rec_mutex_lock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30716,6 +35780,8 @@ functions increases the depth of @mutex and returns immediately.
<description>
Works like calling g_static_rec_mutex_lock() for @mutex @depth times.
+Deprecated: 2.32: Use g_rec_mutex_lock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30739,6 +35805,8 @@ it immediately returns %FALSE. Otherwise it locks @mutex and returns
functions increases the depth of @mutex and immediately returns
%TRUE.
+Deprecated: 2.32: Use g_rec_mutex_trylock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30758,6 +35826,8 @@ before. If @mutex is completely unlocked and another thread is
blocked in a g_static_rec_mutex_lock() call for @mutex, it will be
woken and can lock @mutex itself.
+Deprecated: 2.32: Use g_rec_mutex_unlock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30778,6 +35848,8 @@ before the call to g_static_rec_mutex_unlock_full() you can call
g_static_rec_mutex_lock_full() with the depth returned by this
function.
+Deprecated: 2.32: Use g_rec_mutex_unlock()
+
</description>
<parameters>
<parameter name="mutex">
@@ -30799,6 +35871,8 @@ unbounded lifetime, i.e. objects declared 'static', but if you have
a #GStaticRWLock as a member of a structure, and the structure is
freed, you should also free the #GStaticRWLock.
+Deprecated: 2.32: Use a #GRWLock instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30815,6 +35889,8 @@ A #GStaticRWLock must be initialized with this function before it
can be used. Alternatively you can initialize it with
#G_STATIC_RW_LOCK_INIT.
+Deprecated: 2.32: Use g_rw_lock_init() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30839,6 +35915,8 @@ g_static_rw_lock_reader_unlock().
recursively lock for reading, but that can result in a deadlock, due
to writer preference.
+Deprecated: 2.32: Use g_rw_lock_reader_lock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30857,6 +35935,8 @@ lock @lock for writing, immediately returns %FALSE. Otherwise locks
@lock for reading and returns %TRUE. This lock has to be unlocked by
g_static_rw_lock_reader_unlock().
+Deprectated: 2.32: Use g_rw_lock_reader_trylock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30874,6 +35954,8 @@ Unlocks @lock. If a thread waits to lock @lock for writing and all
locks for reading have been unlocked, the waiting thread is woken up
and can lock @lock for writing.
+Deprectated: 2.32: Use g_rw_lock_reader_unlock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30894,6 +35976,8 @@ reading. When @lock is locked for writing, no other thread can lock
@lock (neither for reading nor writing). This lock has to be
unlocked by g_static_rw_lock_writer_unlock().
+Deprectated: 2.32: Use g_rw_lock_writer_lock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30911,6 +35995,8 @@ either reading or writing) by another thread, it immediately returns
%FALSE. Otherwise it locks @lock for writing and returns %TRUE. This
lock has to be unlocked by g_static_rw_lock_writer_unlock().
+Deprectated: 2.32: Use g_rw_lock_writer_trylock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30931,6 +36017,8 @@ lock @lock for writing, and some thread or threads are waiting to
lock @lock for reading, the waiting threads are woken up and can
lock @lock for reading.
+Deprectated: 2.32: Use g_rw_lock_writer_unlock() instead
+
</description>
<parameters>
<parameter name="lock">
@@ -30968,7 +36056,8 @@ without having to repeatedly scan for the end.
<description>
Compares two strings for byte-by-byte equality and returns %TRUE
if they are equal. It can be passed to g_hash_table_new() as the
- key_equal_func parameter, when using strings as keys in a #GHashTable.
+ key_equal_func parameter, when using non-%NULL strings as keys in a
+#GHashTable.
Note that this function is primarily meant as a hash table comparison
function. For a general-purpose, %NULL-safe string comparison function,
@@ -30999,11 +36088,11 @@ Since: 2.2
</description>
<parameters>
<parameter name="str">
-<parameter_description> a nul-terminated string.
+<parameter_description> a nul-terminated string
</parameter_description>
</parameter>
<parameter name="prefix">
-<parameter_description> the nul-terminated prefix to look for.
+<parameter_description> the nul-terminated prefix to look for
</parameter_description>
</parameter>
</parameters>
@@ -31021,11 +36110,11 @@ Since: 2.2
</description>
<parameters>
<parameter name="str">
-<parameter_description> a nul-terminated string.
+<parameter_description> a nul-terminated string
</parameter_description>
</parameter>
<parameter name="suffix">
-<parameter_description> the nul-terminated suffix to look for.
+<parameter_description> the nul-terminated suffix to look for
</parameter_description>
</parameter>
</parameters>
@@ -31045,7 +36134,7 @@ string, is updated: <literal>hash = hash * 33 + c</literal>. This
function uses the signed value of each byte.
It can be passed to g_hash_table_new() as the @hash_func parameter,
-when using strings as keys in a #GHashTable.
+when using non-%NULL strings as keys in a #GHashTable.
</description>
@@ -31059,6 +36148,36 @@ when using strings as keys in a #GHashTable.
</return>
</function>
+<function name="g_strcanon">
+<description>
+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
+|[
+g_ascii_strup (g_strcanon (str, "abc", '?'))
+]|
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a nul-terminated array of bytes
+</parameter_description>
+</parameter>
+<parameter name="valid_chars">
+<parameter_description> bytes permitted in @string
+</parameter_description>
+</parameter>
+<parameter name="substitutor">
+<parameter_description> replacement character for disallowed bytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> @string
+</return>
+</function>
+
<function name="g_strcasecmp">
<description>
A case-insensitive string comparison, corresponding to the standard
@@ -31084,6 +36203,51 @@ or a positive value if @s1 > @s2.
</return>
</function>
+<function name="g_strchomp">
+<description>
+Removes trailing whitespace from a string.
+
+This function doesn't allocate or reallocate any memory;
+it modifies @string in place. The pointer to @string is
+returned to allow the nesting of functions.
+
+Also see g_strchug() and g_strstrip().
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a string to remove the trailing whitespace from
+</parameter_description>
+</parameter>
+</parameters>
+<return> @string.
+</return>
+</function>
+
+<function name="g_strchug">
+<description>
+Removes leading whitespace from a string, by moving the rest
+of the characters forward.
+
+This function doesn't allocate or reallocate any memory;
+it modifies @string in place. The pointer to @string is
+returned to allow the nesting of functions.
+
+Also see g_strchomp() and g_strstrip().
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a string to remove the leading whitespace from
+</parameter_description>
+</parameter>
+</parameters>
+<return> @string
+</return>
+</function>
+
<function name="g_strcmp0">
<description>
Compares @str1 and @str2 like strcmp(). Handles %NULL
@@ -31108,6 +36272,25 @@ Since: 2.16
</return>
</function>
+<function name="g_strcompress">
+<description>
+Replaces all escaped characters with their one byte equivalent.
+
+This function does the reverse conversion of g_strescape().
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a string to compress
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated copy of @source with all escaped
+character compressed
+</return>
+</function>
+
<function name="g_strconcat">
<description>
Concatenates all of the given strings into one long string.
@@ -31137,6 +36320,38 @@ random memory junk to your string.</para></warning>
</return>
</function>
+<function name="g_strdelimit">
+<description>
+Converts any delimiter characters in @string to @new_delimiter.
+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
+|[
+g_ascii_strup (g_strdelimit (str, "abc", '?'))
+]|
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> the string to convert
+</parameter_description>
+</parameter>
+<parameter name="delimiters">
+<parameter_description> a string containing the current delimiters, or %NULL
+to use the standard delimiters defined in #G_STR_DELIMITERS
+</parameter_description>
+</parameter>
+<parameter name="new_delimiter">
+<parameter_description> the new delimiter character
+</parameter_description>
+</parameter>
+</parameters>
+<return> @string
+</return>
+</function>
+
<function name="g_strdown">
<description>
Converts a string to lower case.
@@ -31256,7 +36471,7 @@ on a %NULL value, g_strdupv() simply returns %NULL.
</description>
<parameters>
<parameter name="str_array">
-<parameter_description> %NULL-terminated array of strings.
+<parameter_description> a %NULL-terminated array of strings
</parameter_description>
</parameter>
</parameters>
@@ -31281,8 +36496,35 @@ documentation
</parameter>
</parameters>
<return> a UTF-8 string describing the error code. If the error code
-is unknown, it returns "unknown error (<code>)". The string
-can only be used until the next call to g_strerror()
+is unknown, it returns "unknown error (<code>)".
+</return>
+</function>
+
+<function name="g_strescape">
+<description>
+Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\v', '\'
+and '"' in the string @source by inserting a '\' before
+them. Additionally all characters in the range 0x01-0x1F (everything
+below SPACE) and in the range 0x7F-0xFF (all non-ASCII chars) are
+replaced with a '\' followed by their octal representation.
+Characters supplied in @exceptions are not escaped.
+
+g_strcompress() does the reverse conversion.
+
+
+</description>
+<parameters>
+<parameter name="source">
+<parameter_description> a string to escape
+</parameter_description>
+</parameter>
+<parameter name="exceptions">
+<parameter_description> a string of characters not to escape in @source
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly-allocated copy of @source with certain
+characters escaped. See above.
</return>
</function>
@@ -31294,7 +36536,7 @@ If called on a %NULL value, g_strfreev() simply returns.
</description>
<parameters>
<parameter name="str_array">
-<parameter_description> a %NULL-terminated array of strings to free.
+<parameter_description> a %NULL-terminated array of strings to free
</parameter_description>
</parameter>
</parameters>
@@ -31303,7 +36545,7 @@ If called on a %NULL value, g_strfreev() simply returns.
<function name="g_string_append">
<description>
-Adds a string onto the end of a #GString, expanding
+Adds a string onto the end of a #GString, expanding
it if necessary.
@@ -31324,7 +36566,7 @@ it if necessary.
<function name="g_string_append_c">
<description>
-Adds a byte onto the end of a #GString, expanding
+Adds a byte onto the end of a #GString, expanding
it if necessary.
@@ -31345,12 +36587,12 @@ it if necessary.
<function name="g_string_append_len">
<description>
-Appends @len bytes of @val to @string. Because @len is
-provided, @val may contain embedded nuls and need not
+Appends @len bytes of @val to @string. Because @len is
+provided, @val may contain embedded nuls and need not
be nul-terminated.
-Since this function does not stop at nul bytes, it is
-the caller's responsibility to ensure that @val has at
+Since this function does not stop at nul bytes, it is
+the caller's responsibility to ensure that @val has at
least @len addressable bytes.
@@ -31376,7 +36618,7 @@ least @len addressable bytes.
<function name="g_string_append_printf">
<description>
Appends a formatted string onto the end of a #GString.
-This function is similar to g_string_printf() except
+This function is similar to g_string_printf() except
that the text is appended to the #GString.
</description>
@@ -31436,7 +36678,8 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="reserved_chars_allowed">
-<parameter_description> a string of reserved characters allowed to be used, or %NULL
+<parameter_description> a string of reserved characters allowed
+to be used, or %NULL
</parameter_description>
</parameter>
<parameter name="allow_utf8">
@@ -31478,7 +36721,7 @@ Since: 2.14
<function name="g_string_ascii_down">
<description>
-Converts all upper case ASCII letters to lower case ASCII letters.
+Converts all uppercase ASCII letters to lowercase ASCII letters.
</description>
@@ -31488,15 +36731,15 @@ Converts all upper case ASCII letters to lower case ASCII letters.
</parameter_description>
</parameter>
</parameters>
-<return> passed-in @string pointer, with all the upper case
-characters converted to lower case in place, with
-semantics that exactly match g_ascii_tolower().
+<return> passed-in @string pointer, with all the
+uppercase characters converted to lowercase in place,
+with semantics that exactly match g_ascii_tolower().
</return>
</function>
<function name="g_string_ascii_up">
<description>
-Converts all lower case ASCII letters to upper case ASCII letters.
+Converts all lowercase ASCII letters to uppercase ASCII letters.
</description>
@@ -31506,24 +36749,24 @@ Converts all lower case ASCII letters to upper case ASCII letters.
</parameter_description>
</parameter>
</parameters>
-<return> passed-in @string pointer, with all the lower case
-characters converted to upper case in place, with
-semantics that exactly match g_ascii_toupper().
+<return> passed-in @string pointer, with all the
+lowercase characters converted to uppercase in place,
+with semantics that exactly match g_ascii_toupper().
</return>
</function>
<function name="g_string_assign">
<description>
-Copies the bytes from a string into a #GString,
-destroying any previous contents. It is rather like
-the standard strcpy() function, except that you do not
+Copies the bytes from a string into a #GString,
+destroying any previous contents. It is rather like
+the standard strcpy() function, except that you do not
have to worry about having enough space to copy the string.
</description>
<parameters>
<parameter name="string">
-<parameter_description> the destination #GString. Its current contents
+<parameter_description> the destination #GString. Its current contents
are destroyed.
</parameter_description>
</parameter>
@@ -31563,7 +36806,7 @@ access any of the strings which were contained within it.
</description>
<parameters>
<parameter name="chunk">
-<parameter_description> a #GStringChunk
+<parameter_description> a #GStringChunk
</parameter_description>
</parameter>
</parameters>
@@ -31573,15 +36816,15 @@ access any of the strings which were contained within it.
<function name="g_string_chunk_insert">
<description>
Adds a copy of @string to the #GStringChunk.
-It returns a pointer to the new copy of the string
-in the #GStringChunk. The characters in the string
-can be changed, if necessary, though you should not
+It returns a pointer to the new copy of the string
+in the #GStringChunk. The characters in the string
+can be changed, if necessary, though you should not
change anything after the end of the string.
-Unlike g_string_chunk_insert_const(), this function
-does not check for duplicates. Also strings added
-with g_string_chunk_insert() will not be searched
-by g_string_chunk_insert_const() when looking for
+Unlike g_string_chunk_insert_const(), this function
+does not check for duplicates. Also strings added
+with g_string_chunk_insert() will not be searched
+by g_string_chunk_insert_const() when looking for
duplicates.
@@ -31596,7 +36839,7 @@ duplicates.
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the copy of @string within
+<return> a pointer to the copy of @string within
the #GStringChunk
</return>
</function>
@@ -31671,15 +36914,15 @@ nul-terminated string
<function name="g_string_chunk_new">
<description>
-Creates a new #GStringChunk.
+Creates a new #GStringChunk.
</description>
<parameters>
<parameter name="size">
-<parameter_description> the default size of the blocks of memory which are
-allocated to store the strings. If a particular string
-is larger than this default size, a larger block of
+<parameter_description> the default size of the blocks of memory which are
+allocated to store the strings. If a particular string
+is larger than this default size, a larger block of
memory will be allocated for it.
</parameter_description>
</parameter>
@@ -31692,8 +36935,8 @@ memory will be allocated for it.
<description>
Converts a #GString to lowercase.
-Deprecated:2.2: This function uses the locale-specific
-tolower() function, which is almost never the right thing.
+Deprecated:2.2: This function uses the locale-specific
+tolower() function, which is almost never the right thing.
Use g_string_ascii_down() or g_utf8_strdown() instead.
</description>
@@ -31703,14 +36946,14 @@ Use g_string_ascii_down() or g_utf8_strdown() instead.
</parameter_description>
</parameter>
</parameters>
-<return> the #GString.
+<return> the #GString
</return>
</function>
<function name="g_string_equal">
<description>
-Compares two strings for equality, returning %TRUE if they are equal.
+Compares two strings for equality, returning %TRUE if they are equal.
For use with #GHashTable.
@@ -31725,7 +36968,7 @@ For use with #GHashTable.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if they strings are the same length and contain the
+<return> %TRUE if they strings are the same length and contain the
same bytes
</return>
</function>
@@ -31759,7 +37002,7 @@ following bytes
<function name="g_string_free">
<description>
Frees the memory allocated for the #GString.
-If @free_segment is %TRUE it also frees the character data. If
+If @free_segment is %TRUE it also frees the character data. If
it's %FALSE, the caller gains ownership of the buffer and must
free it after use with g_free().
@@ -31771,11 +37014,11 @@ free it after use with g_free().
</parameter_description>
</parameter>
<parameter name="free_segment">
-<parameter_description> if %TRUE the actual character data is freed as well
+<parameter_description> if %TRUE, the actual character data is freed as well
</parameter_description>
</parameter>
</parameters>
-<return> the character data of @string
+<return> the character data of @string
(i.e. %NULL if @free_segment is %TRUE)
</return>
</function>
@@ -31798,7 +37041,7 @@ Creates a hash code for @str; for use with #GHashTable.
<function name="g_string_insert">
<description>
-Inserts a copy of a string into a #GString,
+Inserts a copy of a string into a #GString,
expanding it if necessary.
@@ -31894,8 +37137,8 @@ into the string at the given position.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> the position at which to insert character, or -1 to
-append at the end of the string
+<parameter_description> the position at which to insert character, or -1
+to append at the end of the string
</parameter_description>
</parameter>
<parameter name="wc">
@@ -31925,12 +37168,12 @@ Creates a new #GString, initialized with the given string.
<function name="g_string_new_len">
<description>
-Creates a new #GString with @len bytes of the @init buffer.
+Creates a new #GString with @len bytes of the @init buffer.
Because a length is provided, @init need not be nul-terminated,
and can contain embedded nul bytes.
Since this function does not stop at nul bytes, it is the caller's
-responsibility to ensure that @init has at least @len addressable
+responsibility to ensure that @init has at least @len addressable
bytes.
@@ -31977,7 +37220,7 @@ Since: 2.14
<function name="g_string_overwrite_len">
<description>
-Overwrites part of a string, lengthening it if necessary.
+Overwrites part of a string, lengthening it if necessary.
This function will work with embedded nuls.
Since: 2.14
@@ -32008,7 +37251,7 @@ Since: 2.14
<function name="g_string_prepend">
<description>
-Adds a string on to the start of a #GString,
+Adds a string on to the start of a #GString,
expanding it if necessary.
@@ -32029,7 +37272,7 @@ expanding it if necessary.
<function name="g_string_prepend_c">
<description>
-Adds a byte onto the start of a #GString,
+Adds a byte onto the start of a #GString,
expanding it if necessary.
@@ -32050,12 +37293,12 @@ expanding it if necessary.
<function name="g_string_prepend_len">
<description>
-Prepends @len bytes of @val to @string.
-Because @len is provided, @val may contain
+Prepends @len bytes of @val to @string.
+Because @len is provided, @val may contain
embedded nuls and need not be nul-terminated.
-Since this function does not stop at nul bytes,
-it is the caller's responsibility to ensure that
+Since this function does not stop at nul bytes,
+it is the caller's responsibility to ensure that
@val has at least @len addressable bytes.
@@ -32103,8 +37346,8 @@ to the string.
<description>
Writes a formatted string into a #GString.
This is similar to the standard sprintf() function,
-except that the #GString buffer automatically expands
-to contain the results. The previous contents of the
+except that the #GString buffer automatically expands
+to contain the results. The previous contents of the
#GString are destroyed.
</description>
@@ -32131,7 +37374,7 @@ Sets the length of a #GString. If the length is less than
the current length, the string will be truncated. If the
length is greater than the current length, the contents
of the newly added area are undefined. (However, as
-always, string->str[string->len] will be a nul byte.)
+always, string->str[string->len] will be a nul byte.)
</description>
@@ -32151,16 +37394,16 @@ always, string->str[string->len] will be a nul byte.)
<function name="g_string_sized_new">
<description>
-Creates a new #GString, with enough space for @dfl_size
-bytes. This is useful if you are going to add a lot of
-text to the string and don't want it to be reallocated
+Creates a new #GString, with enough space for @dfl_size
+bytes. This is useful if you are going to add a lot of
+text to the string and don't want it to be reallocated
too often.
</description>
<parameters>
<parameter name="dfl_size">
-<parameter_description> the default size of the space allocated to
+<parameter_description> the default size of the space allocated to
hold the string
</parameter_description>
</parameter>
@@ -32173,9 +37416,9 @@ hold the string
<description>
Writes a formatted string into a #GString.
This is similar to the standard sprintf() function,
-except that the #GString buffer automatically expands
-to contain the results. The previous contents of the
-#GString are destroyed.
+except that the #GString buffer automatically expands
+to contain the results. The previous contents of the
+#GString are destroyed.
Deprecated: This function has been renamed to g_string_printf().
@@ -32201,7 +37444,7 @@ Deprecated: This function has been renamed to g_string_printf().
<description>
Appends a formatted string onto the end of a #GString.
This function is similar to g_string_sprintf() except that
-the text is appended to the #GString.
+the text is appended to the #GString.
Deprecated: This function has been renamed to g_string_append_printf()
@@ -32225,7 +37468,7 @@ Deprecated: This function has been renamed to g_string_append_printf()
<function name="g_string_truncate">
<description>
-Cuts off the end of the GString, leaving the first @len bytes.
+Cuts off the end of the GString, leaving the first @len bytes.
</description>
@@ -32247,14 +37490,14 @@ Cuts off the end of the GString, leaving the first @len bytes.
<description>
Converts a #GString to uppercase.
-Deprecated:2.2: This function uses the locale-specific
-toupper() function, which is almost never the right thing.
+Deprecated:2.2: This function uses the locale-specific
+toupper() function, which is almost never the right thing.
Use g_string_ascii_up() or g_utf8_strup() instead.
</description>
<parameters>
<parameter name="string">
-<parameter_description> a #GString
+<parameter_description> a #GString
</parameter_description>
</parameter>
</parameters>
@@ -32265,8 +37508,8 @@ Use g_string_ascii_up() or g_utf8_strup() instead.
<function name="g_string_vprintf">
<description>
-Writes a formatted string into a #GString.
-This function is similar to g_string_printf() except that
+Writes a formatted string into a #GString.
+This function is similar to g_string_printf() except that
the arguments to the format string are passed as a va_list.
Since: 2.14
@@ -32306,9 +37549,9 @@ Since: 2.4
</parameter_description>
</parameter>
</parameters>
-<return> @msgval, unless @msgval is identical to @msgid and contains
-a '|' character, in which case a pointer to the substring of msgid after
-the first '|' character is returned.
+<return> @msgval, unless @msgval is identical to @msgid
+and contains a '|' character, in which case a pointer to
+the substring of msgid after the first '|' character is returned.
</return>
</function>
@@ -32560,11 +37803,11 @@ of the string @needle.
</description>
<parameters>
<parameter name="haystack">
-<parameter_description> a nul-terminated string.
+<parameter_description> a nul-terminated string
</parameter_description>
</parameter>
<parameter name="needle">
-<parameter_description> the nul-terminated string to search for.
+<parameter_description> the nul-terminated string to search for
</parameter_description>
</parameter>
</parameters>
@@ -32583,15 +37826,15 @@ to @haystack_len.
</description>
<parameters>
<parameter name="haystack">
-<parameter_description> a nul-terminated string.
+<parameter_description> a nul-terminated string
</parameter_description>
</parameter>
<parameter name="haystack_len">
-<parameter_description> the maximum length of @haystack.
+<parameter_description> the maximum length of @haystack
</parameter_description>
</parameter>
<parameter name="needle">
-<parameter_description> the nul-terminated string to search for.
+<parameter_description> the nul-terminated string to search for
</parameter_description>
</parameter>
</parameters>
@@ -32617,16 +37860,15 @@ documentation
</parameter>
</parameters>
<return> a UTF-8 string describing the signal. If the signal is unknown,
-it returns "unknown signal (<signum>)". The string can only be
-used until the next call to g_strsignal()
+it returns "unknown signal (<signum>)".
</return>
</function>
<function name="g_strsplit">
<description>
Splits a string into a maximum of @max_tokens pieces, using the given
- delimiter If @max_tokens is reached, the remainder of @string is appended
-to the last token.
+ delimiter If @max_tokens is reached, the remainder of @string is
+appended to the last token.
As a special case, the result of splitting the empty string "" is an empty
vector, not a vector containing a single string. The reason for this
@@ -32639,18 +37881,18 @@ before calling g_strsplit().
</description>
<parameters>
<parameter name="string">
-<parameter_description> a string to split.
+<parameter_description> a string to split
</parameter_description>
</parameter>
<parameter name="delimiter">
-<parameter_description> a string which specifies the places at which to split the string.
-The delimiter is not included in any of the resulting strings, unless
- max_tokens is reached.
+<parameter_description> a string which specifies the places at which to split
+the string. The delimiter is not included in any of the resulting
+strings, unless @max_tokens is reached.
</parameter_description>
</parameter>
<parameter name="max_tokens">
-<parameter_description> the maximum number of pieces to split @string into. If this is
-less than 1, the string is split completely.
+<parameter_description> the maximum number of pieces to split @string into.
+If this is less than 1, the string is split completely.
</parameter_description>
</parameter>
</parameters>
@@ -32718,7 +37960,7 @@ to @haystack_len.
</description>
<parameters>
<parameter name="haystack">
-<parameter_description> a string.
+<parameter_description> a string
</parameter_description>
</parameter>
<parameter name="haystack_len">
@@ -32728,7 +37970,7 @@ search through the whole string.
</parameter_description>
</parameter>
<parameter name="needle">
-<parameter_description> the string to search for.
+<parameter_description> the string to search for
</parameter_description>
</parameter>
</parameters>
@@ -32737,6 +37979,23 @@ search through the whole string.
</return>
</function>
+<function name="g_strstrip">
+<description>
+Removes leading and trailing whitespace from a string.
+See g_strchomp() and g_strchug().
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> a string to remove the leading and trailing whitespace from
+</parameter_description>
+</parameter>
+</parameters>
+<return> @string
+</return>
+</function>
+
<function name="g_strtod">
<description>
Converts a string to a #gdouble value.
@@ -32744,7 +38003,7 @@ It calls the standard strtod() function to handle the conversion, but
if the string is not completely converted it attempts the conversion
again with g_ascii_strtod(), and returns the best match.
-This function should seldomly be used. The normal situation when reading
+This function should seldom be used. The normal situation when reading
numbers not for human consumption is to use g_ascii_strtod(). Only when
you know that you must expect both locale formatted and C formatted numbers
should you use this. Make sure that you don't pass strings such as comma
@@ -32797,7 +38056,7 @@ Since: 2.6
</description>
<parameters>
<parameter name="str_array">
-<parameter_description> a %NULL-terminated array of strings.
+<parameter_description> a %NULL-terminated array of strings
</parameter_description>
</parameter>
</parameters>
@@ -32929,7 +38188,7 @@ a test case changes the base URI for the scope of the test
case only.
Bug URIs are constructed by appending a bug specific URI
portion to @uri_pattern, or by replacing the special string
-'%s' within @uri_pattern if that is present.
+'\%s' within @uri_pattern if that is present.
Since: 2.16
@@ -32948,10 +38207,10 @@ Since: 2.16
Create a new #GTestCase, named @test_name, this API is fairly
low level, calling g_test_add() or g_test_add_func() is preferable.
When this test is executed, a fixture structure of size @data_size
-will be allocated and filled with 0s. Then data_setup() is called
+will be allocated and filled with 0s. Then @data_setup is called
to initialize the fixture. After fixture setup, the actual test
-function data_test() is called. Once the test run completed, the
-fixture structure is torn down by calling data_teardown() and
+function @data_test is called. Once the test run completed, the
+fixture structure is torn down by calling @data_teardown and
after that the memory is released.
Splitting up a test run into fixture setup, test function and
@@ -33084,7 +38343,7 @@ execute all tests matching <replaceable>TESTPATH</replaceable>.
</para></listitem>
</varlistentry>
<varlistentry>
-<term><option>-m {perf|slow|thorough|quick}</option></term>
+<term><option>-m {perf|slow|thorough|quick|undefined|no-undefined}</option></term>
<listitem><para>
execute tests according to these test modes:
<variablelist>
@@ -33107,6 +38366,20 @@ maximize coverage.
quick tests, should run really quickly and give good coverage.
</para></listitem>
</varlistentry>
+<varlistentry>
+<term>undefined</term>
+<listitem><para>
+tests for undefined behaviour, may provoke programming errors
+under g_test_trap_fork() to check that appropriate assertions
+or warnings are given
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>no-undefined</term>
+<listitem><para>
+avoid tests for undefined behaviour
+</para></listitem>
+</varlistentry>
</variablelist>
</para></listitem>
</varlistentry>
@@ -33310,9 +38583,21 @@ Since: 2.16
<return></return>
</function>
+<function name="g_test_perf">
+<description>
+Returns %TRUE if tests are run in performance mode.
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if in performance mode
+</return>
+</function>
+
<function name="g_test_queue_destroy">
<description>
-This function enqueus a callback @destroy_func() to be executed
+This function enqueus a callback @destroy_func to be executed
during the next test case teardown phase. This is most useful
to auto destruct allocted test resources at the end of a test run.
Resources are released in reverse queue order, that means enqueueing
@@ -33353,6 +38638,64 @@ Since: 2.16
<return></return>
</function>
+<function name="g_test_queue_unref">
+<description>
+Enqueue an object to be released with g_object_unref() during
+the next teardown phase. This is equivalent to calling
+g_test_queue_destroy() with a destroy callback of g_object_unref().
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="gobject">
+<parameter_description> the object to unref
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_quick">
+<description>
+Returns %TRUE if tests are run in quick mode.
+Exactly one of g_test_quick() and g_test_slow() is active in any run;
+there is no "medium speed".
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if in quick mode
+</return>
+</function>
+
+<function name="g_test_quiet">
+<description>
+Returns %TRUE if tests are run in quiet mode.
+The default is neither g_test_verbose() nor g_test_quiet().
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if in quiet mode
+</return>
+</function>
+
+<function name="g_test_rand_bit">
+<description>
+Get a reproducible random bit (0 or 1), see g_test_rand_int()
+for details on test case random numbers.
+
+Since: 2.16
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_test_rand_double">
<description>
Get a reproducible random floating point number,
@@ -33479,6 +38822,20 @@ Since: 2.16
</return>
</function>
+<function name="g_test_slow">
+<description>
+Returns %TRUE if tests are run in slow mode.
+Exactly one of g_test_quick() and g_test_slow() is active in any run;
+there is no "medium speed".
+
+
+</description>
+<parameters>
+</parameters>
+<return> the opposite of g_test_quick()
+</return>
+</function>
+
<function name="g_test_suite_add">
<description>
Adds @test_case to @suite.
@@ -33519,6 +38876,19 @@ Since: 2.16
<return></return>
</function>
+<function name="g_test_thorough">
+<description>
+Returns %TRUE if tests are run in thorough mode, equivalent to
+g_test_slow().
+
+
+</description>
+<parameters>
+</parameters>
+<return> the same thing as g_test_slow()
+</return>
+</function>
+
<function name="g_test_timer_elapsed">
<description>
Get the time since the last start of the timer with g_test_timer_start().
@@ -33560,6 +38930,116 @@ Since: 2.16
<return></return>
</function>
+<function name="g_test_trap_assert_failed">
+<description>
+Assert that the last forked test failed.
+See g_test_trap_fork().
+
+This is sometimes used to test situations that are formally considered to
+be undefined behaviour, like inputs that fail a g_return_if_fail()
+check. In these situations you should skip the entire test, including the
+call to g_test_trap_fork(), unless g_test_undefined() returns %TRUE
+to indicate that undefined behaviour may be tested.
+
+Since: 2.16
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_trap_assert_passed">
+<description>
+Assert that the last forked test passed.
+See g_test_trap_fork().
+
+Since: 2.16
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_trap_assert_stderr">
+<description>
+Assert that the stderr output of the last forked test
+matches @serrpattern. See g_test_trap_fork().
+
+This is sometimes used to test situations that are formally considered to
+be undefined behaviour, like inputs that fail a g_return_if_fail()
+check. In these situations you should skip the entire test, including the
+call to g_test_trap_fork(), unless g_test_undefined() returns %TRUE
+to indicate that undefined behaviour may be tested.
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="serrpattern">
+<parameter_description> a glob-style
+<link linkend="glib-Glob-style-pattern-matching">pattern</link>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_trap_assert_stderr_unmatched">
+<description>
+Assert that the stderr output of the last forked test
+does not match @serrpattern. See g_test_trap_fork().
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="serrpattern">
+<parameter_description> a glob-style
+<link linkend="glib-Glob-style-pattern-matching">pattern</link>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_trap_assert_stdout">
+<description>
+Assert that the stdout output of the last forked test matches
+ soutpattern See g_test_trap_fork().
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="soutpattern">
+<parameter_description> a glob-style
+<link linkend="glib-Glob-style-pattern-matching">pattern</link>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_trap_assert_stdout_unmatched">
+<description>
+Assert that the stdout output of the last forked test
+does not match @soutpattern. See g_test_trap_fork().
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="soutpattern">
+<parameter_description> a glob-style
+<link linkend="glib-Glob-style-pattern-matching">pattern</link>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_test_trap_fork">
<description>
Fork the current test program to execute a test case that might
@@ -33637,13 +39117,37 @@ Since: 2.16
</return>
</function>
-<function name="g_thread_create">
+<function name="g_test_undefined">
<description>
-This function creates a new thread with the default priority.
+Returns %TRUE if tests may provoke assertions and other formally-undefined
+behaviour under g_test_trap_fork(), to verify that appropriate warnings
+are given. It can be useful to turn this off if running tests under
+valgrind.
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if tests may provoke programming errors
+</return>
+</function>
+
+<function name="g_test_verbose">
+<description>
+Returns %TRUE if tests are run in verbose mode.
+The default is neither g_test_verbose() nor g_test_quiet().
+
+
+</description>
+<parameters>
+</parameters>
+<return> %TRUE if in verbose mode
+</return>
+</function>
-If @joinable is %TRUE, you can wait for this threads termination
-calling g_thread_join(). Otherwise the thread will just disappear
-when it terminates.
+<function name="g_thread_create">
+<description>
+This function creates a new thread.
The new thread executes the function @func with the argument @data.
If the thread was created successfully, it is returned.
@@ -33651,14 +39155,21 @@ If the thread was created successfully, it is returned.
@error can be %NULL to ignore errors, or non-%NULL to report errors.
The error is set, if and only if the function returns %NULL.
+This function returns a reference to the created thread only if
+ joinable is %TRUE. In that case, you must free this reference by
+calling g_thread_unref() or g_thread_join(). If @joinable is %FALSE
+then you should probably not touch the return value.
+
+Deprecated:2.32: Use g_thread_new() instead
+
</description>
<parameters>
<parameter name="func">
-<parameter_description> a function to execute in the new thread.
+<parameter_description> a function to execute in the new thread
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> an argument to supply to the new thread.
+<parameter_description> an argument to supply to the new thread
</parameter_description>
</parameter>
<parameter name="joinable">
@@ -33666,46 +39177,21 @@ The error is set, if and only if the function returns %NULL.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error.
+<parameter_description> return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the new #GThread on success.
+<return> the new #GThread on success
+
</return>
</function>
<function name="g_thread_create_full">
<description>
-This function creates a new thread with the priority @priority. If
-the underlying thread implementation supports it, the thread gets a
-stack size of @stack_size or the default value for the current
-platform, if @stack_size is 0.
-
-If @joinable is %TRUE, you can wait for this threads termination
-calling g_thread_join(). Otherwise the thread will just disappear
-when it terminates. If @bound is %TRUE, this thread will be
-scheduled in the system scope, otherwise the implementation is free
-to do scheduling in the process scope. The first variant is more
-expensive resource-wise, but generally faster. On some systems (e.g.
-Linux) all threads are bound.
-
-The new thread executes the function @func with the argument @data.
-If the thread was created successfully, it is returned.
+This function creates a new thread.
- error can be %NULL to ignore errors, or non-%NULL to report errors.
-The error is set, if and only if the function returns %NULL.
-
-<note><para>It is not guaranteed that threads with different priorities
-really behave accordingly. On some systems (e.g. Linux) there are no
-thread priorities. On other systems (e.g. Solaris) there doesn't
-seem to be different scheduling for different priorities. All in all
-try to avoid being dependent on priorities. Use
-%G_THREAD_PRIORITY_NORMAL here as a default.</para></note>
-
-<note><para>Only use g_thread_create_full() if you really can't use
-g_thread_create() instead. g_thread_create() does not take
- stack_size, @bound, and @priority as arguments, as they should only
-be used in cases in which it is unavoidable.</para></note>
+Deprecated:2.32: The @bound and @priority arguments are now ignored.
+Use g_thread_new().
</description>
<parameters>
@@ -33726,11 +39212,11 @@ be used in cases in which it is unavoidable.</para></note>
</parameter_description>
</parameter>
<parameter name="bound">
-<parameter_description> should this thread be bound to a system thread?
+<parameter_description> ignored
</parameter_description>
</parameter>
<parameter name="priority">
-<parameter_description> a priority for the thread.
+<parameter_description> ignored
</parameter_description>
</parameter>
<parameter name="error">
@@ -33744,29 +39230,26 @@ be used in cases in which it is unavoidable.</para></note>
<function name="g_thread_exit">
<description>
-Exits the current thread. If another thread is waiting for that
-thread using g_thread_join() and the current thread is joinable, the
-waiting thread will be woken up and get @retval as the return value
-of g_thread_join(). If the current thread is not joinable, @retval
-is ignored. Calling
+Terminates the current thread.
-<informalexample>
-<programlisting>
-g_thread_exit (retval);
-</programlisting>
-</informalexample>
+If another thread is waiting for us using g_thread_join() then the
+waiting thread will be woken up and get @retval as the return value
+of g_thread_join().
-is equivalent to returning @retval from the function @func, as given
-to g_thread_create().
+Calling <literal>g_thread_exit (retval)</literal> is equivalent to
+returning @retval from the function @func, as given to g_thread_new().
-<note><para>Never call g_thread_exit() from within a thread of a
-#GThreadPool, as that will mess up the bookkeeping and lead to funny
-and unwanted results.</para></note>
+<note><para>
+You must only call g_thread_exit() from a thread that you created
+yourself with g_thread_new() or related APIs. You must not call
+this function from a thread created with another threading library
+or or from within a #GThreadPool.
+</para></note>
</description>
<parameters>
<parameter name="retval">
-<parameter_description> the return value of this thread.
+<parameter_description> the return value of this thread
</parameter_description>
</parameter>
</parameters>
@@ -33775,26 +39258,32 @@ and unwanted results.</para></note>
<function name="g_thread_foreach">
<description>
-Call @thread_func on all existing #GThread structures. Note that
-threads may decide to exit while @thread_func is running, so
-without intimate knowledge about the lifetime of foreign threads,
- thread_func shouldn't access the GThread* pointer passed in as
-first argument. However, @thread_func will not be called for threads
-which are known to have exited already.
+Call @thread_func on all #GThreads that have been
+created with g_thread_create().
+
+Note that threads may decide to exit while @thread_func is
+running, so without intimate knowledge about the lifetime of
+foreign threads, @thread_func shouldn't access the GThread*
+pointer passed in as first argument. However, @thread_func will
+not be called for threads which are known to have exited already.
Due to thread lifetime checks, this function has an execution complexity
which is quadratic in the number of existing threads.
Since: 2.10
+Deprecated:2.32: There aren't many things you can do with a #GThread,
+except comparing it with one that was returned from g_thread_create().
+There are better ways to find out if your thread is still alive.
+
</description>
<parameters>
<parameter name="thread_func">
-<parameter_description> function to call for all GThread structures
+<parameter_description> function to call for all #GThread structures
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> second argument to @thread_func
+<parameter_description> second argument to @thread_func
</parameter_description>
</parameter>
</parameters>
@@ -33818,39 +39307,34 @@ Since: 2.20
<function name="g_thread_init">
<description>
If you use GLib from more than one thread, you must initialize the
-thread system by calling g_thread_init(). Most of the time you will
-only have to call <literal>g_thread_init (NULL)</literal>.
+thread system by calling g_thread_init().
-<note><para>Do not call g_thread_init() with a non-%NULL parameter unless
-you really know what you are doing.</para></note>
+Since version 2.24, calling g_thread_init() multiple times is allowed,
+but nothing happens except for the first call.
-<note><para>g_thread_init() must not be called directly or indirectly as a
-callback from GLib. Also no mutexes may be currently locked while
-calling g_thread_init().</para></note>
-
-<note><para>g_thread_init() changes the way in which #GTimer measures
-elapsed time. As a consequence, timers that are running while
-g_thread_init() is called may report unreliable times.</para></note>
+Since version 2.32, GLib does not support custom thread implementations
+anymore and the @vtable parameter is ignored and you should pass %NULL.
-Calling g_thread_init() multiple times is allowed (since version
-2.24), but nothing happens except for the first call. If the
-argument is non-%NULL on such a call a warning will be printed, but
-otherwise the argument is ignored.
-
-If no thread system is available and @vtable is %NULL or if not all
-elements of @vtable are non-%NULL, then g_thread_init() will abort.
+<note><para>g_thread_init() must not be called directly or indirectly
+in a callback from GLib. Also no mutexes may be currently locked while
+calling g_thread_init().</para></note>
-<note><para>To use g_thread_init() in your program, you have to link with
-the libraries that the command <command>pkg-config --libs
+<note><para>To use g_thread_init() in your program, you have to link
+with the libraries that the command <command>pkg-config --libs
gthread-2.0</command> outputs. This is not the case for all the
-other thread related functions of GLib. Those can be used without
+other thread-related functions of GLib. Those can be used without
having to link with the thread libraries.</para></note>
+Deprecated:2.32: This function is no longer necessary. The GLib
+threading system is automatically initialized at the start
+of your program.
+
</description>
<parameters>
<parameter name="vtable">
<parameter_description> a function table of type #GThreadFunctions, that provides
-the entry points to the thread system to be used.
+the entry points to the thread system to be used. Since 2.32,
+this parameter is ignored and should always be %NULL
</parameter_description>
</parameter>
</parameters>
@@ -33859,21 +39343,71 @@ the entry points to the thread system to be used.
<function name="g_thread_join">
<description>
-Waits until @thread finishes, i.e. the function @func, as given to
-g_thread_create(), returns or g_thread_exit() is called by @thread.
-All resources of @thread including the #GThread struct are released.
- thread must have been created with @joinable=%TRUE in
-g_thread_create(). The value returned by @func or given to
-g_thread_exit() by @thread is returned by this function.
+Waits until @thread finishes, i.e. the function @func, as
+given to g_thread_new(), returns or g_thread_exit() is called.
+If @thread has already terminated, then g_thread_join()
+returns immediately.
+
+Any thread can wait for any other thread by calling g_thread_join(),
+not just its 'creator'. Calling g_thread_join() from multiple threads
+for the same @thread leads to undefined behaviour.
+
+The value returned by @func or given to g_thread_exit() is
+returned by this function.
+
+g_thread_join() consumes the reference to the passed-in @thread.
+This will usually cause the #GThread struct and associated resources
+to be freed. Use g_thread_ref() to obtain an extra reference if you
+want to keep the GThread alive beyond the g_thread_join() call.
+
</description>
<parameters>
<parameter name="thread">
-<parameter_description> a #GThread to be waited for.
+<parameter_description> a #GThread
</parameter_description>
</parameter>
</parameters>
-<return> the return value of the thread.
+<return> the return value of the thread
+</return>
+</function>
+
+<function name="g_thread_new">
+<description>
+This function creates a new thread. The new thread starts by invoking
+ func with the argument data. The thread will run until @func returns
+or until g_thread_exit() is called from the new thread. The return value
+of @func becomes the return value of the thread, which can be obtained
+with g_thread_join().
+
+The @name can be useful for discriminating threads in a debugger.
+Some systems restrict the length of @name to 16 bytes.
+
+If the thread can not be created the program aborts. See
+g_thread_try_new() if you want to attempt to deal with failures.
+
+To free the struct returned by this function, use g_thread_unref().
+Note that g_thread_join() implicitly unrefs the #GThread as well.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> a name for the new thread
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a function to execute in the new thread
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> an argument to supply to the new thread
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GThread
+
</return>
</function>
@@ -33881,17 +39415,18 @@ g_thread_exit() by @thread is returned by this function.
<description>
Frees all resources allocated for @pool.
-If @immediate is %TRUE, no new task is processed for
- pool Otherwise @pool is not freed before the last task is
-processed. Note however, that no thread of this pool is
-interrupted, while processing a task. Instead at least all still
-running threads can finish their tasks before the @pool is freed.
+If @immediate is %TRUE, no new task is processed for @pool.
+Otherwise @pool is not freed before the last task is processed.
+Note however, that no thread of this pool is interrupted while
+processing a task. Instead at least all still running threads
+can finish their tasks before the @pool is freed.
-If @wait_ is %TRUE, the functions does not return before all tasks
-to be processed (dependent on @immediate, whether all or only the
-currently running) are ready. Otherwise the function returns immediately.
+If @wait_ is %TRUE, the functions does not return before all
+tasks to be processed (dependent on @immediate, whether all
+or only the currently running) are ready.
+Otherwise the function returns immediately.
-After calling this function @pool must not be used anymore.
+After calling this function @pool must not be used anymore.
</description>
<parameters>
@@ -33913,19 +39448,21 @@ After calling this function @pool must not be used anymore.
<function name="g_thread_pool_get_max_idle_time">
<description>
-This function will return the maximum @interval that a thread will
-wait in the thread pool for new tasks before being stopped.
+This function will return the maximum @interval that a
+thread will wait in the thread pool for new tasks before
+being stopped.
-If this function returns 0, threads waiting in the thread pool for
-new work are not stopped.
+If this function returns 0, threads waiting in the thread
+pool for new work are not stopped.
Since: 2.10
</description>
<parameters>
</parameters>
-<return> the maximum @interval to wait for new tasks in the
-thread pool before stopping the thread (1/1000ths of a second).
+<return> the maximum @interval (milliseconds) to wait
+for new tasks in the thread pool before stopping the
+thread
</return>
</function>
@@ -33994,22 +39531,22 @@ Whenever you call g_thread_pool_push(), either a new thread is
created or an unused one is reused. At most @max_threads threads
are running concurrently for this thread pool. @max_threads = -1
allows unlimited threads to be created for this thread pool. The
-newly created or reused thread now executes the function @func with
-the two arguments. The first one is the parameter to
+newly created or reused thread now executes the function @func
+with the two arguments. The first one is the parameter to
g_thread_pool_push() and the second one is @user_data.
-The parameter @exclusive determines, whether the thread pool owns
-all threads exclusive or whether the threads are shared
-globally. If @exclusive is %TRUE, @max_threads threads are started
-immediately and they will run exclusively for this thread pool until
-it is destroyed by g_thread_pool_free(). If @exclusive is %FALSE,
-threads are created, when needed and shared between all
-non-exclusive thread pools. This implies that @max_threads may not
-be -1 for exclusive thread pools.
+The parameter @exclusive determines whether the thread pool owns
+all threads exclusive or shares them with other thread pools.
+If @exclusive is %TRUE, @max_threads threads are started
+immediately and they will run exclusively for this thread pool
+until it is destroyed by g_thread_pool_free(). If @exclusive is
+%FALSE, threads are created when needed and shared between all
+non-exclusive thread pools. This implies that @max_threads may
+not be -1 for exclusive thread pools.
@error can be %NULL to ignore errors, or non-%NULL to report
-errors. An error can only occur when @exclusive is set to %TRUE and
-not all @max_threads threads could be created.
+errors. An error can only occur when @exclusive is set to %TRUE
+and not all @max_threads threads could be created.
</description>
@@ -34019,13 +39556,13 @@ not all @max_threads threads could be created.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data that is handed over to @func every time it
+<parameter_description> user data that is handed over to @func every time it
is called
</parameter_description>
</parameter>
<parameter name="max_threads">
-<parameter_description> the maximal number of threads to execute concurrently in
-the new thread pool, -1 means no limit
+<parameter_description> the maximal number of threads to execute concurrently
+in the new thread pool, -1 means no limit
</parameter_description>
</parameter>
<parameter name="exclusive">
@@ -34033,7 +39570,7 @@ the new thread pool, -1 means no limit
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error
+<parameter_description> return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -34043,17 +39580,21 @@ the new thread pool, -1 means no limit
<function name="g_thread_pool_push">
<description>
-Inserts @data into the list of tasks to be executed by @pool. When
-the number of currently running threads is lower than the maximal
-allowed number of threads, a new thread is started (or reused) with
-the properties given to g_thread_pool_new (). Otherwise @data stays
-in the queue until a thread in this pool finishes its previous task
-and processes @data.
+Inserts @data into the list of tasks to be executed by @pool.
+
+When the number of currently running threads is lower than the
+maximal allowed number of threads, a new thread is started (or
+reused) with the properties given to g_thread_pool_new().
+Otherwise, @data stays in the queue until a thread in this pool
+finishes its previous task and processes @data.
@error can be %NULL to ignore errors, or non-%NULL to report
errors. An error can only occur when a new thread couldn't be
-created. In that case @data is simply appended to the queue of work
-to do.
+created. In that case @data is simply appended to the queue of
+work to do.
+
+Before version 2.32, this function did not return a success status.
+
</description>
<parameters>
@@ -34066,20 +39607,21 @@ to do.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error
+<parameter_description> return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success, %FALSE if an error occurred
+</return>
</function>
<function name="g_thread_pool_set_max_idle_time">
<description>
-This function will set the maximum @interval that a thread waiting
-in the pool for new tasks can be idle for before being
-stopped. This function is similar to calling
-g_thread_pool_stop_unused_threads() on a regular timeout, except,
-this is done on a per thread basis.
+This function will set the maximum @interval that a thread
+waiting in the pool for new tasks can be idle for before
+being stopped. This function is similar to calling
+g_thread_pool_stop_unused_threads() on a regular timeout,
+except this is done on a per thread basis.
By setting @interval to 0, idle threads will not be stopped.
@@ -34091,8 +39633,8 @@ Since: 2.10
</description>
<parameters>
<parameter name="interval">
-<parameter_description> the maximum @interval (1/1000ths of a second) a thread
-can be idle.
+<parameter_description> the maximum @interval (in milliseconds)
+a thread can be idle
</parameter_description>
</parameter>
</parameters>
@@ -34101,22 +39643,27 @@ can be idle.
<function name="g_thread_pool_set_max_threads">
<description>
-Sets the maximal allowed number of threads for @pool. A value of -1
-means, that the maximal number of threads is unlimited.
+Sets the maximal allowed number of threads for @pool.
+A value of -1 means that the maximal number of threads
+is unlimited. If @pool is an exclusive thread pool, setting
+the maximal number of threads to -1 is not allowed.
-Setting @max_threads to 0 means stopping all work for @pool. It is
-effectively frozen until @max_threads is set to a non-zero value
-again.
+Setting @max_threads to 0 means stopping all work for @pool.
+It is effectively frozen until @max_threads is set to a non-zero
+value again.
A thread is never terminated while calling @func, as supplied by
-g_thread_pool_new (). Instead the maximal number of threads only
-has effect for the allocation of new threads in g_thread_pool_push().
+g_thread_pool_new(). Instead the maximal number of threads only
+has effect for the allocation of new threads in g_thread_pool_push().
A new thread is allocated, whenever the number of currently
running threads in @pool is smaller than the maximal number.
@error can be %NULL to ignore errors, or non-%NULL to report
errors. An error can only occur when a new thread couldn't be
-created.
+created.
+
+Before version 2.32, this function did not return a success status.
+
</description>
<parameters>
@@ -34125,22 +39672,24 @@ created.
</parameter_description>
</parameter>
<parameter name="max_threads">
-<parameter_description> a new maximal number of threads for @pool
+<parameter_description> a new maximal number of threads for @pool,
+or -1 for unlimited
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error
+<parameter_description> return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE on success, %FALSE if an error occurred
+</return>
</function>
<function name="g_thread_pool_set_max_unused_threads">
<description>
-Sets the maximal number of unused threads to @max_threads. If
- max_threads is -1, no limit is imposed on the number of unused
-threads.
+Sets the maximal number of unused threads to @max_threads.
+If @max_threads is -1, no limit is imposed on the number
+of unused threads.
</description>
<parameters>
@@ -34159,10 +39708,10 @@ tasks to be processed by a priority determined by @func, and not
just in the order in which they were added to the pool.
Note, if the maximum number of threads is more than 1, the order
-that threads are executed cannot be guranteed 100%. Threads are
+that threads are executed cannot be guaranteed 100%. Threads are
scheduled by the operating system and are executed at random. It
cannot be assumed that threads are executed in the order they are
-created.
+created.
Since: 2.10
@@ -34173,16 +39722,16 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GCompareDataFunc used to sort the list of tasks.
+<parameter_description> the #GCompareDataFunc used to sort the list of tasks.
This function is passed two tasks. It should return
-0 if the order in which they are handled does not matter,
+0 if the order in which they are handled does not matter,
a negative value if the first task should be processed before
-the second or a positive value if the second task should be
+the second or a positive value if the second task should be
processed first.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data passed to @func.
+<parameter_description> user data passed to @func
</parameter_description>
</parameter>
</parameters>
@@ -34217,27 +39766,49 @@ Returns the number of tasks still unprocessed in @pool.
</return>
</function>
+<function name="g_thread_ref">
+<description>
+Increase the reference count on @thread.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="thread">
+<parameter_description> a #GThread
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new reference to @thread
+
+</return>
+</function>
+
<function name="g_thread_self">
<description>
-This functions returns the #GThread corresponding to the calling
-thread.
+This functions returns the #GThread corresponding to the
+current thread. Note that this function does not increase
+the reference count of the returned struct.
+
+This function will return a #GThread even for threads that
+were not created by GLib (i.e. those created by other threading
+APIs). This may be useful for thread identification purposes
+(i.e. comparisons) but you must not use GLib functions (such
+as g_thread_join()) on these threads.
+
</description>
<parameters>
</parameters>
-<return> the current thread.
+<return> the #GThread representing the current thread
</return>
</function>
<function name="g_thread_set_priority">
<description>
-Changes the priority of @thread to @priority.
+This function does nothing.
-<note><para>It is not guaranteed that threads with different
-priorities really behave accordingly. On some systems (e.g. Linux)
-there are no thread priorities. On other systems (e.g. Solaris) there
-doesn't seem to be different scheduling for different priorities. All
-in all try to avoid being dependent on priorities.</para></note>
+Deprecated:2.32: Thread priorities no longer have any effect.
</description>
<parameters>
@@ -34246,7 +39817,7 @@ in all try to avoid being dependent on priorities.</para></note>
</parameter_description>
</parameter>
<parameter name="priority">
-<parameter_description> a new priority for @thread.
+<parameter_description> ignored
</parameter_description>
</parameter>
</parameters>
@@ -34255,27 +39826,81 @@ in all try to avoid being dependent on priorities.</para></note>
<function name="g_thread_supported">
<description>
-This function returns %TRUE if the thread system is initialized, and
-%FALSE if it is not.
+This macro returns %TRUE if the thread system is initialized,
+and %FALSE if it is not.
+
+For language bindings, g_thread_get_initialized() provides
+the same functionality as a function.
-<note><para>This function is actually a macro. Apart from taking the
-address of it you can however use it as if it was a
-function.</para></note>
</description>
<parameters>
</parameters>
-<return> %TRUE, if the thread system is initialized.
+<return> %TRUE, if the thread system is initialized
</return>
</function>
+<function name="g_thread_try_new">
+<description>
+This function is the same as g_thread_new() except that
+it allows for the possibility of failure.
+
+If a thread can not be created (due to resource limits),
+ error is set and %NULL is returned.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> a name for the new thread
+</parameter_description>
+</parameter>
+<parameter name="func">
+<parameter_description> a function to execute in the new thread
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> an argument to supply to the new thread
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GThread, or %NULL if an error occurred
+
+</return>
+</function>
+
+<function name="g_thread_unref">
+<description>
+Decrease the reference count on @thread, possibly freeing all
+resources associated with it.
+
+Note that each thread holds a reference to its #GThread while
+it is running, so it is safe to drop your own reference to it
+if you don't need it anymore.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="thread">
+<parameter_description> a #GThread
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_thread_yield">
<description>
-Gives way to other threads waiting to be scheduled.
+Causes the calling thread to voluntarily relinquish the CPU, so
+that other threads can run.
This function is often used as a method to make busy wait less evil.
-But in most cases you will encounter, there are better methods to do
-that. So in general you shouldn't use this function.
</description>
<parameters>
@@ -34307,6 +39932,11 @@ also be negative to decrease the value of @time_.
Converts a string containing an ISO 8601 encoded date and time
to a #GTimeVal and puts it into @time_.
+ iso_date must include year, month, day, hours, minutes, and
+seconds. It can optionally include fractions of a second and a time
+zone indicator. (In the absence of any time zone indication, the
+timestamp is assumed to be in local time.)
+
Since: 2.12
</description>
@@ -34327,8 +39957,26 @@ Since: 2.12
<function name="g_time_val_to_iso8601">
<description>
-Converts @time_ into an ISO 8601 encoded string, relative to the
-Coordinated Universal Time (UTC).
+Converts @time_ into an RFC 3339 encoded string, relative to the
+Coordinated Universal Time (UTC). This is one of the many formats
+allowed by ISO 8601.
+
+ISO 8601 allows a large number of date/time formats, with or without
+punctuation and optional elements. The format returned by this function
+is a complete date and time, with optional punctuation included, the
+UTC time zone represented as "Z", and the @tv_usec part included if
+and only if it is nonzero, i.e. either
+"YYYY-MM-DDTHH:MM:SSZ" or "YYYY-MM-DDTHH:MM:SS.fffffZ".
+
+This corresponds to the Internet date/time format defined by
+<ulink url="https://www.ietf.org/rfc/rfc3339.txt">RFC 3339</ulink>, and
+to either of the two most-precise formats defined by
+<ulink url="http://www.w3.org/TR/NOTE-datetime-19980827">the W3C Note
+"Date and Time Formats"</ulink>. Both of these documents are profiles of
+ISO 8601.
+
+Use g_date_time_format() or g_strdup_printf() if a different
+variation of ISO 8601 format is required.
Since: 2.12
@@ -34396,7 +40044,7 @@ succeed (since universal time is monotonic and continuous).
Otherwise @time_ is treated is local time. The distinction between
%G_TIME_TYPE_STANDARD and %G_TIME_TYPE_DAYLIGHT is ignored except in
the case that the given @time_ is ambiguous. In Toronto, for example,
-01:30 on November 7th 2010 occured twice (once inside of daylight
+01:30 on November 7th 2010 occurred twice (once inside of daylight
savings time and the next, an hour later, outside of daylight savings
time). In this case, the different value of @type would result in a
different interval being returned.
@@ -34557,12 +40205,13 @@ Since: 2.26
<function name="g_time_zone_new_local">
<description>
-Creates a #GTimeZone corresponding to local time.
+Creates a #GTimeZone corresponding to local time. The local time
+zone may change between invocations to this function; for example,
+if the system administrator changes it.
This is equivalent to calling g_time_zone_new() with the value of the
<varname>TZ</varname> environment variable (including the possibility
-of %NULL). Changes made to <varname>TZ</varname> after the first
-call to this function may or may not be noticed by future calls.
+of %NULL).
You should release the return value by calling g_time_zone_unref()
when you are done with it.
@@ -34615,27 +40264,6 @@ Since: 2.26
</return>
</function>
-<function name="g_time_zone_refresh_local">
-<description>
-Notifies #GTimeZone that the local timezone may have changed.
-
-In response, #GTimeZone will drop its cache of the local time zone.
-No existing #GTimeZone will be modified and no #GDateTime will change
-its timezone but future calls to g_time_zone_new_local() will start
-returning the new timezone.
-
-#GTimeZone does no monitoring of the local timezone on its own, which
-is why you have to call this function to notify it of the change.
-
-If you use #GTimeZoneMonitor to watch for changes then this function
-will automatically be called for you.
-
-</description>
-<parameters>
-</parameters>
-<return></return>
-</function>
-
<function name="g_time_zone_unref">
<description>
Decreases the reference count on @tz.
@@ -34675,6 +40303,9 @@ This internally creates a main loop source using g_timeout_source_new()
and attaches it to the main loop context using g_source_attach(). You can
do these steps manually if you need greater control.
+The interval given is in terms of monotonic time, not wall clock
+time. See g_get_monotonic_time().
+
</description>
<parameters>
@@ -34715,6 +40346,9 @@ This internally creates a main loop source using g_timeout_source_new()
and attaches it to the main loop context using g_source_attach(). You can
do these steps manually if you need greater control.
+The interval given in terms of monotonic time, not wall clock time.
+See g_get_monotonic_time().
+
</description>
<parameters>
@@ -34761,6 +40395,9 @@ Note that the first call of the timer may not be precise for timeouts
of one second. If you need finer precision and have such a timeout,
you may want to use g_timeout_add() instead.
+The interval given is in terms of monotonic time, not wall clock
+time. See g_get_monotonic_time().
+
Since: 2.14
</description>
@@ -34816,6 +40453,9 @@ g_timeout_source_new_seconds() and attaches it to the main loop context
using g_source_attach(). You can do these steps manually if you need
greater control.
+The interval given is in terms of monotonic time, not wall clock
+time. See g_get_monotonic_time().
+
Since: 2.14
</description>
@@ -34855,6 +40495,9 @@ The source will not initially be associated with any #GMainContext
and must be added to one with g_source_attach() before it will be
executed.
+The interval given is in terms of monotonic time, not wall clock
+time. See g_get_monotonic_time().
+
</description>
<parameters>
@@ -34878,6 +40521,9 @@ executed.
The scheduling granularity/accuracy of this timeout source will be
in seconds.
+The interval given in terms of monotonic time, not wall clock time.
+See g_get_monotonic_time().
+
Since: 2.14
</description>
@@ -34933,11 +40579,6 @@ stopped. The return value is the number of seconds elapsed,
including any fractional part. The @microseconds out parameter is
essentially useless.
-<warning><para>
-Calling initialization functions, in particular g_thread_init(), while a
-timer is running will cause invalid return values from this function.
-</para></warning>
-
</description>
<parameters>
<parameter name="timer">
@@ -35016,6 +40657,76 @@ difference between this end time and the start time.
<return></return>
</function>
+<function name="g_trash_stack_height">
+<description>
+Returns the height of a #GTrashStack.
+
+Note that execution of this function is of O(N) complexity
+where N denotes the number of items on the stack.
+
+
+</description>
+<parameters>
+<parameter name="stack_p">
+<parameter_description> a #GTrashStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the height of the stack
+</return>
+</function>
+
+<function name="g_trash_stack_peek">
+<description>
+Returns the element at the top of a #GTrashStack
+which may be %NULL.
+
+
+</description>
+<parameters>
+<parameter name="stack_p">
+<parameter_description> a #GTrashStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the element at the top of the stack
+</return>
+</function>
+
+<function name="g_trash_stack_pop">
+<description>
+Pops a piece of memory off a #GTrashStack.
+
+
+</description>
+<parameters>
+<parameter name="stack_p">
+<parameter_description> a #GTrashStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> the element at the top of the stack
+</return>
+</function>
+
+<function name="g_trash_stack_push">
+<description>
+Pushes a piece of memory onto a #GTrashStack.
+
+</description>
+<parameters>
+<parameter name="stack_p">
+<parameter_description> a #GTrashStack
+</parameter_description>
+</parameter>
+<parameter name="data_p">
+<parameter_description> the piece of memory to push on the stack
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_tree_destroy">
<description>
Removes all keys and values from the #GTree and decreases its
@@ -35724,9 +41435,9 @@ is used to manage the relationship.
<function name="g_type_add_interface_static">
<description>
-Adds the static @interface_type to @instantiable_type. The information
-contained in the #GTypeInterfaceInfo structure pointed to by @info
-is used to manage the relationship.
+Adds the static @interface_type to @instantiable_type. The
+information contained in the #GInterfaceInfo structure pointed to by
+ info is used to manage the relationship.
</description>
<parameters>
@@ -35797,7 +41508,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 64kB.
+a type and all its parent types cannot excced 64 KiB.
This function should be called in the type's class_init() function.
The private structure can be retrieved using the
@@ -37060,7 +42771,7 @@ include the trailing 0.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -37101,7 +42812,7 @@ byte.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -37155,6 +42866,93 @@ Since: 2.14
</return>
</function>
+<function name="g_unichar_compose">
+<description>
+Performs a single composition step of the
+Unicode canonical composition algorithm.
+
+This function includes algorithmic Hangul Jamo composition,
+but it is not exactly the inverse of g_unichar_decompose().
+No composition can have either of @a or @b equal to zero.
+To be precise, this function composes if and only if
+there exists a Primary Composite P which is canonically
+equivalent to the sequence <@a,@b>. See the Unicode
+Standard for the definition of Primary Composite.
+
+If @a and @b do not compose a new character, @ch is set to zero.
+
+See <ulink url="http://unicode.org/reports/tr15/">UAX#15</ulink>
+for details.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="a">
+<parameter_description> a Unicode character
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> a Unicode character
+</parameter_description>
+</parameter>
+<parameter name="ch">
+<parameter_description> return location for the composed character
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the characters could be composed
+
+</return>
+</function>
+
+<function name="g_unichar_decompose">
+<description>
+Performs a single decomposition step of the
+Unicode canonical decomposition algorithm.
+
+This function does not include compatibility
+decompositions. It does, however, include algorithmic
+Hangul Jamo decomposition, as well as 'singleton'
+decompositions which replace a character by a single
+other character. In the case of singletons * b will
+be set to zero.
+
+If @ch is not decomposable, * a is set to @ch and * b
+is set to zero.
+
+Note that the way Unicode decomposition pairs are
+defined, it is guaranteed that @b would not decompose
+further, but @a may itself decompose. To get the full
+canonical decomposition for @ch, one would need to
+recursively call this function on @a. Or use
+g_unichar_fully_decompose().
+
+See <ulink url="http://unicode.org/reports/tr15/">UAX#15</ulink>
+for details.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="ch">
+<parameter_description> a Unicode character
+</parameter_description>
+</parameter>
+<parameter name="a">
+<parameter_description> return location for the first component of @ch
+</parameter_description>
+</parameter>
+<parameter name="b">
+<parameter_description> return location for the second component of @ch
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the character could be decomposed
+
+</return>
+</function>
+
<function name="g_unichar_digit_value">
<description>
Determines the numeric value of a character as a decimal
@@ -37173,6 +42971,53 @@ g_unichar_isdigit()), its numeric value. Otherwise, -1.
</return>
</function>
+<function name="g_unichar_fully_decompose">
+<description>
+Computes the canonical or compatibility decomposition of a
+Unicode character. For compatibility decomposition,
+pass %TRUE for @compat; for canonical decomposition
+pass %FALSE for @compat.
+
+The decomposed sequence is placed in @result. Only up to
+ result_len characters are written into @result. The length
+of the full decomposition (irrespective of @result_len) is
+returned by the function. For canonical decomposition,
+currently all decompositions are of length at most 4, but
+this may change in the future (very unlikely though).
+At any rate, Unicode does guarantee that a buffer of length
+18 is always enough for both compatibility and canonical
+decompositions, so that is the size recommended. This is provided
+as %G_UNICHAR_MAX_DECOMPOSITION_LENGTH.
+
+See <ulink url="http://unicode.org/reports/tr15/">UAX#15</ulink>
+for details.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="ch">
+<parameter_description> a Unicode character.
+</parameter_description>
+</parameter>
+<parameter name="compat">
+<parameter_description> whether perform canonical or compatibility decomposition
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> location to store decomposed result, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="result_len">
+<parameter_description> length of @result
+</parameter_description>
+</parameter>
+</parameters>
+<return> the length of the full decomposition.
+
+</return>
+</function>
+
<function name="g_unichar_get_mirror_char">
<description>
In Unicode, some characters are <firstterm>mirrored</firstterm>. This
@@ -37206,7 +43051,7 @@ Since: 2.4
<function name="g_unichar_get_script">
<description>
Looks up the #GUnicodeScript for a particular character (as defined
-by Unicode Standard Annex #24). No check is made for @ch being a
+by Unicode Standard Annex \#24). No check is made for @ch being a
valid Unicode character; if you pass in invalid character, the
result is undefined.
@@ -37694,6 +43539,8 @@ g_unichar_isxdigit()), its numeric value. Otherwise, -1.
<description>
Computes the canonical decomposition of a Unicode character.
+Deprecated: 2.30: Use the more flexible g_unichar_fully_decompose()
+instead.
</description>
<parameters>
@@ -37708,6 +43555,7 @@ Computes the canonical decomposition of a Unicode character.
</parameters>
<return> a newly allocated string of Unicode characters.
@result_len is set to the resulting length of the string.
+
</return>
</function>
@@ -37732,17 +43580,72 @@ manual for more information.
<return></return>
</function>
+<function name="g_unicode_script_from_iso15924">
+<description>
+Looks up the Unicode script for @iso15924. ISO 15924 assigns four-letter
+codes to scripts. For example, the code for Arabic is 'Arab'.
+This function accepts four letter codes encoded as a @guint32 in a
+big-endian fashion. That is, the code expected for Arabic is
+0x41726162 (0x41 is ASCII code for 'A', 0x72 is ASCII code for 'r', etc).
+
+See <ulink url="http://unicode.org/iso15924/codelists.html">Codes for the
+representation of names of scripts</ulink> for details.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="iso15924">
+<parameter_description> a Unicode script
+</parameter_description>
+</parameter>
+</parameters>
+<return> the Unicode script for @iso15924, or
+of %G_UNICODE_SCRIPT_INVALID_CODE if @iso15924 is zero and
+%G_UNICODE_SCRIPT_UNKNOWN if @iso15924 is unknown.
+
+</return>
+</function>
+
+<function name="g_unicode_script_to_iso15924">
+<description>
+Looks up the ISO 15924 code for @script. ISO 15924 assigns four-letter
+codes to scripts. For example, the code for Arabic is 'Arab'. The
+four letter codes are encoded as a @guint32 by this function in a
+big-endian fashion. That is, the code returned for Arabic is
+0x41726162 (0x41 is ASCII code for 'A', 0x72 is ASCII code for 'r', etc).
+
+See <ulink url="http://unicode.org/iso15924/codelists.html">Codes for the
+representation of names of scripts</ulink> for details.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="script">
+<parameter_description> a Unicode script
+</parameter_description>
+</parameter>
+</parameters>
+<return> the ISO 15924 code for @script, encoded as an integer,
+of zero if @script is %G_UNICODE_SCRIPT_INVALID_CODE or
+ISO 15924 code 'Zzzz' (script code for UNKNOWN) if @script is not understood.
+
+</return>
+</function>
+
<function name="g_unix_open_pipe">
<description>
Similar to the UNIX pipe() call, but on modern systems like Linux
uses the pipe2() system call, which atomically creates a pipe with
the configured flags. The only supported flag currently is
-%FD_CLOEXEC. If for example you want to configure %O_NONBLOCK,
-that must still be done separately with fcntl().
+<literal>FD_CLOEXEC</literal>. If for example you want to configure
+<literal>O_NONBLOCK</literal>, that must still be done separately with
+fcntl().
-<note>This function does *not* take %O_CLOEXEC, it takes
-%FD_CLOEXEC as if for fcntl(); these are different on
-Linux/glibc.</note>
+<note>This function does *not* take <literal>O_CLOEXEC</literal>, it takes
+<literal>FD_CLOEXEC</literal> as if for fcntl(); these are
+different on Linux/glibc.</note>
Since: 2.30
@@ -37769,8 +43672,8 @@ Since: 2.30
<function name="g_unix_set_fd_nonblocking">
<description>
Control the non-blocking state of the given file descriptor,
-according to @nonblock. On most systems this uses %O_NONBLOCK, but
-on some older ones may use %O_NDELAY.
+according to @nonblock. On most systems this uses <literal>O_NONBLOCK</literal>, but
+on some older ones may use <literal>O_NDELAY</literal>.
Since: 2.30
@@ -37794,7 +43697,7 @@ Since: 2.30
</return>
</function>
-<function name="g_unix_signal_add_watch_full">
+<function name="g_unix_signal_add">
<description>
A convenience function for g_unix_signal_source_new(), which
attaches to the default #GMainContext. You can remove the watch
@@ -37808,11 +43711,39 @@ Since: 2.30
<parameter_description> Signal number
</parameter_description>
</parameter>
+<parameter name="handler">
+<parameter_description> Callback
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> Data for @handler
+</parameter_description>
+</parameter>
+</parameters>
+<return> An ID (greater than 0) for the event source
+
+</return>
+</function>
+
+<function name="g_unix_signal_add_full">
+<description>
+A convenience function for g_unix_signal_source_new(), which
+attaches to the default #GMainContext. You can remove the watch
+using g_source_remove().
+
+Since: 2.30
+
+</description>
+<parameters>
<parameter name="priority">
<parameter_description> the priority of the signal source. Typically this will be in
the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
</parameter_description>
</parameter>
+<parameter name="signum">
+<parameter_description> Signal number
+</parameter_description>
+</parameter>
<parameter name="handler">
<parameter_description> Callback
</parameter_description>
@@ -37834,12 +43765,13 @@ the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
<function name="g_unix_signal_source_new">
<description>
Create a #GSource that will be dispatched upon delivery of the UNIX
-signal @signum. Currently only %SIGHUP, %SIGINT, and %SIGTERM can
+signal @signum. Currently only <literal>SIGHUP</literal>,
+<literal>SIGINT</literal>, and <literal>SIGTERM</literal> can
be monitored. Note that unlike the UNIX default, all sources which
have created a watch will be dispatched, regardless of which
underlying thread invoked g_unix_signal_source_new().
-For example, an effective use of this function is to handle SIGTERM
+For example, an effective use of this function is to handle <literal>SIGTERM</literal>
cleanly; flushing any outstanding files, and then calling
g_main_loop_quit (). It is not safe to do any of this a regular
UNIX signal handler; your handler may be invoked while malloc() or
@@ -37850,12 +43782,6 @@ is safe against this kind of reentrancy.
The interaction of this source when combined with native UNIX
functions like sigprocmask() is not defined.
-<note>For reliable behavior, if your program links to gthread
-(either directly or indirectly via GObject, GIO, or a higher level
-library), you should ensure g_thread_init() is called before using
-this function. For example, if your program uses GObject, call
-g_type_init().</note>
-
The source will not initially be associated with any #GMainContext
and must be added to one with g_source_attach() before it will be
executed.
@@ -37904,17 +43830,30 @@ occurred
<description>
Removes an environment variable from the environment.
-Note that on some systems, when variables are overwritten, the memory
-used for the previous variables and its value isn't reclaimed.
-Furthermore, this function can't be guaranteed to operate in a
-threadsafe way.
+Note that on some systems, when variables are overwritten, the
+memory used for the previous variables and its value isn't reclaimed.
-Since: 2.4
+<warning><para>
+Environment variable handling in UNIX is not thread-safe, and your
+program may crash if one thread calls g_unsetenv() while another
+thread is calling getenv(). (And note that many functions, such as
+gettext(), call getenv() internally.) This function is only safe
+to use at the very start of your program, before creating any other
+threads (or creating objects that create worker threads of their
+own).
+</para><para>
+If you need to set up the environment for a child process, you can
+use g_get_environ() to get an environment array, modify that with
+g_environ_setenv() and g_environ_unsetenv(), and then pass that
+array directly to execvpe(), g_spawn_async(), or the like.
+</para></warning>
+
+Since: 2.4
</description>
<parameters>
<parameter name="variable">
-<parameter_description> the environment variable to remove, must not contain '='.
+<parameter_description> the environment variable to remove, must not contain '='
</parameter_description>
</parameter>
</parameters>
@@ -38063,6 +44002,25 @@ should be freed when no longer needed.
</return>
</function>
+<function name="g_usleep">
+<description>
+Pauses the current thread for the given number of microseconds.
+
+There are 1 million microseconds per second (represented by the
+#G_USEC_PER_SEC macro). g_usleep() may have limited precision,
+depending on hardware and operating system; don't rely on the exact
+length of the sleep.
+
+</description>
+<parameters>
+<parameter name="microseconds">
+<parameter_description> number of microseconds to pause
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_utf16_to_ucs4">
<description>
Convert a string from UTF-16 to UCS-4. The result will be
@@ -38095,7 +44053,7 @@ The value stored here does not include the trailing
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -38151,7 +44109,7 @@ The value stored here does not include the trailing
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -38569,7 +44527,8 @@ converted to lowercase.
<function name="g_utf8_strlen">
<description>
Computes the length of the string in characters, not including
-the terminating nul character.
+the terminating nul character. If the @max'th byte falls in the
+middle of a character, the last (partial) character is not counted.
</description>
@@ -38582,7 +44541,8 @@ the terminating nul character.
<parameter_description> the maximum number of bytes to examine. If @max
is less than 0, then the string is assumed to be
nul-terminated. If @max is 0, @p will not be examined and
-may be %NULL.
+may be %NULL. If @max is greater than 0, up to @max
+bytes are examined
</parameter_description>
</parameter>
</parameters>
@@ -38706,10 +44666,39 @@ converted to uppercase.
</return>
</function>
+<function name="g_utf8_substring">
+<description>
+Copies a substring out of a UTF-8 encoded string.
+The substring will contain @end_pos - @start_pos
+characters.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="str">
+<parameter_description> a UTF-8 encoded string
+</parameter_description>
+</parameter>
+<parameter name="start_pos">
+<parameter_description> a character offset within @str
+</parameter_description>
+</parameter>
+<parameter name="end_pos">
+<parameter_description> another character offset within @str
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated copy of the requested
+substring. Free with g_free() when no longer needed.
+
+</return>
+</function>
+
<function name="g_utf8_to_ucs4">
<description>
Convert a string from UTF-8 to a 32-bit fixed width
-representation as UCS-4. A trailing 0 will be added to the
+representation as UCS-4. A trailing 0 character will be added to the
string after the converted text.
@@ -38739,7 +44728,7 @@ character.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -38757,7 +44746,8 @@ error occurs, %NULL will be returned and
Convert a string from UTF-8 to a 32-bit fixed width
representation as UCS-4, assuming valid UTF-8 input.
This function is roughly twice as fast as g_utf8_to_ucs4()
-but does no error checking on the input.
+but does no error checking on the input. A trailing 0 character
+will be added to the string after the converted text.
</description>
@@ -38814,7 +44804,7 @@ The value stored here does not include the trailing 0.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error occuring, or %NULL to ignore
+<parameter_description> location to store the error occurring, or %NULL to ignore
errors. Any of the errors in #GConvertError other than
%G_CONVERT_ERROR_NO_CONVERSION may occur.
</parameter_description>
@@ -38838,7 +44828,7 @@ character if some bytes were invalid, or the end of the text
being validated otherwise).
Note that g_utf8_validate() returns %FALSE if @max_len is
-positive and NUL is met before @max_len bytes have been read.
+positive and any of the @max_len bytes are NUL.
</description>
@@ -38892,6 +44882,7 @@ occurred
Insert a copy of @value as last element of @value_array. If @value is
%NULL, an uninitialized value is appended.
+Deprecated: 2.32: Use #GArray and g_array_append_val() instead.
</description>
<parameters>
@@ -38905,6 +44896,7 @@ Insert a copy of @value as last element of @value_array. If @value is
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
@@ -38913,6 +44905,7 @@ Insert a copy of @value as last element of @value_array. If @value is
Construct an exact copy of a #GValueArray by duplicating all its
contents.
+Deprecated: 2.32: Use #GArray and g_array_ref() instead.
</description>
<parameters>
@@ -38922,6 +44915,7 @@ contents.
</parameter>
</parameters>
<return> Newly allocated copy of #GValueArray
+
</return>
</function>
@@ -38929,6 +44923,8 @@ contents.
<description>
Free a #GValueArray including its contents.
+Deprecated: 2.32: Use #GArray and g_array_unref() instead.
+
</description>
<parameters>
<parameter name="value_array">
@@ -38943,6 +44939,7 @@ Free a #GValueArray including its contents.
<description>
Return a pointer to the value at @index_ containd in @value_array.
+Deprecated: 2.32: Use g_array_index() instead.
</description>
<parameters>
@@ -38956,6 +44953,7 @@ Return a pointer to the value at @index_ containd in @value_array.
</parameter>
</parameters>
<return> pointer to a value at @index_ in @value_array
+
</return>
</function>
@@ -38964,6 +44962,7 @@ Return a pointer to the value at @index_ containd in @value_array.
Insert a copy of @value at specified position into @value_array. If @value
is %NULL, an uninitialized value is inserted.
+Deprecated: 2.32: Use #GArray and g_array_insert_val() instead.
</description>
<parameters>
@@ -38981,6 +44980,7 @@ is %NULL, an uninitialized value is inserted.
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
@@ -38990,6 +44990,7 @@ Allocate and initialize a new #GValueArray, optionally preserve space
for @n_prealloced elements. New arrays always contain 0 elements,
regardless of the value of @n_prealloced.
+Deprecated: 2.32: Use #GArray and g_array_sized_new() instead.
</description>
<parameters>
@@ -38999,6 +45000,7 @@ regardless of the value of @n_prealloced.
</parameter>
</parameters>
<return> a newly allocated #GValueArray with 0 values
+
</return>
</function>
@@ -39008,6 +45010,7 @@ Insert a copy of @value as first element of @value_array. If @value is
%NULL, an uninitialized value is prepended.
+Deprecated: 2.32: Use #GArray and g_array_prepend_val() instead.
</description>
<parameters>
@@ -39021,6 +45024,7 @@ Insert a copy of @value as first element of @value_array. If @value is
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
@@ -39028,6 +45032,7 @@ Insert a copy of @value as first element of @value_array. If @value is
<description>
Remove the value at position @index_ from @value_array.
+Deprecated: 2.32: Use #GArray and g_array_remove_index() instead.
</description>
<parameters>
@@ -39043,16 +45048,18 @@ linkend="GValueArray.n-values">n_values</link></code>
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
<function name="g_value_array_sort">
<description>
-Sort @value_array using @compare_func to compare the elements accoring to
+Sort @value_array using @compare_func to compare the elements according to
the semantics of #GCompareFunc.
The current implementation uses Quick-Sort as sorting algorithm.
+Deprecated: 2.32: Use #GArray and g_array_sort().
</description>
<parameters>
@@ -39066,16 +45073,18 @@ The current implementation uses Quick-Sort as sorting algorithm.
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
<function name="g_value_array_sort_with_data">
<description>
-Sort @value_array using @compare_func to compare the elements accoring
+Sort @value_array using @compare_func to compare the elements according
to the semantics of #GCompareDataFunc.
The current implementation uses Quick-Sort as sorting algorithm.
+Deprecated: 2.32: Use #GArray and g_array_sort_with_data().
</description>
<parameters>
@@ -39093,6 +45102,7 @@ The current implementation uses Quick-Sort as sorting algorithm.
</parameter>
</parameters>
<return> the #GValueArray passed in as @value_array
+
</return>
</function>
@@ -39256,8 +45266,12 @@ Get the contents of a %G_TYPE_BOXED derived #GValue.
<function name="g_value_get_char">
<description>
-Get the contents of a %G_TYPE_CHAR #GValue.
+Do not use this function; it is broken on platforms where the %char
+type is unsigned, such as ARM and PowerPC. See g_value_get_schar().
+
+Get the contents of a %G_TYPE_CHAR #GValue.
+Deprecated: 2.32: This function's return type is broken, see g_value_get_schar()
</description>
<parameters>
@@ -39448,6 +45462,23 @@ Get the contents of a pointer #GValue.
</return>
</function>
+<function name="g_value_get_schar">
+<description>
+Get the contents of a %G_TYPE_CHAR #GValue.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue of type %G_TYPE_CHAR
+</parameter_description>
+</parameter>
+</parameters>
+<return> signed 8 bit integer contents of @value
+</return>
+</function>
+
<function name="g_value_get_string">
<description>
Get the contents of a %G_TYPE_STRING #GValue.
@@ -39684,6 +45715,7 @@ Deprecated: 2.4: Use g_value_take_boxed() instead.
<function name="g_value_set_char">
<description>
Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+Deprecated: 2.32: This function's input type is broken, see g_value_set_schar()
</description>
<parameters>
@@ -39968,6 +46000,26 @@ Set the contents of a pointer #GValue to @v_pointer.
<return></return>
</function>
+<function name="g_value_set_schar">
+<description>
+Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a valid #GValue of type %G_TYPE_CHAR
+</parameter_description>
+</parameter>
+<parameter name="v_char">
+<parameter_description> signed 8 bit integer to be set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_value_set_static_boxed">
<description>
Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed.
@@ -40236,10 +46288,8 @@ the ownership of the caller's reference to @variant;
the caller doesn't have to unref it any more (i.e. the reference
count of the variant is not increased).
-It is a programmer error to pass a floating variant to this function.
-In particular this means that callbacks in closures, and signal handlers
-for signals of return type %G_TYPE_VARIANT, must never return floating
-variants.
+If @variant was floating then its floating reference is converted to
+a hard reference.
If you want the #GValue to hold its own reference to @variant, use
g_value_set_variant() instead.
@@ -40548,6 +46598,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new, floating, #GVariant
+
</return>
</function>
@@ -40621,6 +46672,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #GVariantBuilder
+
</return>
</function>
@@ -40666,6 +46718,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new reference to @builder
+
</return>
</function>
@@ -40715,6 +46768,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the byteswapped form of @value
+
</return>
</function>
@@ -40732,6 +46786,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the #GVariantClass of @value
+
</return>
</function>
@@ -40773,6 +46828,7 @@ Since: 2.26
<return> negative value if a < b;
zero if a = b;
positive value if a > b.
+
</return>
</function>
@@ -40797,7 +46853,9 @@ the length (not including the nul terminator)
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated string
+<return> (transfer full) (array zero-terminated=1 length=length)
+(element-type guint8): a newly allocated string
+
</return>
</function>
@@ -40828,6 +46886,38 @@ Since: 2.26
</parameter>
</parameters>
<return> an array of strings
+
+</return>
+</function>
+
+<function name="g_variant_dup_objv">
+<description>
+Gets the contents of an array of object paths #GVariant. This call
+makes a deep copy; the return result should be released with
+g_strfreev().
+
+If @length is non-%NULL then the number of elements in the result
+is stored there. In any case, the resulting array will be
+%NULL-terminated.
+
+For an empty array, @length will be set to 0 and a pointer to a
+%NULL pointer will be returned.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> an array of object paths #GVariant
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the result, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of strings
+
</return>
</function>
@@ -40854,6 +46944,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a newly allocated string, utf8 encoded
+
</return>
</function>
@@ -40884,6 +46975,7 @@ Since: 2.24
</parameter>
</parameters>
<return> an array of strings
+
</return>
</function>
@@ -40908,6 +47000,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if @one and @two are equal
+
</return>
</function>
@@ -40962,6 +47055,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE or %FALSE
+
</return>
</function>
@@ -40982,6 +47076,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #guchar
+
</return>
</function>
@@ -41012,7 +47107,9 @@ Since: 2.26
</parameter_description>
</parameter>
</parameters>
-<return> the constant string
+<return>
+the constant string
+
</return>
</function>
@@ -41043,6 +47140,7 @@ Since: 2.26
</parameter>
</parameters>
<return> an array of constant strings
+
</return>
</function>
@@ -41087,6 +47185,9 @@ entries. It is an error to call this function on any other type of
It is an error if @index_ is greater than the number of child items
in the container. See g_variant_n_children().
+The returned value is never floating. You should free it with
+g_variant_unref() when you're done with it.
+
This function is O(1).
Since: 2.24
@@ -41103,6 +47204,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the child at the specified index
+
</return>
</function>
@@ -41124,6 +47226,16 @@ is O(1). If the value is not already in serialised form,
serialisation occurs implicitly and is approximately O(n) in the size
of the result.
+To deserialise the data returned by this function, in addition to the
+serialised data, you must know the type of the #GVariant, and (if the
+machine might be different) the endianness of the machine that stored
+it. As a result, file formats or network messages that incorporate
+serialised #GVariant<!---->s must include this information either
+implicitly (for instance "the file always contains a
+%G_VARIANT_TYPE_VARIANT and it is always in little-endian order") or
+explicitly (by storing the type and/or endianness in addition to the
+serialised data).
+
Since: 2.24
</description>
@@ -41134,6 +47246,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the serialised form of @value, or %NULL
+
</return>
</function>
@@ -41154,6 +47267,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #gdouble
+
</return>
</function>
@@ -41163,13 +47277,36 @@ Provides access to the serialised data for an array of fixed-sized
items.
@value must be an array with fixed-sized elements. Numeric types are
-fixed-size as are tuples containing only other fixed-sized types.
-
- element_size must be the size of a single element in the array. For
-example, if calling this function for an array of 32 bit integers,
+fixed-size, as are tuples containing only other fixed-sized types.
+
+ element_size must be the size of a single element in the array,
+as given by the section on
+<link linkend='gvariant-serialised-data-memory'>Serialised Data
+Memory</link>.
+
+In particular, arrays of these fixed-sized types can be interpreted
+as an array of the given C type, with @element_size set to
+<code>sizeof</code> the appropriate type:
+
+<informaltable>
+<tgroup cols='2'>
+<thead><row><entry>element type</entry> <entry>C type</entry></row></thead>
+<tbody>
+<row><entry>%G_VARIANT_TYPE_INT16 (etc.)</entry>
+<entry>#gint16 (etc.)</entry></row>
+<row><entry>%G_VARIANT_TYPE_BOOLEAN</entry>
+<entry>#guchar (not #gboolean!)</entry></row>
+<row><entry>%G_VARIANT_TYPE_BYTE</entry> <entry>#guchar</entry></row>
+<row><entry>%G_VARIANT_TYPE_HANDLE</entry> <entry>#guint32</entry></row>
+<row><entry>%G_VARIANT_TYPE_DOUBLE</entry> <entry>#gdouble</entry></row>
+</tbody>
+</tgroup>
+</informaltable>
+
+For example, if calling this function for an array of 32 bit integers,
you might say <code>sizeof (gint32)</code>. This value isn't used
except for the purpose of a double-check that the form of the
-seralised data matches the caller's expectation.
+serialised data matches the caller's expectation.
@n_elements, which must be non-%NULL is set equal to the number of
items in the array.
@@ -41191,7 +47328,9 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> a pointer to the fixed array
+<return> a pointer to
+the fixed array
+
</return>
</function>
@@ -41227,6 +47366,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #gint32
+
</return>
</function>
@@ -41247,6 +47387,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #gint16
+
</return>
</function>
@@ -41267,6 +47408,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #gint32
+
</return>
</function>
@@ -41287,6 +47429,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #gint64
+
</return>
</function>
@@ -41305,6 +47448,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the contents of @value, or %NULL
+
</return>
</function>
@@ -41337,6 +47481,38 @@ Since: 2.24
</parameter>
</parameters>
<return> a trusted #GVariant
+
+</return>
+</function>
+
+<function name="g_variant_get_objv">
+<description>
+Gets the contents of an array of object paths #GVariant. This call
+makes a shallow copy; the return result should be released with
+g_free(), but the individual strings must not be modified.
+
+If @length is non-%NULL then the number of elements in the result
+is stored there. In any case, the resulting array will be
+%NULL-terminated.
+
+For an empty array, @length will be set to 0 and a pointer to a
+%NULL pointer will be returned.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> an array of object paths #GVariant
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of the result, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> an array of constant strings
+
</return>
</function>
@@ -41364,6 +47540,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the serialised size of @value
+
</return>
</function>
@@ -41399,6 +47576,7 @@ to store the length
</parameter>
</parameters>
<return> the constant string, utf8 encoded
+
</return>
</function>
@@ -41428,8 +47606,8 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> an array of constant
-strings
+<return> an array of constant strings
+
</return>
</function>
@@ -41450,6 +47628,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #GVariantType
+
</return>
</function>
@@ -41469,6 +47648,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the type string for the type of @value
+
</return>
</function>
@@ -41489,6 +47669,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #guint16
+
</return>
</function>
@@ -41509,6 +47690,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #guint32
+
</return>
</function>
@@ -41529,6 +47711,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #guint64
+
</return>
</function>
@@ -41594,6 +47777,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the item contained in the variant
+
</return>
</function>
@@ -41619,6 +47803,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a hash value corresponding to @value
+
</return>
</function>
@@ -41626,6 +47811,8 @@ Since: 2.24
<description>
Checks if @value is a container.
+Since: 2.24
+
</description>
<parameters>
<parameter name="value">
@@ -41634,6 +47821,7 @@ Checks if @value is a container.
</parameter>
</parameters>
<return> %TRUE if @value is a container
+
</return>
</function>
@@ -41643,7 +47831,8 @@ Checks whether @value has a floating reference count.
This function should only ever be used to assert that a given variant
is or is not floating, or for debug purposes. To acquire a reference
-to a variant that might be floating, always use g_variant_ref_sink().
+to a variant that might be floating, always use g_variant_ref_sink()
+or g_variant_take_ref().
See g_variant_ref_sink() for more information about floating reference
counts.
@@ -41658,6 +47847,7 @@ Since: 2.26
</parameter>
</parameters>
<return> whether @value is floating
+
</return>
</function>
@@ -41684,6 +47874,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if @value is in normal form
+
</return>
</function>
@@ -41708,6 +47899,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if @string is a D-Bus object path
+
</return>
</function>
@@ -41729,6 +47921,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if the type of @value matches @type
+
</return>
</function>
@@ -41751,6 +47944,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if @string is a D-Bus type signature
+
</return>
</function>
@@ -41777,6 +47971,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new heap-allocated #GVariantIter
+
</return>
</function>
@@ -41821,6 +48016,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the number of items in @value
+
</return>
</function>
@@ -41844,7 +48040,11 @@ used when iterating over an array. It is only valid to call this
function with a string constant for the format string and the same
string constant must be used each time. Mixing calls to this
function and g_variant_iter_next() or g_variant_iter_next_value() on
-the same iterator is not recommended.
+the same iterator causes undefined behavior.
+
+If you break out of a such a while loop using g_variant_iter_loop() then
+you must free or unreference all the unpacked values as you would with
+g_variant_get(). Failure to do so will cause a memory leak.
See the section on <link linkend='gvariant-format-strings'>GVariant
Format Strings</link>.
@@ -41867,13 +48067,22 @@ g_print ("Item '%s' has type '%s'\n", key,
g_variant_get_type_string (value));
/<!-- -->* no need to free 'key' and 'value' here *<!-- -->/
+/<!-- -->* unless breaking out of this loop *<!-- -->/
}
}
</programlisting>
</example>
-If you want a slightly less magical alternative that requires more
-typing, see g_variant_iter_next().
+For most cases you should use g_variant_iter_next().
+
+This function is really only useful when unpacking into #GVariant or
+#GVariantIter in order to allow you to skip the call to
+g_variant_unref() or g_variant_iter_free().
+
+For example, if you are only looping over simple integer and string
+types, g_variant_iter_next() is definitely preferred. For string
+types, use the '&' prefix to avoid allocating any memory at all (and
+thereby avoiding the need to free anything as well).
Since: 2.24
@@ -41892,8 +48101,9 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a value was unpacked, or %FALSE if there as no
+<return> %TRUE if a value was unpacked, or %FALSE if there was no
value
+
</return>
</function>
@@ -41915,6 +48125,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the number of children in the container
+
</return>
</function>
@@ -41939,6 +48150,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new heap-allocated #GVariantIter
+
</return>
</function>
@@ -42002,8 +48214,8 @@ Since: 2.24
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if a value was unpacked, or %FALSE if there as no
-value
+<return> %TRUE if a value was unpacked, or %FALSE if there as no value
+
</return>
</function>
@@ -42049,6 +48261,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a #GVariant, or %NULL
+
</return>
</function>
@@ -42159,6 +48372,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the number of children in the container
+
</return>
</function>
@@ -42192,6 +48406,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new floating #GVariant instance
+
</return>
</function>
@@ -42232,6 +48447,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new #GVariant array
+
</return>
</function>
@@ -42249,6 +48465,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new boolean #GVariant instance
+
</return>
</function>
@@ -42266,6 +48483,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new byte #GVariant instance
+
</return>
</function>
@@ -42283,11 +48501,13 @@ Since: 2.26
</description>
<parameters>
<parameter name="string">
-<parameter_description> a normal nul-terminated string in no particular encoding
+<parameter_description> a normal
+nul-terminated string in no particular encoding
</parameter_description>
</parameter>
</parameters>
<return> a floating reference to a new bytestring #GVariant instance
+
</return>
</function>
@@ -42312,6 +48532,7 @@ Since: 2.26
</parameter>
</parameters>
<return> a new floating #GVariant instance
+
</return>
</function>
@@ -42337,6 +48558,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new dictionary entry #GVariant
+
</return>
</function>
@@ -42354,6 +48576,50 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new double #GVariant instance
+
+</return>
+</function>
+
+<function name="g_variant_new_fixed_array">
+<description>
+Provides access to the serialised data for an array of fixed-sized
+items.
+
+ value must be an array with fixed-sized elements. Numeric types are
+fixed-size as are tuples containing only other fixed-sized types.
+
+ element_size must be the size of a single element in the array. For
+example, if calling this function for an array of 32 bit integers,
+you might say <code>sizeof (gint32)</code>. This value isn't used
+except for the purpose of a double-check that the form of the
+serialised data matches the caller's expectation.
+
+ n_elements, which must be non-%NULL is set equal to the number of
+items in the array.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="element_type">
+<parameter_description> the #GVariantType of each element
+</parameter_description>
+</parameter>
+<parameter name="elements">
+<parameter_description> a pointer to the fixed array of contiguous elements
+</parameter_description>
+</parameter>
+<parameter name="n_elements">
+<parameter_description> the number of elements
+</parameter_description>
+</parameter>
+<parameter name="element_size">
+<parameter_description> the size of each element
+</parameter_description>
+</parameter>
+</parameters>
+<return> a floating reference to a new array #GVariant instance
+
</return>
</function>
@@ -42376,6 +48642,10 @@ as a file installed in /usr/lib alongside your application). You
should set trusted to %FALSE if @data is read from the network, a
file in the user's home directory, etc.
+If @data was not stored in this machine's native endianness, any multi-byte
+numeric values in the returned variant will also be in non-native
+endianness. g_variant_byteswap() can be used to recover the original values.
+
@notify will be called with @user_data when @data is no longer
needed. The exact time of this call is unspecified and might even be
before this function returns.
@@ -42410,6 +48680,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new floating #GVariant of type @type
+
</return>
</function>
@@ -42431,6 +48702,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new handle #GVariant instance
+
</return>
</function>
@@ -42448,6 +48720,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new int16 #GVariant instance
+
</return>
</function>
@@ -42465,6 +48738,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new int32 #GVariant instance
+
</return>
</function>
@@ -42482,6 +48756,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new int64 #GVariant instance
+
</return>
</function>
@@ -42512,6 +48787,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new #GVariant maybe instance
+
</return>
</function>
@@ -42531,6 +48807,35 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new object path #GVariant instance
+
+</return>
+</function>
+
+<function name="g_variant_new_objv">
+<description>
+Constructs an array of object paths #GVariant from the given array of
+strings.
+
+Each string must be a valid #GVariant object path; see
+g_variant_is_object_path().
+
+If @length is -1 then @strv is %NULL-terminated.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="strv">
+<parameter_description> an array of strings
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @strv, or -1
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new floating #GVariant instance
+
</return>
</function>
@@ -42560,9 +48865,10 @@ want to parse data from untrusted sources, use g_variant_parse().
You may not use this function to return, unmodified, a single
#GVariant pointer from the argument list. ie: @format may not solely
-be anything along the lines of "%*", "%?", "%r", or anything starting
+be anything along the lines of "%*", "%?", "\%r", or anything starting
with "%@".
+
</description>
<parameters>
<parameter name="format">
@@ -42598,6 +48904,7 @@ At this point, the caller will have their own full reference to the
result. This can also be done by adding the result to a container,
or by passing it to another g_variant_new() call.
+
</description>
<parameters>
<parameter name="format">
@@ -42629,6 +48936,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new signature #GVariant instance
+
</return>
</function>
@@ -42648,6 +48956,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new string #GVariant instance
+
</return>
</function>
@@ -42672,6 +48981,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new floating #GVariant instance
+
</return>
</function>
@@ -42700,6 +49010,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new #GVariant tuple
+
</return>
</function>
@@ -42717,6 +49028,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new uint16 #GVariant instance
+
</return>
</function>
@@ -42734,6 +49046,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new uint32 #GVariant instance
+
</return>
</function>
@@ -42751,6 +49064,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new uint64 #GVariant instance
+
</return>
</function>
@@ -42808,6 +49122,7 @@ or %NULL
</parameter>
</parameters>
<return> a new, usually floating, #GVariant
+
</return>
</function>
@@ -42829,6 +49144,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a floating reference to a new variant #GVariant instance
+
</return>
</function>
@@ -42860,7 +49176,7 @@ In the event that the parsing is successful, the resulting #GVariant
is returned.
In case of any error, %NULL will be returned. If @error is non-%NULL
-then it will be set to reflect the error that occured.
+then it will be set to reflect the error that occurred.
Officially, the language understood by the parser is "any string
produced by g_variant_print()".
@@ -42901,6 +49217,8 @@ The format is described <link linkend='gvariant-text'>here</link>.
If @type_annotate is %TRUE, then type information is included in
the output.
+Since: 2.24
+
</description>
<parameters>
<parameter name="value">
@@ -42914,6 +49232,7 @@ the output
</parameter>
</parameters>
<return> a newly-allocated string holding the result.
+
</return>
</function>
@@ -42943,6 +49262,7 @@ the output
</parameter>
</parameters>
<return> a #GString containing the string
+
</return>
</function>
@@ -42960,6 +49280,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the same @value
+
</return>
</function>
@@ -42998,6 +49319,7 @@ Since: 2.24
</parameter>
</parameters>
<return> the same @value
+
</return>
</function>
@@ -43010,6 +49332,10 @@ The stored data is in machine native byte order but may not be in
fully-normalised form if read from an untrusted source. See
g_variant_get_normal_form() for a solution.
+As with g_variant_get_data(), to be able to deserialise the
+serialised variant successfully, its type and (if the destination
+machine might be different) its endianness must also be available.
+
This function is approximately O(n) in the size of @data.
Since: 2.24
@@ -43028,12 +49354,58 @@ Since: 2.24
<return></return>
</function>
+<function name="g_variant_take_ref">
+<description>
+If @value is floating, sink it. Otherwise, do nothing.
+
+Typically you want to use g_variant_ref_sink() in order to
+automatically do the correct thing with respect to floating or
+non-floating references, but there is one specific scenario where
+this function is helpful.
+
+The situation where this function is helpful is when creating an API
+that allows the user to provide a callback function that returns a
+#GVariant. We certainly want to allow the user the flexibility to
+return a non-floating reference from this callback (for the case
+where the value that is being returned already exists).
+
+At the same time, the style of the #GVariant API makes it likely that
+for newly-created #GVariant instances, the user can be saved some
+typing if they are allowed to return a #GVariant with a floating
+reference.
+
+Using this function on the return value of the user's callback allows
+the user to do whichever is more convenient for them. The caller
+will alway receives exactly one full reference to the value: either
+the one that was returned in the first place, or a floating reference
+that has been converted to a full reference.
+
+This function has an odd interaction when combined with
+g_variant_ref_sink() running at the same time in another thread on
+the same #GVariant instance. If g_variant_ref_sink() runs first then
+the result will be that the floating reference is converted to a hard
+reference. If g_variant_take_ref() runs first then the result will
+be that the floating reference is converted to a hard reference and
+an additional reference on top of that one is added. It is best to
+avoid this situation.
+
+
+</description>
+<parameters>
+<parameter name="value">
+<parameter_description> a #GVariant
+</parameter_description>
+</parameter>
+</parameters>
+<return> the same @value
+</return>
+</function>
+
<function name="g_variant_type_copy">
<description>
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>
@@ -43043,6 +49415,8 @@ Since 2.24
</parameter>
</parameters>
<return> a new #GVariantType
+
+Since 2.24
</return>
</function>
@@ -43052,7 +49426,6 @@ 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>
@@ -43062,6 +49435,8 @@ Since 2.24
</parameter>
</parameters>
<return> the corresponding type string
+
+Since 2.24
</return>
</function>
@@ -43071,7 +49446,6 @@ 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>
@@ -43081,6 +49455,8 @@ Since 2.24
</parameter>
</parameters>
<return> the element type of @type
+
+Since 2.24
</return>
</function>
@@ -43097,7 +49473,6 @@ 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>
@@ -43111,6 +49486,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type1 and @type2 are exactly equal
+
+Since 2.24
</return>
</function>
@@ -43131,7 +49508,6 @@ 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>
@@ -43141,6 +49517,8 @@ Since 2.24
</parameter>
</parameters>
<return> the first item type of @type, or %NULL
+
+Since 2.24
</return>
</function>
@@ -43170,7 +49548,6 @@ 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>
@@ -43180,6 +49557,8 @@ Since 2.24
</parameter>
</parameters>
<return> the length of the corresponding type string
+
+Since 2.24
</return>
</function>
@@ -43191,7 +49570,6 @@ 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>
@@ -43201,6 +49579,8 @@ Since 2.24
</parameter>
</parameters>
<return> the hash value
+
+Since 2.24
</return>
</function>
@@ -43213,7 +49593,6 @@ 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>
@@ -43223,6 +49602,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is an array type
+
+Since 2.24
</return>
</function>
@@ -43238,7 +49619,6 @@ 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>
@@ -43248,6 +49628,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a basic type
+
+Since 2.24
</return>
</function>
@@ -43262,7 +49644,6 @@ 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>
@@ -43272,6 +49653,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a container type
+
+Since 2.24
</return>
</function>
@@ -43288,7 +49671,6 @@ 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>
@@ -43298,6 +49680,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is definite
+
+Since 2.24
</return>
</function>
@@ -43310,7 +49694,6 @@ 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>
@@ -43320,6 +49703,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a dictionary entry type
+
+Since 2.24
</return>
</function>
@@ -43332,7 +49717,6 @@ 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>
@@ -43342,6 +49726,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a maybe type
+
+Since 2.24
</return>
</function>
@@ -43353,7 +49739,6 @@ 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>
@@ -43367,6 +49752,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a subtype of @supertype
+
+Since 2.24
</return>
</function>
@@ -43380,7 +49767,6 @@ 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>
@@ -43390,6 +49776,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is a tuple type
+
+Since 2.24
</return>
</function>
@@ -43397,7 +49785,6 @@ Since 2.24
<description>
Determines if the given @type is the variant type.
-Since 2.24
</description>
<parameters>
@@ -43407,6 +49794,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type is the variant type
+
+Since 2.24
</return>
</function>
@@ -43418,7 +49807,6 @@ 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>
@@ -43428,6 +49816,8 @@ Since 2.24
</parameter>
</parameters>
<return> the key type of the dictionary entry
+
+Since 2.24
</return>
</function>
@@ -43443,7 +49833,6 @@ 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>
@@ -43453,6 +49842,8 @@ Since 2.24
</parameter>
</parameters>
<return> the number of items in @type
+
+Since 2.24
</return>
</function>
@@ -43475,6 +49866,7 @@ Since: 2.24
</parameter>
</parameters>
<return> a new #GVariantType
+
</return>
</function>
@@ -43485,7 +49877,6 @@ type @type.
It is appropriate to call g_variant_type_free() on the return value.
-Since 2.24
</description>
<parameters>
@@ -43495,6 +49886,8 @@ Since 2.24
</parameter>
</parameters>
<return> a new array #GVariantType
+
+Since 2.24
</return>
</function>
@@ -43505,7 +49898,6 @@ 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>
@@ -43519,6 +49911,8 @@ Since 2.24
</parameter>
</parameters>
<return> a new dictionary entry #GVariantType
+
+Since 2.24
</return>
</function>
@@ -43529,7 +49923,6 @@ type @type or Nothing.
It is appropriate to call g_variant_type_free() on the return value.
-Since 2.24
</description>
<parameters>
@@ -43539,6 +49932,8 @@ Since 2.24
</parameter>
</parameters>
<return> a new maybe #GVariantType
+
+Since 2.24
</return>
</function>
@@ -43551,7 +49946,6 @@ 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>
@@ -43565,6 +49959,8 @@ Since 2.24
</parameter>
</parameters>
<return> a new tuple #GVariantType
+
+Since 2.24
</return>
</function>
@@ -43582,7 +49978,6 @@ 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>
@@ -43592,6 +49987,8 @@ Since 2.24
</parameter>
</parameters>
<return> the next #GVariantType after @type, or %NULL
+
+Since 2.24
</return>
</function>
@@ -43603,7 +50000,6 @@ 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>
@@ -43613,6 +50009,8 @@ Since 2.24
</parameter>
</parameters>
<return> the corresponding type string (not nul-terminated)
+
+Since 2.24
</return>
</function>
@@ -43622,7 +50020,6 @@ 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>
@@ -43632,6 +50029,8 @@ Since 2.24
</parameter>
</parameters>
<return> %TRUE if @type_string is exactly one valid type string
+
+Since 2.24
</return>
</function>
@@ -43669,6 +50068,7 @@ Since: 2.24
</parameter>
</parameters>
<return> %TRUE if a valid type string was found
+
</return>
</function>
@@ -43678,7 +50078,6 @@ 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>
@@ -43688,6 +50087,8 @@ Since 2.24
</parameter>
</parameters>
<return> the value type of the dictionary entry
+
+Since 2.24
</return>
</function>
@@ -43866,6 +50267,226 @@ Since: 2.2
</return>
</function>
+<function name="g_wakeup_acknowledge">
+<description>
+Acknowledges receipt of a wakeup signal on @wakeup.
+
+You must call this after @wakeup polls as ready. If not, it will
+continue to poll as ready until you do so.
+
+If you call this function and @wakeup is not signaled, nothing
+happens.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="wakeup">
+<parameter_description> a #GWakeup
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_wakeup_free">
+<description>
+Frees @wakeup.
+
+You must not currently be polling on the #GPollFD returned by
+g_wakeup_get_pollfd(), or the result is undefined.
+
+</description>
+<parameters>
+<parameter name="wakeup">
+<parameter_description> a #GWakeup
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_wakeup_get_pollfd">
+<description>
+Prepares a @poll_fd such that polling on it will succeed when
+g_wakeup_signal() has been called on @wakeup.
+
+ poll_fd is valid until @wakeup is freed.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="wakeup">
+<parameter_description> a #GWakeup
+</parameter_description>
+</parameter>
+<parameter name="poll_fd">
+<parameter_description> a #GPollFD
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_wakeup_new">
+<description>
+Creates a new #GWakeup.
+
+You should use g_wakeup_free() to free it when you are done.
+
+Since: 2.30
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GWakeup
+
+</return>
+</function>
+
+<function name="g_wakeup_signal">
+<description>
+Signals @wakeup.
+
+Any future (or present) polling on the #GPollFD returned by
+g_wakeup_get_pollfd() will immediately succeed until such a time as
+g_wakeup_acknowledge() is called.
+
+This function is safe to call from a UNIX signal handler.
+
+Since: 2.30
+
+</description>
+<parameters>
+<parameter name="wakeup">
+<parameter_description> a #GWakeup
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_warning">
+<description>
+A convenience function/macro to log a warning message.
+
+You can make warnings fatal at runtime by setting the
+<envar>G_DEBUG</envar> environment variable (see
+<ulink url="glib-running.html">Running GLib Applications</ulink>).
+
+</description>
+<parameters>
+<parameter name="Varargs">
+<parameter_description> format string, followed by parameters to insert
+into the format string (as with printf())
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_weak_ref_clear">
+<description>
+Frees resources associated with a non-statically-allocated #GWeakRef.
+After this call, the #GWeakRef is left in an undefined state.
+
+You should only call this on a #GWeakRef that previously had
+g_weak_ref_init() called on it.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="weak_ref">
+<parameter_description> location of a weak reference, which
+may be empty
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_weak_ref_get">
+<description>
+If @weak_ref is not empty, atomically acquire a strong
+reference to the object it points to, and return that reference.
+
+This function is needed because of the potential race between taking
+the pointer value and g_object_ref() on it, if the object was losing
+its last reference at the same time in a different thread.
+
+The caller should release the resulting reference in the usual way,
+by using g_object_unref().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="weak_ref">
+<parameter_description> location of a weak reference to a #GObject
+</parameter_description>
+</parameter>
+</parameters>
+<return> the object pointed to
+by @weak_ref, or %NULL if it was empty
+
+</return>
+</function>
+
+<function name="g_weak_ref_init">
+<description>
+Initialise a non-statically-allocated #GWeakRef.
+
+This function also calls g_weak_ref_set() with @object on the
+freshly-initialised weak reference.
+
+This function should always be matched with a call to
+g_weak_ref_clear(). It is not necessary to use this function for a
+#GWeakRef in static storage because it will already be
+properly initialised. Just use g_weak_ref_set() directly.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="weak_ref">
+<parameter_description> uninitialized or empty location for a weak
+reference
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_weak_ref_set">
+<description>
+Change the object to which @weak_ref points, or set it to
+%NULL.
+
+You must own a strong reference on @object while calling this
+function.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="weak_ref">
+<parameter_description> location for a weak reference
+</parameter_description>
+</parameter>
+<parameter name="object">
+<parameter_description> a #GObject or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_win32_error_message">
<description>
Translate a Win32 error code (as returned by GetLastError()) into
@@ -44040,7 +50661,7 @@ and zero on NT-based systems. Since version 2.14, GLib works only
on NT-based systems, so checking whether your are running on Win9x
in your own software is moot. The least significant byte is 4 on
Windows NT 4, and 5 on Windows XP. Software that needs really
-detailled version and feature information should use Win32 API like
+detailed version and feature information should use Win32 API like
GetVersionEx() and VerifyVersionInfo().
Since: 2.6
@@ -44108,6 +50729,164 @@ failure and lack of short names.
</return>
</function>
+<function name="gboolean">
+<description>
+A standard boolean type.
+Variables of this type should only contain the value
+%TRUE or %FALSE.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gchar">
+<description>
+Corresponds to the standard C <type>char</type> type.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gconstpointer">
+<description>
+An untyped pointer to constant data.
+The data pointed to should not be changed.
+
+This is typically used in function prototypes to indicate
+that the data pointed to will not be altered by the function.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gdouble">
+<description>
+Corresponds to the standard C <type>double</type> type.
+Values of this type can range from -#G_MAXDOUBLE to #G_MAXDOUBLE.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gfloat">
+<description>
+Corresponds to the standard C <type>float</type> type.
+Values of this type can range from -#G_MAXFLOAT to #G_MAXFLOAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gint">
+<description>
+Corresponds to the standard C <type>int</type> type.
+Values of this type can range from #G_MININT to #G_MAXINT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gint16">
+<description>
+A signed integer guaranteed to be 16 bits on all platforms.
+Values of this type can range from #G_MININT16 (= -32,768) to
+#G_MAXINT16 (= 32,767).
+
+To print or scan values of this type, use
+%G_GINT16_MODIFIER and/or %G_GINT16_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gint32">
+<description>
+A signed integer guaranteed to be 32 bits on all platforms.
+Values of this type can range from #G_MININT32 (= -2,147,483,648)
+to #G_MAXINT32 (= 2,147,483,647).
+
+To print or scan values of this type, use
+%G_GINT32_MODIFIER and/or %G_GINT32_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gint64">
+<description>
+A signed integer guaranteed to be 64 bits on all platforms.
+Values of this type can range from #G_MININT64
+(= -9,223,372,036,854,775,808) to #G_MAXINT64
+(= 9,223,372,036,854,775,807).
+
+To print or scan values of this type, use
+%G_GINT64_MODIFIER and/or %G_GINT64_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gint8">
+<description>
+A signed integer guaranteed to be 8 bits on all platforms.
+Values of this type can range from #G_MININT8 (= -128) to
+#G_MAXINT8 (= 127).
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gintptr">
+<description>
+Corresponds to the C99 type <type>intptr_t</type>,
+a signed integer type that can hold any pointer.
+
+To print or scan values of this type, use
+%G_GINTPTR_MODIFIER and/or %G_GINTPTR_FORMAT.
+
+Since: 2.18
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="glib__private__">
+<description>
+Do not call this function; it is used to share private
+API between glib, gobject, and gio.
+
+</description>
+<parameters>
+<parameter name="arg">
+<parameter_description> Do not use this argument
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="glib_check_version">
<description>
Checks that the GLib library in use is compatible with the
@@ -44203,8 +50982,207 @@ by a \004 character
</parameter_description>
</parameter>
</parameters>
-<return> the transation of @str to the current locale
+<return> the translation of @str to the current locale
</return>
</function>
+<function name="glong">
+<description>
+Corresponds to the standard C <type>long</type> type.
+Values of this type can range from #G_MINLONG to #G_MAXLONG.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="goffset">
+<description>
+A signed integer type that is used for file offsets,
+corresponding to the C99 type <type>off64_t</type>.
+Values of this type can range from #G_MINOFFSET to
+#G_MAXOFFSET.
+
+To print or scan values of this type, use
+%G_GOFFSET_MODIFIER and/or %G_GOFFSET_FORMAT.
+
+Since: 2.14
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gpointer">
+<description>
+An untyped pointer.
+#gpointer looks better and is easier to use
+than <type>void*</type>.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gshort">
+<description>
+Corresponds to the standard C <type>short</type> type.
+Values of this type can range from #G_MINSHORT to #G_MAXSHORT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gsize">
+<description>
+An unsigned integer type of the result of the sizeof operator,
+corresponding to the <type>size_t</type> type defined in C99.
+This type is wide enough to hold the numeric value of a pointer,
+so it is usually 32bit wide on a 32bit platform and 64bit wide
+on a 64bit platform. Values of this type can range from 0 to
+#G_MAXSIZE.
+
+To print or scan values of this type, use
+%G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gssize">
+<description>
+A signed variant of #gsize, corresponding to the
+<type>ssize_t</type> defined on most platforms.
+Values of this type can range from #G_MINSSIZE
+to #G_MAXSSIZE.
+
+To print or scan values of this type, use
+%G_GSIZE_MODIFIER and/or %G_GSSIZE_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guchar">
+<description>
+Corresponds to the standard C <type>unsigned char</type> type.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guint">
+<description>
+Corresponds to the standard C <type>unsigned int</type> type.
+Values of this type can range from 0 to #G_MAXUINT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guint16">
+<description>
+An unsigned integer guaranteed to be 16 bits on all platforms.
+Values of this type can range from 0 to #G_MAXUINT16 (= 65,535).
+
+To print or scan values of this type, use
+%G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guint32">
+<description>
+An unsigned integer guaranteed to be 32 bits on all platforms.
+Values of this type can range from 0 to #G_MAXUINT32 (= 4,294,967,295).
+
+To print or scan values of this type, use
+%G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guint64">
+<description>
+An unsigned integer guaranteed to be 64 bits on all platforms.
+Values of this type can range from 0 to #G_MAXUINT64
+(= 18,446,744,073,709,551,615).
+
+To print or scan values of this type, use
+%G_GINT64_MODIFIER and/or %G_GUINT64_FORMAT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guint8">
+<description>
+An unsigned integer guaranteed to be 8 bits on all platforms.
+Values of this type can range from 0 to #G_MAXUINT8 (= 255).
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="guintptr">
+<description>
+Corresponds to the C99 type <type>uintptr_t</type>,
+an unsigned integer type that can hold any pointer.
+
+To print or scan values of this type, use
+%G_GINTPTR_MODIFIER and/or %G_GUINTPTR_FORMAT.
+
+Since: 2.18
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gulong">
+<description>
+Corresponds to the standard C <type>unsigned long</type> type.
+Values of this type can range from 0 to #G_MAXULONG.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gushort">
+<description>
+Corresponds to the standard C <type>unsigned short</type> type.
+Values of this type can range from 0 to #G_MAXUSHORT.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
</root>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
