improve and add comments to make code more readable

src/groupchat_window.py

@@ -504,6 +504,9 @@ def set_subject(self, room_jid, subject):
 		self.subject_tooltip[room_jid].set_tip(event_box, subject)
 
 	def get_specific_unread(self, room_jid):
+		# returns the number of the number of unread msgs
+		# for room_jid & number of unread private msgs with each contact
+		# that we have
 		nb = 0
 		for nick in self.get_nick_list(room_jid):
 			fjid = room_jid + '/' + nick

src/tabbed_chat_window.py

@@ -271,7 +271,9 @@ def draw_name_banner(self, contact):
 		self.paint_banner(jid)
 
 	def get_specific_unread(self, jid):
-		# return the number of unread for contacts in the room when gc, 0 in tc
+		# return the number of unread (private) msgs with contacts in the room
+		# when gc, and that is 0 in tc
+		# FIXME: maybe refactor so this func is not called at all if TC?
 		return 0
 
 	def show_avatar(self, jid, resource):