view doc/sound-signals.dox @ 17834:18b62b0fc253

Get outta my house. This adds a failsafe for the "Logged In" tooltip in the buddy list. If the logged in time is greater than two years then something is wrong (most likely the user's local clock is wrong). In that case, show the actual date the person signed on instead of showing "12 hours and 15 minutes ago" This idea courtesy of one Sean Egan. References #698

/** @page sound-signals Sound Signals

 @signals
  @signal playing-sound-event
 @endsignals

 <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 tw=75 et