From 2945a020061c08071664fe8b79c880846a29029b Mon Sep 17 00:00:00 2001
From: Eric Eastwood <erice@element.io>
Date: Thu, 2 Apr 2026 14:17:48 -0500
Subject: [PATCH] Better explain

---
 synapse/streams/events.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/synapse/streams/events.py b/synapse/streams/events.py
index a5b7ded74f..f5677a2082 100644
--- a/synapse/streams/events.py
+++ b/synapse/streams/events.py
@@ -149,7 +149,9 @@ class EventSources:
                     ].get_max_allocated_token()
 
                     if max_token < token_value.get_max_stream_pos():
-                        # Log *something* as we consider this a Synapse programming error
+                        # Log *something* as we consider this as a Synapse programming error
+                        # (assuming no malicious user manipulation of the token) (we shouldn't be
+                        # handing out future tokens).
                         #
                         # We don't assert as the whole point of bounding is so that we can recover
                         # gracefully.