1/** @page blist-signals Buddy List Signals
2
3 @signals
4  @signal buddy-status-changed
5  @signal buddy-idle-changed
6  @signal buddy-signed-on
7  @signal buddy-signed-off
8  @signal update-idle
9  @signal blist-node-extended-menu
10  @signal buddy-added
11  @signal buddy-removed
12  @signal buddy-icon-changed
13  @signal blist-node-aliased
14  @signal buddy-caps-changed
15  @signal ui-caps-changed
16 @endsignals
17
18 @see blist.h
19
20 <hr>
21
22 @signaldef buddy-status-changed
23  @signalproto
24void (*buddy_away)(PurpleBuddy *buddy, PurpleStatus *old_status, PurpleStatus *status);
25  @endsignalproto
26  @signaldesc
27   Emitted when a buddy on your buddy list goes away.
28  @param buddy      The buddy whose status changed.
29  @param old_status The status that the buddy just changed from.
30  @param status     The status that the buddy just changed to.
31 @endsignaldef
32
33 @signaldef buddy-idle-changed
34  @signalproto
35void (*buddy_idle)(PurpleBuddy *buddy, gboolean old_idle, gboolean idle);
36  @endsignalproto
37  @signaldesc
38   Emitted when a buddy on your buddy list becomes idle.
39  @param buddy    The buddy whose idle status changed.
40  @param old_idle Whether the buddy was idle.
41  @param idle     Whether the buddy is currently idle.
42 @endsignaldef
43
44 @signaldef buddy-signed-on
45  @signalproto
46void (*buddy_signed_on)(PurpleBuddy *buddy);
47  @endsignalproto
48  @signaldesc
49   Emitted when a buddy on your buddy list signs on.
50  @param buddy The buddy that signed on.
51 @endsignaldef
52
53 @signaldef buddy-signed-off
54  @signalproto
55void (*buddy_signed_off)(PurpleBuddy *buddy);
56  @endsignalproto
57  @signaldesc
58   Emitted when a buddy on your buddy list signs off.
59  @param buddy The buddy that signed off.
60 @endsignaldef
61
62 @signaldef update-idle
63  @signalproto
64void (*update_idle)();
65  @endsignalproto
66  @signaldesc
67   Emitted when the buddy list is refreshed and the idle times are updated.
68 @endsignaldef
69
70 @signaldef blist-node-extended-menu
71  @signalproto
72void (*blist_node_extended_menu)(PurpleBlistNode *node, GList **menu)
73  @endsignalproto
74  @signaldesc
75   Emitted when a buddlist menu is being constructed @a menu is a pointer to
76   a GList of PurpleBlistNodeAction's allowing a plugin to add menu items
77 @endsignaldef
78
79 @signaldef blist-node-added
80  @signalproto
81void (*blist_node_added)(PurpleBlistNode *node)
82  @endsignalproto
83  @signaldesc
84   Emitted when a new blist node is added to the buddy list.
85 @endsignaldef
86
87 @signaldef blist-node-removed
88  @signalproto
89void (*blist_node_removed)(PurpleBlistNode *node)
90  @endsignalproto
91  @signaldesc
92   Emitted when a blist node is removed from the buddy list.
93 @endsignaldef
94
95 @signaldef buddy-added
96  @signalproto
97void (*buddy_added)(PurpleBuddy *buddy)
98  @endsignalproto
99  @signaldesc
100   Emitted when a new buddy is added to the buddy list.
101  @deprecated Use blist-node-added instead.
102 @endsignaldef
103
104 @signaldef buddy-removed
105  @signalproto
106void (*buddy_removed)(PurpleBuddy *buddy)
107  @endsignalproto
108  @signaldesc
109   Emitted when a buddy is removed from the buddy list.
110  @deprecated Use blist-node-removed instead.
111 @endsignaldef
112
113 @signaldef buddy-icon-changed
114  @signalproto
115void (*buddy_icon_changed)(PurpleBuddy *buddy)
116  @endsignalproto
117  @signaldesc
118   Emitted when a buddy's icon is set.
119  @endsignaldef
120
121 @signaldef blist-node-aliased
122  @signalproto
123void (*blist_node_aliased)(PurpleBlistNode *node, const char *old_alias)
124  @endsignalproto
125  @signaldesc
126   Emitted when a blist node (buddy, chat, or contact) is aliased.
127  @endsignaldef
128
129 @signaldef buddy-caps-changed
130  @signalproto
131void (*buddy_caps_changed)(PurpleBuddy *buddy, PurpleMediaCaps newcaps,
132    PurpleMediaCaps oldcaps)
133  @endsignalproto
134  @signaldesc
135    Emitted when updating a buddy's media capabilities.
136  @param buddy	  The buddy
137  @param newcaps
138  @param oldcaps
139  @since 2.7.0
140 @endsignaldef
141
142 @signaldef ui-caps-changed
143  @signalproto
144void (*ui_caps_changed)(PurpleMediaCaps newcaps, PurpleMediaCaps oldcaps)
145  @endsignalproto
146  @signaldesc
147    Emitted when updating the media capabilities of the UI.
148  @param newcaps
149  @param oldcaps
150  @since 2.7.0
151 @endsignaldef
152
153 */
154// vim: syntax=c.doxygen tw=75 et
155