Mercurial > pidgin
view doc/blist-signals.dox @ 31167:060739bdc84d
Suppress msgfmt errors by removing c-format markers
This is unfortunate, but it's the best that I could come up with. The
translator, Khaled Hosny, informed me that C does not allow you to skip
positional format string arguments, and printf(3) on my system agrees.
It does work on glibc, but I'm not sure if gettext guarantees this. It
does make other guarantees about the printf implementation above those
from C, but this involves replacing the printf function if the native one
doesn't provide it. So, even assuming that gettext's printf allows this
like glibc's does, gettext may not replace the printf function if the
native C printf provides positional arguments but does not allow skipping
them.
Finally, intltool-update does not seem to put the c-format marker back,
which actually surprised me. So we'll see how this goes long-term.
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Wed, 26 Jan 2011 18:48:19 +0000 |
parents | e68d6c7990c1 |
children | 02a2e8183b1d |
line wrap: on
line source
/** @page blist-signals Buddy List Signals @signals @signal buddy-status-changed @signal buddy-idle-changed @signal buddy-signed-on @signal buddy-signed-off @signal update-idle @signal blist-node-extended-menu @signal buddy-added @signal buddy-removed @signal buddy-icon-changed @signal blist-node-aliased @signal buddy-caps-changed @signal ui-caps-changed @endsignals @see blist.h <hr> @signaldef buddy-status-changed @signalproto void (*buddy_away)(PurpleBuddy *buddy, PurpleStatus *old_status, PurpleStatus *status); @endsignalproto @signaldesc Emitted when a buddy on your buddy list goes away. @param buddy The buddy whose status changed. @param old_status The status that the buddy just changed from. @param status The status that the buddy just changed to. @endsignaldef @signaldef buddy-idle-changed @signalproto void (*buddy_idle)(PurpleBuddy *buddy, gboolean old_idle, gboolean idle); @endsignalproto @signaldesc Emitted when a buddy on your buddy list becomes idle. @param buddy The buddy whose idle status changed. @param old_idle Whether the buddy was idle. @param idle Whether the buddy is currently idle. @endsignaldef @signaldef buddy-signed-on @signalproto void (*buddy_signed_on)(PurpleBuddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs on. @param buddy The buddy that signed on. @endsignaldef @signaldef buddy-signed-off @signalproto void (*buddy_signed_off)(PurpleBuddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs off. @param buddy The buddy that signed off. @endsignaldef @signaldef update-idle @signalproto void (*update_idle)(); @endsignalproto @signaldesc Emitted when the buddy list is refreshed and the idle times are updated. @endsignaldef @signaldef blist-node-extended-menu @signalproto void (*blist_node_extended_menu)(PurpleBlistNode *node, GList **menu) @endsignalproto @signaldesc Emitted when a buddlist menu is being constructed @a menu is a pointer to a GList of PurpleBlistNodeAction's allowing a plugin to add menu items @endsignaldef @signaldef blist-node-added @signalproto void (*blist_node_added)(PurpleBlistNode *node) @endsignalproto @signaldesc Emitted when a new blist node is added to the buddy list. @endsignaldef @signaldef blist-node-removed @signalproto void (*blist_node_removed)(PurpleBlistNode *node) @endsignalproto @signaldesc Emitted when a blist node is removed from the buddy list. @endsignaldef @signaldef buddy-added @signalproto void (*buddy_added)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a new buddy is added to the buddy list. @deprecated Use blist-node-added instead. @endsignaldef @signaldef buddy-removed @signalproto void (*buddy_removed)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a buddy is removed from the buddy list. @deprecated Use blist-node-removed instead. @endsignaldef @signaldef buddy-icon-changed @signalproto void (*buddy_icon_changed)(PurpleBuddy *buddy) @endsignalproto @signaldesc Emitted when a buddy's icon is set. @endsignaldef @signaldef blist-node-aliased @signalproto void (*blist_node_aliased)(PurpleBlistNode *node, const char *old_alias) @endsignalproto @signaldesc Emitted when a blist node (buddy, chat, or contact) is aliased. @endsignaldef @signaldef buddy-caps-changed @signalproto void (*buddy_caps_changed)(PurpleBuddy *buddy, PurpleMediaCaps newcaps, PurpleMediaCaps oldcaps) @endsignalproto @signaldesc Emitted when updating a buddy's media capabilities. @param buddy The buddy @param newcaps @param oldcaps @since 2.7.0 @endsignaldef @signaldef ui-caps-changed @signalproto void (*ui_caps_changed)(PurpleMediaCaps newcaps, PurpleMediaCaps oldcaps) @endsignalproto @signaldesc Emitted when updating the media capabilities of the UI. @param newcaps @param oldcaps @since 2.7.0 @endsignaldef */ // vim: syntax=c.doxygen tw=75 et