[next] telepathy-glib: TpHandleRepo: Deprecate tp_handle_set/get_qdata()

[Xavier Claessens]

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

Author: Xavier Claessens <xavier.claessens at collabora.co.uk>
Date:   Thu Sep  6 15:13:41 2012 +0200

TpHandleRepo: Deprecate tp_handle_set/get_qdata()

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

---

 telepathy-glib/handle-repo.c |    5 +++++
 telepathy-glib/handle-repo.h |    4 ++++
 2 files changed, 9 insertions(+), 0 deletions(-)

diff --git a/telepathy-glib/handle-repo.c b/telepathy-glib/handle-repo.c
index d633d6f..fa04930 100644
--- a/telepathy-glib/handle-repo.c
+++ b/telepathy-glib/handle-repo.c
@@ -394,6 +394,9 @@ tp_handle_lookup (TpHandleRepoIface *self,
  * Since version 0.13.8, handles always last as long as the
  * connection, so @destroy will not be called until the connection
  * disconnects.
+ *
+ * Deprecated: Since 0.UNRELEASED. It is not recommended to use this function
+ *  because the associated data won't be freed until the connection disconnects.
  */
 
 void
@@ -417,6 +420,8 @@ tp_handle_set_qdata (TpHandleRepoIface *repo,
  *
  * Returns: the data associated with a given key on a given handle; %NULL
  * if there is no associated data.
+ * Deprecated: Since 0.UNRELEASED. It is not recommended to use this function
+ *  because the associated data won't be freed until the connection disconnects.
  */
 gpointer
 tp_handle_get_qdata (TpHandleRepoIface *repo, TpHandle handle,
diff --git a/telepathy-glib/handle-repo.h b/telepathy-glib/handle-repo.h
index ba16fd0..3ddb392 100644
--- a/telepathy-glib/handle-repo.h
+++ b/telepathy-glib/handle-repo.h
@@ -132,10 +132,14 @@ TpHandle tp_handle_ensure_finish (TpHandleRepoIface *self,
     GAsyncResult *result,
     GError **error);
 
+#ifndef TP_DISABLE_DEPRECATED
+_TP_DEPRECATED_IN_0_20
 void tp_handle_set_qdata (TpHandleRepoIface *repo, TpHandle handle,
     GQuark key_id, gpointer data, GDestroyNotify destroy);
+_TP_DEPRECATED_IN_0_20
 gpointer tp_handle_get_qdata (TpHandleRepoIface *repo, TpHandle handle,
     GQuark key_id);
+#endif
 
 /* Handle set helper class */