[empathy] individual-manager: document individual_notify_im_interaction_count()

[Guillaume Desmottes <gdesmott src gnome org>]

commit 35dfc34fc41a8150b9d66d3bbbbc7414e9cb3699
Author: Guillaume Desmottes <guillaume desmottes collabora co uk>
Date:   Thu Jun 14 11:30:18 2012 +0200

    individual-manager: document individual_notify_im_interaction_count()
    
    https://bugzilla.gnome.org/show_bug.cgi?id=677940

 libempathy/empathy-individual-manager.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/libempathy/empathy-individual-manager.c b/libempathy/empathy-individual-manager.c
index e80e132..c75a782 100644
--- a/libempathy/empathy-individual-manager.c
+++ b/libempathy/empathy-individual-manager.c
@@ -220,6 +220,10 @@ individual_notify_im_interaction_count (FolksIndividual *individual,
 {
   EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
 
+  /* We don't use g_sequence_sort_changed() because we'll first have to find
+   * the iter of @individual using g_sequence_lookup() but the lookup function
+   * won't work as it assumes that the sequence is sorted which is no longer
+   * the case at this point as @individual's popularity just changed. */
   g_sequence_sort (priv->individuals_pop, compare_individual_by_pop, NULL);
   check_top_individuals (self);
 }