Add javadoc to SmackException.ConnectionException

and HostAddress

smack-core/src/main/java/org/jivesoftware/smack/SmackException.java

@@ -122,6 +122,12 @@ public class SmackException extends Exception {
         }
     }
 
+    /**
+     * ConnectionException is thrown if Smack is unable to connect to all hosts of a given XMPP
+     * service. The failed hosts can be retrieved with
+     * {@link ConnectionException#getFailedAddresses()}, which will have the exception causing the
+     * connection failure set and retrievable with {@link HostAddress#getException()}.
+     */
     public static class ConnectionException extends SmackException {
 
         /**

smack-core/src/main/java/org/jivesoftware/smack/util/dns/HostAddress.java

@@ -16,6 +16,8 @@
  */
 package org.jivesoftware.smack.util.dns;
 
+import org.jivesoftware.smack.SmackException.ConnectionException;
+
 public class HostAddress {
     private final String fqdn;
     private final int port;
@@ -66,6 +68,13 @@ public class HostAddress {
         this.exception = e;
     }
 
+    /**
+     * Retrieve the Exception that caused a connection failure to this HostAddress. Every
+     * HostAddress found in {@link ConnectionException} will have an Exception set,
+     * which can be retrieved with this method.
+     * 
+     * @return the Exception causing this HostAddress to fail
+     */
     public Exception getException() {
         return this.exception;
     }