diff plugins/SIGNALS @ 6020:3b6f48766acb

[gaim-migrate @ 6470] Yeah, this *should* work. But maybe it won't. I sure as hell ain't testin it. That's what we pay you for you. This is a plugin event that gets triggered when the user switches tabs in a window. Used in conjunction with GTK signals, you should be able to get a good idea of when a conversation has taken focus. Maybe now the notify plugin can be fixed. While doing this, I noticed that a lot of the plugin documentation stuff is woefully outdated. Someone who wants to get involved with a non-coding project is welcome to send a patch. committer: Tailor Script <[e-mail]>

--- a/plugins/SIGNALS	Sat Jul 05 01:49:07 2003 +0000
+++ b/plugins/SIGNALS	Sat Jul 05 03:09:43 2003 +0000
@@ -30,6 +30,7 @@
 	event_got_typing,
 	event_del_conversation,
 	event_connecting,
+	event_switch_conversation,
 };
 
 To add a signal handler, call the fuction gaim_signal_connect with the
@@ -357,3 +358,14 @@
 	counter decremented.
 
 	'u'	is the account being connected.
+
+event_conversation_switch:
+	GaimConversation *c
+
+	This is called when a new conversation has become the active conversation
+	in its GaimWindow.
+
+	Using this in conjuction with GTK's focus-in-event will allow you to trigger
+	callbacks anytime a conversation receives focus.
+
+	'c' 	is the conversation that has just received focus.