Skip to content

Commit 47ba122

Browse files
TrottBethGriggs
authored andcommittedDec 15, 2020
doc: improve text for breakOnSigint
* Make the 7 instances of breakOnSigint text blocks consistent. * Use present tense. * Use kbd element for keystrokes. * Minor style edits. PR-URL: #35692 Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
1 parent c0d9756 commit 47ba122

File tree

1 file changed

+35
-35
lines changed

1 file changed

+35
-35
lines changed
 

‎doc/api/vm.md

+35-35
Original file line numberDiff line numberDiff line change
@@ -146,11 +146,11 @@ changes:
146146
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
147147
before terminating execution. If execution is terminated, an [`Error`][]
148148
will be thrown. This value must be a strictly positive integer.
149-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
150-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
151-
event that have been attached via `process.on('SIGINT')` will be disabled
152-
during script execution, but will continue to work after that. If execution
153-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
149+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
150+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
151+
event that have been attached via `process.on('SIGINT')` are disabled
152+
during script execution, but continue to work after that. If execution
153+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
154154
* Returns: {any} the result of the very last statement executed in the script.
155155

156156
Runs the compiled code contained by the `vm.Script` object within the given
@@ -208,11 +208,11 @@ changes:
208208
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
209209
before terminating execution. If execution is terminated, an [`Error`][]
210210
will be thrown. This value must be a strictly positive integer.
211-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
212-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
213-
event that have been attached via `process.on('SIGINT')` will be disabled
214-
during script execution, but will continue to work after that. If execution
215-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
211+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
212+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
213+
event that have been attached via `process.on('SIGINT')` are disabled
214+
during script execution, but continue to work after that. If execution
215+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
216216
* `contextName` {string} Human-readable name of the newly created context.
217217
**Default:** `'VM Context i'`, where `i` is an ascending numerical index of
218218
the created context.
@@ -272,11 +272,11 @@ changes:
272272
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
273273
before terminating execution. If execution is terminated, an [`Error`][]
274274
will be thrown. This value must be a strictly positive integer.
275-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
276-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
277-
event that have been attached via `process.on('SIGINT')` will be disabled
278-
during script execution, but will continue to work after that. If execution
279-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
275+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
276+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
277+
event that have been attached via `process.on('SIGINT')` are disabled
278+
during script execution, but continue to work after that. If execution
279+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
280280
* Returns: {any} the result of the very last statement executed in the script.
281281

282282
Runs the compiled code contained by the `vm.Script` within the context of the
@@ -511,11 +511,11 @@ in the ECMAScript specification.
511511
* `timeout` {integer} Specifies the number of milliseconds to evaluate
512512
before terminating execution. If execution is interrupted, an [`Error`][]
513513
will be thrown. This value must be a strictly positive integer.
514-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
515-
`SIGINT` (Ctrl+C) is received. Existing handlers for the event that have
516-
been attached via `process.on('SIGINT')` will be disabled during script
517-
execution, but will continue to work after that. If execution is
518-
interrupted, an [`Error`][] will be thrown. **Default:** `false`.
514+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
515+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
516+
event that have been attached via `process.on('SIGINT')` are disabled
517+
during script execution, but continue to work after that. If execution
518+
is interrupted, an [`Error`][] is thrown. **Default:** `false`.
519519
* Returns: {Promise}
520520

521521
Evaluate the module.
@@ -959,11 +959,11 @@ changes:
959959
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
960960
before terminating execution. If execution is terminated, an [`Error`][]
961961
will be thrown. This value must be a strictly positive integer.
962-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
963-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
964-
event that have been attached via `process.on('SIGINT')` will be disabled
965-
during script execution, but will continue to work after that. If execution
966-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
962+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
963+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
964+
event that have been attached via `process.on('SIGINT')` are disabled
965+
during script execution, but continue to work after that. If execution
966+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
967967
* `cachedData` {Buffer|TypedArray|DataView} Provides an optional `Buffer` or
968968
`TypedArray`, or `DataView` with V8's code cache data for the supplied
969969
source. When supplied, the `cachedDataRejected` value will be set to
@@ -1042,11 +1042,11 @@ changes:
10421042
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
10431043
before terminating execution. If execution is terminated, an [`Error`][]
10441044
will be thrown. This value must be a strictly positive integer.
1045-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
1046-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
1047-
event that have been attached via `process.on('SIGINT')` will be disabled
1048-
during script execution, but will continue to work after that. If execution
1049-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
1045+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
1046+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
1047+
event that have been attached via `process.on('SIGINT')` are disabled
1048+
during script execution, but continue to work after that. If execution
1049+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
10501050
* `contextName` {string} Human-readable name of the newly created context.
10511051
**Default:** `'VM Context i'`, where `i` is an ascending numerical index of
10521052
the created context.
@@ -1136,11 +1136,11 @@ changes:
11361136
* `timeout` {integer} Specifies the number of milliseconds to execute `code`
11371137
before terminating execution. If execution is terminated, an [`Error`][]
11381138
will be thrown. This value must be a strictly positive integer.
1139-
* `breakOnSigint` {boolean} If `true`, the execution will be terminated when
1140-
`SIGINT` (Ctrl+C) is received. Existing handlers for the
1141-
event that have been attached via `process.on('SIGINT')` will be disabled
1142-
during script execution, but will continue to work after that. If execution
1143-
is terminated, an [`Error`][] will be thrown. **Default:** `false`.
1139+
* `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT`
1140+
(<kbd>Ctrl</kbd>+<kbd>C</kbd>) is received. Existing handlers for the
1141+
event that have been attached via `process.on('SIGINT')` are disabled
1142+
during script execution, but continue to work after that. If execution
1143+
is terminated, an [`Error`][] is thrown. **Default:** `false`.
11441144
* `cachedData` {Buffer|TypedArray|DataView} Provides an optional `Buffer` or
11451145
`TypedArray`, or `DataView` with V8's code cache data for the supplied
11461146
source. When supplied, the `cachedDataRejected` value will be set to

0 commit comments

Comments
 (0)
Please sign in to comment.