From 1ed7741a968003de3cf58a559cbf2acfd09d2517 Mon Sep 17 00:00:00 2001
From: Trustin Lee <trustin@gmail.com>
Date: Wed, 3 Sep 2008 07:44:39 +0000
Subject: [PATCH] Added the limitation section to oio factories

---
 .../channel/socket/oio/OioClientSocketChannelFactory.java   | 6 ++++++
 .../channel/socket/oio/OioServerSocketChannelFactory.java   | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/src/main/java/org/jboss/netty/channel/socket/oio/OioClientSocketChannelFactory.java b/src/main/java/org/jboss/netty/channel/socket/oio/OioClientSocketChannelFactory.java
index 36b76b9944..b0e2177ad3 100644
--- a/src/main/java/org/jboss/netty/channel/socket/oio/OioClientSocketChannelFactory.java
+++ b/src/main/java/org/jboss/netty/channel/socket/oio/OioClientSocketChannelFactory.java
@@ -72,6 +72,12 @@ import org.jboss.netty.channel.socket.SocketChannel;
  * closed.  Otherwise, you will end up with a {@link RejectedExecutionException}
  * and the related resources might not be released properly.
  *
+ * <h3>Limitation</h3>
+ * <p>
+ * A {@link SocketChannel} created by this factory doesn't support asynchronous
+ * operations.  Any I/O requests such as {@code "connect"} and {@code "write"}
+ * will be performed in a blocking manner.
+ *
  * @author The Netty Project (netty-dev@lists.jboss.org)
  * @author Trustin Lee (tlee@redhat.com)
  *
diff --git a/src/main/java/org/jboss/netty/channel/socket/oio/OioServerSocketChannelFactory.java b/src/main/java/org/jboss/netty/channel/socket/oio/OioServerSocketChannelFactory.java
index 2ec324a48e..1158d73019 100644
--- a/src/main/java/org/jboss/netty/channel/socket/oio/OioServerSocketChannelFactory.java
+++ b/src/main/java/org/jboss/netty/channel/socket/oio/OioServerSocketChannelFactory.java
@@ -84,6 +84,12 @@ import org.jboss.netty.channel.socket.ServerSocketChannelFactory;
  * closed.  Otherwise, you will end up with a {@link RejectedExecutionException}
  * and the related resources might not be released properly.
  *
+ * <h3>Limitation</h3>
+ * <p>
+ * A {@link ServerSocketChannel} created by this factory and its child channels
+ * don't support asynchronous operations.  Any I/O requests such as
+ * {@code "write"} will be performed in a blocking manner.
+ *
  * @author The Netty Project (netty-dev@lists.jboss.org)
  * @author Trustin Lee (tlee@redhat.com)
  *