DOCSP-23367 multiple eval args (#229)

* DOCSP-23367 multiple eval arguments

* DOCSP-23367 multiple eval arguments

* DOCSP-23367 multiple eval arguments

* DOCSP-23367 multiple eval arguments

* DOCSP-23367 multiple eval arguments

Author: Dave Cuthbert

source/includes/examples/ex-eval-multi.rst

@@ -0,0 +1,10 @@
+To get a list of collections in the ``moviesDatabase``, use multiple
+``--eval`` statements:
+
+.. code-block:: javascript
+
+   mongosh --quiet \
+           --eval 'use moviesDatabase' \
+           --eval 'show collections' \
+           mongodb://localhost/
+

source/includes/examples/ex-eval-output.rst

@@ -1,9 +1,12 @@
+To get output suitable for automated parsing, use
+``EJSON.stringify()``.
+
 .. code-block:: javascript
 
-   mongosh --quiet  --host rs0/centos1104 --port 27500 \
-           --eval "EJSON.stringify(rs.status().members.map( \
-             m => ({'id':m._id, 'name':m.name, 'stateStr':m.stateStr})));" \
-   | jq 
+  mongosh --quiet  --host rs0/centos1104 --port 27500 \
+          --eval "EJSON.stringify(rs.status().members.map( \
+            m => ({'id':m._id, 'name':m.name, 'stateStr':m.stateStr})));" \
+  | jq 
 
 After parsing with ``jq``, the output resembles this:
 

source/reference/compatibility.txt

@@ -165,8 +165,7 @@ in ``mongosh`` better align with the types used by the MongoDB Drivers.
 ``--eval`` Behavior
 -------------------
 
-``mongosh --eval`` does not quote object keys in its ouptut. To get
-output suitable for automated parsing, use ``EJSON.stringify()``.
+``mongosh --eval`` does not quote object keys in its ouptut.
 
 .. include:: /includes/examples/ex-eval-output.rst
 

source/reference/options.txt

@@ -25,19 +25,22 @@ General Options
 
 .. option:: --eval <javascript>
 
-   Evaluates a JavaScript expression that is specified as an argument.
-   ``mongosh`` does not load its own environment when evaluating
-   code. As a result many options of the shell environment are not
-   available.
-
-   The result of evaluating a JavaScript argument is printed to your 
-   command line.
+   Evaluates a JavaScript expression. You can use a single ``--eval``
+   argument or multiple ``--eval`` arguments together.
+   
+   After ``mongosh`` evaluates the ``--eval`` argument, it prints the
+   results to your command line. If you use multiple ``--eval``
+   statements, ``mongosh`` only prints the results of the last
+   ``--eval``.
 
-   To get output suitable for automated parsing, use
-   ``EJSON.stringify()``.
+   **Example: Format Output**
 
    .. include:: /includes/examples/ex-eval-output.rst
 
+   **Example: Multiple ``--eval`` Arguments**
+
+   .. include:: /includes/examples/ex-eval-multi.rst
+
 .. option:: --help, -h
 
    Returns information on the options and use of the |mdb-shell|.
@@ -445,8 +448,6 @@ Authentication Options
    :option:`--password <--password>` and
    :option:`--authenticationDatabase <--authenticationDatabase>`
    options.
-   
-
 
 Session Options
 ---------------