Mercurial > pidgin3 / file diff

--- a/libpurple/imgstore.h	Sat Apr 05 02:40:00 2014 +0200
+++ b/libpurple/imgstore.h	Sat Apr 05 03:12:23 2014 +0200
@@ -47,8 +47,9 @@
 typedef struct _PurpleStoredImage PurpleStoredImage;
 
 #define PURPLE_TYPE_STORED_IMAGE (purple_imgstore_get_type())
+
+/* TODO: make it a real GObject */
 #if 0
-/* TODO */
 #define PURPLE_IS_STORED_IMAGE(image) (G_TYPE_CHECK_INSTANCE_TYPE((image), PURPLE_TYPE_STORED_IMAGE))
 #else
 #define PURPLE_IS_STORED_IMAGE(image) ((image) != NULL)
@@ -148,6 +149,15 @@
  */
 int purple_imgstore_new_with_id(gpointer data, size_t size, const char *filename);
 
+/**
+ * purple_imgstore_add_with_id:
+ * @image: The image.
+ *
+ * Adds previously created #PurpleStoredImage to the local store with newly
+ * generated id. If it was already in the store, an old id will be returned.
+ *
+ * Returns: ID for the image.
+ */
 int
 purple_imgstore_add_with_id(PurpleStoredImage *image);