[glib: 1/2] gdbusproxy: Document blocking guarantees of constructors

[Emmanuele Bassi <ebassi src gnome org>]

commit 2eaeefdf5df09dc6de24e045b8c11fc3675f439f
Author: Philip Withnall <withnall endlessm com>
Date:   Tue Oct 9 09:14:12 2018 +1300

    gdbusproxy: Document blocking guarantees of constructors
    
    Signed-off-by: Philip Withnall <withnall endlessm com>
    
    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