annotate doc/blist-signals.dox @ 8383:ae15e717ca75

[gaim-migrate @ 9111] (00:18:52) lschiere: marv: https://sourceforge.net/tracker/?func=detail&atid=300235&aid=908071&group_id=235 (00:21:24) marv: what does gc->wants_to_die = TRUE; do? is that some sort of hint for the autoreconnect plugin? (00:21:43) lschiere: kinda sorta (00:21:51) lschiere: if a gc wants to die, you signed off (00:22:01) lschiere: if it doesn't, then something killed it, and it should be reconnected (00:22:41) lschiere: i'm not sure how we used to handle that kind of thing for aim (00:23:03) lschiere: but basically if that's what he's doing, he's mimicing you signing off manually (00:23:52) marv: yeah, all the patch does is add that line right before the gaim_connection_error when yahoo receives a patch telling us we got signed off because we signed on with another client (00:24:22) lschiere: i dare say it would work, as long as we can uniquely id when we are kicked off for that reason (00:25:07) marv: i think we do a pretty good job of that, i haven't heard any reports of anyone getting that message when that's not what happened. (00:25:22) marv: then again, i don't remember when i added that, and if yahoo's worked since then. (00:25:36) lschiere: *nods* basically, Rob Foehl figured out a predictable way to work around yahoo being too dumb to handle 2 instances of the same sn on at once. Jabber's done that for years, and aim even figured it out, so you'd think yahoo would get a clue... ;-) committer: Tailor Script <[e-mail]>

/** @page blist-signals Buddy List Signals

 @signals
  @signal buddy-away
  @signal buddy-back
  @signal buddy-idle
  @signal buddy-unidle
  @signal buddy-signed-on
  @signal buddy-signed-off
  @signal update-idle
 @endsignals

 <hr>

 @signaldef buddy-away
  @signalproto
void (*buddy_away)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list goes away.
  @param buddy The buddy that went away.
 @endsignaldef

 @signaldef buddy-back
  @signalproto
void (*buddy_back)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list comes back from being away.
  @param buddy The buddy that came back from being away.
 @endsignaldef

 @signaldef buddy-idle
  @signalproto
void (*buddy_idle)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list becomes idle.
  @param buddy The buddy that became idle.
 @endsignaldef

 @signaldef buddy-unidle
  @signalproto
void (*buddy_unidle)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list returns from being idle.
  @param buddy The buddy that returned from being idle.
 @endsignaldef

 @signaldef buddy-signed-on
  @signalproto
void (*buddy_signed_on)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list signs on.
  @param buddy The buddy that signed on.
 @endsignaldef

 @signaldef buddy-signed-off
  @signalproto
void (*buddy_signed_off)(struct buddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when a buddy on your buddy list signs off.
  @param buddy The buddy that signed off.
 @endsignaldef

 @signaldef update-idle
  @signalproto
void (*update_idle)();
  @endsignalproto
  @signaldesc
   Emitted when the buddy list is refreshed and the idle times are updated.
 @endsignaldef

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