update pair doc (#3170)

* update pair doc
zeromq · Jun 21, 2018 · edec224 · edec224
1 parent 85dfca3
commit edec224
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/zmq_socket.txt b/doc/zmq_socket.txt
@@ -358,6 +358,11 @@ high water mark for the connected peer, or if no peer is connected, then
 any linkzmq:zmq_send[3] operations on the socket shall block until the peer
 becomes available for sending; messages are not discarded.
 
+While 'ZMQ_PAIR' sockets can be used over transports other than linkzmq:zmq_inproc[7],
+their inability to auto-reconnect coupled with the fact new incoming connections will
+be terminated while any previous connections (including ones in a closing state)
+exist makes them unsuitable for TCP in most cases.
+
 NOTE: 'ZMQ_PAIR' sockets are designed for inter-thread communication across
 the linkzmq:zmq_inproc[7] transport and do not implement functionality such
 as auto-reconnection.