From 98eb18ba3fb0a2a6938a84152004c69038349055 Mon Sep 17 00:00:00 2001
From: QianJin2013 <osexp2003@gmail.com>
Date: Sun, 12 Feb 2017 18:45:42 +0900
Subject: [PATCH] doc: add comment for net.Server's error event

Fixes: https://github.com/nodejs/node/issues/9710
PR-URL: https://github.com/nodejs/node/pull/11136
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Sam Roberts <vieuxtech@gmail.com>
---
 doc/api/net.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/api/net.md b/doc/api/net.md
index 49e8b6126895d0..2936800fe91178 100644
--- a/doc/api/net.md
+++ b/doc/api/net.md
@@ -40,8 +40,10 @@ added: v0.1.90
 
 * {Error}
 
-Emitted when an error occurs.  The [`'close'`][] event will be called directly
-following this event.  See example in discussion of `server.listen`.
+Emitted when an error occurs. Unlike [`net.Socket`][], the [`'close'`][]
+event will **not** be emitted directly following this event unless
+[`server.close()`][] is manually called. See the example in discussion of
+[`server.listen()`][`server.listen(port, host, backlog, callback)`].
 
 ### Event: 'listening'
 <!-- YAML
@@ -942,6 +944,7 @@ Returns true if input is a version 6 IP address, otherwise returns false.
 [`resume()`]: #net_socket_resume
 [`server.getConnections()`]: #net_server_getconnections_callback
 [`server.listen(port, host, backlog, callback)`]: #net_server_listen_port_hostname_backlog_callback
+[`server.close()`]: #net_server_close_callback
 [`socket.connect(options, connectListener)`]: #net_socket_connect_options_connectlistener
 [`socket.connect`]: #net_socket_connect_options_connectlistener
 [`socket.setTimeout()`]: #net_socket_settimeout_timeout_callback