From 9dde1db33263c4acf2883fd1a31715ca9e788c90 Mon Sep 17 00:00:00 2001
From: Robert Nagy <ronagy@icloud.com>
Date: Tue, 5 May 2020 13:04:08 +0200
Subject: [PATCH] doc: add warning for socket.connect reuse

PR-URL: https://github.com/nodejs/node/pull/33204
Refs: https://github.com/nodejs/node/issues/25969
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
---
 doc/api/net.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/api/net.md b/doc/api/net.md
index aa2b918ecdac12..b801be156192cf 100644
--- a/doc/api/net.md
+++ b/doc/api/net.md
@@ -600,6 +600,10 @@ 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 only be used for reconnecting a socket after
+`'close'` has been emitted or otherwise it may lead to undefined
+behavior.
+
 #### `socket.connect(options[, connectListener])`
 <!-- YAML
 added: v0.1.90