Attachment 48955 Details for Bug 29022 – McdHandlerMap: add brief documentation

[patch] McdHandlerMap: add brief documentation

0002-McdHandlerMap-add-brief-documentation.patch (text/plain), 2.86 KB, created by Simon McVittie on 2011-07-11 01:39:48 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2011-07-11 01:39:48 UTC

Size: 2.86 KB

patch

obsolete

>From 9de74f6272d8e4253b0c235f18916d3510e29406 Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Thu, 19 May 2011 17:30:25 +0100
>Subject: [PATCH 2/4] McdHandlerMap: add brief documentation
>
>---
> src/mcd-handler-map.c |   37 +++++++++++++++++++++++++++++++++++++
> 1 files changed, 37 insertions(+), 0 deletions(-)
>
>diff --git a/src/mcd-handler-map.c b/src/mcd-handler-map.c
>index 933a0ae..d750006 100644
>--- a/src/mcd-handler-map.c
>+++ b/src/mcd-handler-map.c
>@@ -204,6 +204,12 @@ _mcd_handler_map_new (TpDBusDaemon *dbus_daemon)
>                          NULL);
> }
> 
>+/*
>+ * @well_known_name: (out): the well-known Client name of the handler,
>+ *  or %NULL if not known (or if it's Mission Control itself)
>+ *
>+ * Returns: (transfer none): the unique name of the handler
>+ */
> const gchar *
> _mcd_handler_map_get_handler (McdHandlerMap *self,
>                               const gchar *channel_path,
>@@ -216,6 +222,17 @@ _mcd_handler_map_get_handler (McdHandlerMap *self,
>     return g_hash_table_lookup (self->priv->channel_processes, channel_path);
> }
> 
>+/*
>+ * @channel_path: a channel
>+ * @unique_name: the unique name of the handler
>+ * @well_known_name: the well-known name of the handler, or %NULL if not known
>+ *  (or if it's Mission Control itself)
>+ *
>+ * Record that @channel_path is being handled by the Client
>+ * @well_known_name, whose unique name is @unique_name.
>+ *
>+ * Returns: (transfer none): the unique name of the handler
>+ */
> void
> _mcd_handler_map_set_path_handled (McdHandlerMap *self,
>                                    const gchar *channel_path,
>@@ -316,6 +333,19 @@ handled_channel_invalidated_cb (TpChannel *channel,
>     g_object_unref (self);
> }
> 
>+/*
>+ * @channel: a channel
>+ * @unique_name: the unique name of the handler
>+ * @well_known_name: the well-known name of the handler, or %NULL if not known
>+ *  (or if it's Mission Control itself)
>+ * @account_path: the account that @channel came from, or %NULL if not known
>+ *
>+ * Record that @channel_path is being handled by the Client
>+ * @well_known_name, whose unique name is @unique_name.
>+ * The record will be removed if the channel closes or is invalidated.
>+ *
>+ * Returns: (transfer none): the unique name of the handler
>+ */
> void
> _mcd_handler_map_set_channel_handled (McdHandlerMap *self,
>                                       TpChannel *channel,
>@@ -409,12 +439,19 @@ mcd_handler_map_name_owner_cb (TpDBusDaemon *dbus_daemon,
>     }
> }
> 
>+/*
>+ * Returns: (transfer container): all channels that are being handled
>+ */
> GList *
> _mcd_handler_map_get_handled_channels (McdHandlerMap *self)
> {
>     return g_hash_table_get_values (self->priv->handled_channels);
> }
> 
>+/*
>+ * Returns: (transfer none): the account that @channel_path belongs to,
>+ *  or %NULL if not known
>+ */
> const gchar *
> _mcd_handler_map_get_channel_account (McdHandlerMap *self,
>     const gchar *channel_path)
>-- 
>1.7.5.4
>

Actions: View | Splinter Review

Attachments on bug 29022: 48954 | 48955 | 48956 | 48957

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.