From 8d8834d3e7d6c0c4086ea47664c922bfa91757d4 Mon Sep 17 00:00:00 2001
From: Erik Johnston <erik@matrix.org>
Date: Wed, 20 Mar 2019 17:49:56 +0000
Subject: [PATCH] comment block_room

---
 synapse/storage/room.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/synapse/storage/room.py b/synapse/storage/room.py
index 33870b585..abc9786a9 100644
--- a/synapse/storage/room.py
+++ b/synapse/storage/room.py
@@ -500,6 +500,15 @@ class RoomStore(RoomWorkerStore, SearchStore):
 
     @defer.inlineCallbacks
     def block_room(self, room_id, user_id):
+        """Marks the room as blocked. Can be called multiple times.
+
+        Args:
+            room_id (str): Room to block
+            user_id (str): Who blocked it
+
+        Returns:
+            Deferred
+        """
         yield self._simple_upsert(
             table="blocked_rooms",
             keyvalues={