telepathy-glib: connection-internal. h Add warning comment for APIs that should not be used outside contact.c

[Xavier Claessens]

Module: telepathy-glib
Branch: master
Commit: 7b7fad6ef2d9211489891c66d497b4b720d1b53c
URL:    http://cgit.freedesktop.org/telepathy/telepathy-glib/commit/?id=7b7fad6ef2d9211489891c66d497b4b720d1b53c

Author: Xavier Claessens <xavier.claessens at collabora.co.uk>
Date:   Mon Apr 16 18:43:33 2012 +0200

connection-internal.h Add warning comment for APIs that should not be used outside contact.c

---

 telepathy-glib/connection-internal.h |    2 ++
 1 files changed, 2 insertions(+), 0 deletions(-)

diff --git a/telepathy-glib/connection-internal.h b/telepathy-glib/connection-internal.h
index 65a7376..5cfb63b 100644
--- a/telepathy-glib/connection-internal.h
+++ b/telepathy-glib/connection-internal.h
@@ -137,6 +137,8 @@ void _tp_connection_get_capabilities_async (TpConnection *self,
 gboolean _tp_connection_get_capabilities_finish (TpConnection *self,
     GAsyncResult *result, GError **error);
 
+/* Those functions should be used only from contact.c, they are risky since they
+ * could operate on incomplete contacts */
 void _tp_connection_add_contact (TpConnection *self, TpHandle handle,
     TpContact *contact);
 void _tp_connection_remove_contact (TpConnection *self, TpHandle handle,