@@ -60,6 +60,11 @@ data EndPoint = EndPoint {
6060-- | Lightweight connection to an endpoint.
6161data Connection = Connection {
6262 -- | Send a message on this connection.
63+ --
64+ -- 'send' provides vectored I/O, and allows multiple data segments to be
65+ -- sent using a single call (cf. 'Network.Socket.ByteString.sendMany').
66+ -- Note that this segment structure is entirely unrelated to the segment
67+ -- structure /returned/ by a 'Received' event.
6368 send :: [ByteString] -> IO (Either (TransportError SendErrorCode) ())
6469 -- | Close the connection.
6570 , close :: IO ()