[telepathy-glib/master] account{, -manager}: add more notes on what each core feature means

[Jonny Lamb]

Signed-off-by: Jonny Lamb <jonny.lamb at collabora.co.uk>
---
 telepathy-glib/account-manager.c |   24 +++++++++++++++---------
 telepathy-glib/account.c         |    7 +++++++
 2 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/telepathy-glib/account-manager.c b/telepathy-glib/account-manager.c
index 8e5da0b..88074e7 100644
--- a/telepathy-glib/account-manager.c
+++ b/telepathy-glib/account-manager.c
@@ -118,6 +118,21 @@ static guint signals[LAST_SIGNAL];
 G_DEFINE_TYPE (TpAccountManager, tp_account_manager, TP_TYPE_PROXY);
 
 /**
+ * TP_ACCOUNT_MANAGER_FEATURE_CORE:
+ *
+ * Expands to a call to a function that returns a quark for the "core" feature
+ * on a #TpAccountManager.
+ *
+ * When this feature is prepared, the list of accounts have been retrieved and
+ * are available for use, and change-notification has been set up.
+ *
+ * One can ask for a feature to be prepared using the
+ * tp_account_manager_prepare_async() function, and waiting for it to callback.
+ *
+ * Since: 0.7.UNRELEASED
+ */
+
+/**
  * tp_account_manager_get_feature_quark_core:
  *
  * <!-- -->
@@ -1321,15 +1336,6 @@ tp_account_manager_create_account_finish (TpAccountManager *manager,
 }
 
 /**
- * TP_ACCOUNT_MANAGER_FEATURE_CORE:
- *
- * Expands to a call to a function that returns a quark for the "core" feature
- * on a #TpAccountManager.
- *
- * Since: 0.7.UNRELEASED
- */
-
-/**
  * tp_account_manager_is_ready:
  * @manager: a #TpAccountManager
  * @feature: a feature which is required
diff --git a/telepathy-glib/account.c b/telepathy-glib/account.c
index 7e1247c..28086b6 100644
--- a/telepathy-glib/account.c
+++ b/telepathy-glib/account.c
@@ -167,6 +167,13 @@ enum {
  * Expands to a call to a function that returns a quark for the "core" feature
  * on a #TpAccount.
  *
+ * When this feature is prepared, the basic properties of the Account have
+ * been retrieved and are available for use, and change-notification has been
+ * set up.
+ *
+ * One can ask for a feature to be prepared using the
+ * tp_account_prepare_async() function, and waiting for it to callback.
+ *
  * Since: 0.7.UNRELEASED
  */
 
-- 
1.5.6.5