From ec8e1e4be326656fdb203d4462525e896e69d4e1 Mon Sep 17 00:00:00 2001 From: Cosimo Alfarano Date: Mon, 3 Oct 2011 15:20:53 +0100 Subject: [PATCH 4/5] Fix documentation for _dbus_transport_get_is_authenticated() Make clear it has collateral effects --- dbus/dbus-transport.c | 9 +++++++-- 1 files changed, 7 insertions(+), 2 deletions(-) diff --git a/dbus/dbus-transport.c b/dbus/dbus-transport.c index cd16628..9f606ef 100644 --- a/dbus/dbus-transport.c +++ b/dbus/dbus-transport.c @@ -544,8 +544,13 @@ _dbus_transport_get_is_connected (DBusTransport *transport) } /** - * Returns #TRUE if we have been authenticated. Will return #TRUE - * even if the transport is disconnected. + * Run the next step of authentication progress if not authenticated + * yet or return immediately if the transport it is or it has been + * authenticated. + * + * Returns #TRUE if we have been authenticated. It will return #TRUE even if + * the transport is disconnected and it has been authenticated before + * disconnecting. * * @todo we drop connection->mutex when calling the unix_user_function, * and windows_user_function, which may not be safe really. -- 1.7.6.3