view doc/notify-signals.dox @ 13363:ef5287de40b5

[gaim-migrate @ 15736] Emil Nowak pointed out that the names of other IM clients shouldn't be marked for translation. I did some checking and it seems the creators of those clients don't translate the names. I thought perhaps MSN Messenger would be, for example. Also, I noticed that the logout notifications should be reworded to match the string we use now in the buddy state notification plugin. This reuses an existing string, so it doesn't break the string freeze. I really need to get back to work on this plugin. 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