doc: Document the `--stack-trace-limit` cli flag.
Checklist
-
documentation is changed or added -
the commit message follows commit guidelines
Affected core subsystem(s)
doc
Description of change
Partially fixes https://github.com/nodejs/node/issues/6271. This commit
simply documents the V8 cli option --stack_trace_limit
but specifies
dashes instead of underscores, which is the Node.js cli convention. I
did not write a test for this, since the behavior hasn't changed. But I
did validate locally that --stack-trace-limit=N
works as now
documented.
The issue noted also has a feature request for functional changes to
the stack trace display, potentially filtering Node.js internals. And also,
potentially increasing the Error.stackTraceLimit
just for the first tick
for Module.runMain
. This PR does not address those requests since
it wasn't really clear to me from the conversation if those were really
desired or needed.