diff --git a/doc/api/cli.md b/doc/api/cli.md
index e03773d1e71dd0..ac0233b9d7e2c4 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -111,6 +111,10 @@ Process v8 profiler output generated using the v8 option `--prof`.
 
 Print v8 command line options.
 
+Note: v8 options allow words to be separated by both dashes (`-`) or underscores
+(`_`).
+
+For example, `--stack-trace-limit` is equivalent to `--stack_trace_limit`.
 
 ### `--tls-cipher-list=list`
 
diff --git a/doc/node.1 b/doc/node.1
index de9ea1703452a1..8b70cbbfa34c98 100644
--- a/doc/node.1
+++ b/doc/node.1
@@ -107,6 +107,12 @@ Process v8 profiler output generated using the v8 option \fB\-\-prof\fR
 .BR \-\-v8\-options
 Print v8 command line options.
 
+Note: v8 options allow words to be separated by both dashes (\fB-\fR) or
+underscores (\fB_\fR).
+
+For example, \fB\-\-stack\-trace\-limit\fR is equivalent to
+\fB\-\-stack\_trace\_limit\fR
+
 .TP
 .BR \-\-v8\-pool\-size =\fInum\fR
 Set v8's thread pool size which will be used to allocate background jobs.