annotate doc/sound-signals.dox @ 30593:e492df53a0f3

ca-certs: Add the Go Daddy Class 2 self-signed root. Fixes #12594 There's another copy of this cert that's a ICA up to ValiCert via some voodoo X.509 hacks, but I went with the self-signed root version (if someone can rationally explain to me why people use the same keying material to make "the same" cert but as an ICA instead of root, please do)

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