From 8148c48f11845af1747dc9447e47f9cce70c615f Mon Sep 17 00:00:00 2001
From: Erik Johnston <erik@matrix.org>
Date: Tue, 15 Sep 2015 16:54:43 +0100
Subject: [PATCH] "Comments"

---
 synapse/storage/event_federation.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/synapse/storage/event_federation.py b/synapse/storage/event_federation.py
index 27284cd08c..7cb314dee8 100644
--- a/synapse/storage/event_federation.py
+++ b/synapse/storage/event_federation.py
@@ -306,6 +306,12 @@ class EventFederationStore(SQLBaseStore):
         self._update_extremeties(txn, events)
 
     def _update_extremeties(self, txn, events):
+        """Updates the event_*_extremities tables based on the new/updated
+        events being persisted.
+
+        This is called for new events *and* for events that were outliers, but
+        are are now being persisted as non-outliers.
+        """
         events_by_room = {}
         for ev in events:
             events_by_room.setdefault(ev.room_id, []).append(ev)