Deprecate the slow version of TpIntset iteration

1 files changed, 25 insertions, 3 deletions

diff --git a/telepathy-glib/intset.c b/telepathy-glib/intset.c
index 72be3dd25..f5da30c28 100644
--- a/telepathy-glib/intset.c
+++ b/telepathy-glib/intset.c
@@ -96,6 +96,15 @@ tp_intset_get_type (void)
 /* (typedef, see header) */
 
 /**
+ * TpIntSetIter: (skip)
+ *
+ * Before 0.11.16, this was the name for <type>TpIntsetIter</type>, but
+ * it's now just a backwards compatibility typedef.
+ *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
+ */
+
+/**
  * TpIntsetIter:
  * @set: The set iterated over.
  * @element: Must be (guint)(-1) before iteration starts. Set to the next
@@ -110,6 +119,8 @@ tp_intset_get_type (void)
  *
  * Before 0.11.16, this type was called <type>TpIntSetIter</type>,
  * which is now a backwards compatibility typedef.
+ *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
  */
 /* (public, see header) */
 
@@ -128,9 +139,7 @@ tp_intset_get_type (void)
  * }
  * </programlisting></informalexample>
  *
- * Since 0.11.6, consider using #TpIntsetFastIter if iteration in
- * numerical order is not required.
- *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
  */
 /* (macro, see header) */
 
@@ -140,6 +149,8 @@ tp_intset_get_type (void)
  * @set: An integer set to be used by that iterator
  *
  * Reset the iterator @iter to the beginning and make it iterate over @set.
+ *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
  */
 void
 tp_intset_iter_init (
@@ -157,6 +168,8 @@ tp_intset_iter_init (
  *
  * Reset the iterator @iter to the beginning. It must already be associated
  * with a set.
+ *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
  */
 void
 tp_intset_iter_reset (TpIntsetIter *iter)
@@ -873,6 +886,15 @@ tp_intset_iter_next (TpIntsetIter *iter)
 }
 
 /**
+ * TpIntSetFastIter: (skip)
+ *
+ * Before 0.11.16, this was the name for <type>TpIntsetFastIter</type>,
+ * but it's now just a backwards compatibility typedef.
+ *
+ * Deprecated: since 0.UNRELEASED. Use #TpIntsetFastIter instead
+ */
+
+/**
  * TpIntsetFastIter:
  *
  * An opaque structure representing iteration in undefined order over a set of