From 2c2dcf81d03fabfe4a018b60b4b840069627b3fe 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 5d6f7dfa2..03981f5d2 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,