empathy r1204 - trunk/libempathy

[xclaesse svn gnome org]

Author: xclaesse
Date: Mon Jul  7 20:41:45 2008
New Revision: 1204
URL: http://svn.gnome.org/viewvc/empathy?rev=1204&view=rev

Log:
Add some comments to the message queue code


Modified:
   trunk/libempathy/empathy-tp-chat.c

Modified: trunk/libempathy/empathy-tp-chat.c
==============================================================================
--- trunk/libempathy/empathy-tp-chat.c	(original)
+++ trunk/libempathy/empathy-tp-chat.c	Mon Jul  7 20:41:45 2008
@@ -292,8 +292,9 @@
 	gboolean             removed = FALSE;
 
 	/* Emit all messages queued until we find a message with not
-	 * ready sender. When leaving this loop, sender is the first not ready
-	 * contact queued and removed tells if at least one message got removed
+	 * ready sender (in case of a MUC we could have more than one sender).
+	 * When leaving this loop, sender is the first not ready contact queued
+	 * and removed tells if at least one message got removed
 	 * from the queue. */
 	while (priv->message_queue) {
 		message = priv->message_queue->data;
@@ -314,11 +315,15 @@
 	}
 
 	if (removed) {
+		/* We removed at least one message from the queue, disconnect
+		 * the ready signal from the previous contact */
 		g_signal_handlers_disconnect_by_func (contact,
 						      tp_chat_sender_ready_notify_cb,
 						      chat);
 
 		if (priv->message_queue) {
+			/* We still have queued message, connect the ready
+			 * signal on the new first message sender. */
 			g_signal_connect (sender, "notify::ready",
 					  G_CALLBACK (tp_chat_sender_ready_notify_cb),
 					  chat);