From faa896642df51286c8d349be99a2219ed7d54140 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 7 Apr 2011 17:14:36 -0400 Subject: [PATCH] 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 file changed, 8 insertions(+), 1 deletion(-) diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c index b8ba677df..35c6772c8 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