diff --git a/src/network/ssl/qssl.cpp b/src/network/ssl/qssl.cpp
index a6224da..3ed0cf3 100644
--- a/src/network/ssl/qssl.cpp
+++ b/src/network/ssl/qssl.cpp
@@ -92,6 +92,12 @@ QT_BEGIN_NAMESPACE
     \value UnknownProtocol The cipher's protocol cannot be determined.
     \value AnyProtocol The socket understands SSLv2, SSLv3, and TLSv1. This
     value is used by QSslSocket only.
+
+    Note: most servers using SSL understand both versions (2 and 3),
+    but it is recommended to use the latest version only for security
+    reasons. However, SSL and TLS are not compatible with each other:
+    if you get unexpected handshake failures, verify that you chose
+    the correct setting for your protocol.
 */

 QT_END_NAMESPACE