HGKeeper

266f7f4e0591

merge of 'ddb96d3b9aab2ad5b20313b9d5c42cda07ebb7f5'
and 'cad3d4a543081fe6d39167d8674b48bde1243fb6'

/** @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