doc: doc that listen can be called multiple times

Fixes: #4646 PR-URL: #8294 Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
nodejs · Aug 29, 2016 · 488d37b · 488d37b
1 parent 61fa50d
commit 488d37b
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -681,6 +681,9 @@ This function is asynchronous. `callback` will be added as a listener for the
 
 Returns `server`.
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listen(path[, callback])
 <!-- YAML
 added: v0.1.90
@@ -691,6 +694,9 @@ Start a UNIX socket server listening for connections on the given `path`.
 This function is asynchronous. `callback` will be added as a listener for the
 [`'listening'`][] event.  See also [`net.Server.listen(path)`][].
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listen([port][, hostname][, backlog][, callback])
 <!-- YAML
 added: v0.1.90
@@ -713,6 +719,9 @@ parameter is 511 (not 512).
 This function is asynchronous. `callback` will be added as a listener for the
 [`'listening'`][] event.  See also [`net.Server.listen(port)`][].
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listening
 <!-- YAML
 added: v5.7.0

diff --git a/doc/api/net.md b/doc/api/net.md
@@ -173,6 +173,9 @@ server.listen({
 });
 ```
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listen(path[, backlog][, callback])
 <!-- YAML
 added: v0.1.90
@@ -210,6 +213,9 @@ double-backslashes, such as:
 The parameter `backlog` behaves the same as in
 [`server.listen([port][, hostname][, backlog][, callback])`][`server.listen(port, host, backlog, callback)`].
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listen([port][, hostname][, backlog][, callback])
 <!-- YAML
 added: v0.1.90
@@ -249,6 +255,9 @@ server.on('error', (e) => {
 
 (Note: All sockets in Node.js are set `SO_REUSEADDR`.)
 
+*Note*: The `server.listen()` method may be called multiple times. Each
+subsequent call will *re-open* the server using the provided options.
+
 ### server.listening
 <!-- YAML
 added: v5.7.0