From 91b6954805de2541dad743256cc3f9e9c6f65943 Mon Sep 17 00:00:00 2001 From: Danielle Madeley Date: Thu, 17 Dec 2009 08:50:33 +1100 Subject: Don't destroy the request properties, EmpathyDispatcher now owns them This is not the same as tp-glib semantics (e.g. tp_..._call_create_channel). Add some docs to EmpathyDispatcher to explain this, for the next person. --- libempathy/empathy-dispatcher.c | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'libempathy/empathy-dispatcher.c') diff --git a/libempathy/empathy-dispatcher.c b/libempathy/empathy-dispatcher.c index 49be0babe..839dababb 100644 --- a/libempathy/empathy-dispatcher.c +++ b/libempathy/empathy-dispatcher.c @@ -1610,6 +1610,19 @@ empathy_dispatcher_call_create_or_ensure_channel ( } } +/** + * empathy_dispatcher_create_channel: + * @self: the EmpathyDispatcher + * @connection: the Connection to dispatch on + * @request: an a{sv} map of properties for the request, i.e. using tp_asv_new() + * @callback: a callback for when the channel arrives (or NULL) + * @user_data: optional user data (or NULL) + * + * When calling this function, #EmpathyDispatcher takes ownership of your + * reference to @request. DO NOT unref or destroy @request. When the request is + * done, @request will be unreferenced. Take another reference if you want to + * keep it around. + */ void empathy_dispatcher_create_channel (EmpathyDispatcher *self, TpConnection *connection, -- cgit v1.2.3