Mercurial > pidgin3 / file diff

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/reference/libpurple/signals_blist.xml	Sun Oct 20 15:11:49 2013 +0530
@@ -0,0 +1,156 @@
+<?xml version='1.0' encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+]>
+<chapter id="chapter-signals-blist">
+  <title>Buddy List signals</title>
+
+  <programlisting>
+ @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
+
+ @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
+ @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
+ @endsignaldef
+
+  </programlisting>
+</chapter>