diff --git a/akka-docs/rst/java/io-tcp.rst b/akka-docs/rst/java/io-tcp.rst
index b1e49bdf3a..72ffbf1aa4 100644
--- a/akka-docs/rst/java/io-tcp.rst
+++ b/akka-docs/rst/java/io-tcp.rst
@@ -347,3 +347,9 @@ and register that as the recipient of inbound traffic and ourselves as
 recipient for the decrypted payload data. The we send a greeting to the server
 and forward any replies to some ``listener`` actor.
 
+.. warning::
+
+  The SslTlsSupport does not support messages that are larger than the size
+  of the send buffer on the socket. Trying to send such a message will result
+  in a ``CommandFailed``. If you need to send large messages over SSL, then
+  they have to be sent in chunks.
diff --git a/akka-docs/rst/scala/io-tcp.rst b/akka-docs/rst/scala/io-tcp.rst
index 1508785e86..47fd4a8053 100644
--- a/akka-docs/rst/scala/io-tcp.rst
+++ b/akka-docs/rst/scala/io-tcp.rst
@@ -329,3 +329,9 @@ It should be noted that communication with the :class:`TcpPipelineHandler`
 wraps commands and events in the inner types of the ``init`` object in order to
 keep things well separated.
 
+.. warning::
+
+  The SslTlsSupport does not support messages that are larger than the size
+  of the send buffer on the socket. Trying to send such a message will result
+  in a ``CommandFailed``. If you need to send large messages over SSL, then
+  they have to be sent in chunks.