updated docs

Author: Alexandru Scvortov

src/com/rabbitmq/client/Connection.java

@@ -41,6 +41,7 @@
  * <pre>
  * ConnectionFactory factory = new ConnectionFactory();
  * factory.setHostName(hostName);
+ * factory.setPortNumber(portNumber);
  * factory.setVirtualHost(virtualHost);
  * factory.setUsername(username);
  * factory.setPassword(password);

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

@@ -57,14 +57,20 @@
  * To connect to a broker,
  *
  * <pre>
- * AMQConnection conn = new AMQConnection(hostName, portNumber);
- * conn.open(username, portNumber, virtualHost);
+ * ConnectionFactory factory = new {@link ConnectionFactory ConnectionFactory}();
+ * factory.setHost(hostName);
+ * factory.setPort(portNumber);
+ * factory.setVirtualHost(virtualHost);
+ * AMQConnection conn = new AMQConnection(factory, factory.{@link ConnectionFactory#createFrameHandler createFrameHandler}(new {@link Address Address}(hostName, portNumber));
+ * conn.{@link AMQConnection#start start}(false);
  * </pre>
  *
  * <pre>
- * ChannelN ch1 = conn.createChannel(1);
- * ch1.open(&quot;&quot;);
+ * {@link ChannelN ChannelN} ch1 = new {@link ChannelN ChannelN}(conn, 1);
+ * ch1.open();
  * </pre>
+ *
+ * For a saner 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) */

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

@@ -64,8 +64,8 @@
  * To open a channel,
  * <pre>
  * {@link Connection} conn = ...;
- * {@link ChannelN} ch1 = conn.{@link Connection#createChannel createChannel}(1);
- * ch1.{@link ChannelN#open open}("");
+ * {@link ChannelN} ch1 = conn.{@link Connection#createChannel createChannel}();
+ * ch1.{@link ChannelN#open open}();
  * </pre>
  */
 public class ChannelN extends AMQChannel implements com.rabbitmq.client.Channel {