summary refs log tree commit diff
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2018-07-24 15:12:50 +0100
committerErik Johnston <erik@matrix.org>2018-07-24 15:12:50 +0100
commit709c309b0e1756afd8b4514b95b0e901c567a0f1 (patch)
treec2ca53f09b547c1dd5d0e6e221bb96b423361d90
parentRemove unnecessary iteritems (diff)
downloadsynapse-709c309b0e1756afd8b4514b95b0e901c567a0f1.tar.xz
Expand on docstring comment about return value
-rw-r--r--synapse/storage/events.py5
1 files changed, 5 insertions, 0 deletions
diff --git a/synapse/storage/events.py b/synapse/storage/events.py
index 9c94d3454f..906a405031 100644
--- a/synapse/storage/events.py
+++ b/synapse/storage/events.py
@@ -557,6 +557,11 @@ class EventsStore(EventsWorkerStore):
             Returns a tuple of two state maps, the first being the full new current
             state and the second being the delta to the existing current state.
             If both are None then there has been no change.
+
+            If there has been a change then we only return the delta if its
+            already been calculated. Conversely if we do know the delta then
+            the new current state is only returned if we've already calculated
+            it.
         """
 
         if not new_latest_event_ids: