[gnome-builder/wip/tintou/toolchain] toolchain: add and fix documentation

[Corentin Noël <corentinnoel src gnome org>]

commit b4f73b3075e70301d99c9687fbdb66a8506f66b5
Author: Corentin Noël <corentin noel collabora co uk>
Date:   Thu Apr 26 09:29:06 2018 +0100

    toolchain: add and fix documentation

 src/libide/toolchain/ide-toolchain-manager.c  | 13 +++++++++++++
 src/libide/toolchain/ide-toolchain-provider.c |  4 +++-
 src/libide/toolchain/ide-toolchain.c          | 10 ++++++++++
 3 files changed, 26 insertions(+), 1 deletion(-)
---
diff --git a/src/libide/toolchain/ide-toolchain-manager.c b/src/libide/toolchain/ide-toolchain-manager.c
index 933453148..26cc6292c 100644
--- a/src/libide/toolchain/ide-toolchain-manager.c
+++ b/src/libide/toolchain/ide-toolchain-manager.c
@@ -443,6 +443,8 @@ list_model_iface_init (GListModelInterface *iface)
  * Gets the toolchain by its internal identifier.
  *
  * Returns: (transfer full): An #IdeToolchain.
+ *
+ * Since: 3.30
  */
 IdeToolchain *
 ide_toolchain_manager_get_toolchain (IdeToolchainManager *self,
@@ -465,6 +467,17 @@ ide_toolchain_manager_get_toolchain (IdeToolchainManager *self,
   return NULL;
 }
 
+/**
+ * ide_toolchain_manager_is_loaded:
+ * @self: An #IdeToolchainManager
+ *
+ * Gets whether all the #IdeToolchainProvider implementations are loaded
+ * and have registered all their #IdeToolchain.
+ *
+ * Returns: %TRUE if all the toolchains are loaded
+ *
+ * Since: 3.30
+ */
 gboolean
 ide_toolchain_manager_is_loaded (IdeToolchainManager  *self)
 {
diff --git a/src/libide/toolchain/ide-toolchain-provider.c b/src/libide/toolchain/ide-toolchain-provider.c
index 72adb3cb1..ecc043f53 100644
--- a/src/libide/toolchain/ide-toolchain-provider.c
+++ b/src/libide/toolchain/ide-toolchain-provider.c
@@ -153,7 +153,7 @@ ide_toolchain_provider_default_init (IdeToolchainProviderInterface *iface)
  * before completing the asynchronous function so that the toolchain
  * manager may be made aware of the toolchains.
  *
- * Since: 3.28
+ * Since: 3.30
  */
 void
 ide_toolchain_provider_load_async (IdeToolchainProvider *self,
@@ -175,6 +175,8 @@ ide_toolchain_provider_load_async (IdeToolchainProvider *self,
  * Completes an asynchronous request to ide_toolchain_provider_load_async().
  *
  * Returns: %TRUE if successful; otherwise %FALSE and @error is set.
+ *
+ * Since: 3.30
  */
 gboolean
 ide_toolchain_provider_load_finish (IdeToolchainProvider  *self,
diff --git a/src/libide/toolchain/ide-toolchain.c b/src/libide/toolchain/ide-toolchain.c
index b881943a1..b8577113b 100644
--- a/src/libide/toolchain/ide-toolchain.c
+++ b/src/libide/toolchain/ide-toolchain.c
@@ -65,6 +65,16 @@ ide_toolchain_get_id (IdeToolchain  *self)
   return priv->id;
 }
 
+
+/**
+ * ide_toolchain_set_id:
+ * @self: an #IdeToolchain
+ * @id: the unique identifier
+ *
+ * Sets the internal identifier of the toolchain
+ *
+ * Since: 3.30
+ */
 void
 ide_toolchain_set_id (IdeToolchain  *self,
                       const gchar   *id)