view doc/notify-signals.dox @ 12463:b1717befbb26

[gaim-migrate @ 14773] SF Patch #1377719 from Evan Schoenberg "A recent reorganization of how the chat_add_users() conversation UI op is sent removed passing to the UI of whether the additions are new arrivals or not. This information lets the UI make decisions about how to handle the new people, what if anything to display, etc." committer: Tailor Script <[e-mail]>

/** @page conversation-signals Notification Signals

 @signals
  @signal displaying-userinfo
 @endsignals

 @signaldef displaying-userinfo
  @signalproto
void (*displaying_userinfo)(GaimAccount *account, const char *who, char **infotext);
  @endsignalproto
  @signaldesc
   Emitted before userinfo is handed to the UI to display.
   @a infotext is a pointer to a string, so a plugin can replace the text that
   will be displayed.
  @note
   Make sure to free @a *infotext before you replace it!
  @param account  The account on which the info was obtained.
  @param who      The screen name of the user whose info is to be displayed.
  @param infotext A pointer to the userinfo text to be displayed.
 @endsignaldef

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