diff --git a/doc/api/net.md b/doc/api/net.md index d85bf56c895690..3e16d4a638f330 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -600,9 +600,9 @@ the error passed to the [`'error'`][] listener. The last parameter `connectListener`, if supplied, will be added as a listener for the [`'connect'`][] event **once**. -This function should not be used for reconnecting a socket. Calling -[`socket.connect()`][] a second time leads to undefined behavior. -[`net.connect()`][] implicitly calls [`socket.connect()`][]. +This function should only be used for reconnecting a socket after +`'close'` has been emitted or otherwise it may lead to undefined +behavior. #### `socket.connect(options[, connectListener])`