view doc/sound-signals.dox @ 28878:86ff30fb8ae3

http://dev.aol.com/aim/oscar/ says, "All strings in Feedbag are UTF8 encoded." So stop trying to validate stuff as utf8 then salvage when it isn't and just display broken crap or crash. I'm not sure if this is actually a good idea. Our cleanlist function in family_feedbag.c should probably remove or fix strings that aren't utf8, but I'm not about to do that right now. If someone else wants to feel free.

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