DOCSP-47758-history-command (#396)

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

* DOCSP-47758-history-command

---------

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/logs/command-history.txt

@@ -32,3 +32,40 @@ text editor:
 
    * - Windows
      - ``%UserProfile%/.mongodb/mongosh/mongosh_repl_history``
+
+Starting in |mdb-shell| 2.4.0, you can use the ``history()`` command to
+view a list of previously executed commands. For example:
+
+.. code-block:: javascript
+
+   history()
+
+The following example output shows a list of commands in an array of
+strings:
+
+.. code-block:: javascript
+   :copyable: false
+
+   [
+     'db.pizzaOrders.explain()',
+     'db.pizzaOrders.find()',
+     'db.pizzaOrders.explain.find()',
+     'db.pizzaOrders.explain.find( {} )',
+     'db.pizzaOrders.explain().find( {} )',
+     'db.pizzaOrders.explain().find( orderDate, totalNumber )',
+     'db.pizzaOrders.explain().find( orderDate: Date( "2024-03-20T10:01:12Z" ), totalNumber: 20 )',
+     'db.pizzaOrders.explain().find( totalNumber: 20 )',
+     'db.pizzaOrders.explain().find( { orderDate: Date( "2024-03-20T10:01:12Z" ) }, { totalNumber: 20 } )',
+     'db.pizzaOrders.find( { orderDate: Date( "2024-03-20T10:01:12Z" ) }, { totalNumber: 20 } )',
+     ...
+   ]
+
+The history is returned in chronological order.
+
+``history()`` supports JavaScript array methods. You can use ``slice()``
+to return a section of an array. For example, to view the last 10
+commands, run:
+
+.. code-block:: javascript
+
+   history().slice(-10)

source/reference/access-mdb-shell-help.txt

@@ -407,6 +407,10 @@ certain database commands and obtain information on your deployment:
    * - ``help``
      - Display help.
 
+   * - ``history()``
+     - Display a list of previously executed commands. Available
+       starting in |mdb-shell| 2.4.0.
+
    * - ``show collections``
      - Display a list of all collections for current database.