diff --git a/akka-docs/rst/java/io-tcp.rst b/akka-docs/rst/java/io-tcp.rst
index 72ffbf1aa4..2d242c4e51 100644
--- a/akka-docs/rst/java/io-tcp.rst
+++ b/akka-docs/rst/java/io-tcp.rst
@@ -349,7 +349,8 @@ 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.
+  The SslTlsSupport currently does not support using a ``Tcp.WriteCommand``
+  other than ``Tcp.Write``, like for example ``Tcp.WriteFile``. It also doesn't
+  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 47fd4a8053..284ba84511 100644
--- a/akka-docs/rst/scala/io-tcp.rst
+++ b/akka-docs/rst/scala/io-tcp.rst
@@ -331,7 +331,8 @@ 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.
+  The SslTlsSupport currently does not support using a ``Tcp.WriteCommand``
+  other than ``Tcp.Write``, like for example ``Tcp.WriteFile``. It also doesn't
+  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.