Mercurial > pidgin
view doc/gtkblist-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 | d75813811637 |
children |
line wrap: on
line source
/** @page gtkblist-signals GtkBlist Signals @signals @signal gtkblist-hiding @signal gtkblist-unhiding @signal gtkblist-created @signal drawing-tooltip @signal drawing-buddy @endsignals @see gtkblist.h <hr> @signaldef gtkblist-hiding @signalproto void (*gtkblist-hiding)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is about to be hidden. @param blist The buddy list. @endsignaldef @signaldef gtkblist-unhiding @signalproto void (*gtkblist-unhiding)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is about to be unhidden. @param blist The buddy list. @endsignaldef @signaldef gtkblist-created @signalproto void (*gtkblist-created)(PurpleBuddyList *blist); @endsignalproto @signaldesc Emitted when the buddy list is created. @param blist The buddy list. @endsignaldef @signaldef drawing-tooltip @signalproto void (*drawing-tooltip)(PurpleBlistNode *node, GString *text, gboolean full); @endsignalproto @signaldesc Emitted just before a tooltip is displayed. @a text is a standard GString, so the plugin can modify 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. @param full Whether we're doing a full tooltip for the priority buddy or a compact tooltip for a non-priority buddy. @endsignaldef @signaldef drawing-buddy @signalproto char *(*drawing-buddy)(PurpleBuddy *buddy); @endsignalproto @signaldesc Emitted to allow plugins to handle markup within a buddy's name or to override the default of no formatting for names shown in the buddy list. @param buddy A pointer to the PurpleBuddy that will be displayed. @return The text to display (must be allocated), or @c NULL if no changes to the default behavior are desired. @endsignaldef */ // vim: syntax=c.doxygen tw=75 et