[next] telepathy-glib: tp_channel_dispatch_operation_get_channels: annotate return type, don't skip

[Simon McVittie]

Module: telepathy-glib
Branch: next
Commit: 68022368089c6430df6577fd1718f75e60cdc57c
URL:    http://cgit.freedesktop.org/telepathy/telepathy-glib/commit/?id=68022368089c6430df6577fd1718f75e60cdc57c

Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date:   Wed Sep 19 13:56:28 2012 +0100

tp_channel_dispatch_operation_get_channels: annotate return type, don't skip

The justification for (skip)ing it is that it's just a binding for a
property, but the underlying property is not useful from g-i due to
a g-i limitation (GPtrArray properties can't be annotated with their
element types, https://bugzilla.gnome.org/show_bug.cgi?id=663846).

https://bugs.freedesktop.org/show_bug.cgi?id=55102

---

 telepathy-glib/channel-dispatch-operation.c |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/telepathy-glib/channel-dispatch-operation.c b/telepathy-glib/channel-dispatch-operation.c
index 71742f4..92e2940 100644
--- a/telepathy-glib/channel-dispatch-operation.c
+++ b/telepathy-glib/channel-dispatch-operation.c
@@ -1119,7 +1119,7 @@ tp_channel_dispatch_operation_get_account (
 }
 
 /**
- * tp_channel_dispatch_operation_get_channels: (skip)
+ * tp_channel_dispatch_operation_get_channels:
  * @self: a #TpChannelDispatchOperation
  *
  * Returns a #GPtrArray containing the #TpChannel of this
@@ -1127,7 +1127,8 @@ tp_channel_dispatch_operation_get_account (
  * The returned array and its #TpChannel are only valid while @self is
  * valid - copy array and reference channels with g_object_ref() if needed.
  *
- * Returns: (transfer none): the value of #TpChannelDispatchOperation:channels
+ * Returns: (transfer none) (element-type TelepathyGLib.Channel): the value
+ *  of #TpChannelDispatchOperation:channels
  *
  * Since: 0.19.9
  */