annotate doc/gtkblist-signals.dox @ 9075:0d5206ffe86a

[gaim-migrate @ 9851] Fixed a privacy-related bug in MSN that affected blocking/permitting, which was due to case-sensitive string comparisons. Patch by Gudmundur Olafsson. 13:19:27 <Aquatopia> I block myself: [e-mail] 13:19:43 <Aquatopia> and when I wanna unblock me, I go to the tools | privacy window 13:20:05 <Aquatopia> and I add: [e-mail] (I registered to MSN with an uppercase A) 13:20:28 <Aquatopia> the client compares [e-mail] from the server to [e-mail] committer: Tailor Script <[e-mail]>

/** @page gtkblist-signals GtkBlist Signals

 @signals
  @signal gtkblist-created
  @signal drawing-menu
  @signal drawing-tooltip
 @endsignals

 <hr>

 @signaldef gtkblist-created
  @signalproto
(*gtkblist-created)(GaimBuddyList *blist);
  @endsignalproto
  @signaldesc
   Emitted when the buddy list is created.
  @param blist The buddy list.
 @endsignaldef

 @signaldef drawing-menu
  @signalproto
void (*drawing-menu)(GtkMenu *menu, GaimBuddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when the user right clicks on a buddy or chat in the buddy list.
  @param menu The menu that will be shown.
  @param buddy The buddy or chat.
 @endsignaldef

 @signaldef drawing-tooltip
  @signalproto
void (*drawing-tooltip)(GaimBlistNode *node, char **text);
  @endsignalproto
  @signaldesc
   Emitted just before a tooltip is displayed.
   @a text is a pointer to a string, so the plugin can replace the text that
   will be displayed.
  @note
   Make sure to free @a *text before you replace it!
  @param node The blist node for the tooltip.
  @param text A pointer to the text that will be displayed.
 @endsignaldef
*/