summaryrefslogtreecommitdiff
path: root/doc/api
diff options
context:
space:
mode:
authorcjihrig <cjihrig@gmail.com>2019-02-18 14:01:12 -0500
committercjihrig <cjihrig@gmail.com>2019-02-20 15:15:57 -0500
commit823c988b482e609978869820758b7182f32e9de5 (patch)
tree40f0445410b16afeec0e2e273e4890bb82e5e90e /doc/api
parent11a8a940d7bf03dc108082bdd456668210b949c1 (diff)
downloadandroid-node-v8-823c988b482e609978869820758b7182f32e9de5.tar.gz
android-node-v8-823c988b482e609978869820758b7182f32e9de5.tar.bz2
android-node-v8-823c988b482e609978869820758b7182f32e9de5.zip
report: remove verbose setting
This commit removes the --diagnostic-report-verbose CLI option and all associated logic. The flag is currently only used in one place, and only reflects the settings at startup. Additionally, Node tends to use the NODE_DEBUG mechanism for adding verbose output. PR-URL: https://github.com/nodejs/node/pull/26195 Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Diffstat (limited to 'doc/api')
-rw-r--r--doc/api/cli.md8
-rw-r--r--doc/api/process.md5
-rw-r--r--doc/api/report.md11
3 files changed, 2 insertions, 22 deletions
diff --git a/doc/api/cli.md b/doc/api/cli.md
index 5e817eaa1d..a4866e94d5 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -126,13 +126,6 @@ Enables report to be generated on un-caught exceptions, if
`--experimental-report` is enabled. Useful when inspecting JavaScript stack in
conjunction with native stack and other runtime environment data.
-### `--diagnostic-report-verbose`
-<!-- YAML
-added: v11.8.0
--->
-
-Flag that enables additional information to be printed during report generation.
-
### `--enable-fips`
<!-- YAML
added: v6.0.0
@@ -688,7 +681,6 @@ Node.js options that are allowed are:
- `--diagnostic-report-on-signal`
- `--diagnostic-report-signal`
- `--diagnostic-report-uncaught-exception`
-- `--diagnostic-report-verbose`
- `--enable-fips`
- `--experimental-modules`
- `--experimental-repl-await`
diff --git a/doc/api/process.md b/doc/api/process.md
index b87223b9c4..1a009bce54 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -1703,8 +1703,6 @@ added: v11.8.0
* `filename` {string} Name of the file where the report is written.
* `path` {string} Directory where the report is written.
**Default:** the current working directory of the Node.js process.
- * `verbose` {boolean} Flag that controls additional verbose information on
- report generation. **Default:** `false`.
Configures the diagnostic reporting behavior. Upon invocation, the runtime
is reconfigured to generate reports based on `options`. Several usage examples
@@ -1721,9 +1719,6 @@ process.report.setOptions({ filename: 'foo.json', path: '/home' });
// to `stdout` and `stderr`. Usage of these will result in report being written
// to the associated standard streams. URLs are not supported.
process.report.setOptions({ filename: 'stdout' });
-
-// Enable verbose option on report generation.
-process.report.setOptions({ verbose: true });
```
Signal based report generation is not supported on Windows.
diff --git a/doc/api/report.md b/doc/api/report.md
index 8d6d054c0a..419fe33417 100644
--- a/doc/api/report.md
+++ b/doc/api/report.md
@@ -401,9 +401,6 @@ written.
* `--diagnostic-report-signal` Sets or resets the signal for report generation
(not supported on Windows). Default signal is `SIGUSR2`.
-* `--diagnostic-report-verbose` Flag that enables additional information to be
-printed during report generation.
-
A report can also be triggered via an API call from a JavaScript application:
```js
@@ -495,8 +492,7 @@ process.report.setOptions({
events: ['exception', 'fatalerror', 'signal'],
signal: 'SIGUSR2',
filename: 'myreport.json',
- path: '/home/nodeuser',
- verbose: true
+ path: '/home/nodeuser'
});
```
@@ -519,9 +515,6 @@ timestamp, PID and sequence number.
URLs are not supported. Defaults to the current working directory of the
Node.js process.
-`verbose` specifies whether to print additional verbose messages
-pertinent to the report generation. Defaults to `false`.
-
```js
// Trigger report only on uncaught exceptions.
process.report.setOptions({ events: ['exception'] });
@@ -541,7 +534,7 @@ environment variables:
NODE_OPTIONS="--experimental-report --diagnostic-report-uncaught-exception \
--diagnostic-report-on-fatalerror --diagnostic-report-on-signal \
--diagnostic-report-signal=SIGUSR2 --diagnostic-report-filename=./report.json \
- --diagnostic-report-directory=/home/nodeuser --diagnostic-report-verbose"
+ --diagnostic-report-directory=/home/nodeuser"
```
Specific API documentation can be found under