Minor javadoc fixes and improvements

smack-tcp/src/main/java/org/jivesoftware/smack/tcp/BundleAndDefer.java

@@ -27,6 +27,14 @@ public class BundleAndDefer {
         this.isStopped = isStopped;
     }
 
+    /**
+     * Stop the bundle and defer mechanism that was started when this instance of {@link BundleAndDefer} was emitted by
+     * Smack.
+     * <p>
+     * It is possible that the defer period already expired when this is invoked. In this case this method is basically
+     * a no-op.
+     * </p>
+     */
     public void stopCurrentBundleAndDefer() {
         synchronized (isStopped) {
             if (isStopped.get()) {

smack-tcp/src/main/java/org/jivesoftware/smack/tcp/XMPPTCPConnection.java

@@ -185,8 +185,19 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
     private final SynchronizationPoint<XMPPException> compressSyncPoint = new SynchronizationPoint<XMPPException>(
                     this);
 
+    /**
+     * The default bundle and defer callback, used for new connections.
+     * @see bundleAndDeferCallback
+     */
     private static BundleAndDeferCallback defaultBundleAndDeferCallback;
 
+    /**
+     * The used bundle and defer callback.
+     * <p>
+     * Although this field may be set concurrently, the 'volatile' keyword was deliberately not added, in order to avoid
+     * having a 'volatile' read within the writer threads loop.
+     * </p>
+     */
     private BundleAndDeferCallback bundleAndDeferCallback = defaultBundleAndDeferCallback;
 
     private static boolean useSmDefault = false;