Clarify when RecoveryListener methods are invoked

Fixes #286.

Conflicts:
	src/main/java/com/rabbitmq/client/RecoveryListener.java

Author: michaelklishin

src/main/java/com/rabbitmq/client/RecoveryListener.java

@@ -22,6 +22,18 @@
  * @since 3.3.0
  */
 public interface RecoveryListener {
+    /**
+     * Invoked when automatic connection recovery has completed.
+     * This includes topology recovery if it was enabled.
+     * @param recoverable a {@link Recoverable} connection.
+     */
     void handleRecovery(Recoverable recoverable);
+
+    /**
+     * Invoked before automatic connection recovery starts.
+     * This means no recovery steps were performed at this point
+     * during recovery process.
+     * @param recoverable a {@link Recoverable} connection.
+     */
     void handleRecoveryStarted(Recoverable recoverable);
 }