diff --git a/src/main/java/org/jboss/netty/handler/timeout/IdleStateHandler.java b/src/main/java/org/jboss/netty/handler/timeout/IdleStateHandler.java
index 2d7c80b677..b5ad39c0f4 100644
--- a/src/main/java/org/jboss/netty/handler/timeout/IdleStateHandler.java
+++ b/src/main/java/org/jboss/netty/handler/timeout/IdleStateHandler.java
@@ -79,7 +79,7 @@ import org.jboss.netty.util.TimerTask;
  *
  *     public {@link ChannelPipeline} getPipeline() {
  *         return {@link Channels}.pipeline(
- *             new {@link IdleStateHandler}(timer, 30, 30, 0),
+ *             <b>new {@link IdleStateHandler}(timer, 30, 30, 0), // timer must be shared.</b>
  *             new MyHandler());
  *     }
  * }
diff --git a/src/main/java/org/jboss/netty/handler/timeout/ReadTimeoutHandler.java b/src/main/java/org/jboss/netty/handler/timeout/ReadTimeoutHandler.java
index f0927cd771..c06e722aac 100644
--- a/src/main/java/org/jboss/netty/handler/timeout/ReadTimeoutHandler.java
+++ b/src/main/java/org/jboss/netty/handler/timeout/ReadTimeoutHandler.java
@@ -50,7 +50,7 @@ import org.jboss.netty.util.TimerTask;
  *     public {@link ChannelPipeline} getPipeline() {
  *         // An example configuration that implements 30-second read timeout:
  *         return {@link Channels}.pipeline(
- *             new {@link ReadTimeoutHandler}(timer, 30),
+ *             <b>new {@link ReadTimeoutHandler}(timer, 30), // timer must be shared.</b>
  *             new MyHandler());
  *     }
  * }
diff --git a/src/main/java/org/jboss/netty/handler/timeout/WriteTimeoutHandler.java b/src/main/java/org/jboss/netty/handler/timeout/WriteTimeoutHandler.java
index 81f7341957..931d3e583b 100644
--- a/src/main/java/org/jboss/netty/handler/timeout/WriteTimeoutHandler.java
+++ b/src/main/java/org/jboss/netty/handler/timeout/WriteTimeoutHandler.java
@@ -51,7 +51,7 @@ import org.jboss.netty.util.TimerTask;
  *     public {@link ChannelPipeline} getPipeline() {
  *         // An example configuration that implements 30-second write timeout:
  *         return {@link Channels}.pipeline(
- *             new {@link WriteTimeoutHandler}(timer, 30),
+ *             <b>new {@link WriteTimeoutHandler}(timer, 30), // timer must be shared.</b>
  *             new MyHandler());
  *     }
  * }