doc: fixes in cluster.md

* Capitalization and punctuation.

* `setupMaster` contained info about `settings` which where incomplete.

PR-URL: https://github.com/nodejs/node/pull/14140
Fixes: https://github.com/nodejs/node/issues/8495
Fixes: https://github.com/nodejs/node/issues/12941
Refs: https://github.com/nodejs/node/pull/9659
Refs: https://github.com/nodejs/node/pull/13761
Reviewed-By: Refael Ackermann <refack@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
This commit is contained in:
cornholio 2017-07-10 15:19:57 -04:00 committed by Refael Ackermann
parent 074b7c271c
commit ca5b0c4f11
No known key found for this signature in database
GPG Key ID: CD704BD80FDDDB64

View File

@ -700,12 +700,12 @@ changes:
--> -->
* {Object} * {Object}
* `execArgv` {Array} list of string arguments passed to the Node.js * `execArgv` {Array} List of string arguments passed to the Node.js
executable. (Default=`process.execArgv`) executable. (Default=`process.execArgv`)
* `exec` {string} file path to worker file. (Default=`process.argv[1]`) * `exec` {string} File path to worker file. (Default=`process.argv[1]`)
* `args` {Array} string arguments passed to worker. * `args` {Array} String arguments passed to worker.
(Default=`process.argv.slice(2)`) (Default=`process.argv.slice(2)`)
* `silent` {boolean} whether or not to send output to parent's stdio. * `silent` {boolean} Whether or not to send output to parent's stdio.
(Default=`false`) (Default=`false`)
* `stdio` {Array} Configures the stdio of forked processes. Because the * `stdio` {Array} Configures the stdio of forked processes. Because the
cluster module relies on IPC to function, this configuration must contain an cluster module relies on IPC to function, this configuration must contain an
@ -727,26 +727,19 @@ changes:
description: The `stdio` option is supported now. description: The `stdio` option is supported now.
--> -->
* `settings` {Object} * `settings` {Object} see [`cluster.settings`][]
* `exec` {string} file path to worker file. (Default=`process.argv[1]`)
* `args` {Array} string arguments passed to worker.
(Default=`process.argv.slice(2)`)
* `silent` {boolean} whether or not to send output to parent's stdio.
(Default=`false`)
* `stdio` {Array} Configures the stdio of forked processes. When this option
is provided, it overrides `silent`.
`setupMaster` is used to change the default 'fork' behavior. Once called, `setupMaster` is used to change the default 'fork' behavior. Once called,
the settings will be present in `cluster.settings`. the settings will be present in `cluster.settings`.
Note that: Note that:
* any settings changes only affect future calls to `.fork()` and have no * Any settings changes only affect future calls to `.fork()` and have no
effect on workers that are already running effect on workers that are already running.
* The *only* attribute of a worker that cannot be set via `.setupMaster()` is * The *only* attribute of a worker that cannot be set via `.setupMaster()` is
the `env` passed to `.fork()` the `env` passed to `.fork()`.
* the defaults above apply to the first call only, the defaults for later * The defaults above apply to the first call only, the defaults for later
calls is the current value at the time of `cluster.setupMaster()` is called calls is the current value at the time of `cluster.setupMaster()` is called.
Example: Example:
@ -834,3 +827,4 @@ socket.on('data', (id) => {
[Child Process module]: child_process.html#child_process_child_process_fork_modulepath_args_options [Child Process module]: child_process.html#child_process_child_process_fork_modulepath_args_options
[child_process event: 'exit']: child_process.html#child_process_event_exit [child_process event: 'exit']: child_process.html#child_process_event_exit
[child_process event: 'message']: child_process.html#child_process_event_message [child_process event: 'message']: child_process.html#child_process_event_message
[`cluster.settings`]: #clustersettings