+2.49.7:
+
+Gio
+* AppInfo: Add launch_default_for_uri_async().
+ (Murray Cumming)
+* Application::get_busy(): return the bool.
+ (Murray Cumming) Bug #770304
+* Drive: Add is_removable().
+ (Murray Cumming)
+* Settings:
+ - set_uiint(): Deprecate for set_uint().
+ - Add get/set_uint64().
+ - Add get/set_int64().
+ (Murray Cumming)
+* giomm.h: Add include for settingsschemasource.h
+ (Murray Cumming)
+
+Documentation:
+* Glib::OptionGroup: Improve the documentation of add_entry()
+ (Kjell Ahlstedt)
+
+
+2.49.5:
+
+Glib:
+* OptionContext: Wrap g_option_context_parse_strv()
+ (Kjell Ahlstedt)
+
+gmmproc:
+* Add DocsParser::remove_c_memory_handling_info()
+ (Kjell Ahlstedt)
+* Add missing objects to glib/gio_extra_objects.defs
+ (Kjell Ahlstedt)
+* Remove DocsParser::non_object_method_name()
+ (Kjell Ahlstedt)
+* swap() implementations: Use std::swap().
+ (Murray Cumming <murrayc@murrayc.com>
+
+Documentation:
+* Gio::SocketService: Update the class documentation
+ (Kjell Ahlstedt)
+
2.49.4:
glib:
## You should have received a copy of the GNU Lesser General Public License
## along with this library. If not, see <http://www.gnu.org/licenses/>.
-AC_INIT([glibmm], [2.49.4],
+AC_INIT([glibmm], [2.49.7],
[http://bugzilla.gnome.org/enter_bug.cgi?product=glibmm],
[glibmm], [http://www.gtkmm.org/])
AC_PREREQ([2.59])
AC_DEFINE([GIOMM_STATIC_LIB], [1], [Define if giomm is built as a static library])
])
-glibreq='2.0 >= 2.48.0'
+glibreq='2.0 >= 2.49.7'
GLIBMM_MODULES="sigc++-2.0 >= 2.9.1 glib-$glibreq gobject-$glibreq gmodule-$glibreq"
GIOMM_MODULES="$GLIBMM_MODULES gio-$glibreq"
#include <giomm/settings.h>
#include <giomm/settingsschema.h>
#include <giomm/settingsschemakey.h>
+#include <giomm/settingsschemasource.h>
#include <giomm/simpleaction.h>
#include <giomm/simpleactiongroup.h>
#include <giomm/simpleiostream.h>
#include <giomm/file.h>
#include <glibmm/listhandle.h>
#include <glibmm/vectorutils.h>
+#include "slot_async.h"
#include <gio/gio.h>
namespace Gio
_CONFIGINCLUDE(giommconfig.h)
#include <giomm/applaunchcontext.h>
+#include <giomm/asyncresult.h>
+#include <giomm/cancellable.h>
#include <exception>
_WRAP_METHOD(static void reset_type_associations(const std::string& content_type), g_app_info_reset_type_associations)
_WRAP_METHOD(static bool launch_default_for_uri(const std::string& uri, const Glib::RefPtr<AppLaunchContext>& launch_context{?}), g_app_info_launch_default_for_uri, errthrow)
+ _WRAP_METHOD(static void launch_default_for_uri_async(const std::string& uri, const Glib::RefPtr<AppLaunchContext>& launch_context{.?},
+ const SlotAsyncReady& slot{callback?}, const Glib::RefPtr<Cancellable>& cancellable{.?}), g_app_info_launch_default_for_uri_async, slot_name slot, slot_callback SignalProxy_async_callback)
+ _IGNORE(g_app_info_launch_default_for_uri_async)
+ _WRAP_METHOD(static bool launch_default_for_uri_finish(const Glib::RefPtr<AsyncResult>& result), g_app_info_launch_default_for_uri_finish, errthrow)
+
protected:
//_WRAP_VFUNC(Glib::RefPtr<AppInfo> dup(), "dup")
//_WRAP_VFUNC(bool equal(const Glib::RefPtr<AppInfo>& appinfo2), "equal")
_WRAP_METHOD(void mark_busy(), g_application_mark_busy)
_WRAP_METHOD(void unmark_busy(), g_application_unmark_busy)
- _WRAP_METHOD(void get_is_busy() const, g_application_get_is_busy)
+ _WRAP_METHOD(bool get_is_busy() const, g_application_get_is_busy)
_WRAP_METHOD(void send_notification(const Glib::ustring& id{?}, const Glib::RefPtr<Notification>& notification), g_application_send_notification)
_WRAP_METHOD(void withdraw_notification(const Glib::ustring& id), g_application_withdraw_notification)
public:
+ /** Gets the list of arguments that was passed on the command line.
+ *
+ * The strings in the array may contain non-UTF-8 data on UNIX (such as
+ * filenames or arguments given in the system locale) but are always in
+ * UTF-8 on Windows.
+ *
+ * If you wish to use the return value with Glib::OptionContext, you must
+ * use Glib::OptionContext::parse(char**& argv).
+ *
+ * The return value is nullptr-terminated and should be freed using
+ * g_strfreev().
+ *
+ * @newin{2,28}
+ *
+ * @param[out] argc The length of the arguments array.
+ * @return The string array containing the arguments (the argv).
+ */
_WRAP_METHOD(char** get_arguments(int& argc) const, g_application_command_line_get_arguments)
//TODO: Wrap the GVariantDict*. See also Application's handle-local-options signal.
_WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<Volume> > get_volumes(), g_drive_get_volumes)
_WRAP_METHOD(bool is_media_removable() const, g_drive_is_media_removable)
+ _WRAP_METHOD(bool is_removable() const, g_drive_is_removable)
_WRAP_METHOD(bool has_media() const, g_drive_has_media)
_WRAP_METHOD(bool is_media_check_automatic() const, g_drive_is_media_check_automatic)
_WRAP_METHOD(bool can_poll_for_media() const, g_drive_can_poll_for_media)
</parameter_description>
</parameter>
<parameter name="G_CREDENTIALS_TYPE_LINUX_UCRED">
-<parameter_description> The native credentials type is a <type>struct ucred</type>.
+<parameter_description> The native credentials type is a struct ucred.
</parameter_description>
</parameter>
<parameter name="G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED">
-<parameter_description> The native credentials type is a <type>struct cmsgcred</type>.
+<parameter_description> The native credentials type is a struct cmsgcred.
</parameter_description>
</parameter>
<parameter name="G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED">
-<parameter_description> The native credentials type is a <type>struct sockpeercred</type>. Added in 2.30.
+<parameter_description> The native credentials type is a struct sockpeercred. Added in 2.30.
</parameter_description>
</parameter>
<parameter name="G_CREDENTIALS_TYPE_SOLARIS_UCRED">
-<parameter_description> The native credentials type is a <type>ucred_t</type>. Added in 2.40.
+<parameter_description> The native credentials type is a ucred_t. Added in 2.40.
</parameter_description>
</parameter>
<parameter name="G_CREDENTIALS_TYPE_NETBSD_UNPCBID">
-<parameter_description> The native credentials type is a <type>struct unpcbid</type>.
+<parameter_description> The native credentials type is a struct unpcbid.
</parameter_description>
</parameter>
</parameters>
<description>
Emitted when @file has been changed.
-If using %G_FILE_MONITOR_WATCH_RENAMES on a directory monitor, and
+If using %G_FILE_MONITOR_WATCH_MOVES on a directory monitor, and
the information is available (and if supported by the backend),
@event_type may be %G_FILE_MONITOR_EVENT_RENAMED,
%G_FILE_MONITOR_EVENT_MOVED_IN or %G_FILE_MONITOR_EVENT_MOVED_OUT.
%G_FILE_MONITOR_EVENT_DELETED, with extra information.
%G_FILE_MONITOR_EVENT_RENAMED is equivalent to a delete/create
pair. This is exactly how the events will be reported in the case
-that the %G_FILE_MONITOR_WATCH_RENAMES flag is not in use.
+that the %G_FILE_MONITOR_WATCH_MOVES flag is not in use.
If using the deprecated flag %G_FILE_MONITOR_SEND_MOVED flag and @event_type is
#G_FILE_MONITOR_EVENT_MOVED, @file will be set to a #GFile containing the
detailed signal "changed::x" in order to only receive callbacks
when key "x" changes.
+Note that @settings only emits this signal if you have read @key at
+least once while a signal handler was already connected for @key.
+
</description>
<parameters>
<parameter name="settings">
</description>
</property>
+<signal name="GXdpDocuments::handle-add">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</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 gxdp_documents_complete_add() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_fd">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-add-named">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</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 gxdp_documents_complete_add_named() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_parent_fd">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-delete">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</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 gxdp_documents_complete_delete() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-get-mount-point">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</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 gxdp_documents_complete_get_mount_point() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-grant-permissions">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</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 gxdp_documents_complete_grant_permissions() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-info">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</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 gxdp_documents_complete_info() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-list">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</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 gxdp_documents_complete_list() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-lookup">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</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 gxdp_documents_complete_lookup() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpDocuments::handle-revoke-permissions">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</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 gxdp_documents_complete_revoke_permissions() 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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
+<signal name="GXdpNetworkMonitor::changed">
+<description>
+On the client-side, this signal is emitted whenever the D-Bus signal <link linkend="gdbus-signal-org-freedesktop-portal-NetworkMonitor.changed">"changed"</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="object">
+<parameter_description> A #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+<parameter name="arg_available">
+<parameter_description> Argument.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<property name="GXdpNetworkMonitor:available">
+<description>
+Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</link>.
+
+Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
+
+</description>
+</property>
+
+<property name="GXdpNetworkMonitor:connectivity">
+<description>
+Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</link>.
+
+Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
+
+</description>
+</property>
+
+<property name="GXdpNetworkMonitor:metered">
+<description>
+Represents the D-Bus property <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</link>.
+
+Since the D-Bus property for this #GObject property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
+
+</description>
+</property>
+
+<signal name="GXdpProxyResolver::handle-lookup">
+<description>
+Signal emitted when a remote caller is invoking the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</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 gxdp_proxy_resolver_complete_lookup() 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 #GXdpProxyResolver.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_uri">
+<parameter_description> Argument passed by remote caller.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the invocation was handled, %FALSE to let other signal handlers run.
+</return>
+</signal>
+
<property name="GZlibCompressor:file-info">
<description>
If set to a non-%NULL #GFileInfo object, and #GZlibCompressor:format is
It is an error to call this function with an invalid action name.
-This function is the opposite of
-g_action_parse_detailed_action_name(). It will produce a string that
-can be parsed back to the @action_name and @target_value by that
-function.
+This function is the opposite of g_action_parse_detailed_name().
+It will produce a string that can be parsed back to the @action_name
+and @target_value by that function.
See that function for the types of strings that will be printed by
this function.
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the @appinfo's commandline,
+<return> a string containing the @appinfo's commandline,
or %NULL if this information is not available
</return>
</parameter_description>
</parameter>
</parameters>
-<return> a string containing the @appinfo's application
+<return> a string containing the @appinfo's application
binaries name
</return>
</function>
</parameter_description>
</parameter>
<parameter name="launch_context">
-<parameter_description> an optional #GAppLaunchContext.
+<parameter_description> an optional #GAppLaunchContext
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a #GError.
+<parameter_description> return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
</return>
</function>
+<function name="g_app_info_launch_default_for_uri_async">
+<description>
+Async version of g_app_info_launch_default_for_uri().
+
+This version is useful if you are interested in receiving
+error information in the case where the application is
+sandboxed and the portal may present an application chooser
+dialog to the user.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="uri">
+<parameter_description> the uri to show
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> an optional #GAppLaunchContext
+cancellable: (allow-none): a #GCancellable
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GASyncReadyCallback to call when the request is done
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data to pass to @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_app_info_launch_default_for_uri_finish">
+<description>
+Finishes an asynchronous launch-default-for-uri operation.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for an error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the launch was successful, %FALSE if @error is set
+
+</return>
+</function>
+
<function name="g_app_info_launch_uris">
<description>
Launches the application. This passes the @uris to the launched application
</parameter_description>
</parameter>
<parameter name="extension">
-<parameter_description> a string containing the file extension (without the dot).
+<parameter_description> a string containing the file extension
+(without the dot).
</parameter_description>
</parameter>
<parameter name="error">
</description>
<parameters>
<parameter name="object_path">
-<parameter_description> The object path to export the manager object at, which should
-not be `/`.
+<parameter_description> The object path to export the manager object at.
</parameter_description>
</parameter>
</parameters>
</parameter_description>
</parameter>
</parameters>
-<return> The full path to the file for @info, or %NULL if not known.
+<return> The full path to the file for @info,
+or %NULL if not known.
</return>
</function>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> the path of a desktop file, in the GLib filename encoding
+<parameter_description> the path of a desktop file, in the GLib
+filename encoding
</parameter_description>
</parameter>
</parameters>
</return>
</function>
+<function name="g_drive_is_removable">
+<description>
+Checks if the #GDrive and/or its media is considered removable by the user.
+See g_drive_is_media_removable().
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="drive">
+<parameter_description> a #GDrive.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @drive and/or its media is considered removable, %FALSE otherwise.
+
+</return>
+</function>
+
<function name="g_drive_poll_for_media">
<description>
Asynchronously polls @drive to see if media has been inserted or removed.
requires allocation of a temporary #GError.
In contrast, with this function, a %FALSE return from
-gs_file_enumerator_iterate() *always* means
+g_file_enumerator_iterate() *always* means
"error". End of iteration is signaled by @out_info or @out_child being %NULL.
Another crucial difference is that the references for @out_info and
</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> 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>
</parameter_description>
</parameter>
</parameters>
-<return> string containing the #GFile's path, or %NULL
-if no such path exists. The returned string should be freed
+<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>
</parameter_description>
</parameter>
</parameters>
-<return> string with the relative path from @descendant
-to @parent, or %NULL if @descendant doesn't have @parent as
+<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>
</parameter_description>
</parameter>
<parameter name="symlink_value">
-<parameter_description> a string with the path for the target of the new symlink
+<parameter_description> a string with the path for the target
+of the new symlink
</parameter_description>
</parameter>
<parameter name="cancellable">
Creates a new #GInetSocketAddress for @address and @port.
If @address is an IPv6 address, it can also contain a scope ID
-(separated from the address by a "<literal>%</literal>").
+(separated from the address by a `%`).
Since: 2.40
</description>
<parameters>
<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to load.
+<parameter_description> pathname for a directory containing modules
+to load.
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to load.
+<parameter_description> pathname for a directory containing modules
+to load.
</parameter_description>
</parameter>
<parameter name="scope">
</description>
<parameters>
<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to scan.
+<parameter_description> pathname for a directory containing modules
+to scan.
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="dirname">
-<parameter_description> pathname for a directory containing modules to scan.
+<parameter_description> pathname for a directory containing modules
+to scan.
</parameter_description>
</parameter>
<parameter name="scope">
</return>
</function>
+<function name="g_settings_get_int64">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for 64-bit integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a int64 type in the schema for @settings.
+
+Since: 2.50
+
+</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 64-bit integer
+
+</return>
+</function>
+
<function name="g_settings_get_mapped">
<description>
Gets the value that is stored at @key in @settings, subject to
</return>
</function>
+<function name="g_settings_get_uint64">
+<description>
+Gets the value that is stored at @key in @settings.
+
+A convenience variant of g_settings_get() for 64-bit unsigned
+integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a uint64 type in the schema for @settings.
+
+Since: 2.50
+
+</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 64-bit unsigned integer
+
+</return>
+</function>
+
<function name="g_settings_get_user_value">
<description>
Checks the "user value" of a key, if there is one.
</return>
</function>
+<function name="g_settings_set_int64">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for 64-bit integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a int64 type in the schema for @settings.
+
+Since: 2.50
+
+</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.
</return>
</function>
+<function name="g_settings_set_uint64">
+<description>
+Sets @key in @settings to @value.
+
+A convenience variant of g_settings_set() for 64-bit unsigned
+integers.
+
+It is a programmer error to give a @key that isn't specified as
+having a uint64 type in the schema for @settings.
+
+Since: 2.50
+
+</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.
New listeners can be added with e.g. g_socket_listener_add_address()
or g_socket_listener_add_inet_port().
+New services are created active, there is no need to call
+g_socket_service_start(), unless g_socket_service_stop() has been
+called before.
+
Since: 2.22
</description>
<function name="g_socket_service_start">
<description>
-Starts the service, i.e. start accepting connections
-from the added sockets when the mainloop runs.
+Restarts the service, i.e. start accepting connections
+from the added sockets when the mainloop runs. This only needs
+to be called after the service has been stopped from
+g_socket_service_stop().
This call is thread-safe, so it may be called from a thread
handling an incoming client request.
close the listening sockets, call g_socket_listener_close(). (This
will happen automatically when the #GSocketService is finalized.)
+This must be called before calling g_socket_listener_close() as
+the socket service will start accepting connections immediately
+when a new socket is added.
+
Since: 2.22
</description>
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a filename or %NULL
+<parameter_description> (type filename) (nullable: a filename or %NULL
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="cert_file">
-<parameter_description> file containing one or more PEM-encoded certificates to
-import
+<parameter_description> file containing one or more PEM-encoded
+certificates to import
</parameter_description>
</parameter>
<parameter name="key_file">
-<parameter_description> file containing a PEM-encoded private key to import
+<parameter_description> file containing a PEM-encoded private key
+to import
</parameter_description>
</parameter>
<parameter name="error">
</return>
</function>
+<function name="g_vfs_register_uri_scheme">
+<description>
+Registers @uri_func and @parse_name_func as the #GFile URI and parse name
+lookup functions for URIs with a scheme matching @scheme.
+Note that @scheme is registered only within the running application, as
+opposed to desktop-wide as it happens with GVfs backends.
+
+When a #GFile is requested with an URI containing @scheme (e.g. through
+g_file_new_for_uri()), @uri_func will be called to allow a custom
+constructor. The implementation of @uri_func should not be blocking, and
+must not call g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme().
+
+When g_file_parse_name() is called with a parse name obtained from such file,
+@parse_name_func will be called to allow the #GFile to be created again. In
+that case, it's responsibility of @parse_name_func to make sure the parse
+name matches what the custom #GFile implementation returned when
+g_file_get_parse_name() was previously called. The implementation of
+@parse_name_func should not be blocking, and must not call
+g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme().
+
+It's an error to call this function twice with the same scheme. To unregister
+a custom URI scheme, use g_vfs_unregister_uri_scheme().
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="vfs">
+<parameter_description> a #GVfs
+</parameter_description>
+</parameter>
+<parameter name="scheme">
+<parameter_description> an URI scheme, e.g. "http"
+</parameter_description>
+</parameter>
+<parameter name="uri_func">
+<parameter_description> a #GVfsFileLookupFunc
+</parameter_description>
+</parameter>
+<parameter name="uri_data">
+<parameter_description> custom data passed to be passed to @uri_func, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="uri_destroy">
+<parameter_description> function to be called when unregistering the
+URI scheme, or when @vfs is disposed, to free the resources used
+by the URI lookup function
+</parameter_description>
+</parameter>
+<parameter name="parse_name_func">
+<parameter_description> a #GVfsFileLookupFunc
+</parameter_description>
+</parameter>
+<parameter name="parse_name_data">
+<parameter_description> custom data passed to be passed to
+@parse_name_func, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="parse_name_destroy">
+<parameter_description> function to be called when unregistering the
+URI scheme, or when @vfs is disposed, to free the resources used
+by the parse name lookup function
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @scheme was successfully registered, or %FALSE if a handler
+for @scheme already exists.
+
+</return>
+</function>
+
+<function name="g_vfs_unregister_uri_scheme">
+<description>
+Unregisters the URI handler for @scheme previously registered with
+g_vfs_register_uri_scheme().
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="vfs">
+<parameter_description> a #GVfs
+</parameter_description>
+</parameter>
+<parameter name="scheme">
+<parameter_description> an URI scheme, e.g. "http"
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @scheme was successfully unregistered, or %FALSE if a
+handler for @scheme does not exist.
+
+</return>
+</function>
+
<function name="g_volume_can_eject">
<description>
Checks if a volume can be ejected.
</return>
</function>
+<function name="gxdp_documents_call_add">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</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 gxdp_documents_call_add_finish() to get the result of the operation.
+
+See gxdp_documents_call_add_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_fd">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<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="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="gxdp_documents_call_add_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_add().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_doc_id">
+<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> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_add_named">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</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 gxdp_documents_call_add_named_finish() to get the result of the operation.
+
+See gxdp_documents_call_add_named_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_parent_fd">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<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="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="gxdp_documents_call_add_named_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_add_named().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_doc_id">
+<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> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_add_named().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_add_named_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_add_named() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_parent_fd">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<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_doc_id">
+<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> 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 call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_add_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_add() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_o_path_fd">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_reuse_existing">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_persistent">
+<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_doc_id">
+<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> 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 call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_delete">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</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 gxdp_documents_call_delete_finish() to get the result of the operation.
+
+See gxdp_documents_call_delete_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_delete_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_delete().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_delete().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_delete_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_delete() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<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="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_get_mount_point">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</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 gxdp_documents_call_get_mount_point_finish() to get the result of the operation.
+
+See gxdp_documents_call_get_mount_point_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</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="gxdp_documents_call_get_mount_point_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_get_mount_point().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_path">
+<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 gxdp_documents_call_get_mount_point().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_get_mount_point_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_get_mount_point() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_path">
+<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> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_grant_permissions">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</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 gxdp_documents_call_grant_permissions_finish() to get the result of the operation.
+
+See gxdp_documents_call_grant_permissions_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_grant_permissions_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_grant_permissions().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_grant_permissions().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_grant_permissions_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_grant_permissions() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<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="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_info">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</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 gxdp_documents_call_info_finish() to get the result of the operation.
+
+See gxdp_documents_call_info_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_info_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_info().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_path">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_apps">
+<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 gxdp_documents_call_info().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_info_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_info() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_path">
+<parameter_description> Return location for return parameter or %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="out_apps">
+<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> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_list">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</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 gxdp_documents_call_list_finish() to get the result of the operation.
+
+See gxdp_documents_call_list_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_list_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_list().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_docs">
+<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 gxdp_documents_call_list().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_list_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_list() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_docs">
+<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> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_lookup">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</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 gxdp_documents_call_lookup_finish() to get the result of the operation.
+
+See gxdp_documents_call_lookup_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_lookup_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_lookup().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_doc_id">
+<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 gxdp_documents_call_lookup().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_lookup_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_lookup() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_filename">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_doc_id">
+<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> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_revoke_permissions">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</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 gxdp_documents_call_revoke_permissions_finish() to get the result of the operation.
+
+See gxdp_documents_call_revoke_permissions_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<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></return>
+</function>
+
+<function name="gxdp_documents_call_revoke_permissions_finish">
+<description>
+Finishes an operation started with gxdp_documents_call_revoke_permissions().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_call_revoke_permissions().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_call_revoke_permissions_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_documents_call_revoke_permissions() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpDocumentsProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_doc_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_app_id">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="arg_permissions">
+<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="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_complete_add">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Add">Add()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="doc_id">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_add_named">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.AddNamed">AddNamed()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="fd_list">
+<parameter_description> A #GUnixFDList or %NULL.
+</parameter_description>
+</parameter>
+<parameter name="doc_id">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_delete">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Delete">Delete()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_get_mount_point">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GetMountPoint">GetMountPoint()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_grant_permissions">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.GrantPermissions">GrantPermissions()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_info">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Info">Info()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+<parameter name="apps">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_list">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.List">List()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="docs">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_lookup">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.Lookup">Lookup()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="doc_id">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_complete_revoke_permissions">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-Documents.RevokePermissions">RevokePermissions()</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 #GXdpDocuments.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_documents_interface_info">
+<description>
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link> D-Bus interface.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="gxdp_documents_override_properties">
+<description>
+Overrides all #GObject properties in the #GXdpDocuments 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="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>
+
+<function name="gxdp_documents_proxy_new">
+<description>
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</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 gxdp_documents_proxy_new_finish() to get the result of the operation.
+
+See gxdp_documents_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 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="gxdp_documents_proxy_new_finish">
+<description>
+Finishes an operation started with gxdp_documents_proxy_new().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_proxy_new().
+</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.
+</return>
+</function>
+
+<function name="gxdp_documents_proxy_new_for_bus">
+<description>
+Like gxdp_documents_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 gxdp_documents_proxy_new_for_bus_finish() to get the result of the operation.
+
+See gxdp_documents_proxy_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 #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="gxdp_documents_proxy_new_for_bus_finish">
+<description>
+Finishes an operation started with gxdp_documents_proxy_new_for_bus().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_documents_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.
+</return>
+</function>
+
+<function name="gxdp_documents_proxy_new_for_bus_sync">
+<description>
+Like gxdp_documents_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_documents_proxy_new_for_bus() for the asynchronous 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 #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> The constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_proxy_new_sync">
+<description>
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_documents_proxy_new() for the asynchronous 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 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 constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_documents_skeleton_new">
+<description>
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-Documents.top_of_page">org.freedesktop.portal.Documents</link>.
+
+
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_emit_changed">
+<description>
+Emits the <link linkend="gdbus-signal-org-freedesktop-portal-NetworkMonitor.changed">"changed"</link> D-Bus signal.
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> A #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+<parameter name="arg_available">
+<parameter_description> Argument to pass with the signal.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_network_monitor_get_available">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_get_connectivity">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_get_metered">
+<description>
+Gets the value of the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+</parameters>
+<return> The property value.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_interface_info">
+<description>
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link> D-Bus interface.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_override_properties">
+<description>
+Overrides all #GObject properties in the #GXdpNetworkMonitor 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="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>
+
+<function name="gxdp_network_monitor_proxy_new">
+<description>
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</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 gxdp_network_monitor_proxy_new_finish() to get the result of the operation.
+
+See gxdp_network_monitor_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 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="gxdp_network_monitor_proxy_new_finish">
+<description>
+Finishes an operation started with gxdp_network_monitor_proxy_new().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_proxy_new().
+</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.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_proxy_new_for_bus">
+<description>
+Like gxdp_network_monitor_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 gxdp_network_monitor_proxy_new_for_bus_finish() to get the result of the operation.
+
+See gxdp_network_monitor_proxy_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 #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="gxdp_network_monitor_proxy_new_for_bus_finish">
+<description>
+Finishes an operation started with gxdp_network_monitor_proxy_new_for_bus().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_network_monitor_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.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_proxy_new_for_bus_sync">
+<description>
+Like gxdp_network_monitor_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_network_monitor_proxy_new_for_bus() for the asynchronous 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 #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> The constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_proxy_new_sync">
+<description>
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_network_monitor_proxy_new() for the asynchronous 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 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 constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_network_monitor_set_available">
+<description>
+Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.available">"available"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_network_monitor_set_connectivity">
+<description>
+Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.connectivity">"connectivity"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_network_monitor_set_metered">
+<description>
+Sets the <link linkend="gdbus-property-org-freedesktop-portal-NetworkMonitor.metered">"metered"</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 #GXdpNetworkMonitor.
+</parameter_description>
+</parameter>
+<parameter name="value">
+<parameter_description> The value to set.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_network_monitor_skeleton_new">
+<description>
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-NetworkMonitor.top_of_page">org.freedesktop.portal.NetworkMonitor</link>.
+
+
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_call_lookup">
+<description>
+Asynchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</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 gxdp_proxy_resolver_call_lookup_finish() to get the result of the operation.
+
+See gxdp_proxy_resolver_call_lookup_sync() for the synchronous, blocking version of this method.
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpProxyResolverProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_uri">
+<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></return>
+</function>
+
+<function name="gxdp_proxy_resolver_call_lookup_finish">
+<description>
+Finishes an operation started with gxdp_proxy_resolver_call_lookup().
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpProxyResolverProxy.
+</parameter_description>
+</parameter>
+<parameter name="out_proxies">
+<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 gxdp_proxy_resolver_call_lookup().
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> Return location for error or %NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_call_lookup_sync">
+<description>
+Synchronously invokes the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</link> D-Bus method on @proxy. The calling thread is blocked until a reply is received.
+
+See gxdp_proxy_resolver_call_lookup() for the asynchronous version of this method.
+
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> A #GXdpProxyResolverProxy.
+</parameter_description>
+</parameter>
+<parameter name="arg_uri">
+<parameter_description> Argument to pass with the method invocation.
+</parameter_description>
+</parameter>
+<parameter name="out_proxies">
+<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> %TRUE if the call succeded, %FALSE if @error is set.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_complete_lookup">
+<description>
+Helper function used in service implementations to finish handling invocations of the <link linkend="gdbus-method-org-freedesktop-portal-ProxyResolver.Lookup">Lookup()</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 #GXdpProxyResolver.
+</parameter_description>
+</parameter>
+<parameter name="invocation">
+<parameter_description> A #GDBusMethodInvocation.
+</parameter_description>
+</parameter>
+<parameter name="proxies">
+<parameter_description> Parameter to return.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gxdp_proxy_resolver_interface_info">
+<description>
+Gets a machine-readable description of the <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link> D-Bus interface.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A #GDBusInterfaceInfo. Do not free.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_override_properties">
+<description>
+Overrides all #GObject properties in the #GXdpProxyResolver 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="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>
+
+<function name="gxdp_proxy_resolver_proxy_new">
+<description>
+Asynchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</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 gxdp_proxy_resolver_proxy_new_finish() to get the result of the operation.
+
+See gxdp_proxy_resolver_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 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="gxdp_proxy_resolver_proxy_new_finish">
+<description>
+Finishes an operation started with gxdp_proxy_resolver_proxy_new().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_proxy_new().
+</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.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_proxy_new_for_bus">
+<description>
+Like gxdp_proxy_resolver_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 gxdp_proxy_resolver_proxy_new_for_bus_finish() to get the result of the operation.
+
+See gxdp_proxy_resolver_proxy_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 #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="gxdp_proxy_resolver_proxy_new_for_bus_finish">
+<description>
+Finishes an operation started with gxdp_proxy_resolver_proxy_new_for_bus().
+
+
+</description>
+<parameters>
+<parameter name="res">
+<parameter_description> The #GAsyncResult obtained from the #GAsyncReadyCallback passed to gxdp_proxy_resolver_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.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_proxy_new_for_bus_sync">
+<description>
+Like gxdp_proxy_resolver_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_proxy_resolver_proxy_new_for_bus() for the asynchronous 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 #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> The constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_proxy_new_sync">
+<description>
+Synchronously creates a proxy for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link>. See g_dbus_proxy_new_sync() for more details.
+
+The calling thread is blocked until a reply is received.
+
+See gxdp_proxy_resolver_proxy_new() for the asynchronous 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 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 constructed proxy object or %NULL if @error is set.
+</return>
+</function>
+
+<function name="gxdp_proxy_resolver_skeleton_new">
+<description>
+Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-org-freedesktop-portal-ProxyResolver.top_of_page">org.freedesktop.portal.ProxyResolver</link>.
+
+
+</description>
+<parameters>
+</parameters>
+<return> The skeleton object.
+</return>
+</function>
+
</root>
;; G_IO_ERROR_BROKEN_PIPE,
;; G_IO_ERROR_CONNECTION_CLOSED = G_IO_ERROR_BROKEN_PIPE,
;; G_IO_ERROR_NOT_CONNECTED,
-;; G_IO_ERROR_MESSAGE_TOO_LARGE,
+;; G_IO_ERROR_MESSAGE_TOO_LARGE
;; } GIOErrorEnum;
(define-enum-extended IOErrorEnum
(gtype-id "G_TYPE_SETTINGS_SCHEMA_KEY")
)
+(define-object SettingsSchemaSource
+ (in-module "Gio")
+ (c-name "GSettingsSchemaSource")
+ (gtype-id "G_TYPE_SETTINGS_SCHEMA_SOURCE")
+)
+
(define-object SimpleAction
(in-module "Gio")
(c-name "GSimpleAction")
(gtype-id "G_TYPE_NETWORK_MONITOR_NM")
)
+(define-object MonitorPortal
+ (in-module "GNetwork")
+ (parent "GNetworkMonitorBase")
+ (c-name "GNetworkMonitorPortal")
+ (gtype-id "G_TYPE_NETWORK_MONITOR_PORTAL")
+)
+
(define-object Service
(in-module "GNetwork")
(parent "GObject")
(gtype-id "G_TYPE_WIN32_REGISTRY_KEY")
)
+(define-object Documents
+ (in-module "GXdp")
+ (c-name "GXdpDocuments")
+ (gtype-id "G_TYPE_XDP_DOCUMENTS")
+)
+
+(define-object DocumentsProxy
+ (in-module "GXdp")
+ (parent "GDBusProxy")
+ (c-name "GXdpDocumentsProxy")
+ (gtype-id "G_TYPE_XDP_DOCUMENTS_PROXY")
+)
+
+(define-object DocumentsSkeleton
+ (in-module "GXdp")
+ (parent "GDBusInterfaceSkeleton")
+ (c-name "GXdpDocumentsSkeleton")
+ (gtype-id "G_TYPE_XDP_DOCUMENTS_SKELETON")
+)
+
+(define-object NetworkMonitor
+ (in-module "GXdp")
+ (c-name "GXdpNetworkMonitor")
+ (gtype-id "G_TYPE_XDP_NETWORK_MONITOR")
+)
+
+(define-object NetworkMonitorProxy
+ (in-module "GXdp")
+ (parent "GDBusProxy")
+ (c-name "GXdpNetworkMonitorProxy")
+ (gtype-id "G_TYPE_XDP_NETWORK_MONITOR_PROXY")
+)
+
+(define-object NetworkMonitorSkeleton
+ (in-module "GXdp")
+ (parent "GDBusInterfaceSkeleton")
+ (c-name "GXdpNetworkMonitorSkeleton")
+ (gtype-id "G_TYPE_XDP_NETWORK_MONITOR_SKELETON")
+)
+
+(define-object ProxyResolver
+ (in-module "GXdp")
+ (c-name "GXdpProxyResolver")
+ (gtype-id "G_TYPE_XDP_PROXY_RESOLVER")
+)
+
+(define-object ProxyResolverProxy
+ (in-module "GXdp")
+ (parent "GDBusProxy")
+ (c-name "GXdpProxyResolverProxy")
+ (gtype-id "G_TYPE_XDP_PROXY_RESOLVER_PROXY")
+)
+
+(define-object ProxyResolverSkeleton
+ (in-module "GXdp")
+ (parent "GDBusInterfaceSkeleton")
+ (c-name "GXdpProxyResolverSkeleton")
+ (gtype-id "G_TYPE_XDP_PROXY_RESOLVER_SKELETON")
+)
+
;; Enumerations and flags ...
(define-enum AuthMechanismState
)
)
+(define-function g_app_info_launch_default_for_uri_async
+ (c-name "g_app_info_launch_default_for_uri_async")
+ (return-type "none")
+ (parameters
+ '("const-char*" "uri")
+ '("GAppLaunchContext*" "launch_context")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function g_app_info_launch_default_for_uri_finish
+ (c-name "g_app_info_launch_default_for_uri_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "result")
+ '("GError**" "error")
+ )
+)
+
(define-function g_app_launch_context_get_type
(c-name "g_app_launch_context_get_type")
(return-type "GType")
+;; From gdocumentportal.h
+
+(define-function g_document_portal_add_document
+ (c-name "g_document_portal_add_document")
+ (return-type "char*")
+ (parameters
+ '("GFile*" "file")
+ '("GError**" "error")
+ )
+)
+
+
+
;; From gdrive.h
(define-function g_drive_get_type
(return-type "GList*")
)
+(define-method is_removable
+ (of-object "GDrive")
+ (c-name "g_drive_is_removable")
+ (return-type "gboolean")
+)
+
(define-method is_media_removable
(of-object "GDrive")
(c-name "g_drive_is_media_removable")
+;; From gio_probes.h
+
+
+
;; From gioscheduler.h
(define-function g_io_scheduler_push_job
+;; From gio-tool.h
+
+(define-function print_file_error
+ (c-name "print_file_error")
+ (return-type "none")
+ (parameters
+ '("GFile*" "file")
+ '("const-char*" "message")
+ )
+)
+
+(define-function show_help
+ (c-name "show_help")
+ (return-type "none")
+ (parameters
+ '("GOptionContext*" "context")
+ '("const-char*" "message")
+ )
+)
+
+(define-function file_type_to_string
+ (c-name "file_type_to_string")
+ (return-type "const-char*")
+ (parameters
+ '("GFileType" "type")
+ )
+)
+
+(define-function attribute_type_to_string
+ (c-name "attribute_type_to_string")
+ (return-type "const-char*")
+ (parameters
+ '("GFileAttributeType" "type")
+ )
+)
+
+(define-function attribute_type_from_string
+ (c-name "attribute_type_from_string")
+ (return-type "GFileAttributeType")
+ (parameters
+ '("const-char*" "str")
+ )
+)
+
+(define-function attribute_flags_to_string
+ (c-name "attribute_flags_to_string")
+ (return-type "char*")
+ (parameters
+ '("GFileAttributeInfoFlags" "flags")
+ )
+)
+
+(define-function file_is_dir
+ (c-name "file_is_dir")
+ (return-type "gboolean")
+ (parameters
+ '("GFile*" "file")
+ )
+)
+
+(define-function handle_cat
+ (c-name "handle_cat")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_copy
+ (c-name "handle_copy")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_info
+ (c-name "handle_info")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_list
+ (c-name "handle_list")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_mime
+ (c-name "handle_mime")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_mkdir
+ (c-name "handle_mkdir")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_monitor
+ (c-name "handle_monitor")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_mount
+ (c-name "handle_mount")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_move
+ (c-name "handle_move")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_open
+ (c-name "handle_open")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_rename
+ (c-name "handle_rename")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_remove
+ (c-name "handle_remove")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_save
+ (c-name "handle_save")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_set
+ (c-name "handle_set")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_trash
+ (c-name "handle_trash")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+(define-function handle_tree
+ (c-name "handle_tree")
+ (return-type "int")
+ (parameters
+ '("int" "argc")
+ '("char*[]" "argv")
+ '("gboolean" "do_help")
+ )
+)
+
+
+
+;; From gio_trace.h
+
+
+
;; From giotypes.h
+;; From gnetworkmonitorportal.h
+
+(define-function g_network_monitor_portal_get_type
+ (c-name "g_network_monitor_portal_get_type")
+ (return-type "GType")
+)
+
+
+
;; From gnetworkservice.h
(define-function g_network_service_get_type
+;; From gportalsupport.h
+
+(define-function glib_should_use_portal
+ (c-name "glib_should_use_portal")
+ (return-type "gboolean")
+)
+
+(define-function glib_network_available_in_sandbox
+ (c-name "glib_network_available_in_sandbox")
+ (return-type "gboolean")
+)
+
+
+
;; From gpropertyaction.h
(define-function g_property_action_get_type
+;; From gproxyresolverportal.h
+
+(define-function g_proxy_resolver_portal_get_type
+ (c-name "g_proxy_resolver_portal_get_type")
+ (return-type "GType")
+)
+
+
+
;; From gregistrysettingsbackend.h
(define-function g_registry_backend_get_type
)
)
+(define-method get_int64
+ (of-object "GSettings")
+ (c-name "g_settings_get_int64")
+ (return-type "gint64")
+ (parameters
+ '("const-gchar*" "key")
+ )
+)
+
+(define-method set_int64
+ (of-object "GSettings")
+ (c-name "g_settings_set_int64")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "key")
+ '("gint64" "value")
+ )
+)
+
(define-method get_uint
(of-object "GSettings")
(c-name "g_settings_get_uint")
)
)
+(define-method get_uint64
+ (of-object "GSettings")
+ (c-name "g_settings_get_uint64")
+ (return-type "guint64")
+ (parameters
+ '("const-gchar*" "key")
+ )
+)
+
+(define-method set_uint64
+ (of-object "GSettings")
+ (c-name "g_settings_set_uint64")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "key")
+ '("guint64" "value")
+ )
+)
+
(define-method get_string
(of-object "GSettings")
(c-name "g_settings_get_string")
(return-type "GVfs*")
)
+(define-method register_uri_scheme
+ (of-object "GVfs")
+ (c-name "g_vfs_register_uri_scheme")
+ (return-type "gboolean")
+ (parameters
+ '("const-char*" "scheme")
+ '("GVfsFileLookupFunc" "uri_func")
+ '("gpointer" "uri_data")
+ '("GDestroyNotify" "uri_destroy")
+ '("GVfsFileLookupFunc" "parse_name_func")
+ '("gpointer" "parse_name_data")
+ '("GDestroyNotify" "parse_name_destroy")
+ )
+)
+
+(define-method unregister_uri_scheme
+ (of-object "GVfs")
+ (c-name "g_vfs_unregister_uri_scheme")
+ (return-type "gboolean")
+ (parameters
+ '("const-char*" "scheme")
+ )
+)
+
+
+
+;; From gvolume.h
-
-;; From gvolume.h
-
(define-function g_volume_get_type
(c-name "g_volume_get_type")
(return-type "GType")
)
+
+;; From xdp-dbus.h
+
+(define-function gxdp_documents_get_type
+ (c-name "gxdp_documents_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_documents_interface_info
+ (c-name "gxdp_documents_interface_info")
+ (return-type "GDBusInterfaceInfo*")
+)
+
+(define-function gxdp_documents_override_properties
+ (c-name "gxdp_documents_override_properties")
+ (return-type "guint")
+ (parameters
+ '("GObjectClass*" "klass")
+ '("guint" "property_id_begin")
+ )
+)
+
+(define-method complete_get_mount_point
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_get_mount_point")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("const-gchar*" "path")
+ )
+)
+
+(define-method complete_add
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_add")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("GUnixFDList*" "fd_list")
+ '("const-gchar*" "doc_id")
+ )
+)
+
+(define-method complete_add_named
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_add_named")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("GUnixFDList*" "fd_list")
+ '("const-gchar*" "doc_id")
+ )
+)
+
+(define-method complete_grant_permissions
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_grant_permissions")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ )
+)
+
+(define-method complete_revoke_permissions
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_revoke_permissions")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ )
+)
+
+(define-method complete_delete
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_delete")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ )
+)
+
+(define-method complete_lookup
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_lookup")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("const-gchar*" "doc_id")
+ )
+)
+
+(define-method complete_info
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_info")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("const-gchar*" "path")
+ '("GVariant*" "apps")
+ )
+)
+
+(define-method complete_list
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_complete_list")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("GVariant*" "docs")
+ )
+)
+
+(define-method call_get_mount_point
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_get_mount_point")
+ (return-type "none")
+ (parameters
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_get_mount_point_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_get_mount_point_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_path")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_get_mount_point_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_get_mount_point_sync")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_add
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add")
+ (return-type "none")
+ (parameters
+ '("GVariant*" "arg_o_path_fd")
+ '("gboolean" "arg_reuse_existing")
+ '("gboolean" "arg_persistent")
+ '("GUnixFDList*" "fd_list")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_add_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_doc_id")
+ '("GUnixFDList**" "out_fd_list")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_add_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add_sync")
+ (return-type "gboolean")
+ (parameters
+ '("GVariant*" "arg_o_path_fd")
+ '("gboolean" "arg_reuse_existing")
+ '("gboolean" "arg_persistent")
+ '("GUnixFDList*" "fd_list")
+ '("gchar**" "out_doc_id")
+ '("GUnixFDList**" "out_fd_list")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_add_named
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add_named")
+ (return-type "none")
+ (parameters
+ '("GVariant*" "arg_o_path_parent_fd")
+ '("const-gchar*" "arg_filename")
+ '("gboolean" "arg_reuse_existing")
+ '("gboolean" "arg_persistent")
+ '("GUnixFDList*" "fd_list")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_add_named_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add_named_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_doc_id")
+ '("GUnixFDList**" "out_fd_list")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_add_named_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_add_named_sync")
+ (return-type "gboolean")
+ (parameters
+ '("GVariant*" "arg_o_path_parent_fd")
+ '("const-gchar*" "arg_filename")
+ '("gboolean" "arg_reuse_existing")
+ '("gboolean" "arg_persistent")
+ '("GUnixFDList*" "fd_list")
+ '("gchar**" "out_doc_id")
+ '("GUnixFDList**" "out_fd_list")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_grant_permissions
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_grant_permissions")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("const-gchar*" "arg_app_id")
+ '("const-gchar*-const*" "arg_permissions")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_grant_permissions_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_grant_permissions_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_grant_permissions_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_grant_permissions_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("const-gchar*" "arg_app_id")
+ '("const-gchar*-const*" "arg_permissions")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_revoke_permissions
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_revoke_permissions")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("const-gchar*" "arg_app_id")
+ '("const-gchar*-const*" "arg_permissions")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_revoke_permissions_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_revoke_permissions_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_revoke_permissions_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_revoke_permissions_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("const-gchar*" "arg_app_id")
+ '("const-gchar*-const*" "arg_permissions")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_delete
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_delete")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_delete_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_delete_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_delete_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_delete_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_lookup
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_lookup")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_filename")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_lookup_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_lookup_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_doc_id")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_lookup_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_lookup_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_filename")
+ '("gchar**" "out_doc_id")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_info
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_info")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_info_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_info_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar**" "out_path")
+ '("GVariant**" "out_apps")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_info_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_info_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_doc_id")
+ '("gchar**" "out_path")
+ '("GVariant**" "out_apps")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_list
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_list")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_app_id")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_list_finish
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_list_finish")
+ (return-type "gboolean")
+ (parameters
+ '("GVariant**" "out_docs")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_list_sync
+ (of-object "GXdpDocuments")
+ (c-name "gxdp_documents_call_list_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_app_id")
+ '("GVariant**" "out_docs")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_documents_proxy_get_type
+ (c-name "gxdp_documents_proxy_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_documents_proxy_new_finish
+ (c-name "gxdp_documents_proxy_new_finish")
+ (return-type "GXdpDocuments*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_documents_proxy_new_sync
+ (c-name "gxdp_documents_proxy_new_sync")
+ (return-type "GXdpDocuments*")
+ (parameters
+ '("GDBusConnection*" "connection")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_documents_proxy_new_for_bus
+ (c-name "gxdp_documents_proxy_new_for_bus")
+ (return-type "none")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function gxdp_documents_proxy_new_for_bus_finish
+ (c-name "gxdp_documents_proxy_new_for_bus_finish")
+ (return-type "GXdpDocuments*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_documents_proxy_new_for_bus_sync
+ (c-name "gxdp_documents_proxy_new_for_bus_sync")
+ (return-type "GXdpDocuments*")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_documents_skeleton_get_type
+ (c-name "gxdp_documents_skeleton_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_network_monitor_get_type
+ (c-name "gxdp_network_monitor_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_network_monitor_interface_info
+ (c-name "gxdp_network_monitor_interface_info")
+ (return-type "GDBusInterfaceInfo*")
+)
+
+(define-function gxdp_network_monitor_override_properties
+ (c-name "gxdp_network_monitor_override_properties")
+ (return-type "guint")
+ (parameters
+ '("GObjectClass*" "klass")
+ '("guint" "property_id_begin")
+ )
+)
+
+(define-method emit_changed
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_emit_changed")
+ (return-type "none")
+ (parameters
+ '("gboolean" "arg_available")
+ )
+)
+
+(define-method get_available
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_get_available")
+ (return-type "gboolean")
+)
+
+(define-method set_available
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_set_available")
+ (return-type "none")
+ (parameters
+ '("gboolean" "value")
+ )
+)
+
+(define-method get_metered
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_get_metered")
+ (return-type "gboolean")
+)
+
+(define-method set_metered
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_set_metered")
+ (return-type "none")
+ (parameters
+ '("gboolean" "value")
+ )
+)
+
+(define-method get_connectivity
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_get_connectivity")
+ (return-type "guint")
+)
+
+(define-method set_connectivity
+ (of-object "GXdpNetworkMonitor")
+ (c-name "gxdp_network_monitor_set_connectivity")
+ (return-type "none")
+ (parameters
+ '("guint" "value")
+ )
+)
+
+(define-function gxdp_network_monitor_proxy_get_type
+ (c-name "gxdp_network_monitor_proxy_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_network_monitor_proxy_new_finish
+ (c-name "gxdp_network_monitor_proxy_new_finish")
+ (return-type "GXdpNetworkMonitor*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_network_monitor_proxy_new_sync
+ (c-name "gxdp_network_monitor_proxy_new_sync")
+ (return-type "GXdpNetworkMonitor*")
+ (parameters
+ '("GDBusConnection*" "connection")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_network_monitor_proxy_new_for_bus
+ (c-name "gxdp_network_monitor_proxy_new_for_bus")
+ (return-type "none")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function gxdp_network_monitor_proxy_new_for_bus_finish
+ (c-name "gxdp_network_monitor_proxy_new_for_bus_finish")
+ (return-type "GXdpNetworkMonitor*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_network_monitor_proxy_new_for_bus_sync
+ (c-name "gxdp_network_monitor_proxy_new_for_bus_sync")
+ (return-type "GXdpNetworkMonitor*")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_network_monitor_skeleton_get_type
+ (c-name "gxdp_network_monitor_skeleton_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_proxy_resolver_get_type
+ (c-name "gxdp_proxy_resolver_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_proxy_resolver_interface_info
+ (c-name "gxdp_proxy_resolver_interface_info")
+ (return-type "GDBusInterfaceInfo*")
+)
+
+(define-function gxdp_proxy_resolver_override_properties
+ (c-name "gxdp_proxy_resolver_override_properties")
+ (return-type "guint")
+ (parameters
+ '("GObjectClass*" "klass")
+ '("guint" "property_id_begin")
+ )
+)
+
+(define-method complete_lookup
+ (of-object "GXdpProxyResolver")
+ (c-name "gxdp_proxy_resolver_complete_lookup")
+ (return-type "none")
+ (parameters
+ '("GDBusMethodInvocation*" "invocation")
+ '("const-gchar*-const*" "proxies")
+ )
+)
+
+(define-method call_lookup
+ (of-object "GXdpProxyResolver")
+ (c-name "gxdp_proxy_resolver_call_lookup")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "arg_uri")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-method call_lookup_finish
+ (of-object "GXdpProxyResolver")
+ (c-name "gxdp_proxy_resolver_call_lookup_finish")
+ (return-type "gboolean")
+ (parameters
+ '("gchar***" "out_proxies")
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-method call_lookup_sync
+ (of-object "GXdpProxyResolver")
+ (c-name "gxdp_proxy_resolver_call_lookup_sync")
+ (return-type "gboolean")
+ (parameters
+ '("const-gchar*" "arg_uri")
+ '("gchar***" "out_proxies")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_proxy_resolver_proxy_get_type
+ (c-name "gxdp_proxy_resolver_proxy_get_type")
+ (return-type "GType")
+)
+
+(define-function gxdp_proxy_resolver_proxy_new_finish
+ (c-name "gxdp_proxy_resolver_proxy_new_finish")
+ (return-type "GXdpProxyResolver*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_proxy_resolver_proxy_new_sync
+ (c-name "gxdp_proxy_resolver_proxy_new_sync")
+ (return-type "GXdpProxyResolver*")
+ (parameters
+ '("GDBusConnection*" "connection")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_proxy_resolver_proxy_new_for_bus
+ (c-name "gxdp_proxy_resolver_proxy_new_for_bus")
+ (return-type "none")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GAsyncReadyCallback" "callback")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function gxdp_proxy_resolver_proxy_new_for_bus_finish
+ (c-name "gxdp_proxy_resolver_proxy_new_for_bus_finish")
+ (return-type "GXdpProxyResolver*")
+ (parameters
+ '("GAsyncResult*" "res")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_proxy_resolver_proxy_new_for_bus_sync
+ (c-name "gxdp_proxy_resolver_proxy_new_for_bus_sync")
+ (return-type "GXdpProxyResolver*")
+ (parameters
+ '("GBusType" "bus_type")
+ '("GDBusProxyFlags" "flags")
+ '("const-gchar*" "name")
+ '("const-gchar*" "object_path")
+ '("GCancellable*" "cancellable")
+ '("GError**" "error")
+ )
+)
+
+(define-function gxdp_proxy_resolver_skeleton_get_type
+ (c-name "gxdp_proxy_resolver_skeleton_get_type")
+ (return-type "GType")
+)
+
+
_WRAP_METHOD(int get_int(const Glib::ustring& key) const, g_settings_get_int)
_WRAP_METHOD(void set_int(const Glib::ustring& key, int value), g_settings_set_int)
+ _WRAP_METHOD(gint64 get_int64(const Glib::ustring& key) const, g_settings_get_int64)
+ _WRAP_METHOD(void set_int64(const Glib::ustring& key, gint64 value), g_settings_set_int64)
_WRAP_METHOD(guint get_uint(const Glib::ustring& key) const, g_settings_get_uint)
- _WRAP_METHOD(void set_uiint(const Glib::ustring& key, guint value), g_settings_set_uint)
+ _WRAP_METHOD(void set_uiint(const Glib::ustring& key, guint value), g_settings_set_uint, deprecated "Use set_uint() instead.")
+ _WRAP_METHOD(void set_uint(const Glib::ustring& key, guint value), g_settings_set_uint)
+ _WRAP_METHOD(guint64 get_uint64(const Glib::ustring& key) const, g_settings_get_uint64)
+ _WRAP_METHOD(void set_uint64(const Glib::ustring& key, guint64 value), g_settings_set_uint64)
_WRAP_METHOD(bool get_boolean(const Glib::ustring& key) const, g_settings_get_boolean)
_WRAP_METHOD(void set_boolean(const Glib::ustring& key, bool value), g_settings_set_boolean)
_WRAP_METHOD(Glib::ustring get_string(const Glib::ustring& key) const, g_settings_get_string)
-// -*- Mode: C++; indent-tabs-mode: nil; c-basic-offset: 2 -*-
-
/* Copyright (C) 2010 Jonathon Jongsma
*
* This library is free software; you can redistribute it and/or
namespace Gio
{
-/**
- * Make it easy to implement a network service
+/** Make it easy to implement a network service.
*
* @see ThreadedSocketService, SocketListener.
*
- * A SocketService is an object that represents a service that is
+ * A %SocketService is an object that represents a service that is
* provided to the network or over local sockets. When a new
- * connection is made to the service the SocketService:incoming
- * signal is emitted.
+ * connection is made to the service signal_incoming() is emitted.
*
- * A SocketService is a subclass of SocketListener and you need
- * to add the addresses you want to accept connections on to the
- * with the SocketListener APIs.
+ * A %SocketService is a subclass of SocketListener and you need
+ * to add the addresses you want to accept connections on with the
+ * SocketListener APIs.
*
* There are two options for implementing a network service based on
- * SocketService. The first is to create the service using
- * g_socket_service_new() and to connect to the SocketService:incoming
- * signal. The second is to subclass SocketService and override the
- * default signal handler implementation.
+ * %SocketService. The first is to create the service using
+ * create() and to connect to signal_incoming().
+ * The second is to subclass %SocketService and override the
+ * default signal handler implementation, on_incoming().
*
* In either case, the handler must immediately return, or else it
* will block additional incoming connections from being serviced.
* If you are interested in writing connection handlers that contain
* blocking code then see ThreadedSocketService.
*
- * The socket service runs on the main loop in the main thread, and is
- * not threadsafe in general. However, the calls to start and stop
+ * The socket service runs on the main loop of the thread-default context
+ * of the thread it is created in, and is not
+ * threadsafe in general. However, the calls to start and stop
* the service are threadsafe so these can be used from threads that
* handle incoming clients.
*
*/
class SocketService : public Gio::SocketListener
{
- _CLASS_GOBJECT(SocketService, GSocketService, G_SOCKET_SERVICE, Gio::SocketListener, GSocketListener)
+ _CLASS_GOBJECT(SocketService, GSocketService, G_SOCKET_SERVICE, Gio::SocketListener, GSocketListener)
protected:
- _CTOR_DEFAULT
+ _CTOR_DEFAULT
public:
- _WRAP_CREATE()
- _WRAP_METHOD(void start(), g_socket_service_start)
- _WRAP_METHOD(void stop(), g_socket_service_stop)
- _WRAP_METHOD(bool is_active(), g_socket_service_is_active)
+ _WRAP_CREATE()
+ _WRAP_METHOD(void start(), g_socket_service_start)
+ _WRAP_METHOD(void stop(), g_socket_service_stop)
+ _WRAP_METHOD(bool is_active(), g_socket_service_is_active)
#m4 _CONVERSION(`GObject*',`const Glib::RefPtr<Glib::Object>&',`Glib::wrap($3, true)')
#m4 _CONVERSION(`GSocketConnection*',`const Glib::RefPtr<SocketConnection>&',`Glib::wrap($3, true)')
- _WRAP_SIGNAL(bool incoming(const Glib::RefPtr<SocketConnection>& connection, const Glib::RefPtr<Glib::Object>& source_object), "incoming")
+ _WRAP_SIGNAL(bool incoming(const Glib::RefPtr<SocketConnection>& connection, const Glib::RefPtr<Glib::Object>& source_object), "incoming")
_WRAP_PROPERTY("active", bool, newin "2,46")
};
</parameter_description>
</parameter>
<parameter name="G_CHECKSUM_SHA512">
-<parameter_description> Use the SHA-512 hashing algorithm
+<parameter_description> Use the SHA-512 hashing algorithm (Since: 2.36)
</parameter_description>
</parameter>
</parameters>
</parameters>
</enum>
+<enum name="GLogWriterOutput">
+<description>
+Return values from #GLogWriterFuncs to indicate whether the given log entry
+was successfully handled by the writer, or whether there was an error in
+handling it (and hence a fallback writer should be used).
+
+If a #GLogWriterFunc ignores a log entry, it should return
+%G_LOG_WRITER_HANDLED.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="G_LOG_WRITER_HANDLED">
+<parameter_description> Log writer has handled the log entry.
+</parameter_description>
+</parameter>
+<parameter name="G_LOG_WRITER_UNHANDLED">
+<parameter_description> Log writer could not handle the log entry.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GMarkupCollectType">
<description>
A mixed enumerated type and flags field. You must specify one type
<description>
These are the possible character classifications from the
Unicode specification.
-See <ulink url="http://www.unicode.org/Public/UNIDATA/UnicodeData.html">http://www.unicode.org/Public/UNIDATA/UnicodeData.html</ulink>.
+See <ulink url="http://www.unicode.org/reports/tr44/#General_Category_Values">Unicode Character Database</unlink>.
</description>
<parameters>
</parameters>
</enum>
+<function name="g_abort">
+<description>
+A wrapper for the POSIX abort() function.
+
+On Windows it is a function that makes extra effort (including a call
+to abort()) to ensure that a debugger-catchable exception is thrown
+before the program terminates.
+
+See your C library manual for more details about abort().
+
+Since: 2.50
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
<function name="g_access">
<description>
A wrapper for the POSIX access() function. This function is used to
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
membuf = g_malloc (8192);
-/ * Some computation on membuf * /
+/<!-- -->* Some computation on membuf *<!-- -->/
-/ * membuf will be automatically freed here * /
+/<!-- -->* membuf will be automatically freed here *<!-- -->/
return TRUE;
}
]|
</parameter_description>
</parameter>
<parameter name="full_path">
-<parameter_description> return location for a string containing the full path
-of the file, or %NULL
+<parameter_description> return location for a string
+containing the full path of the file, or %NULL
</parameter_description>
</parameter>
<parameter name="error">
</parameter_description>
</parameter>
<parameter name="filename">
-<parameter_description> the path of a filename to load, in the GLib file name encoding
+<parameter_description> the path of a filename to load, in the
+GLib file name encoding
</parameter_description>
</parameter>
<parameter name="error">
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string that must be freed with g_free().
+<return> a newly-allocated string that must be freed with
+g_free().
</return>
</function>
</description>
<parameters>
<parameter name="args">
-<parameter_description> %NULL-terminated array of strings containing the path elements.
+<parameter_description> %NULL-terminated
+array of strings containing the path elements.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string that must be freed with g_free().
+<return> a newly-allocated string that must be freed
+with g_free().
</return>
</function>
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string that must be freed with g_free().
+<return> a newly-allocated string that must be freed with
+g_free().
</return>
</function>
</parameter_description>
</parameter>
<parameter name="args">
-<parameter_description> %NULL-terminated array of strings containing the path elements.
+<parameter_description> %NULL-terminated
+array of strings containing the path elements.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string that must be freed with g_free().
+<return> a newly-allocated string that must be freed
+with g_free().
</return>
</function>
</description>
<parameters>
<parameter name="path">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
</return>
</function>
+<function name="g_compute_hmac_for_bytes">
+<description>
+Computes the HMAC for a binary @data. 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.50
+
+</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="data">
+<parameter_description> binary blob to compute the HMAC of
+</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_data">
<description>
Computes the HMAC for a binary @data of @length. This is a
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
character will automatically be appended to @..., and need not be entered
manually.
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
<parameter name="Varargs">
<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.
+weeks are understood to begin on Sunday. The date must be valid.
Can return 0 if the day is before the first Sunday of the year.
character will automatically be appended to @..., and need not be entered
manually.
-Such messages are suppressed by the g_log_default_handler() unless
-the G_MESSAGES_DEBUG environment variable is set appropriately.
+Such messages are suppressed by the g_log_default_handler() and
+g_log_writer_default() unless the `G_MESSAGES_DEBUG` environment variable is
+set appropriately.
+
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
Since: 2.6
character will automatically be appended to @..., and need not be entered
manually.
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
</description>
<parameters>
</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 string with the contents of
+the symbolic link, or %NULL if an error occurred.
</return>
</function>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a filename to test in the GLib file name encoding
+<parameter_description> a filename to test in the
+GLib file name encoding
</parameter_description>
</parameter>
<parameter name="test">
</description>
<parameters>
<parameter name="filename">
-<parameter_description> an absolute pathname in the GLib file name encoding
+<parameter_description> an absolute pathname in the
+GLib file name encoding
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname hopefully in the GLib file name encoding
+<parameter_description> a pathname hopefully in the
+GLib file name encoding
</parameter_description>
</parameter>
</parameters>
</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> 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">
</description>
<parameters>
<parameter name="opsysstring">
-<parameter_description> a string in the encoding for filenames
+<parameter_description> a string in the encoding for filenames
</parameter_description>
</parameter>
<parameter name="len">
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string with the absolute path, or %NULL
+<return> a newly-allocated string with the absolute path,
+or %NULL
</return>
</function>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
and said environment variables have no effect.
`G_FILENAME_ENCODING` may be set to a comma-separated list of
-character set names. The special token "@locale" is taken
+character set names. The special token "\@locale" is taken
to mean the character set for the [current locale][setlocale].
If `G_FILENAME_ENCODING` is not set, but `G_BROKEN_FILENAMES` is,
the character set of the current locale is taken as the filename
</description>
<parameters>
</parameters>
-<return> a %NULL-terminated array of strings owned by GLib that must
-not be modified or freed.
+<return>
+a %NULL-terminated array of strings owned by GLib that must not be
+modified or freed.
+
</return>
</function>
</description>
<parameters>
</parameters>
-<return> a %NULL-terminated array of strings owned by GLib that must
-not be modified or freed.
+<return>
+a %NULL-terminated array of strings owned by GLib that must not be
+modified or freed.
+
</return>
</function>
</description>
<parameters>
</parameters>
-<return> a string owned by GLib that must not be modified
+<return> a string owned by GLib that must not be modified
or freed.
</return>
</function>
</description>
<parameters>
</parameters>
-<return> a string owned by GLib that must not be modified
+<return> a string owned by GLib that must not be modified
or freed.
</return>
</function>
</description>
<parameters>
</parameters>
-<return> a string owned by GLib that must not be modified
+<return> a string owned by GLib that must not be modified
or freed.
</return>
</function>
</description>
<parameters>
</parameters>
-<return> a string owned by GLib that must not be modified or freed.
+<return> a string owned by GLib that must not be
+modified or freed.
</return>
</function>
</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
+<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>
character will automatically be appended to @..., and need not be entered
manually.
-Such messages are suppressed by the g_log_default_handler() unless
-the G_MESSAGES_DEBUG environment variable is set appropriately.
+Such messages are suppressed by the g_log_default_handler() and
+g_log_writer_default() unless the `G_MESSAGES_DEBUG` environment variable is
+set appropriately.
+
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
Since: 2.40
</return>
</function>
+<function name="g_key_file_load_from_bytes">
+<description>
+Loads a key file from the data in @bytes into an empty #GKeyFile structure.
+If the object cannot be created then %error is set to a #GKeyFileError.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="key_file">
+<parameter_description> an empty #GKeyFile struct
+</parameter_description>
+</parameter>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="flags">
+<parameter_description> flags from #GKeyFileFlags
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if a key file could be loaded, %FALSE otherwise
+
+</return>
+</function>
+
<function name="g_key_file_load_from_data">
<description>
Loads a key file from memory into an empty #GKeyFile structure.
character will automatically be appended to @..., and need not be entered
manually.
+If [structured logging is enabled][using-structured-logging] this will
+output via the structured log writer function (see g_log_set_writer_func()).
+
</description>
<parameters>
<parameter name="log_domain">
%G_LOG_LEVEL_WARNING and %G_LOG_LEVEL_MESSAGE. stdout is used for
the rest.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
<parameter name="log_domain">
<description>
Removes the log handler.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
<parameter name="log_domain">
the `G_DEBUG` environment variable (see
[Running GLib Applications](glib-running.html)).
+Libraries should not call this function, as it affects all messages logged
+by a process, including those from other libraries.
+
+Structured log messages (using g_log_structured() and
+g_log_structured_array()) are fatal only if the default log writer is used;
+otherwise it is up to the writer function to determine which log messages
+are fatal. See [Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
and log level combination. By default, GLib uses
g_log_default_handler() as default log handler.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
+
Since: 2.6
</description>
Sets the log levels which are fatal in the given domain.
%G_LOG_LEVEL_ERROR is always fatal.
+This has no effect on structured log messages (using g_log_structured() or
+g_log_structured_array()). To change the fatal behaviour for specific log
+messages, programs must install a custom log writer function using
+g_log_set_writer_func(). See
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
you want to set a handler for this log level you must combine it with
#G_LOG_FLAG_FATAL.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
+
Here is an example for adding a log handler for all warning messages
in the default domain:
|[<!-- language="C" -->
<description>
Like g_log_sets_handler(), but takes a destroy notify for the @user_data.
+This has no effect if structured logging is enabled; see
+[Using Structured Logging][using-structured-logging].
+
Since: 2.46
</description>
</return>
</function>
+<function name="g_log_set_writer_func">
+<description>
+Set a writer function which will be called to format and write out each log
+message. Each program should set a writer function, or the default writer
+(g_log_writer_default()) will be used.
+
+Libraries **must not** call this function — only programs are allowed to
+install a writer function, as there must be a single, central point where
+log messages are formatted and outputted.
+
+There can only be one writer function. It is an error to set more than one.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="func">
+<parameter_description> log writer function, which must not be %NULL
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="user_data_free">
+<parameter_description> function to free @user_data once it’s
+finished with, if non-%NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_structured">
+<description>
+Log a message with structured data. The message will be passed through to
+the log writer set by the application using g_log_set_writer_func(). If the
+message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
+be aborted at the end of this function.
+
+The structured data is provided as key–value pairs, where keys are UTF-8
+strings, and values are arbitrary pointers — typically pointing to UTF-8
+strings, but that is not a requirement. To pass binary (non-nul-terminated)
+structured data, use g_log_structured_array(). The keys for structured data
+should follow the [systemd journal
+fields](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html)
+specification. It is suggested that custom keys are namespaced according to
+the code which sets them. For example, custom keys from GLib all have a
+`GLIB_` prefix.
+
+The @log_domain will be converted into a `GLIB_DOMAIN` field. @log_level will
+be converted into a
+[`PRIORITY`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#PRIORITY=)
+field. The format string will have its placeholders substituted for the provided
+values and be converted into a
+[`MESSAGE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE=)
+field.
+
+Other fields you may commonly want to pass into this function:
+
+* [`MESSAGE_ID`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE_ID=)
+* [`CODE_FILE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_FILE=)
+* [`CODE_LINE`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_LINE=)
+* [`CODE_FUNC`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#CODE_FUNC=)
+* [`ERRNO`](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#ERRNO=)
+
+Note that `CODE_FILE`, `CODE_LINE` and `CODE_FUNC` are automatically set by
+the logging macros, G_DEBUG_HERE(), g_message(), g_warning(), g_critical(),
+g_error(), etc, if the symbols `G_LOG_USE_STRUCTURED` is defined before including
+glib.h.
+
+For example:
+|[<!-- language="C" -->
+g_log_structured (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG,
+"MESSAGE_ID", "06d4df59e6c24647bfe69d2c27ef0b4e",
+"MY_APPLICATION_CUSTOM_FIELD", "some debug string",
+"MESSAGE", "This is a debug message about pointer %p and integer %u.",
+some_pointer, some_integer);
+]|
+
+Note that each `MESSAGE_ID` must be [uniquely and randomly
+generated](https://www.freedesktop.org/software/systemd/man/systemd.journal-fields.html#MESSAGE_ID=).
+If adding a `MESSAGE_ID`, consider shipping a [message
+catalog](https://www.freedesktop.org/wiki/Software/systemd/catalog/) with
+your software.
+
+To pass a user data pointer to the log writer function which is specific to
+this logging call, you must use g_log_structured_array() and pass the pointer
+as a field with #GLogField.length set to zero, otherwise it will be
+interpreted as a string.
+
+For example:
+|[<!-- language="C" -->
+const GLogField fields[] = {
+{ "MESSAGE", "This is a debug message.", -1 },
+{ "MESSAGE_ID", "fcfb2e1e65c3494386b74878f1abf893", -1 },
+{ "MY_APPLICATION_CUSTOM_FIELD", "some debug string", -1 },
+{ "MY_APPLICATION_STATE", state_object, 0 },
+};
+g_log_structured_array (G_LOG_LEVEL_DEBUG, fields, G_N_ELEMENTS (fields));
+]|
+
+Note also that, even if no other structured fields are specified, there
+must always be a "MESSAGE" key before the format string. The "MESSAGE"-format
+pair has to be the last of the key-value pairs, and "MESSAGE" is the only
+field for which printf()-style formatting is supported.
+
+The default writer function for `stdout` and `stderr` will automatically
+append a new-line character after the message, so you should not add one
+manually to the format string.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> log domain, usually %G_LOG_DOMAIN
+</parameter_description>
+</parameter>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> key-value pairs of structured data to add to the log entry, followed
+by the key "MESSAGE", followed by a printf()-style message format,
+followed by parameters to insert in the format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_structured_array">
+<description>
+Log a message with structured data. The message will be passed through to the
+log writer set by the application using g_log_set_writer_func(). If the
+message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
+be aborted at the end of this function.
+
+See g_log_structured() for more documentation.
+
+This assumes that @log_level is already present in @fields (typically as the
+`PRIORITY` field).
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> key–value pairs of structured data to add
+to the log message
+</parameter_description>
+</parameter>
+<parameter name="n_fields">
+<parameter_description> number of elements in the @fields array
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_variant">
+<description>
+Log a message with structured data, accepting the data within a #GVariant. This
+version is especially useful for use in other languages, via introspection.
+
+The only mandatory item in the @fields dictionary is the "MESSAGE" which must
+contain the text shown to the user.
+
+The values in the @fields dictionary are likely to be of type String
+(#G_VARIANT_TYPE_STRING). Array of bytes (#G_VARIANT_TYPE_BYTESTRING) is also
+supported. In this case the message is handled as binary and will be forwarded
+to the log writer as such. The size of the array should not be higher than
+%G_MAXSSIZE. Otherwise it will be truncated to this size. For other types
+g_variant_print() will be used to convert the value into a string.
+
+For more details on its usage and about the parameters, see g_log_structured().
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_domain">
+<parameter_description> log domain, usually %G_LOG_DOMAIN
+</parameter_description>
+</parameter>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> a dictionary (#GVariant of the type %G_VARIANT_TYPE_VARDICT)
+containing the key-value pairs of message data.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_log_writer_default">
+<description>
+Format a structured log message and output it to the default log destination
+for the platform. On Linux, this is typically the systemd journal, falling
+back to `stdout` or `stderr` if running from the terminal or if output is
+being redirected to a file.
+
+Support for other platform-specific logging mechanisms may be added in
+future. Distributors of GLib may modify this function to impose their own
+(documented) platform-specific log writing policies.
+
+This is suitable for use as a #GLogWriterFunc, and is the default writer used
+if no other is set using g_log_set_writer_func().
+
+As with g_log_default_handler(), this function drops debug and informational
+messages unless their log domain (or `all`) is listed in the space-separated
+`G_MESSAGES_DEBUG` environment variable.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> key–value pairs of structured data forming
+the log message
+</parameter_description>
+</parameter>
+<parameter name="n_fields">
+<parameter_description> number of elements in the @fields array
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to g_log_set_writer_func()
+</parameter_description>
+</parameter>
+</parameters>
+<return> %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise
+</return>
+</function>
+
+<function name="g_log_writer_format_fields">
+<description>
+Format a structured log message as a string suitable for outputting to the
+terminal (or elsewhere). This will include the values of all fields it knows
+how to interpret, which includes `MESSAGE` and `GLIB_DOMAIN` (see the
+documentation for g_log_structured()). It does not include values from
+unknown fields.
+
+The returned string does **not** have a trailing new-line character. It is
+encoded in the character set of the current locale, which is not necessarily
+UTF-8.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> key–value pairs of structured data forming
+the log message
+</parameter_description>
+</parameter>
+<parameter name="n_fields">
+<parameter_description> number of elements in the @fields array
+</parameter_description>
+</parameter>
+<parameter name="use_color">
+<parameter_description> %TRUE to use ANSI color escape sequences when formatting the
+message, %FALSE to not
+</parameter_description>
+</parameter>
+</parameters>
+<return> string containing the formatted log message, in
+the character set of the current locale
+</return>
+</function>
+
+<function name="g_log_writer_is_journald">
+<description>
+Check whether the given @output_fd file descriptor is a connection to the
+systemd journal, or something else (like a log file or `stdout` or
+`stderr`).
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="output_fd">
+<parameter_description> output file descriptor to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @output_fd points to the journal, %FALSE otherwise
+</return>
+</function>
+
+<function name="g_log_writer_journald">
+<description>
+Format a structured log message and send it to the systemd journal as a set
+of key–value pairs. All fields are sent to the journal, but if a field has
+length zero (indicating program-specific data) then only its key will be
+sent.
+
+This is suitable for use as a #GLogWriterFunc.
+
+If GLib has been compiled without systemd support, this function is still
+defined, but will always return %G_LOG_WRITER_UNHANDLED.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> key–value pairs of structured data forming
+the log message
+</parameter_description>
+</parameter>
+<parameter name="n_fields">
+<parameter_description> number of elements in the @fields array
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to g_log_set_writer_func()
+</parameter_description>
+</parameter>
+</parameters>
+<return> %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise
+</return>
+</function>
+
+<function name="g_log_writer_standard_streams">
+<description>
+Format a structured log message and print it to either `stdout` or `stderr`,
+depending on its log level. %G_LOG_LEVEL_INFO and %G_LOG_LEVEL_DEBUG messages
+are sent to `stdout`; all other log levels are sent to `stderr`. Only fields
+which are understood by this function are included in the formatted string
+which is printed.
+
+If the output stream supports ANSI color escape sequences, they will be used
+in the output.
+
+A trailing new-line character is added to the log message when it is printed.
+
+This is suitable for use as a #GLogWriterFunc.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="log_level">
+<parameter_description> log level, either from #GLogLevelFlags, or a user-defined
+level
+</parameter_description>
+</parameter>
+<parameter name="fields">
+<parameter_description> key–value pairs of structured data forming
+the log message
+</parameter_description>
+</parameter>
+<parameter name="n_fields">
+<parameter_description> number of elements in the @fields array
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to g_log_set_writer_func()
+</parameter_description>
+</parameter>
+</parameters>
+<return> %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise
+</return>
+</function>
+
+<function name="g_log_writer_supports_color">
+<description>
+Check whether the given @output_fd file descriptor supports ANSI color
+escape sequences. If so, they can safely be used when formatting log
+messages.
+
+Since: 2.50
+
+</description>
+<parameters>
+<parameter name="output_fd">
+<parameter_description> output file descriptor to check
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if ANSI color escapes are supported, %FALSE otherwise
+</return>
+</function>
+
<function name="g_logv">
<description>
Logs an error or debugging message.
character will automatically be appended to @..., and need not be entered
manually.
+If [structured logging is enabled][using-structured-logging] this will
+output via the structured log writer function (see g_log_set_writer_func()).
+
</description>
<parameters>
<parameter name="log_domain">
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="buf">
Normally you would call this function shortly after creating a new
thread, passing it a #GMainContext which will be run by a
#GMainLoop in that thread, to set a new default context for all
-async operations in that thread. (In this case, you don't need to
-ever call g_main_context_pop_thread_default().) In some cases
-however, you may want to schedule a single operation in a
+async operations in that thread. In this case you may not need to
+ever call g_main_context_pop_thread_default(), assuming you want the
+new #GMainContext to be the default for the whole lifecycle of the
+thread.
+
+If you don't have control over how the new thread was created (e.g.
+in the new thread isn't newly created, or if the thread life
+cycle is managed by a #GThreadPool), it is always suggested to wrap
+the logic that needs to use the new #GMainContext inside a
+g_main_context_push_thread_default() / g_main_context_pop_thread_default()
+pair, otherwise threads that are re-used will end up never explicitly
+releasing the #GMainContext reference they hold.
+
+In some cases you may want to schedule a single operation in a
non-default context, or temporarily use a non-default context in
the main thread. In that case, you can wrap the call to the
asynchronous operation inside a
</description>
<parameters>
<parameter name="filename">
-<parameter_description> The path of the file to load, in the GLib filename encoding
+<parameter_description> The path of the file to load, in the GLib
+filename encoding
</parameter_description>
</parameter>
<parameter name="writable">
character will automatically be appended to @..., and need not be entered
manually.
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
<parameter name="Varargs">
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="mode">
</parameter_description>
</parameter>
</parameters>
-<return> A pointer to @tmpl, which has been modified
-to hold the directory name. In case of errors, %NULL is
+<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>
</parameter_description>
</parameter>
</parameters>
-<return> A pointer to @tmpl, which has been modified
-to hold the directory name. In case of errors, %NULL is
+<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>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="flags">
</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>
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().
+use g_log(), g_log_structured(), or the convenience macros g_message(),
+g_warning() and g_error().
</description>
<parameters>
new-line character.
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().
+Instead g_log() or g_log_structured() should be used, or the convenience
+macros g_message(), g_warning() and g_error().
</description>
<parameters>
<description>
Returns the compile options that @regex was created with.
+Depending on the version of PCRE that is used, this may or may not
+include flags set by option expressions such as `(?i)` found at the
+top-level within the compiled pattern.
+
Since: 2.26
</description>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="oldfilename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="newfilename">
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
</parameters>
gtk_widget_hide (other_widget);
}
-…
+...
g_signal_connect (button, "clicked",
(GCallback) button_clicked_cb, other_widget);
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="buf">
optional @separator inserted between each of them. The returned string
should be freed with g_free().
+If @str_array has no items, the return value will be an
+empty string. If @str_array contains a single item, @separator will not
+appear in the resulting string.
+
</description>
<parameters>
Asserts that all messages previously indicated via
g_test_expect_message() have been seen and suppressed.
+This API may only be used with the old logging API (g_log() without
+%G_LOG_USE_STRUCTURED defined). It will not work with the structured logging
+API. See [Testing for Messages][testing-for-messages].
+
If messages at %G_LOG_LEVEL_DEBUG are emitted, but not explicitly
expected via g_test_expect_message() then they will be ignored.
message is logged, it will not be printed, and the test case will
not abort.
+This API may only be used with the old logging API (g_log() without
+%G_LOG_USE_STRUCTURED defined). It will not work with the structured logging
+API. See [Testing for Messages][testing-for-messages].
+
Use g_test_assert_expected_messages() to assert that all
previously-expected messages have been seen and suppressed.
`quick`: Quick tests, should run really quickly and give good coverage.
`undefined`: Tests for undefined behaviour, may provoke programming errors
-under g_test_trap_subprocess() or g_test_expect_messages() to check
+under g_test_trap_subprocess() or g_test_expect_message() to check
that appropriate assertions or warnings are given
`no-undefined`: Avoid tests for undefined behaviour
This handler has no effect on g_error messages.
+This handler also has no effect on structured log messages (using
+g_log_structured() or g_log_structured_array()). To change the fatal
+behaviour for specific log messages, programs must install a custom log
+writer function using g_log_set_writer_func().See
+[Using Structured Logging][using-structured-logging].
+
Since: 2.22
</description>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
</parameters>
</description>
<parameters>
<parameter name="filename">
-<parameter_description> a pathname in the GLib file name encoding (UTF-8 on Windows)
+<parameter_description> a pathname in the GLib file name encoding
+(UTF-8 on Windows)
</parameter_description>
</parameter>
<parameter name="utb">
</parameter_description>
</parameter>
<parameter name="index_">
-<parameter_description> insertion position, must be <= value_array->n_values
+<parameter_description> insertion position, must be <= value_array->;n_values
</parameter_description>
</parameter>
<parameter name="value">
<description>
Check whether g_value_transform() is able to transform values
of type @src_type into values of type @dest_type. Note that for
-the types to be transformable, they must be compatible and a
-transform function must be registered.
+the types to be transformable, they must be compatible or a
+transformation function must be registered.
</description>
It is not permissible to use @builder in any way after this call
except for reference counting operations (in the case of a
heap-allocated #GVariantBuilder) or by reinitialising it with
-g_variant_builder_init() (in the case of stack-allocated).
+g_variant_builder_init() (in the case of stack-allocated). This
+means that for the stack-allocated builders there is no need to
+call g_variant_builder_clear() after the call to
+g_variant_builder_end().
It is an error to call this function in any way that would create an
inconsistent value to be constructed (ie: insufficient number of
the last byte then the returned string is the string, up to the first
such nul character.
+g_variant_get_fixed_array() should be used instead if the array contains
+arbitrary data that could not be nul-terminated or could contain nul bytes.
+
It is an error to call this function with a @value that is not an
array of bytes.
a newline character will automatically be appended to @..., and
need not be entered manually.
+If structured logging is enabled, this will use g_log_structured();
+otherwise it will use g_log(). See
+[Using Structured Logging][using-structured-logging].
+
</description>
<parameters>
<parameter name="Varargs">
)
)
+;; Original typedef:
+;; typedef enum
+;; {
+;; G_LOG_WRITER_HANDLED = 1,
+;; G_LOG_WRITER_UNHANDLED = 0,
+;; } GLogWriterOutput;
+
+(define-enum-extended LogWriterOutput
+ (in-module "G")
+ (c-name "GLogWriterOutput")
+ (values
+ '("handled" "G_LOG_WRITER_HANDLED" "1")
+ '("unhandled" "G_LOG_WRITER_UNHANDLED" "0")
+ )
+)
+
;; From gnode.h
;; Original typedef:
; (DocsParser.pm:substitute_function(), which uses GtkDefs.pm:lookup_object().)
(define-object ByteArray
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GByteArray")
)
(define-object Checksum
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GChecksum")
(gtype-id "G_TYPE_CHECKSUM")
)
(define-object DateTime
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GDateTime")
)
(define-object GArray
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GArray")
)
(define-object IOChannel
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GIOChannel")
)
(define-object KeyFile
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GKeyFile")
(gtype-id "G_TYPE_KEY_FILE")
)
(define-object MatchInfo
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GMatchInfo")
(gtype-id "G_TYPE_MATCH_INFO")
)
+(define-object Object
+ (in-module "Glib")
+ (c-name "GObject")
+ (gtype-id "G_TYPE_OBJECT")
+)
+
(define-object OptionContext
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GOptionContext")
(gtype-id "G_TYPE_OPTION_CONTEXT")
)
(define-object Regex
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GRegex")
(gtype-id "G_TYPE_REGEX")
)
(define-object Set
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GSet")
(gtype-id "G_TYPE_SET")
)
(define-object TimeZone
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GTimeZone")
)
(define-object Variant
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GVariant")
(gtype-id "G_TYPE_VARIANT")
)
(define-object VariantDict
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GVariantDict")
(gtype-id "G_TYPE_VARIANT_DICT")
)
(define-object VariantType
- (in-module "GLib")
+ (in-module "Glib")
(c-name "GVariantType")
(gtype-id "G_TYPE_VARIANT_TYPE")
)
)
)
+(define-enum WriterOutput
+ (in-module "GLog")
+ (c-name "GLogWriterOutput")
+ (gtype-id "G_TYPE_LOG_WRITER_OUTPUT")
+ (values
+ '("handled" "G_LOG_WRITER_HANDLED")
+ '("unhandled" "G_LOG_WRITER_UNHANDLED")
+ )
+)
+
(define-flags Flags
(in-module "GTraverse")
(c-name "GTraverseFlags")
)
)
+(define-function g_compute_hmac_for_bytes
+ (c-name "g_compute_hmac_for_bytes")
+ (return-type "gchar*")
+ (parameters
+ '("GChecksumType" "digest_type")
+ '("GBytes*" "key")
+ '("GBytes*" "data")
+ )
+)
+
;; From ghook.h
)
)
+(define-method load_from_bytes
+ (of-object "GKeyFile")
+ (c-name "g_key_file_load_from_bytes")
+ (return-type "gboolean")
+ (parameters
+ '("GBytes*" "bytes")
+ '("GKeyFileFlags" "flags")
+ '("GError**" "error")
+ )
+)
+
(define-method load_from_dirs
(of-object "GKeyFile")
(c-name "g_key_file_load_from_dirs")
(return-type "none")
)
+(define-function g_thread_win32_process_detach
+ (c-name "g_thread_win32_process_detach")
+ (return-type "none")
+)
+
(define-function g_thread_win32_thread_detach
(c-name "g_thread_win32_thread_detach")
(return-type "none")
+;; From glib_probes.h
+
+
+
;; From glib_trace.h
)
)
+(define-function g_log_structured
+ (c-name "g_log_structured")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "log_domain")
+ '("GLogLevelFlags" "log_level")
+ )
+ (varargs #t)
+)
+
+(define-function g_log_structured_array
+ (c-name "g_log_structured_array")
+ (return-type "none")
+ (parameters
+ '("GLogLevelFlags" "log_level")
+ '("const-GLogField*" "fields")
+ '("gsize" "n_fields")
+ )
+)
+
+(define-function g_log_variant
+ (c-name "g_log_variant")
+ (return-type "none")
+ (parameters
+ '("const-gchar*" "log_domain")
+ '("GLogLevelFlags" "log_level")
+ '("GVariant*" "fields")
+ )
+)
+
+(define-function g_log_set_writer_func
+ (c-name "g_log_set_writer_func")
+ (return-type "none")
+ (parameters
+ '("GLogWriterFunc" "func")
+ '("gpointer" "user_data")
+ '("GDestroyNotify" "user_data_free")
+ )
+)
+
+(define-function g_log_writer_supports_color
+ (c-name "g_log_writer_supports_color")
+ (return-type "gboolean")
+ (parameters
+ '("gint" "output_fd")
+ )
+)
+
+(define-function g_log_writer_is_journald
+ (c-name "g_log_writer_is_journald")
+ (return-type "gboolean")
+ (parameters
+ '("gint" "output_fd")
+ )
+)
+
+(define-function g_log_writer_format_fields
+ (c-name "g_log_writer_format_fields")
+ (return-type "gchar*")
+ (parameters
+ '("GLogLevelFlags" "log_level")
+ '("const-GLogField*" "fields")
+ '("gsize" "n_fields")
+ '("gboolean" "use_color")
+ )
+)
+
+(define-function g_log_writer_journald
+ (c-name "g_log_writer_journald")
+ (return-type "GLogWriterOutput")
+ (parameters
+ '("GLogLevelFlags" "log_level")
+ '("const-GLogField*" "fields")
+ '("gsize" "n_fields")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function g_log_writer_standard_streams
+ (c-name "g_log_writer_standard_streams")
+ (return-type "GLogWriterOutput")
+ (parameters
+ '("GLogLevelFlags" "log_level")
+ '("const-GLogField*" "fields")
+ '("gsize" "n_fields")
+ '("gpointer" "user_data")
+ )
+)
+
+(define-function g_log_writer_default
+ (c-name "g_log_writer_default")
+ (return-type "GLogWriterOutput")
+ (parameters
+ '("GLogLevelFlags" "log_level")
+ '("const-GLogField*" "fields")
+ '("gsize" "n_fields")
+ '("gpointer" "user_data")
+ )
+)
+
(define-function g_return_if_fail_warning
(c-name "g_return_if_fail_warning")
(return-type "none")
)
)
+(define-function g_abort
+ (c-name "g_abort")
+ (return-type "none")
+)
+
;; From gvariant-core.h
+;; From gobject_probes.h
+
+
+
;; From gobject_trace.h
* <tt>testtreemodel -r 1 --max-size 20 --rand --display=:1.0 -vb -- file1 file2</tt>
*
* The example demonstrates a number of features of the GOption
- * commandline parser
+ * commandline parser:
* - Options can be single letters, prefixed by a single dash.
- Multiple short options can be grouped behind a single dash.
+ * - Multiple short options can be grouped behind a single dash.
* - Long options are prefixed by two consecutive dashes.
* - Options can have an extra argument, which can be a number, a string or
* a filename. For long options, the extra argument can be appended with
*/
explicit OptionContext(const Glib::ustring& parameter_string = Glib::ustring());
- //Note that, unlike Glib::Wrap(), this would create a second C++ instance for the same C instance,u
+ //Note that, unlike Glib::wrap(), this would create a second C++ instance for the same C instance,
//so it should be used carefully. For instance you could not access data in a derived class via this second instance.
explicit OptionContext(GOptionContext* castitem, bool take_ownership = false);
#m4 _CONVERSION(`char**&',`gchar***',`&($3)')
_WRAP_METHOD(bool parse(int& argc, char**& argv), g_option_context_parse, errthrow)
- //TODO: Document this as useful (only?) with the result from g_win32_get_command_line?
- //goption.c has example code that suggests always using this, and ifdefing for G_OS_WIN32, with a g_strdupv for the non-win32 case.
- //Presumably we cannot hide that ifdeffing from application code because the argument-removal would be invisible to the caller.
- //So can we hide it for people who don't care about arguments being removed from argv?
- //TODO? _WRAP_METHOD(bool parse(char**& argv), g_option_context_parse_strv, errthrow)
+ /** Parses the command line arguments.
+ *
+ * This function is similar to parse(int& argc, char**& argv) except that it
+ * respects the normal memory rules when dealing with a strv instead of
+ * assuming that the passed-in array is the argv of the main function.
+ * In particular, strings that are removed from the arguments list will
+ * be freed using g_free().
+ *
+ * On Windows, the strings are expected to be in UTF-8. This is in
+ * contrast to parse(int& argc, char**& argv) which expects them to be in the
+ * system codepage, which is how they are passed as @a argv to main().
+ * See g_win32_get_command_line() or Gio::ApplicationCommandLine::get_arguments()
+ * for a solution.
+ *
+ * This function is useful if you are trying to use OptionContext with
+ * Gio::Application.
+ *
+ * @newin{2,50}
+ *
+ * @param[in,out] argv A pointer to the command line arguments
+ * (which must be in UTF-8 on Windows).
+ * @return <tt>true</tt> if the parsing was successful,
+ * <tt>false</tt> if an error occurred.
+ * @throw Glib::OptionError
+ */
+ _WRAP_METHOD(bool parse(char**& argv), g_option_context_parse_strv, errthrow)
//g_option_context_add_main_entries(), just creates a group internally, adds them to it, and does a set_main_group()
//- a group without callbacks seems to do some simple default parsing.
_WRAP_METHOD(Glib::ustring get_help(bool main_help, const OptionGroup& group) const, g_option_context_get_help)
/** Returns a formatted, translated help text for the given context.
- * To obtain the text produced by --help, call get_help (true).
- * To obtain the text produced by --help-all, call get_help(false).
- * To obtain the help text for an option group, call get_help(false, group).
+ *
+ * - To obtain the text produced by --help, call get_help(true).
+ * - To obtain the text produced by --help-all, call get_help(false).
+ * - To obtain the help text for an option group, call get_help(false, group).
*
* @param main_help If true, only include the main group.
* @result string containing the help text.
using vecstrings = std::vector<std::string>;
/** Add a boolean option @a entry.
- * The @arg parameter will be set to the option's extra argument
- * after OptionContext::parse() has returned.
+ * If the option exists among the parsed arguments, the @a arg parameter will
+ * be set to <tt>true</tt> or, if @a entry contains OptionEntry::FLAG_REVERSE,
+ * to <tt>false</tt> after OptionContext::parse() has returned.
*/
void add_entry(const OptionEntry& entry, bool& arg);
/** Add an integer option @a entry.
- * The @arg parameter will be set to the option's extra argument
+ * The @a arg parameter will be set to the option's extra argument
* after OptionContext::parse() has returned.
*/
void add_entry(const OptionEntry& entry, int& arg);
/** Add a double option @a entry.
- * The @arg parameter will be set to the option's extra argument
+ * The @a arg parameter will be set to the option's extra argument
* after OptionContext::parse() has returned.
*/
void add_entry(const OptionEntry& entry, double& arg);
/** Add a UTF-8 string option @a entry.
- * The @arg parameter will be set to the option's extra argument
+ * The @a arg parameter will be set to the option's extra argument
* after OptionContext::parse() has returned.
*
* As indicated by the Glib::ustring type, the string will be
void add_entry(const OptionEntry& entry, Glib::ustring& arg);
/** Add a filename string option @a entry.
- * The @arg parameter will be set to the option's extra argument
+ * The @a arg parameter will be set to the option's extra argument
* after OptionContext::parse() has returned.
*
* The string will be in glib's filename encoding.
void add_entry_filename(const OptionEntry& entry, std::string& arg);
/** Add an option @a entry that provides a list of UTF-8 strings.
- * The @arg parameter will be set to the option's extra argument
+ * The @a arg parameter will be set to the option's extra argument
* after OptionContext::parse() has returned.
*
* As indicated by the Glib::ustring type, the strings will be
* UTF-8 encoded.
*/
void add_entry(const OptionEntry& entry, vecustrings& arg);
+
+ /** Add an option @a entry that provides a list of filename strings.
+ * The @a arg parameter will be set to the option's extra argument
+ * after OptionContext::parse() has returned.
+ *
+ * The strings will be in glib's filename encoding.
+ */
void add_entry_filename(const OptionEntry& entry, vecstrings& arg);
/** Add a string option @a entry, but let a callback slot parse the extra argument
void __CPPNAME__::swap(__CPPNAME__& other) noexcept
{
- __CNAME__ *const temp = gobject_;
- gobject_ = other.gobject_;
- other.gobject_ = temp;
+ std::swap(gobject_, other.gobject_);
}
__CNAME__* __CPPNAME__::gobj_copy() const
void __CPPNAME__::swap(__CPPNAME__& other) noexcept
{
- __CNAME__ *const temp = gobject_;
- gobject_ = other.gobject_;
- other.gobject_ = temp;
+ std::swap(gobject_, other.gobject_);
}
__CNAME__* __CPPNAME__::gobj_copy() const
$DocsParser::objCurrentFunction = undef; #Function
%DocsParser::hasharrayFunctions = (); #Function elements
-#~ $DocsParser::bOverride = 0; #First we parse the C docs, then we parse the C++ override docs.
$DocsParser::commentStart = " /** ";
$DocsParser::commentMiddleStart = " * ";
$$DocsParser::objCurrentFunction{param_descriptions} = ();
$$DocsParser::objCurrentFunction{return_description} = "";
$$DocsParser::objCurrentFunction{mapped_class} = "";
- # We don't need this any more, the only reference to this field is commented
- # $$DocsParser::objCurrentFunction{description_overridden} = $DocsParser::bOverride;
}
}
elsif($tag eq "parameters")
# Chop off leading and trailing whitespace.
$$text =~ s/^\s+//;
$$text =~ s/\s+$//;
-# HagenM: this is the only reference to $$obj_function{description_overridden}
-# and it seems not to be in use.
-# if(!$$obj_function{description_overridden})
-# {
- # Convert C documentation to C++.
- DocsParser::convert_tags_to_doxygen($text);
- DocsParser::substitute_identifiers($$obj_function{name}, $text);
-
- $$text =~ s/\bX\s+Window\b/X \%Window/g;
- $$text =~ s/\bWindow\s+manager/\%Window manager/g;
-# }
+
+ # Convert C documentation to C++.
+ DocsParser::remove_c_memory_handling_info($text);
+ DocsParser::convert_tags_to_doxygen($text);
+ DocsParser::substitute_identifiers($$obj_function{name}, $text);
+
+ $$text =~ s/\bX\s+Window\b/X \%Window/g;
+ $$text =~ s/\bWindow\s+manager/\%Window manager/g;
}
+sub remove_c_memory_handling_info($)
+{
+ my ($text) = @_;
+
+ # These C memory handling functions are removed, in most cases:
+ # g_free, g_strfreev, g_list_free, g_slist_free
+ my $mem_funcs = '\\bg_(?:free|strfreev|s?list_free)\\b';
+
+ return if ($$text !~ /$mem_funcs/);
+
+ # The text contains $mem_funcs. That's usually not relevant to C++ programmers.
+ # Try to remove irrelevant text without removing too much.
+
+ # This function is called separately for the description of each method,
+ # parameter and return value. Let's assume that only one removal is necessary.
+
+ # Don't modify the text, if $mem_funcs is part of example code.
+ # remove_c_memory_handling_info() is called before remove_example_code().
+ return if ($$text =~ m"(?:<informalexample>|<programlisting>|\|\[).*?$mem_funcs.*?(?:</informalexample>|</programlisting>|]\|)"s);
+
+ # First try to remove the sentence containing $mem_funcs.
+ # For simplicity, assume that a sentence is any string ending with a period.
+ my $tmp = $$text;
+ if ($tmp =~ s/[^.]*$mem_funcs.*?(?:\.|$)//s)
+ {
+ if ($tmp =~ /\w/)
+ {
+ # A sentence contains $mem_funcs, and it's not the only sentence in the text.
+ # Remove that sentence.
+ $$text = $tmp;
+ return;
+ }
+ }
+
+ $tmp = $$text;
+ if ($tmp =~ s/[^.,]*$mem_funcs.*?(?:\.|,|$)//s)
+ {
+ if ($tmp =~ /\w/)
+ {
+ # A clause, delimited by comma or period, contains $mem_funcs,
+ # and it's not the only clause in the text. Remove that clause.
+ $tmp =~ s/,\s*$/./;
+ $$text = $tmp;
+ return;
+ }
+ }
+
+ # Last attempt. If this doesn't remove anything, don't modify the text.
+ $$text =~ s/ that (?:must|should) be freed with g_free(?:\(\))?//;
+}
sub convert_tags_to_doxygen($)
{
}
else
{
- print "Documentation: Transformed C name $name into ";
- non_object_method_name($doc_func, \$name);
- print "C++ name $name\n";
+ print STDERR "Documentation: Class/Namespace for $name not found\n";
}
}
else
return $name . "()";
}
-sub non_object_method_name($$)
-{
- my ($doc_func, $name) = @_;
- if ($$name =~ m/^gtk_/)
- {
- my %gtk_objects = ("gtk_accel_map" => "AccelMap",
- "gtk_clipboard" => "Clipboard",
- "gtk_file_filter" => "FileFilter",
- "gtk_icon_set" => "IconSet",
- "gtk_icon_source" => "IconSource",
- "gtk_icon_info" => "IconInfo",
- "gtk_page_setup" => "PageSetup",
- "gtk_recent_info" => "RecentInfo",
- "gtk_tooltip" => "Tooltip",
- "gtk_target_list" => "TargetList",
- "gtk_drag_source" => "DragSource",
- "gtk_print_settings" => "PrintSettings",
- "gtk_recent_filter" => "RecentFilter");
- foreach my $key (keys(%gtk_objects))
- {
- if ($$name =~ m/^\Q$key\E/)
- {
- DocsParser::build_method_name($doc_func, "Gtk", $gtk_objects{$key}, $name);
- return;
- }
- }
- }
-
- print STDERR "Documentation: Class/Namespace for $$name not found\n";
-}
-
sub lookup_object_of_method($$)
{
my ($object, $name) = @_;