pidgin/pidgin

Make PurplePluginProtocolInfo definitions consistent
release-2.x.y
2020-05-20, David Woodhouse
159344ba2a49
Make PurplePluginProtocolInfo definitions consistent

Since we can't use C99 structure initialisers, we have to manually add
new NULL fields to all protocols whenever we extend the structure.

Make it slightly easier to script that, by making the current last
field (get_cb_alias) consistent in all cases. In particular, there's
no reason *not* to have the trailing comma, as most already do.

Now I can add a new field to the PRPL by doing something like this...

PROTOFILES=`grep -rl '[A-Za-z_][A-Za-z0-9_]*,[[:space:]]*/\* get_cb_alias \*/' libpurple/protocols/ `
sed '/\/\* get_cb_alias \*\//{p;s/[A-Za-z_][A-Za-
/** @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