From 54dcec2a8312634116c5a1acbbd0070953525c8a Mon Sep 17 00:00:00 2001 From: Kristian Høgsberg Date: Wed, 2 Jun 2004 13:13:14 +0000 Subject: 2004-06-02 Kristian Høgsberg MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * glib/dbus-gproxy.c, glib/dbus-gmain.c, dbus/dbus-string.c, dbus/dbus-object-tree.c, dbus/dbus-message.c: add comments to quiet doxygen. * Doxyfile.in: remove deprecated options. * dbus/dbus-message-handler.c, dbus/dbus-message-handler.h, glib/test-thread.h, glib/test-thread-client.c, glib/test-thread-server.c, glib/test-profile.c, glib/test-dbus-glib.c: remove these unused files. --- glib/dbus-gproxy.c | 32 ++++++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) (limited to 'glib/dbus-gproxy.c') diff --git a/glib/dbus-gproxy.c b/glib/dbus-gproxy.c index 906fd2e0..4e8d200f 100644 --- a/glib/dbus-gproxy.c +++ b/glib/dbus-gproxy.c @@ -29,6 +29,10 @@ * @{ */ +/** + * DBusGProxyManager typedef + */ + typedef struct DBusGProxyManager DBusGProxyManager; /** @@ -49,7 +53,7 @@ struct DBusGProxy */ struct DBusGProxyClass { - GObjectClass parent_class; + GObjectClass parent_class; /**< Parent class */ }; static void dbus_gproxy_init (DBusGProxy *proxy); @@ -62,12 +66,12 @@ static void dbus_gproxy_emit_received (DBusGProxy *proxy, /** - * A list of proxies with a given service+path+interface, used to route incoming - * signals. + * A list of proxies with a given service+path+interface, used to + * route incoming signals. */ typedef struct { - GSList *proxies; + GSList *proxies; /**< The list of proxies */ char name[4]; /**< service (empty string for none), nul byte, * path, nul byte, @@ -1256,6 +1260,17 @@ dbus_gproxy_send (DBusGProxy *proxy, g_error ("Out of memory\n"); } +/** + * Connect a signal handler to a proxy for a remote interface. When + * the remote interface emits the specified signal, the proxy will + * emit a corresponding GLib signal. + * + * @param proxy a proxy for a remote interface + * @param signal_name the DBus signal name to listen for + * @param handler the handler to connect + * @param data data to pass to handler + * @param free_data_func callback function to destroy data + */ void dbus_gproxy_connect_signal (DBusGProxy *proxy, const char *signal_name, @@ -1281,6 +1296,15 @@ dbus_gproxy_connect_signal (DBusGProxy *proxy, g_free (detail); } +/** + * Disconnect all signal handlers from a proxy that match the given + * criteria. + * + * @param proxy a proxy for a remote interface + * @param signal_name the DBus signal name to disconnect + * @param handler the handler to disconnect + * @param data the data that was registered with handler + */ void dbus_gproxy_disconnect_signal (DBusGProxy *proxy, const char *signal_name, -- cgit