view doc/sound-signals.dox @ 23321:a61bb76597fc

patch from Andrew Gaul that fixes a memleak, we weren't free'ing this when we can't connect to fetch the image, I think: ==2802== 34 (24 direct, 10 indirect) bytes in 1 blocks are definitely lost in loss record 48 of 289 ==2802== at 0x4A05854: calloc (vg_replace_malloc.c:397) ==2802== by 0x331303F849: g_malloc0 (in /lib64/libglib-2.0.so.0.1600.3) ==2802== by 0xE653A86: yahoo_process_picture (yahoo_picture.c:130) ==2802== by 0xE6474C4: yahoo_packet_process (yahoo.c:2448) ==2802== by 0xE648A42: yahoo_pending (yahoo.c:2575) ==2802== by 0x461B9D: pidgin_io_invoke (gtkeventloop.c:78) ==2802== by 0x331303749A: g_main_context_dispatch (in /lib64/libglib-2.0.so.0.1600.3) ==2802== by 0x331303AC7C: (within /lib64/libglib-2.0.so.0.1600.3) ==2802== by 0x331303B1AC: g_main_loop_run (in /lib64/libglib-2.0.so.0.1600.3) ==2802== by 0x3317584887: gtk_main (in /usr/lib64/libgtk-x11-2.0.so.0.1200.9) ==2802== by 0x4788A7: main (gtkmain.c:893)

/** @page sound-signals Sound Signals

 @signals
  @signal playing-sound-event
 @endsignals

 @see sound.h

 <hr>

 @signaldef playing-sound-event
  @signalproto
gboolean (*playing_sound_event)(PurpleSoundEventID event, PurpleAccount *account);
  @endsignalproto
  @signaldesc
   Emitted when libpurple is going to play a sound event. This can be used to cancel playing sound by returning TRUE.
  @param event   The event this sound represents.
  @param account The account the sound is being played for.
  @return @c TRUE if the sound should not be played, or @c FALSE otherwise.
 @endsignaldef

 */
// vim: syntax=c.doxygen tw=75 et