Some javadocs

handler/src/main/java/io/netty/handler/logging/LoggingHandler.java

@@ -324,6 +324,9 @@ public class LoggingHandler extends ChannelDuplexHandler {
         }
     }
 
+    /**
+     * Returns a String which contains all details to log the {@link ByteBuf}
+     */
     protected String formatByteBuf(String eventName, ByteBuf buf) {
         int length = buf.readableBytes();
         int rows = length / 16 + (length % 15 == 0? 0 : 1) + 4;
@@ -375,6 +378,9 @@ public class LoggingHandler extends ChannelDuplexHandler {
         return dump.toString();
     }
 
+    /**
+     * Returns a String which contains all details to log the {@link Object}
+     */
     protected String formatNonByteBuf(String eventName, Object msg) {
         return eventName + ": " + msg;
     }

handler/src/main/java/io/netty/handler/timeout/IdleStateHandler.java

@@ -77,9 +77,9 @@ import java.util.concurrent.TimeUnit;
  *         if (evt instanceof {@link IdleState}} {
  *             {@link IdleState} e = ({@link IdleState}) evt;
  *             if (e.getState() == {@link IdleState}.READER_IDLE) {
- *                 ctx.channel().close();
+ *                 ctx.close();
  *             } else if (e.getState() == {@link IdleState}.WRITER_IDLE) {
- *                 ctx.channel().write(new PingMessage());
+ *                 ctx.writeAndFlush(new PingMessage());
  *             }
  *         }
  *     }
@@ -313,6 +313,10 @@ public class IdleStateHandler extends ChannelDuplexHandler {
         }
     }
 
+    /**
+     * Is called when an {@link IdleStateEvent} should be fired. This implementation calls
+     * {@link ChannelHandlerContext#fireUserEventTriggered(Object)}.
+     */
     protected void channelIdle(ChannelHandlerContext ctx, IdleStateEvent evt) throws Exception {
         ctx.fireUserEventTriggered(evt);
     }

handler/src/main/java/io/netty/handler/timeout/ReadTimeoutHandler.java

@@ -177,6 +177,9 @@ public class ReadTimeoutHandler extends ChannelInboundHandlerAdapter {
         }
     }
 
+    /**
+     * Is called when a read timeout was detected.
+     */
     protected void readTimedOut(ChannelHandlerContext ctx) throws Exception {
         if (!closed) {
             ctx.fireExceptionCaught(ReadTimeoutException.INSTANCE);

handler/src/main/java/io/netty/handler/timeout/WriteTimeoutHandler.java

@@ -133,6 +133,9 @@ public class WriteTimeoutHandler extends ChannelOutboundHandlerAdapter {
         }
     }
 
+    /**
+     * Is called when a write timeout was detected
+     */
     protected void writeTimedOut(ChannelHandlerContext ctx) throws Exception {
         if (!closed) {
             ctx.fireExceptionCaught(WriteTimeoutException.INSTANCE);