diff --git a/src/main/java/org/jboss/netty/example/http/snoop/HttpClient.java b/src/main/java/org/jboss/netty/example/http/snoop/HttpClient.java
index fe707b2cf7..86a6c0616e 100644
--- a/src/main/java/org/jboss/netty/example/http/snoop/HttpClient.java
+++ b/src/main/java/org/jboss/netty/example/http/snoop/HttpClient.java
@@ -31,6 +31,9 @@ import org.jboss.netty.handler.codec.http.HttpRequest;
 import org.jboss.netty.handler.codec.http.HttpVersion;
 
 /**
+ * A simple HTTP client that prints out the content of the HTTP response to
+ * {@link System#out} to test {@link HttpServer}.
+ *
  * @author The Netty Project (netty-dev@lists.jboss.org)
  * @author Andy Taylor (andy.taylor@jboss.org)
  * @author Trustin Lee (tlee@redhat.com)
diff --git a/src/main/java/org/jboss/netty/example/http/snoop/HttpServer.java b/src/main/java/org/jboss/netty/example/http/snoop/HttpServer.java
index 494f048b7b..9eef1c4786 100644
--- a/src/main/java/org/jboss/netty/example/http/snoop/HttpServer.java
+++ b/src/main/java/org/jboss/netty/example/http/snoop/HttpServer.java
@@ -22,6 +22,9 @@ import org.jboss.netty.bootstrap.ServerBootstrap;
 import org.jboss.netty.channel.socket.nio.NioServerSocketChannelFactory;
 
 /**
+ * An HTTP server that sends back the content of the received HTTP request
+ * in a pretty plaintext form.
+ *
  * @author The Netty Project (netty-dev@lists.jboss.org)
  * @author Andy Taylor (andy.taylor@jboss.org)
  * @author Trustin Lee (tlee@redhat.com)