From 6fa48346e3e881d7a20b676306381fca30efd95e Mon Sep 17 00:00:00 2001
From: James M Snell <jasnell@gmail.com>
Date: Tue, 27 Apr 2021 19:21:53 -0700
Subject: [PATCH] doc: document `'secureConnect'` event limitation

Fixes: https://github.com/nodejs/node/issues/10555
Signed-off-by: James M Snell <jasnell@gmail.com>
Refs: https://github.com/nodejs/node/pull/10846

PR-URL: https://github.com/nodejs/node/pull/38447
Reviewed-By: Alba Mendez <me@alba.sh>
Reviewed-By: Adrian Estrada <edsadr@gmail.com>
---
 doc/api/tls.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/tls.md b/doc/api/tls.md
index 7b32cdfd869e84..055ba472b5c666 100644
--- a/doc/api/tls.md
+++ b/doc/api/tls.md
@@ -817,6 +817,9 @@ determine if the server certificate was signed by one of the specified CAs. If
 `tlsSocket.alpnProtocol` property can be checked to determine the negotiated
 protocol.
 
+The `'secureConnect'` event is not emitted when a {tls.TLSSocket} is created
+using the `new tls.TLSSocket()` constructor.
+
 ### Event: `'session'`
 <!-- YAML
 added: v11.10.0