From 68b3d72e1db68b080b61beb1cc8e074475b14b24 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Fri, 6 Sep 2013 11:43:59 +0100 Subject: [PATCH 06/19] TpAccount: document interaction with factories a bit better --- telepathy-glib/account.c | 14 +++++++++++--- 1 file 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 -- 1.8.4.rc3