Merge pull request #167 from davemungo/DOCSP-16154-graceful-handling-of-ctrl-c

DOCSP-16154 Graceful handling of ctrl+c

Author: jason-price-mongodb

source/run-commands.txt

@@ -117,13 +117,30 @@ using the :option:`--norc <mongosh --norc>` option.
 Terminate a Running Command
 ---------------------------
 
-To terminate a running command or query in ``mongosh``,
+To terminate a running command or query in :binary:`~bin.mongosh`,
 press ``Ctrl + C``.
 
-``Ctrl + C`` terminates the process in the shell, but does not
-terminate the process on the MongoDB server. This behavior
-differs from the :method:`db.killOp()` method, which terminates
-commands on the server.
+When you enter ``Ctrl + C``, :binary:`~bin.mongosh`: 
+
+- interrupts the active command,
+- tries to terminate the ongoing, server-side operation, and
+- returns a command prompt.
+
+If :binary:`~bin.mongosh` cannot cleanly terminate the running process,
+it issues a warning. 
+
+.. note::
+
+   Pressing ``Ctrl + C`` in :binary:`~bin.mongosh` does not terminate
+   asynchronous code. Asynchronous operations such as ``setTimeout`` or
+   operations like ``fs.readFile`` continue to run.
+
+   There is no way to terminate asynchronous code in
+   :binary:`~bin.mongosh`. This is the same behavior as in the Node.js
+   `REPL <https://nodejs.org/api/repl.html>`__.
+
+Pressing ``Ctrl + C`` once will not exit :binary:`~bin.mongosh`, press
+``Ctrl + C`` twice to  exit :binary:`~bin.mongosh`.
 
 Command Exceptions
 ------------------
@@ -150,3 +167,4 @@ with ``Ctrl + L`` and ``console.clear()``.
 
    /crud
    /run-agg-pipelines
+