From 23f513c0d26a7eff899f66557ff0a64830845af1 Mon Sep 17 00:00:00 2001
From: nmittler <nathanmittler@google.com>
Date: Mon, 23 Feb 2015 14:44:25 -0800
Subject: [PATCH] Some comment cleanup in the Netty builders.

---
 .../transport/netty/NettyChannelBuilder.java  |  2 +-
 .../transport/netty/NettyServerBuilder.java   | 22 ++++++++++++++++++-
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/netty/src/main/java/io/grpc/transport/netty/NettyChannelBuilder.java b/netty/src/main/java/io/grpc/transport/netty/NettyChannelBuilder.java
index 6353366f2d..cd857dbce1 100644
--- a/netty/src/main/java/io/grpc/transport/netty/NettyChannelBuilder.java
+++ b/netty/src/main/java/io/grpc/transport/netty/NettyChannelBuilder.java
@@ -41,7 +41,7 @@ import java.net.InetSocketAddress;
 import java.net.SocketAddress;
 
 /**
- * Convenient class for building channels with the netty transport.
+ * A builder to help simplify construction of channels using the Netty transport.
  */
 public final class NettyChannelBuilder extends AbstractChannelBuilder<NettyChannelBuilder> {
 
diff --git a/netty/src/main/java/io/grpc/transport/netty/NettyServerBuilder.java b/netty/src/main/java/io/grpc/transport/netty/NettyServerBuilder.java
index 02fe34109e..1ab523b1b7 100644
--- a/netty/src/main/java/io/grpc/transport/netty/NettyServerBuilder.java
+++ b/netty/src/main/java/io/grpc/transport/netty/NettyServerBuilder.java
@@ -46,7 +46,7 @@ import java.net.InetSocketAddress;
 import java.net.SocketAddress;
 
 /**
- * The convenient builder for a netty-based GRPC server.
+ * A builder to help simplify the construction of a Netty-based GRPC server.
  */
 public final class NettyServerBuilder extends AbstractServerBuilder<NettyServerBuilder> {
 
@@ -56,14 +56,34 @@ public final class NettyServerBuilder extends AbstractServerBuilder<NettyServerB
   private EventLoopGroup userWorkerEventLoopGroup;
   private SslContext sslContext;
 
+  /**
+   * Creates a server builder that will bind to the given port.
+   *
+   * @param port the port on which the server is to be bound.
+   * @return the server builder.
+   */
   public static NettyServerBuilder forPort(int port) {
     return new NettyServerBuilder(port);
   }
 
+  /**
+   * Creates a server builder that will bind to the given port and use the {@link HandlerRegistry}
+   * for call dispatching.
+   *
+   * @param registry the registry of handlers used for dispatching incoming calls.
+   * @param port the port on which to the server is to be bound.
+   * @return the server builder.
+   */
   public static NettyServerBuilder forRegistryAndPort(HandlerRegistry registry, int port) {
     return new NettyServerBuilder(registry, port);
   }
 
+  /**
+   * Creates a server builder configured with the given {@link SocketAddress}.
+   *
+   * @param address the socket address on which the server is to be bound.
+   * @return the server builder
+   */
   public static NettyServerBuilder forAddress(SocketAddress address) {
     return new NettyServerBuilder(address);
   }