Annotate new Channel API as Since: 0.7.12telepathy-glib_0.7.12telepathy-glib-0.7.12

20080721092849-53eee-4e26531707b2e2f0f973c1d054921b3317caef7b.gz

2 files changed, 20 insertions, 0 deletions

diff --git a/telepathy-glib/channel-group.c b/telepathy-glib/channel-group.c
index f93598086..9884c28e4 100644
--- a/telepathy-glib/channel-group.c
+++ b/telepathy-glib/channel-group.c
@@ -73,6 +73,7 @@ local_pending_info_free (LocalPendingInfo *info)
  * of that property for notes on validity).
  *
  * Returns: the handle representing the user, or 0
+ * Since: 0.7.12
  */
 TpHandle
 tp_channel_group_get_self_handle (TpChannel *self)
@@ -89,6 +90,7 @@ tp_channel_group_get_self_handle (TpChannel *self)
  * of that property for notes on validity).
  *
  * Returns: the group flags, or 0
+ * Since: 0.7.12
  */
 TpChannelGroupFlags
 tp_channel_group_get_flags (TpChannel *self)
@@ -110,6 +112,7 @@ tp_channel_group_get_flags (TpChannel *self)
  * If @self is not a group, return %NULL.
  *
  * Returns: the members, or %NULL
+ * Since: 0.7.12
  */
 const TpIntSet *
 tp_channel_group_get_members (TpChannel *self)
@@ -131,6 +134,7 @@ tp_channel_group_get_members (TpChannel *self)
  * If @self is not a group, return %NULL.
  *
  * Returns: the local-pending members, or %NULL
+ * Since: 0.7.12
  */
 const TpIntSet *
 tp_channel_group_get_local_pending (TpChannel *self)
@@ -152,6 +156,7 @@ tp_channel_group_get_local_pending (TpChannel *self)
  * If @self is not a group, return %NULL.
  *
  * Returns: the remote-pending members, or %NULL
+ * Since: 0.7.12
   */
 const TpIntSet *
 tp_channel_group_get_remote_pending (TpChannel *self)
@@ -180,6 +185,7 @@ tp_channel_group_get_remote_pending (TpChannel *self)
  * and "" into @message, and return %FALSE.
  *
  * Returns: %TRUE if the contact is in fact local-pending
+ * Since: 0.7.12
  */
 gboolean
 tp_channel_group_get_local_pending_info (TpChannel *self,
@@ -273,6 +279,7 @@ tp_channel_group_get_local_pending_info (TpChannel *self,
  * without extra D-Bus round trips is not possible using the older API).
  *
  * Returns: the global handle that owns the given handle, or 0
+ * Since: 0.7.12
  */
 TpHandle
 tp_channel_group_get_handle_owner (TpChannel *self,
diff --git a/telepathy-glib/channel.c b/telepathy-glib/channel.c
index 0ef856f38..1ab752210 100644
--- a/telepathy-glib/channel.c
+++ b/telepathy-glib/channel.c
@@ -117,6 +117,7 @@ G_DEFINE_TYPE_WITH_CODE (TpChannel,
  *
  * Returns: the channel type, if the channel is ready; either the channel
  *  type or %NULL, if the channel is not yet ready.
+ * Since: 0.7.12
  */
 const gchar *
 tp_channel_get_channel_type (TpChannel *self)
@@ -137,6 +138,7 @@ tp_channel_get_channel_type (TpChannel *self)
  *
  * Returns: the channel type, if the channel is ready; either the channel
  *  type or 0, if the channel is not yet ready.
+ * Since: 0.7.12
  */
 GQuark
 tp_channel_get_channel_type_id (TpChannel *self)
@@ -163,6 +165,7 @@ tp_channel_get_channel_type_id (TpChannel *self)
  * #TpChannel:handle-type property.
  *
  * Returns: the handle
+ * Since: 0.7.12
  */
 TpHandle
 tp_channel_get_handle (TpChannel *self,
@@ -184,6 +187,7 @@ tp_channel_get_handle (TpChannel *self,
  * Returns the same thing as the #TpChannel:channel-ready property.
  *
  * Returns: %TRUE if introspection has completed
+ * Since: 0.7.12
  */
 gboolean
 tp_channel_is_ready (TpChannel *self)
@@ -200,6 +204,7 @@ tp_channel_is_ready (TpChannel *self)
  * while this channel is valid - reference it with g_object_ref() if needed.
  *
  * Returns: the value of #TpChannel:connection
+ * Since: 0.7.12
  */
 TpConnection *
 tp_channel_borrow_connection (TpChannel *self)
@@ -729,6 +734,8 @@ tp_channel_class_init (TpChannelClass *klass)
    * Otherwise, either a handle representing the user, or 0.
    *
    * Change notification is via notify::group-self-handle.
+   *
+   * Since: 0.7.12
    */
   param_spec = g_param_spec_uint ("group-self-handle", "Group.SelfHandle",
       "Undefined if not a group", 0, G_MAXUINT32, 0,
@@ -748,6 +755,8 @@ tp_channel_class_init (TpChannelClass *klass)
    *
    * Change notification is via notify::group-flags or
    * TpChannel::group-flags-changed.
+   *
+   * Since: 0.7.12
    */
   param_spec = g_param_spec_uint ("group-flags", "Group.GroupFlags",
       "0 if not a group", 0, G_MAXUINT32, 0,
@@ -764,6 +773,8 @@ tp_channel_class_init (TpChannelClass *klass)
    *
    * Emitted when the #TpChannel:group-flags property changes while the
    * channel is ready.
+   *
+   * Since: 0.7.12
    */
   signals[SIGNAL_GROUP_FLAGS_CHANGED] = g_signal_new ("group-flags-changed",
       G_OBJECT_CLASS_TYPE (klass),
@@ -788,6 +799,8 @@ tp_channel_class_init (TpChannelClass *klass)
    * @reason: the reason for the change as a #TpChannelGroupChangeReason
    *
    * Emitted when the group members change in a Group channel that is ready.
+   *
+   * Since: 0.7.12
    */
   signals[SIGNAL_GROUP_MEMBERS_CHANGED] = g_signal_new (
       "group-members-changed", G_OBJECT_CLASS_TYPE (klass),