view doc/gtkblist-signals.dox @ 9531:06fe6ed7f63a

[gaim-migrate @ 10358] "How do you update your po files ("make update-po" or ./update.pl)? update.pl has some advantages. But update.pl has also a small bug. In rare cases (double msgid's etc.) update.pl kills your po-file. This can happen, if msgmerge fails and if you have an old gettext version. The problem is here: po/update.pl:149: ... $d="mv $LANG.po $LANG.po.old && msgmerge $LANG.po.old $PACKAGE.pot -o +$LANG.po"; ... If msgmerge fails, the file $LANG.po will be overwritten. "make update-po" has not this problem, because it uses a temporary file: ... if $(MSGMERGE) $$lang.po $(PACKAGE).pot -o $$lang.new.po; then \ mv -f $$lang.new.po $$lang.po; \ else \ echo "msgmerge for $$cat failed!"; \ rm -f $$lang.new.po; \ fi; \ ... I patched po/update.pl. Now it uses a temporary file. Also, update2.pl lists files in po/POTFILES.in which have no i18n strings as a warning." -- Bjoern Voigt committer: Tailor Script <[e-mail]>

/** @page gtkblist-signals GtkBlist Signals

 @signals
  @signal gtkblist-created
  @signal drawing-menu
  @signal drawing-tooltip
 @endsignals

 <hr>

 @signaldef gtkblist-created
  @signalproto
(*gtkblist-created)(GaimBuddyList *blist);
  @endsignalproto
  @signaldesc
   Emitted when the buddy list is created.
  @param blist The buddy list.
 @endsignaldef

 @signaldef drawing-menu
  @signalproto
void (*drawing-menu)(GtkMenu *menu, GaimBuddy *buddy);
  @endsignalproto
  @signaldesc
   Emitted when the user right clicks on a buddy or chat in the buddy list.
  @param menu The menu that will be shown.
  @param buddy The buddy or chat.
 @endsignaldef

 @signaldef drawing-tooltip
  @signalproto
void (*drawing-tooltip)(GaimBlistNode *node, char **text);
  @endsignalproto
  @signaldesc
   Emitted just before a tooltip is displayed.
   @a text is a pointer to a string, so the plugin can replace the text that
   will be displayed.
  @note
   Make sure to free @a *text before you replace it!
  @param node The blist node for the tooltip.
  @param text A pointer to the text that will be displayed.
 @endsignaldef
*/