From: Niels De Graef <nielsdegraef@gmail.com>
Date: Mon, 5 Aug 2019 17:07:54 +0000 (+0200)
Subject: Fix several GObject Introspection warnings
X-Git-Tag: archive/raspbian/1%0.1.106-3+rpi1^2~15^2~11^2~23
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=dca1bac258f66c9ce7b713b084e9fe9a1575ffc0;p=babl.git

Fix several GObject Introspection warnings
---

diff --git a/babl/babl-introspect.h b/babl/babl-introspect.h
index 27f6626..d164031 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 6b44e0d..305ac06 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 e25e519..964abbc 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);