summaryrefslogtreecommitdiff
path: root/telepathy-glib/channel-request.c
diff options
context:
space:
mode:
authorGuillaume Desmottes <guillaume.desmottes@collabora.co.uk>2011-02-22 16:08:13 +0100
committerGuillaume Desmottes <guillaume.desmottes@collabora.co.uk>2011-02-22 16:29:49 +0100
commitbb953c79a4052a96e3e57b96c25f57ab54437fb6 (patch)
tree411036fc8ff43852d631fe724ce18c53bc093223 /telepathy-glib/channel-request.c
parent8b69a0cfa0f9bf13273bea2207dfdb48a9370381 (diff)
downloadtelepathy-glib-bb953c79a4052a96e3e57b96c25f57ab54437fb6.tar.gz
improve doc
Diffstat (limited to 'telepathy-glib/channel-request.c')
-rw-r--r--telepathy-glib/channel-request.c8
1 files changed, 5 insertions, 3 deletions
diff --git a/telepathy-glib/channel-request.c b/telepathy-glib/channel-request.c
index 34794aab4..e4d471119 100644
--- a/telepathy-glib/channel-request.c
+++ b/telepathy-glib/channel-request.c
@@ -409,7 +409,8 @@ tp_channel_request_class_init (TpChannelRequestClass *klass)
* Emitted when the channel request succeeds.
*
* Deprecated: since 0.13.UNRELEASED. Use
- * #TpChannelRequest::succeeded-with-channel instead
+ * #TpChannelRequest::succeeded-with-channel, which provides the resulting
+ * channel, instead.
*/
signals[SIGNAL_SUCCEEDED] = g_signal_new ("succeeded",
G_OBJECT_CLASS_TYPE (klass),
@@ -427,8 +428,9 @@ tp_channel_request_class_init (TpChannelRequestClass *klass)
*
* Emitted when the channel request succeeds.
*
- * @connection and @channel may be %NULL your telepathy-mission-control is
- * too old (< 5.7.1).
+ * With telepathy-mission-control version 5.7.1 and earlier, @connection and
+ * @channel will be %NULL. When using newer versions, they will be correctly
+ * set to the newly-created channel, and the connection which owns it.
*
* The #TpChannel is created using #TpChannelRequest:channel-factory but
* the features of the factory are NOT prepared. It's up to the user to