Fix mvn javadoc errors

Author: michaelklishin

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

@@ -259,24 +259,26 @@ public interface Connection extends ShutdownNotifier, Closeable { // rename to A
     ExceptionHandler getExceptionHandler();
 
     /**
-     * Unique ID for this connection.
-     * This ID should be unique, otherwise some services
+     * Returns a unique ID for this connection.
+     *
+     * This ID must be unique, otherwise some services
      * like the metrics collector won't work properly.
      * This ID doesn't have to be provided by the client,
-     * services that require it will assign it automatically
-     * if it's not set.
-     * @return
+     * services that require it will be assigned automatically
+     * if not set.
+     *
+     * @return unique ID for this connection.
      */
     String getId();
 
     /**
-     * Set the unique ID for this connection.
-     * This ID should be unique, otherwise some services
+     * Sets a unique ID for this connection.
+     *
+     * This ID must be unique, otherwise some services
      * like the metrics collector won't work properly.
      * This ID doesn't have to be provided by the client,
-     * services that require it will assign it automatically
-     * if it's not set.
-     * @return
+     * services that require it will be assigned automatically
+     * if not set.
      */
     void setId(String id);
 }

src/main/java/com/rabbitmq/client/impl/recovery/RecoveryCanBeginListener.java

@@ -19,8 +19,10 @@
 
 /**
  * Used internally to indicate when connection recovery can
- * begin. See {@link <a href="https://github.com/rabbitmq/rabbitmq-java-client/issues/135">Issue 135 on GitHub</a>}.
+ * begin.
  * This is package-local by design.
+ *
+ * @see <a href="https://github.com/rabbitmq/rabbitmq-java-client/issues/135">Issue 135 on GitHub</a>
  */
 public interface RecoveryCanBeginListener {
     void recoveryCanBegin(ShutdownSignalException cause);