[Telepathy-commits] [telepathy-glib/master] BaseConnection: discourage setting ::self_handle directly once CONNECTED

[Will Thompson]

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

diff --git a/telepathy-glib/base-connection.h b/telepathy-glib/base-connection.h
index c42fc02..5b8c2be 100644
--- a/telepathy-glib/base-connection.h
+++ b/telepathy-glib/base-connection.h
@@ -218,7 +218,9 @@ struct _TpBaseConnectionClass {
  *  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.
+ *  to the handle. Changing this property directly having moved to state
+ *  CONNECTED is very strongly discouraged, as this will prevent the
+ *  SelfHandleChanged signal being emitted.
  *
  * Data structure representing a generic #TpSvcConnection implementation.
  *
-- 
1.5.6.3