fix all javadoc warnings/errors

Author: rade

src/com/rabbitmq/client/Channel.java

@@ -369,9 +369,9 @@ Exchange.DeclareOk exchangeDeclare(String exchange,
      * Bind an exchange to an exchange, with no extra arguments.
      * @see com.rabbitmq.client.AMQP.Exchange.Bind
      * @see com.rabbitmq.client.AMQP.Exchange.BindOk
-     * @param destination: the name of the exchange to which messages flow across the binding
-     * @param source: the name of the exchange from which messages flow across the binding
-     * @param routingKey: the routine key to use for the binding
+     * @param destination the name of the exchange to which messages flow across the binding
+     * @param source the name of the exchange from which messages flow across the binding
+     * @param routingKey the routine key to use for the binding
      * @return a binding-confirm method if the binding was successfully created
      * @throws java.io.IOException if an error is encountered
      */
@@ -381,10 +381,10 @@ Exchange.DeclareOk exchangeDeclare(String exchange,
      * Bind an exchange to an exchange.
      * @see com.rabbitmq.client.AMQP.Exchange.Bind
      * @see com.rabbitmq.client.AMQP.Exchange.BindOk
-     * @param destination: the name of the exchange to which messages flow across the binding
-     * @param source: the name of the exchange from which messages flow across the binding
-     * @param routingKey: the routine key to use for the binding
-     * @param arguments: other properties (binding parameters)
+     * @param destination the name of the exchange to which messages flow across the binding
+     * @param source the name of the exchange from which messages flow across the binding
+     * @param routingKey the routine key to use for the binding
+     * @param arguments other properties (binding parameters)
      * @return a binding-confirm method if the binding was successfully created
      * @throws java.io.IOException if an error is encountered
      */
@@ -394,9 +394,9 @@ Exchange.DeclareOk exchangeDeclare(String exchange,
      * Unbind an exchange from an exchange, with no extra arguments.
      * @see com.rabbitmq.client.AMQP.Exchange.Bind
      * @see com.rabbitmq.client.AMQP.Exchange.BindOk
-     * @param destination: the name of the exchange to which messages flow across the binding
-     * @param source: the name of the exchange from which messages flow across the binding
-     * @param routingKey: the routine key to use for the binding
+     * @param destination the name of the exchange to which messages flow across the binding
+     * @param source the name of the exchange from which messages flow across the binding
+     * @param routingKey the routine key to use for the binding
      * @return a binding-confirm method if the binding was successfully created
      * @throws java.io.IOException if an error is encountered
      */
@@ -406,10 +406,10 @@ Exchange.DeclareOk exchangeDeclare(String exchange,
      * Unbind an exchange from an exchange.
      * @see com.rabbitmq.client.AMQP.Exchange.Bind
      * @see com.rabbitmq.client.AMQP.Exchange.BindOk
-     * @param destination: the name of the exchange to which messages flow across the binding
-     * @param source: the name of the exchange from which messages flow across the binding
-     * @param routingKey: the routine key to use for the binding
-     * @param arguments: other properties (binding parameters)
+     * @param destination the name of the exchange to which messages flow across the binding
+     * @param source the name of the exchange from which messages flow across the binding
+     * @param routingKey the routine key to use for the binding
+     * @param arguments other properties (binding parameters)
      * @return a binding-confirm method if the binding was successfully created
      * @throws java.io.IOException if an error is encountered
      */

src/com/rabbitmq/client/ConnectionFactory.java

@@ -350,7 +350,7 @@ public void setClientProperties(Map<String, Object> clientProperties) {
 
     /**
      * Gets the sasl config to use when authenticating
-     * @return
+     * @return the sasl config
      * @see com.rabbitmq.client.SaslConfig
      */
     public SaslConfig getSaslConfig() {

src/com/rabbitmq/client/SaslMechanism.java

@@ -25,7 +25,7 @@
 public interface SaslMechanism {
     /**
      * The name of this mechanism (e.g. PLAIN)
-     * @return
+     * @return the name
      */
     String getName();
 

src/com/rabbitmq/tools/Tracer.java

@@ -46,7 +46,7 @@
  * port (out-port). Relays frames from the in-port to the out-port.
  * Commands are decoded and printed to a supplied {@link Logger}.
  * <p/>
- * The stand-alone program ({@link #main()}) prints to <code>System.out</code>,
+ * The stand-alone program ({@link #main(String[])}) prints to <code>System.out</code>,
  * using a private {@link AsyncLogger} instance.  When the connection closes
  * the program listens for a subsequent connection and traces that to the same {@link Logger}.
  * This continues until the program is interrupted.
@@ -388,7 +388,7 @@ public interface Logger {
      * A {@link Tracer.Logger} designed to print {@link String}s to a designated {@link OutputStream}
      * on a private thread.
      * <p/>{@link String}s are read from a private queue and <i>printed</i> to a buffered {@link PrintStream}
-     * which is periodically flushed, determined by a {@link #flushInterval}.
+     * which is periodically flushed.
      * <p/>
      * When instantiated the private queue is created (an in-memory {@link ArrayBlockingQueue} in this
      * implementation) and when {@link #start()}ed the private thread is created and started unless it is
@@ -400,7 +400,7 @@ public interface Logger {
      * If the private thread is interrupted, the thread will also end, and the count set to zero,
      * This will cause subsequent {@link #stop()}s to be ignored, and the next {@link #start()} will create a new thread.
      * <p/>
-     * {@link #log()} never blocks unless the private queue is full; this may never un-block if the {@link Logger} is stopped.
+     * {@link #log(String)} never blocks unless the private queue is full; this may never un-block if the {@link Logger} is stopped.
      */
     public static class AsyncLogger implements Logger {
         private static final int MIN_FLUSH_INTERVAL = 100;
@@ -435,7 +435,7 @@ private enum LogCmd {
                 LOG_QUEUE_SIZE, true);
 
         /**
-         * Same as {@link #AsyncLogger(os, flushInterval)} with a one-second flush interval.
+         * Same as {@link #Tracer.AsyncLogger(OutputStream, int)} with a one-second flush interval.
          * @param os OutputStream to print to.
          */
         public AsyncLogger(OutputStream os) {