From 56d6e82b0af246a48e76aea9e00493ce80248662 Mon Sep 17 00:00:00 2001
From: Timothy Gu <timothygu99@gmail.com>
Date: Wed, 18 Apr 2018 08:50:35 -0700
Subject: [PATCH] doc: fully document --experimental-repl-await

PR-URL: https://github.com/nodejs/node/pull/20133
Fixes: https://github.com/nodejs/node/pull/19604#issuecomment-382427090
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/cli.md  | 8 ++++++++
 doc/api/repl.md | 3 ++-
 doc/node.1      | 5 +++++
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 7c06056fad4368..97edf0f4b2186f 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -74,6 +74,14 @@ added: v8.5.0
 Enable experimental ES module support and caching modules.
 
 
+### `--experimental-repl-await`
+<!-- YAML
+added: REPLACEME
+-->
+
+Enable experimental top-level `await` keyword support in REPL.
+
+
 ### `--experimental-vm-modules`
 <!-- YAML
 added: v9.6.0
diff --git a/doc/api/repl.md b/doc/api/repl.md
index 3a5134d1e24c0e..46cac0df3e0307 100644
--- a/doc/api/repl.md
+++ b/doc/api/repl.md
@@ -181,7 +181,7 @@ Error: foo
 
 #### `await` keyword
 
-With the `--experimental-repl-await` command line option specified,
+With the [`--experimental-repl-await`][] command line option specified,
 experimental support for the `await` keyword is enabled.
 
 <!-- eslint-skip -->
@@ -612,6 +612,7 @@ a `net.Server` and `net.Socket` instance, see: https://gist.github.com/2209310
 For an example of running a REPL instance over [curl(1)][],
 see: https://gist.github.com/2053342
 
+[`--experimental-repl-await`]: cli.html#cli_experimental_repl_await
 [`readline.InterfaceCompleter`]: readline.html#readline_use_of_the_completer_function
 [`readline.Interface`]: readline.html#readline_class_interface
 [`util.inspect()`]: util.html#util_util_inspect_object_options
diff --git a/doc/node.1 b/doc/node.1
index 710487cb864fc8..24d8260b8765ac 100644
--- a/doc/node.1
+++ b/doc/node.1
@@ -83,6 +83,11 @@ Requires Node.js to be built with
 .It Fl \-experimental-modules
 Enable experimental ES module support and caching modules.
 .
+.It Fl \-experimental-repl-await
+Enable experimental top-level
+.Sy await
+keyword support in REPL.
+.
 .It Fl \-experimental-vm-modules
 Enable experimental ES module support in VM module.
 .