annotate doc/buddyicon-signals.dox @ 11815:821f40e1912f

[gaim-migrate @ 14106] SF Patch #1336924 from sadrul 'From the wiki: "If you have a tab open for a given contact, and then drag an additional buddy into that contact, the send to menu does not update." This patch updates all the focused-conversations in every window (note that not all conversation in every tab). This wouldn't be necessary if it was possible to tell which contact a buddy was removed from. But that info is not available, so this is the way I can think of. It works, and will probably not cause too much overhead for most users -- assuming most of them use tabbed convs and hence number of windows won't be too great.' To track which contact was updated would be problematic, I think. This doesn't seem like too much overhead to me and it keeps the code clean. committer: Tailor Script <[e-mail]>

/** @page buddyicon-signals Buddy Icon Signals

 @signals
  @signal buddy-icon-cached
 @endsignals

 <hr>

 @signaldef buddy-icon-cached
  @signalproto
void (*buddy-icon-cached)(GaimBuddyIcon *icon, GaimBuddy *buddy, const char *filename, const char *old_icon);
  @endsignalproto
  @signaldesc
   Emitted when a buddy icon is cached.
  @param icon     The icon that was just cached.
  @param buddy    The buddy the icon belongs to.
  @param filename The full filename for the newly created icon cache file.
  @param old_icon The filename of the icon cache file for the buddy's previous icon, or @c NULL if the buddy
                  had no icon when this new icon was set. This filename is generally the full filename of the
                  previous icon cache file, but if the previous buddy icon was set in an old version of Gaim,
                  this may just be the basename of the icon cache file. The directory can be obtained with
                  gaim_buddy_icons_get_cache_dir().
 @endsignaldef
*/