From 388e552579aff6b5152c67adeda182d2d40e8dfc Mon Sep 17 00:00:00 2001
From: Sam Roberts <vieuxtech@gmail.com>
Date: Mon, 26 Jun 2017 11:00:34 -0700
Subject: [PATCH] src: document --abort-on-uncaught-exception

Its important for post-mortem diagnostics and should be more prominently
documented.

PR-URL: https://github.com/nodejs/node/pull/13931
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Refael Ackermann <refack@gmail.com>
Reviewed-By: Julien Gilli <jgilli@nodejs.org>
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
---
 doc/api/cli.md | 8 ++++++++
 doc/node.1     | 4 ++++
 src/node.cc    | 3 +++
 3 files changed, 15 insertions(+)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 0c88eeca17..fd2c4d0bd1 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -178,6 +178,14 @@ added: v8.0.0
 Enable loading native modules compiled with the ABI-stable Node.js API (N-API)
 (experimental).
 
+## `--abort-on-uncaught-exception`
+<!-- YAML
+added: v0.10
+-->
+
+Aborting instead of exiting causes a core file to be generated for post-mortem
+analysis using a debugger (such as `lldb`, `gdb`, and `mdb`).
+
 ### `--trace-warnings`
 <!-- YAML
 added: v6.0.0
diff --git a/doc/node.1 b/doc/node.1
index af9069f134..ca142a2cab 100644
--- a/doc/node.1
+++ b/doc/node.1
@@ -135,6 +135,10 @@ Silence all process warnings (including deprecations).
 Enable loading native modules compiled with the ABI-stable Node.js API (N-API)
 (experimental).
 
+.TP
+.BR \-\-abort\-on\-uncaught\-exception
+Aborting instead of exiting causes a core file to be generated for analysis.
+
 .TP
 .BR \-\-trace\-warnings
 Print stack traces for process warnings (including deprecations).
diff --git a/src/node.cc b/src/node.cc
index 3252a4adf0..1903303724 100644
--- a/src/node.cc
+++ b/src/node.cc
@@ -3645,6 +3645,9 @@ static void PrintHelp() {
          "  --pending-deprecation      emit pending deprecation warnings\n"
          "  --no-warnings              silence all process warnings\n"
          "  --napi-modules             load N-API modules\n"
+         "  --abort-on-uncaught-exception\n"
+         "                             aborting instead of exiting causes a\n"
+         "                             core file to be generated for analysis\n"
          "  --trace-warnings           show stack traces on process warnings\n"
          "  --redirect-warnings=file\n"
          "                             write warnings to file instead of\n"