view doc/buddyicon-signals.dox @ 12143:cbebda5f019c

[gaim-migrate @ 14444] SF Patch #1360399 from Evan Schoenberg (evands) "I discussed this previously with Mark and he said it'd be fine. This factors out the part of the send_file function which creates a new GaimXfer into a separate prpl function, new_xfer. It's called in each of the existing send_file functions. This is needed so that another client (okay, Adium) can get a new outgoing GaimXfer from a prpl without depending upon the specific ft.c logic of send_file; previously I was adding a duplicate method to each prpl and then calling it directly." I fixed a couple small bugs in this. Otherwise, it looks good, and seems like a reasonable libgaim request. 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
*/