comparison doc/imgstore-signals.dox @ 20869:2a6ef74f5a4e

merge of '3efb5d625e5a73423be8be77a6baeed0b65f7e55' and 'c848ad4c20988b5dac9ac164455d3ba2d7307230'
author Sadrul Habib Chowdhury <imadil@gmail.com>
date Wed, 10 Oct 2007 01:06:16 +0000
parents e0613cf8c493
children
comparison
equal deleted inserted replaced
20805:e0ce7124d2d4 20869:2a6ef74f5a4e
1 /** @page imgstore-signals Image Store Signals 1 /** @page imgstore-signals Image Store Signals
2 2
3 @signals 3 @signals
4 @signal image-deleting 4 @signal image-deleting
5 @endsignals 5 @endsignals
6
7 @see imgstore.h
6 8
7 <hr> 9 <hr>
8 10
9 @signaldef image-deleting 11 @signaldef image-deleting
10 @signalproto 12 @signalproto
11 char *(*image_deleting)(const PurpleStoredImage *img); 13 char *(*image_deleting)(const PurpleStoredImage *img);
12 @endsignalproto 14 @endsignalproto
13 @signaldesc 15 @signaldesc
14 Emitted when a PurpleStoredImage is about to be destroyed. This allows 16 Emitted when a #PurpleStoredImage is about to be destroyed. This allows
15 for what amounts to weak references. Code can hold onto a pointer to 17 for what amounts to weak references. Code can hold onto a pointer to
16 the PurpleStoredImage without actually "holding" a reference. They can 18 the PurpleStoredImage without actually "holding" a reference. They can
17 then use a signal handler to let them know when their img is about to 19 then use a signal handler to let them know when their img is about to
18 be destroyed. 20 be destroyed.
19 @param img The image about to be destroyed. 21 @param img The image about to be destroyed.
20 @note It's not possible to purple_imgstore_ref() img to save it. 22 @note It's not possible to purple_imgstore_ref() img to save it.
21 @endsignaldef 23 @endsignaldef
22 24
23 */ 25 */
24 // vim: syntax=c tw=75 et 26 // vim: syntax=c.doxygen tw=75 et