diff doc/conversation-signals.dox @ 23150:d476ab1b47b2

propagate from branch 'im.pidgin.pidgin.custom_smiley' (head 2a2aa2b4e4f34248a96a684b2e29963c358c1338) to branch 'im.pidgin.pidgin.next.minor' (head 485ba8630d52b894d8ec9648d6fe2ccb9754d1e8)

--- a/doc/conversation-signals.dox	Tue May 13 06:03:58 2008 +0000
+++ b/doc/conversation-signals.dox	Tue May 13 06:04:10 2008 +0000
@@ -27,6 +27,7 @@
   @signal chat-invited-user
   @signal chat-invited
   @signal chat-joined
+  @signal chat-join-failed
   @signal chat-left
   @signal chat-topic-changed
   @signal conversation-extended-menu
@@ -302,6 +303,18 @@
   @param new_arrival If the buddy is a new arrival.
  @endsignaldef
 
+ @signaldef chat-join-failed
+  @signalproto
+void (*chat_join_failed)(PurpleConnection *gc, GHashTable *components);
+  @endsignalproto
+  @signaldesc
+   Emitted when an account fails to join a chat room
+  @param gc The PurpleConnection of the account which failed to join the chat.
+  @param data    The components passed to serv_join_chat() originally.
+                 The hash function should be g_str_hash() and the equal
+                 function should be g_str_equal().
+ @endsignaldef
+
  @signaldef chat-buddy-flags
   @signalproto
 void (*chat_buddy_flags)(PurpleConversation *conv, const char *name,