From d79745bdb2e9bbd02e162a5209de9f227d1dbbc3 Mon Sep 17 00:00:00 2001
From: Charles Kerr <charles.kerr@canonical.com>
Date: Thu, 18 Apr 2013 10:29:50 -0500
Subject: in rebuild_soon(), add a comment explaining the 500 msec interval

---
 src/service.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/service.c b/src/service.c
index 2206621..2a10290 100644
--- a/src/service.c
+++ b/src/service.c
@@ -808,6 +808,10 @@ rebuild_soon (IndicatorSessionService * self, int section)
 
   if (p->rebuild_id == 0)
     {
+      /* Change events seem to come over the bus in small bursts. This msec
+         value is an arbitrary number that tries to be large enough to fold
+         multiple events into a single rebuild, but small enough that the
+         user won't notice any lag. */
       static const int REBUILD_INTERVAL_MSEC = 500;
 
       p->rebuild_id = g_timeout_add (REBUILD_INTERVAL_MSEC,
-- 
cgit v1.2.3