view doc/notify-signals.dox @ 12345:f6fa5d742c76

[gaim-migrate @ 14649] so we were talking in #gaim the other day, and chat nick colors came up. I mentioned that back when sean changed the color code list, that we'd talked about maybe someday having code to generate the list of colors automatically. And datallah found the w3.org algorithm to check a given color code for visibility, so Tak wrote up some code to use that to generate a list of colors. I like it, and nwalp says to go ahead and commit it then. 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