Mercurial > pidgin
changeset 16680:61ddeb85ab86
Document the image-deleting signal.
| author | Richard Laager <rlaager@wiktel.com> |
|---|---|
| date | Sun, 29 Apr 2007 23:34:04 +0000 |
| parents | 07b5cf0a46e2 |
| children | bb902111bd9c |
| files | doc/Makefile.am doc/imgstore-signals.dox libpurple/buddyicon.c |
| diffstat | 3 files changed, 26 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/Makefile.am Sun Apr 29 23:23:17 2007 +0000 +++ b/doc/Makefile.am Sun Apr 29 23:34:04 2007 +0000 @@ -21,6 +21,7 @@ gtklog-signals.dox \ gtkimhtml-signals.dox \ gtkrc-2.0 \ + imgstore-signals.dox \ log-signals.dox \ notify-signals.dox \ pidgin.1.in \
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/imgstore-signals.dox Sun Apr 29 23:34:04 2007 +0000 @@ -0,0 +1,24 @@ +/** @page imgstore-signals Image Store Signals + + @signals + @signal image-deleting + @endsignals + + <hr> + + @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 + +*/ +// vim: syntax=c tw=75 et
--- a/libpurple/buddyicon.c Sun Apr 29 23:23:17 2007 +0000 +++ b/libpurple/buddyicon.c Sun Apr 29 23:34:04 2007 +0000 @@ -208,7 +208,7 @@ } static void -image_deleting_cb(PurpleStoredImage *img, gpointer data) +image_deleting_cb(const PurpleStoredImage *img, gpointer data) { const char *filename = purple_imgstore_get_filename(img);