       (gen-tcp-handler core stats channel-group tcp-handler))))
 
 (defn tcp-server
-  "Create a new TCP server. Doesn't start until (service/start!). Options:
+  "Create a new TCP server. Doesn't start until (service/start!).
+
+  Options:
   :host             The host to listen on (default 127.0.0.1).
   :port             The port to listen on. (default 5554 with TLS, or 5555 std)
-  :core             An atom used to track the active core for this server
+  :core             An atom used to track the active core for this server.
+  :so-backlog       The maximum queue length for incoming tcp connections (default 50).
   :channel-group    A global channel group used to track all connections.
   :initializer      A ChannelInitializer for creating new pipelines.
 

                    (.channel (:channel netty-implementation))
                    (.option ChannelOption/SO_REUSEADDR true)
                    (.option ChannelOption/TCP_NODELAY true)
                    (.childOption ChannelOption/SO_REUSEADDR true)
                    (.childOption ChannelOption/TCP_NODELAY true)
                    (.childOption ChannelOption/SO_KEEPALIVE true)

  ChannelInboundHandlerAdapter which calls (handler core stats
  channel-handler-context message) for each received message.

  To prevent Netty outbound buffer from filling up in the case of clients not
  reading ack messages, we close the channel when it becomes unwritable. Clients
  should then be ready to reconnect if need be as they will receive some form
  of exception in this case.
