src/doc: improve man page and --help

- add missing environment variables to --help
- add missing flags to man page
- sort environment variables alphabetically
- add some highlighting to the man page
- remove stops from descriptions in --help for consistency
- few other minor tweaks to --help

PR-URL: https://github.com/nodejs/node/pull/10157
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Italo A. Casas <me@italoacasas.com>
Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>

doc/node.1

@@ -116,6 +116,15 @@ Print stack traces for process warnings (including deprecations).
 Print a stack trace whenever synchronous I/O is detected after the first turn
 of the event loop.
 
+.TP
+.BR \-\-trace\-events\-enabled
+Enables the collection of trace event tracing information.
+
+.TP
+.BR \-\-trace\-event\-categories " " \fIcategories\fR
+A comma separated list of categories that should be traced when trace event
+tracing is enabled using \fB--trace-events-enabled\fR.
+
 .TP
 .BR \-\-zero\-fill\-buffers
 Automatically zero-fills all newly allocated Buffer and SlowBuffer instances.
@@ -182,28 +191,36 @@ Specify ICU data load path. (overrides \fBNODE_ICU_DATA\fR)
 \',\'\-separated list of core modules that should print debug information.
 
 .TP
-.BR NODE_PATH =\fIpath\fR[:\fI...\fR]
+.BR NODE_DISABLE_COLORS =\fI1\fR
-\':\'\-separated list of directories prefixed to the module search path.
+When set to \fI1\fR, colors will not be used in the REPL.
 
 .TP
-.BR NODE_DISABLE_COLORS=1
+.BR NODE_EXTRA_CA_CERTS =\fIfile\fR
-When set to 1 colors will not be used in the REPL.
+When set, the well known "root" CAs (like VeriSign) will be extended with the
+extra certificates in \fIfile\fR. The file should consist of one or more
+trusted certificates in PEM format. A message will be emitted (once) with
+\fBprocess.emitWarning()\fR if the file is missing or misformatted, but any
+errors are otherwise ignored.
 
 .TP
 .BR NODE_ICU_DATA =\fIfile\fR
 Data path for ICU (Intl object) data. Will extend linked-in data when compiled
 with small\-icu support.
 
+.TP
+.BR NODE_PATH =\fIpath\fR[:\fI...\fR]
+\':\'\-separated list of directories prefixed to the module search path.
+
 .TP
 .BR NODE_REPL_HISTORY =\fIfile\fR
 Path to the file used to store the persistent REPL history. The default path
-is ~/.node_repl_history, which is overridden by this variable. Setting the
+is \fB~/.node_repl_history\fR, which is overridden by this variable. Setting the
 value to an empty string ("" or " ") disables persistent REPL history.
 
 .TP
-.BR NODE_TTY_UNSAFE_ASYNC=1
+.BR NODE_TTY_UNSAFE_ASYNC =\fI1\fR
-When set to 1, writes to stdout and stderr will be non-blocking and asynchronous
+When set to \fI1\fR, writes to stdout and stderr will be non-blocking and
-when outputting to a TTY on platforms which support async stdio.
+asynchronous when outputting to a TTY on platforms which support async stdio.
 Setting this will void any guarantee that stdio will not be interleaved or
 dropped at program exit. \fBAvoid use.\fR
 

src/node.cc

@@ -3482,8 +3482,7 @@ static void PrintHelp() {
          "repeated)\n"
          "  --no-deprecation         silence deprecation warnings\n"
          "  --trace-deprecation      show stack traces on deprecations\n"
-         "  --throw-deprecation      throw an exception anytime a deprecated "
+         "  --throw-deprecation      throw an exception on deprecations\n"
-         "function is used\n"
          "  --no-warnings            silence all process warnings\n"
          "  --trace-warnings         show stack traces on process warnings\n"
          "  --trace-sync-io          show stack trace when use of sync IO\n"
@@ -3514,27 +3513,29 @@ static void PrintHelp() {
          "  --icu-data-dir=dir       set ICU data load path to dir\n"
          "                           (overrides NODE_ICU_DATA)\n"
 #if !defined(NODE_HAVE_SMALL_ICU)
-         "                           note: linked-in ICU data is\n"
+         "                           note: linked-in ICU data is present\n"
-         "                           present.\n"
 #endif
          "  --preserve-symlinks      preserve symbolic links when resolving\n"
-         "                           and caching modules.\n"
+         "                           and caching modules\n"
 #endif
          "\n"
          "Environment variables:\n"
-#ifdef _WIN32
+         "NODE_DEBUG                 ','-separated list of core modules that\n"
-         "NODE_PATH                  ';'-separated list of directories\n"
+         "                           should print debug information\n"
-#else
-         "NODE_PATH                  ':'-separated list of directories\n"
-#endif
-         "                           prefixed to the module search path.\n"
          "NODE_DISABLE_COLORS        set to 1 to disable colors in the REPL\n"
+         "NODE_EXTRA_CA_CERTS        path to additional CA certificates file\n"
 #if defined(NODE_HAVE_I18N_SUPPORT)
          "NODE_ICU_DATA              data path for ICU (Intl object) data\n"
 #if !defined(NODE_HAVE_SMALL_ICU)
          "                           (will extend linked-in data)\n"
 #endif
 #endif
+#ifdef _WIN32
+         "NODE_PATH                  ';'-separated list of directories\n"
+#else
+         "NODE_PATH                  ':'-separated list of directories\n"
+#endif
+         "                           prefixed to the module search path\n"
          "NODE_REPL_HISTORY          path to the persistent REPL history file\n"
          "\n"
          "Documentation can be found at https://nodejs.org/\n");