[glib] Add a warning to the g_dbus_connection_set_exit_on_close docs

[Matthias Clasen <matthiasc src gnome org>]

commit a2e3a4d150b59213694b5166d0fda60d2b17970a
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Apr 7 17:14:36 2011 -0400

    Add a warning to the g_dbus_connection_set_exit_on_close docs
    
    Tell people to not leak their apps out of the session.

 gio/gdbusconnection.c |    9 ++++++++-
 1 files changed, 8 insertions(+), 1 deletions(-)
---
diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c
index 4227bda..a10bf4d 100644
--- a/gio/gdbusconnection.c
+++ b/gio/gdbusconnection.c
@@ -2712,12 +2712,19 @@ g_dbus_connection_new_for_address_sync (const gchar           *address,
  * g_dbus_connection_set_exit_on_close:
  * @connection: A #GDBusConnection.
  * @exit_on_close: Whether the process should be terminated
- * when @connection is closed by the remote peer.
+ *     when @connection is closed by the remote peer.
  *
  * Sets whether the process should be terminated when @connection is
  * closed by the remote peer. See #GDBusConnection:exit-on-close for
  * more details.
  *
+ * Note that this function should be used with care. Most modern UNIX
+ * desktops tie the notion of a user session the session bus, and expect
+ * all of a users applications to quit when their bus connection goes away.
+ * If you are setting @exit_on_close to %FALSE for the shared session
+ * bus connection, you should make sure that your application exits
+ * when the user session ends.
+ *
  * Since: 2.26
  */
 void