From e4435b014e50a10ad89c201d6f91b6be35a9b02f Mon Sep 17 00:00:00 2001
From: Erik Johnston <erik@matrix.org>
Date: Wed, 3 May 2017 10:00:29 +0100
Subject: [PATCH] Update comment

---
 synapse/storage/state.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/synapse/storage/state.py b/synapse/storage/state.py
index 5d6f7dfa28..03981f5d2b 100644
--- a/synapse/storage/state.py
+++ b/synapse/storage/state.py
@@ -229,7 +229,8 @@ class StateStore(SQLBaseStore):
 
             # Prefill the state group cache with this group.
             # It's fine to use the sequence like this as the state group map
-            # is immutable.
+            # is immutable. (If the map wasn't immutable then this prefill could
+            # race with another update)
             txn.call_after(
                 self._state_group_cache.update,
                 self._state_group_cache.sequence,