[tracker/drop-inotify: 6/24] libtracker-miner, GIO monitors: comment for the CHANGES_DONE_HINT signal

[Martyn James Russell <mr src gnome org>]

commit da6598790ecd7fae6bae9738bd3d673ef4d22734
Author: Aleksander Morgado <aleksander lanedo com>
Date:   Tue Jun 29 17:47:39 2010 +0200

    libtracker-miner, GIO monitors: comment for the CHANGES_DONE_HINT signal

 src/libtracker-miner/tracker-monitor.c |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/src/libtracker-miner/tracker-monitor.c b/src/libtracker-miner/tracker-monitor.c
index 7f68e7f..4c510eb 100644
--- a/src/libtracker-miner/tracker-monitor.c
+++ b/src/libtracker-miner/tracker-monitor.c
@@ -1553,6 +1553,15 @@ monitor_event_cb (GFileMonitor	    *file_monitor,
 		break;
 
 	case G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT:
+		/* Note: the general case is that this event is the last
+		 * one after a series of EVENT_CHANGED ones. It may be the
+		 * case that after this one, an ATTRIBUTE_CHANGED one is
+		 * issued, as when downloading a file with wget, where
+		 * mtime of the file is modified. But this last case is
+		 * quite specific, so we will anyway signal the event
+		 * right away instead of adding it to the HT.
+		 */
+
 		event_data = g_hash_table_lookup (monitor->private->event_pairs, file);
 
 		if (event_data) {