From 6bf213936596250b7531e01c564a15d290eb38eb Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Sat, 17 Oct 2020 04:49:05 -0700 Subject: [PATCH] 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: https://github.com/nodejs/node/pull/35692 Reviewed-By: Luigi Pinca --- doc/api/vm.md | 70 +++++++++++++++++++++++++-------------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/doc/api/vm.md b/doc/api/vm.md index 437a5e0177d782..547ff38af0dffc 100644 --- a/doc/api/vm.md +++ b/doc/api/vm.md @@ -146,11 +146,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * Returns: {any} the result of the very last statement executed in the script. Runs the compiled code contained by the `vm.Script` object within the given @@ -208,11 +208,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * `contextName` {string} Human-readable name of the newly created context. **Default:** `'VM Context i'`, where `i` is an ascending numerical index of the created context. @@ -272,11 +272,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * Returns: {any} the result of the very last statement executed in the script. Runs the compiled code contained by the `vm.Script` within the context of the @@ -511,11 +511,11 @@ in the ECMAScript specification. * `timeout` {integer} Specifies the number of milliseconds to evaluate before terminating execution. If execution is interrupted, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the event that have - been attached via `process.on('SIGINT')` will be disabled during script - execution, but will continue to work after that. If execution is - interrupted, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is interrupted, an [`Error`][] is thrown. **Default:** `false`. * Returns: {Promise} Evaluate the module. @@ -961,11 +961,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * `cachedData` {Buffer|TypedArray|DataView} Provides an optional `Buffer` or `TypedArray`, or `DataView` with V8's code cache data for the supplied source. When supplied, the `cachedDataRejected` value will be set to @@ -1044,11 +1044,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * `contextName` {string} Human-readable name of the newly created context. **Default:** `'VM Context i'`, where `i` is an ascending numerical index of the created context. @@ -1138,11 +1138,11 @@ changes: * `timeout` {integer} Specifies the number of milliseconds to execute `code` before terminating execution. If execution is terminated, an [`Error`][] will be thrown. This value must be a strictly positive integer. - * `breakOnSigint` {boolean} If `true`, the execution will be terminated when - `SIGINT` (Ctrl+C) is received. Existing handlers for the - event that have been attached via `process.on('SIGINT')` will be disabled - during script execution, but will continue to work after that. If execution - is terminated, an [`Error`][] will be thrown. **Default:** `false`. + * `breakOnSigint` {boolean} If `true`, execution is terminated when `SIGINT` + (Ctrl+C) is received. Existing handlers for the + event that have been attached via `process.on('SIGINT')` are disabled + during script execution, but continue to work after that. If execution + is terminated, an [`Error`][] is thrown. **Default:** `false`. * `cachedData` {Buffer|TypedArray|DataView} Provides an optional `Buffer` or `TypedArray`, or `DataView` with V8's code cache data for the supplied source. When supplied, the `cachedDataRejected` value will be set to