From 703843b42b8fb7fb6a9d0152610e714e9c6fb75e Mon Sep 17 00:00:00 2001
From: Miguel Grinberg <miguel.grinberg@gmail.com>
Date: Tue, 4 May 2021 23:09:34 +0100
Subject: [PATCH] Document that callbacks cannot be used in external processes
 (Fixes https://github.com/miguelgrinberg/Flask-SocketIO/issues/1533)

---
 docs/server.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/server.rst b/docs/server.rst
index 6f11281..a2fc365 100644
--- a/docs/server.rst
+++ b/docs/server.rst
@@ -567,6 +567,11 @@ example::
     # emit an event
     external_sio.emit('my event', data={'foo': 'bar'}, room='my room')
 
+A limitation of the write-only client manager object is that it cannot receive
+callbacks when emitting. When the external process needs to receive callbacks,
+using a client to connect to the server with read and write support is a better
+option than a write-only client manager.
+
 Debugging and Troubleshooting
 -----------------------------