telepathy-glib: TpConnection: describe factory behaviour

[Simon McVittie]

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

Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date:   Fri Sep  6 12:01:18 2013 +0100

TpConnection: describe factory behaviour

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=54061
Reviewed-by: Guillaume Desmottes <guillaume.desmottes at collabora.co.uk>

---

 telepathy-glib/connection.c |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/telepathy-glib/connection.c b/telepathy-glib/connection.c
index aa93d97..177d1fe 100644
--- a/telepathy-glib/connection.c
+++ b/telepathy-glib/connection.c
@@ -65,6 +65,14 @@
  * are implementing a lower-level Telepathy component (such as the account
  * manager service itself).
  *
+ * Since 0.16, #TpConnection always has a non-%NULL #TpProxy:factory, and its
+ * #TpProxy:factory will be propagated to its #TpChannel objects
+ * (if any). Similarly, the #TpProxy:factory<!-- -->'s features
+ * will be used for #TpContact objects.
+ * If a #TpConnection is created without going via the
+ * #TpAccount or specifying a #TpProxy:factory, the default
+ * is to use a new #TpAutomaticClientFactory.
+ *
  * Since: 0.7.1
  */