[Telepathy-commits] [telepathy-glib/master] BaseConnection: deprecate setting self_handle directly

[Will Thompson]

---
 telepathy-glib/base-connection.h |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)

diff --git a/telepathy-glib/base-connection.h b/telepathy-glib/base-connection.h
index 6b806e2..c42fc02 100644
--- a/telepathy-glib/base-connection.h
+++ b/telepathy-glib/base-connection.h
@@ -215,7 +215,10 @@ struct _TpBaseConnectionClass {
  *  subclasses: use tp_base_connection_change_status() to set it.
  * @self_handle: The handle of type %TP_HANDLE_TYPE_CONTACT representing the
  *  local user. Must be set nonzero by the subclass before moving to state
- *  CONNECTED. If nonzero, the connection must hold a reference to the handle.
+ *  CONNECTED. Since 0.7.UNRELEASED, setting this property directly is
+ *  deprecated, in favour of tp_base_connection_set_self_handle(); if this
+ *  property is set directly, the connection must ensure it holds a reference
+ *  to the handle.
  *
  * Data structure representing a generic #TpSvcConnection implementation.
  *
-- 
1.5.6.3