updated docs

Author: Alexandru Scvortov

src/com/rabbitmq/client/Connection.java

@@ -40,8 +40,8 @@
  *
  * <pre>
  * ConnectionFactory factory = new ConnectionFactory();
- * factory.setHostName(hostName);
- * factory.setPortNumber(portNumber);
+ * factory.setHost(hostName);
+ * factory.setPort(portNumber);
  * factory.setVirtualHost(virtualHost);
  * factory.setUsername(username);
  * factory.setPassword(password);

src/com/rabbitmq/client/ConnectionFactory.java

@@ -134,9 +134,6 @@ public int getPort() {
         return portOrDefault(port);
     }
 
-    /**
-     *  @return the default port to use for connections
-     */
     public void setPort(int port) {
         this.port = port;
     }
@@ -244,7 +241,7 @@ public void setRequestedHeartbeat(int requestedHeartbeat) {
      * table. Such changes will take effect when the next new
      * connection is started using this factory.
      * @return the map of client properties
-     * @see setClientProperties()
+     * @see #setClientProperties
      */
     public Map<String, Object> getClientProperties() {
         return _clientProperties;
@@ -254,7 +251,7 @@ public Map<String, Object> getClientProperties() {
      * Replace the table of client properties that will be sent to the
      * server during subsequent connection startups.
      * @param clientProperties the map of extra client properties
-     * @see getClientProperties()
+     * @see #getClientProperties
      */
     public void setClientProperties(Map<String, Object> clientProperties) {
         _clientProperties = clientProperties;

src/com/rabbitmq/client/impl/AMQConnection.java

@@ -70,7 +70,7 @@
  * ch1.open();
  * </pre>
  *
- * For a saner way of connecting to a broker, see {@link Connection}.
+ * For a better way of connecting to a broker, see {@link Connection}.
  */
 public class AMQConnection extends ShutdownNotifierComponent implements Connection {
     /** Timeout used while waiting for AMQP handshaking to complete (milliseconds) */
@@ -85,7 +85,7 @@ public class AMQConnection extends ShutdownNotifierComponent implements Connecti
      * method is called when each new ConnectionFactory instance is
      * constructed.
      * @return a map of client properties
-     * @see Connection.getClientProperties()
+     * @see Connection#getClientProperties
      */
     public static Map<String, Object> defaultClientProperties() {
         return Frame.buildTable(new Object[] {
@@ -140,7 +140,7 @@ public static Map<String, Object> defaultClientProperties() {
 
     /**
      * Protected API - respond, in the driver thread, to a ShutdownSignal.
-     * @param channelNumber the number of the channel to disconnect
+     * @param channel the channel to disconnect
      */
     public final void disconnectChannel(ChannelN channel) {
         _channelManager.disconnectChannel(channel);