Fix several GObject Introspection warnings
authorNiels De Graef <nielsdegraef@gmail.com>
Mon, 5 Aug 2019 17:07:54 +0000 (19:07 +0200)
committerØyvind Kolås <pippin@gimp.org>
Tue, 6 Aug 2019 18:34:20 +0000 (20:34 +0200)
babl/babl-introspect.h
babl/babl-version.h.in
babl/babl.h

index 27f662687a217a669de30d563e69c5e882880536..d1640310f8a722f6c73adb46d816bae17fc6b520 100644 (file)
 #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
index 6b44e0d91b96755edb76f57f79a9cefa52bfa71a..305ac061e10e35081a0617f935e18e64d723d198 100644 (file)
 #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);
index e25e519972abffc1ec9e3018ac896ff80d6ea636..964abbc515e82abf5ead74c6c9e71ec7378ac174 100644 (file)
@@ -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);