diff -r 9708227bcb8e -r d256e7a2ec4c doc/reference/libpurple/signals_imgstore.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/libpurple/signals_imgstore.xml Sun Oct 20 15:11:49 2013 +0530 @@ -0,0 +1,30 @@ + + + + Stored Image signals + + + @signals + @signal image-deleting + @endsignals + + @see imgstore.h + + @signaldef image-deleting + @signalproto +char *(*image_deleting)(const PurpleStoredImage *img); + @endsignalproto + @signaldesc + Emitted when a #PurpleStoredImage is about to be destroyed. This allows + for what amounts to weak references. Code can hold onto a pointer to + the PurpleStoredImage without actually "holding" a reference. They can + then use a signal handler to let them know when their img is about to + be destroyed. + @param img The image about to be destroyed. + @note It's not possible to purple_imgstore_ref() img to save it. + @endsignaldef + + +