diff --git a/source/org/jivesoftware/smack/SSLXMPPConnection.java b/source/org/jivesoftware/smack/SSLXMPPConnection.java
index 3f4ef2917..c81e5f433 100644
--- a/source/org/jivesoftware/smack/SSLXMPPConnection.java
+++ b/source/org/jivesoftware/smack/SSLXMPPConnection.java
@@ -31,7 +31,12 @@ import java.security.KeyManagementException;
 import java.security.NoSuchAlgorithmException;
 
 /**
- * Creates an SSL connection to a XMPP server.
+ * Creates an SSL connection to a XMPP server using the legacy dedicated SSL port
+ * mechanism. Fully compliant XMPP 1.0 servers (e.g. Jive Messenger 2.3.0) do not
+ * require using a dedicated SSL port. Instead, TLS (a standardized version of SSL 3.0)
+ * is dynamically negotiated over the standard XMPP port. Therefore, only use this
+ * class to connect to an XMPP server if you know that the server does not support
+ * XMPP 1.0 TLS connections. 
  *
  * @author Matt Tucker
  */