libgimpthumb: fix all gtk-doc warnings, and reach 100% doc coverage, yay!

libgimpthumb/gimpthumb-enums.h

@@ -85,8 +85,8 @@ typedef enum
  * GimpThumbState:
  * @GIMP_THUMB_STATE_UNKNOWN:   nothing is known about the file/thumbnail
  * @GIMP_THUMB_STATE_REMOTE:    the file is on a remote file system
- * @GIMP_THUMB_STATE_FOLDER:
- * @GIMP_THUMB_STATE_SPECIAL:
+ * @GIMP_THUMB_STATE_FOLDER:    the file is a directory
+ * @GIMP_THUMB_STATE_SPECIAL:   the file is a special file
  * @GIMP_THUMB_STATE_NOT_FOUND: the file/thumbnail doesn't exist
  * @GIMP_THUMB_STATE_EXISTS:    the file/thumbnail exists
  * @GIMP_THUMB_STATE_OLD:       the thumbnail may be outdated

libgimpthumb/gimpthumb-utils.c

@@ -186,8 +186,8 @@ gimp_thumb_get_thumb_dir (GimpThumbSize  size)
 
 /**
  * gimp_thumb_get_thumb_dir_local:
- * @dirname:
- * @size: a GimpThumbSize
+ * @dirname: the basename of the dir, without the actual dirname itself
+ * @size:    a GimpThumbSize
  *
  * Retrieve the name of the local thumbnail folder for a specific
  * size.  Unlike gimp_thumb_get_thumb_dir() the returned string is not
@@ -260,9 +260,9 @@ gimp_thumb_ensure_thumb_dir (GimpThumbSize   size,
 
 /**
  * gimp_thumb_ensure_thumb_dir_local:
- * @dirname:
- * @size: a GimpThumbSize
- * @error: return location for possible errors
+ * @dirname: the basename of the dir, without the actual dirname itself
+ * @size:    a GimpThumbSize
+ * @error:   return location for possible errors
  *
  * This function checks if the directory that is required to store
  * local thumbnails for a particular @size exist and attempts to

libgimpthumb/gimpthumbnail.c

@@ -169,6 +169,8 @@ gimp_thumbnail_class_init (GimpThumbnailClass *klass)
   /**
    * GimpThumbnail::image-mimetype:
    *
+   * Image mimetype
+   *
    * Since: GIMP 2.2
    **/
   g_object_class_install_property (object_class,

libgimpthumb/gimpthumbnail.h

@@ -38,6 +38,12 @@ G_BEGIN_DECLS
 
 typedef struct _GimpThumbnailClass GimpThumbnailClass;
 
+/**
+ * GimpThumbnail:
+ *
+ * All members of #GimpThumbnail are private and should only be accessed
+ * using object properties.
+ **/
 struct _GimpThumbnail
 {
   GObject         parent_instance;