telepathy-glib: TpAccountManager: fix documentation of how many accounts are prepared

[Simon McVittie]

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

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

TpAccountManager: fix documentation of how many accounts are prepared

The documentation had fewer guarantees than the implementation: since
0.16, we've delayed notification of new accounts until they're prepared.

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

---

 telepathy-glib/account-manager.c |   13 ++++---------
 1 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/telepathy-glib/account-manager.c b/telepathy-glib/account-manager.c
index 679000d..502f8da 100644
--- a/telepathy-glib/account-manager.c
+++ b/telepathy-glib/account-manager.c
@@ -151,15 +151,10 @@ G_DEFINE_TYPE (TpAccountManager, tp_account_manager, TP_TYPE_PROXY)
  *
  * When this feature is prepared, the list of accounts have been retrieved and
  * are available for use, and change-notification has been set up.
- * Additionally, the #TpAccount objects for accounts which existed at the time
- * this feature was prepared will have #TP_ACCOUNT_FEATURE_CORE prepared, but
- * #TpAccount objects subsequently announced by
- * #TpAccountManager::account-validity-changed are <emphasis>not</emphasis>
- * guaranteed to have this feature prepared. In practice, this means that
- * the accounts returned by calling tp_account_manager_dup_valid_accounts()
- * immediately after successfully calling tp_proxy_prepare_finish() on the
- * #TpAccountManager will have #TP_ACCOUNT_FEATURE_CORE prepared, but later
- * calls to that function do not have the same guarantee.
+ * Additionally, since 0.16 the #TpAccount objects returned by
+ * tp_account_manager_dup_valid_accounts() have their
+ * features prepared as configured by the #TpProxy:factory; in particular,
+ * they will all have %TP_ACCOUNT_FEATURE_CORE.
  *
  * One can ask for a feature to be prepared using the
  * tp_proxy_prepare_async() function, and waiting for it to callback.