[next] telepathy-glib: TpAccount: document interaction with factories a bit better

[Simon McVittie]

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

Author: Simon McVittie <simon.mcvittie at collabora.co.uk>
Date:   Fri Sep  6 11:43:59 2013 +0100

TpAccount: document interaction with factories a bit better

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

---

 telepathy-glib/account.c |   14 +++++++++++---
 1 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/telepathy-glib/account.c b/telepathy-glib/account.c
index 23cc796..a342fd4 100644
--- a/telepathy-glib/account.c
+++ b/telepathy-glib/account.c
@@ -73,6 +73,14 @@
  * for many of the properties on this object. Refer to each property's
  * documentation for whether it can be used in this way.
  *
+ * #TpAccount objects should normally be obtained from the #TpAccountManager.
+ *
+ * Since 0.16, #TpAccount always has a non-%NULL #TpProxy:factory, and its
+ * #TpProxy:factory will be propagated to its #TpConnection
+ * (if any). If a #TpAccount is created without going via the
+ * #TpAccountManager or specifying a #TpProxy:factory, the default
+ * is to use a new #TpAutomaticClientFactory.
+ *
  * Since: 0.7.32
  */
 
@@ -232,9 +240,9 @@ connection_is_internal (TpAccount *self)
  * feature on a #TpAccount.
  *
  * When this feature is prepared, it is guaranteed that #TpAccount:connection
- * will always be either %NULL or prepared. If the account was created using a
- * #TpSimpleClientFactory, the same factory will be used to create #TpConnection
- * object and to determine desired connection features. Change notification of
+ * will always be either %NULL or prepared. The account's #TpProxy:factory
+ * will be used to create the #TpConnection object and to determine its
+ * desired connection features. Change notification of the
  * #TpAccount:connection property will be delayed until all features (at least
  * %TP_CONNECTION_FEATURE_CORE) are prepared. See
  * tp_simple_client_factory_add_account_features() to define which features