[babl] Fix several GObject Introspection warnings

[Øyvind "pippin" Kolås <ok src gnome org>]

commit dca1bac258f66c9ce7b713b084e9fe9a1575ffc0
Author: Niels De Graef <nielsdegraef gmail com>
Date:   Mon Aug 5 19:07:54 2019 +0200

    Fix several GObject Introspection warnings

 babl/babl-introspect.h |  9 ++++++++-
 babl/babl-version.h.in |  9 ++++++++-
 babl/babl.h            | 11 ++++-------
 3 files changed, 20 insertions(+), 9 deletions(-)
---
diff --git a/babl/babl-introspect.h b/babl/babl-introspect.h
index 27f662687..d1640310f 100644
--- a/babl/babl-introspect.h
+++ b/babl/babl-introspect.h
@@ -19,8 +19,15 @@
 #ifndef _BABL_INTROSPECT_H
 #define _BABL_INTROSPECT_H
 
+#include <babl/babl.h>
 
-void         babl_introspect (Babl       *babl); /* introspect a given BablObject     */
+/**
+ * babl_introspect:
+ * @babl: A #Babl
+ *
+ * introspect a given BablObject
+ */
+void         babl_introspect (Babl       *babl);
 
 
 #endif
diff --git a/babl/babl-version.h.in b/babl/babl-version.h.in
index 6b44e0d91..305ac061e 100644
--- a/babl/babl-version.h.in
+++ b/babl/babl-version.h.in
@@ -36,7 +36,14 @@
 #define BABL_MINOR_VERSION @BABL_MINOR_VERSION@
 #define BABL_MICRO_VERSION @BABL_MICRO_VERSION@
 
-/** Get the version information on the babl library */
+/** 
+ * babl_get_version:
+ * @major: (out): The major version number
+ * @minor: (out): The minor version number
+ * @micro: (out): The micro version number
+ *
+ * Get the version information on the babl library
+ */
 void   babl_get_version (int *major,
                          int *minor,
                          int *micro);
diff --git a/babl/babl.h b/babl/babl.h
index e25e51997..964abbc51 100644
--- a/babl/babl.h
+++ b/babl/babl.h
@@ -111,12 +111,10 @@ typedef enum {
 
 /**
  * babl_space_from_icc:
- *
  * @icc_data: pointer to icc profile in memory
  * @icc_length: length of icc profile in bytes
  * @intent: the intent from the ICC profile to use.
- *
- " @error: pointer to a string where decoding errors can be stored,
+ * @error: (out): pointer to a string where decoding errors can be stored,
  *         if an error occurs, NULL is returned and an error message
  *         is provided in error.
  *
@@ -618,16 +616,15 @@ int babl_model_is (const Babl *babl, const char *model_name);
 
 /**
  * babl_space_get_icc:
+ * @babl: a #Babl
+ * @length: (out) (optional): Length of the profile in bytes.
  *
  * Return pointer to ICC profile for space note that this is
  * the ICC profile for R'G'B', though in formats only supporting linear
  * like EXR GEGL chooses to load this lienar data as RGB and use the sRGB
  * TRC.
  *
- * @babl: a BablSpace
- * @length: point to an integer where length of profile in bytes is stored.
- *
- * Returns pointer to ICC profile data.
+ * Returns: pointer to ICC profile data.
  */
 const char *babl_space_get_icc (const Babl *babl, int *length);