From 2eaeefdf5df09dc6de24e045b8c11fc3675f439f Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Tue, 9 Oct 2018 09:14:12 +1300 Subject: [PATCH] gdbusproxy: Document blocking guarantees of constructors Signed-off-by: Philip Withnall https://gitlab.gnome.org/GNOME/glib/issues/734 --- gio/gdbusproxy.c | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/gio/gdbusproxy.c b/gio/gdbusproxy.c index 3c0d0544e..6d84deced 100644 --- a/gio/gdbusproxy.c +++ b/gio/gdbusproxy.c @@ -1996,6 +1996,10 @@ initable_iface_init (GInitableIface *initable_iface) * match rules for signals. Connect to the #GDBusProxy::g-signal signal * to handle signals from the remote object. * + * If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and + * %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is + * guaranteed to complete immediately without blocking. + * * If @name is a well-known name and the * %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION * flags aren't set and no name owner currently exists, the message bus @@ -2096,6 +2100,10 @@ g_dbus_proxy_new_finish (GAsyncResult *res, * match rules for signals. Connect to the #GDBusProxy::g-signal signal * to handle signals from the remote object. * + * If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and + * %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is + * guaranteed to return immediately without blocking. + * * If @name is a well-known name and the * %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION * flags aren't set and no name owner currently exists, the message bus