view doc/sound-signals.dox @ 22292:5aabf4e24188

In msimprpl, for server-side contacts, first search for an existing group on the client before creating one and adding it to the beginning of the list. If there is an existing group, use that. Fixes problem where MySpaceIM groups always move to the top of the buddy list upon sign-on, because they were always created anew. Closes #3378.

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