Clearer documentation for the `max_http_buffer_size` argument (Fixes #1272)

src/socketio/async_server.py

@@ -65,9 +65,11 @@ class AsyncServer(base_server.BaseServer):
     :param ping_timeout: The time in seconds that the client waits for the
                          server to respond before disconnecting. The default
                          is 20 seconds.
-    :param max_http_buffer_size: The maximum size of a message when using the
+    :param max_http_buffer_size: The maximum size that is accepted for incoming
-                                 polling transport. The default is 1,000,000
+                                 messages.  The default is 1,000,000 bytes. In
-                                 bytes.
+                                 spite of its name, the value set in this
+                                 argument is enforced for HTTP long-polling and
+                                 WebSocket connections.
     :param allow_upgrades: Whether to allow transport upgrades or not. The
                            default is ``True``.
     :param http_compression: Whether to compress packages when using the

src/socketio/server.py

@@ -74,9 +74,11 @@ class Server(base_server.BaseServer):
     :param ping_timeout: The time in seconds that the client waits for the
                          server to respond before disconnecting. The default
                          is 20 seconds.
-    :param max_http_buffer_size: The maximum size of a message when using the
+    :param max_http_buffer_size: The maximum size that is accepted for incoming
-                                 polling transport. The default is 1,000,000
+                                 messages.  The default is 1,000,000 bytes. In
-                                 bytes.
+                                 spite of its name, the value set in this
+                                 argument is enforced for HTTP long-polling and
+                                 WebSocket connections.
     :param allow_upgrades: Whether to allow transport upgrades or not. The
                            default is ``True``.
     :param http_compression: Whether to compress packages when using the