summary refs log tree commit diff
diff options
context:
space:
mode:
authorErik Johnston <erik@matrix.org>2019-01-29 21:22:47 +0000
committerErik Johnston <erik@matrix.org>2019-01-29 21:22:47 +0000
commit38590a4870a2774c500e9ff2478b2d420221f1d0 (patch)
tree7611b546c25f12fe4dd0279b25fd9100ec4066f0
parentUpdate synapse/storage/events_worker.py (diff)
downloadsynapse-38590a4870a2774c500e9ff2478b2d420221f1d0.tar.xz
Add docstring
-rw-r--r--synapse/events/__init__.py12
1 files changed, 12 insertions, 0 deletions
diff --git a/synapse/events/__init__.py b/synapse/events/__init__.py
index 70d3c0fbd9..527aec8c69 100644
--- a/synapse/events/__init__.py
+++ b/synapse/events/__init__.py
@@ -64,6 +64,18 @@ class _EventInternalMetadata(object):
         return getattr(self, "send_on_behalf_of", None)
 
     def need_to_check_redaction(self):
+        """Whether the redaction event needs to be rechecked when fetching
+        from the database.
+
+        Starting in room v3 redaction events are accepted up front, and later
+        checked to see if the redacter and redactee's domains match.
+
+        If the sender of the redaction event is allowed to redact due to auth
+        rules, then this will always return false.
+
+        Returns:
+            bool
+        """
         return getattr(self, "recheck_redaction", False)