DOCSP-15525 update Manual for mongosh - mongo monospace

andf-mongodb · andf-mongodb · commit 9ff09e3e6dd4 · 2021-07-12T16:38:53.000-04:00
diff --git a/source/core/server-side-javascript.txt b/source/core/server-side-javascript.txt
@@ -43,8 +43,8 @@ see :ref:`disable-server-side-js`.
 
 .. _running-js-scripts-in-mongo-on-mongod-host:
 
-Running ``.js`` files via a ``mongo`` shell Instance on the Server
-------------------------------------------------------------------
+Running ``.js`` files via a ``mongosh`` Instance on the Server
+--------------------------------------------------------------
 
 You can specify a JavaScript (``.js``) file to :mongosh:`mongosh </>`
 to execute the file on the server. This is a good technique
diff --git a/source/core/shell-types.txt b/source/core/shell-types.txt
@@ -1,6 +1,6 @@
-=================================
-Data Types in the ``mongo`` Shell
-=================================
+========================================
+Data Types in the Legacy ``mongo`` Shell
+========================================
 
 .. default-domain:: mongodb
 
diff --git a/source/core/transactions-in-applications.txt b/source/core/transactions-in-applications.txt
@@ -38,7 +38,7 @@ The :ref:`txn-core-api`:
 .. _txn-callback-api:
 
 Callback API
--------------
+------------
 
 The callback API incorporates logic:
 
@@ -453,8 +453,8 @@ Additional Information
 
 .. _txn-mongo-shell-example:
 
-``mongo`` Shell Example
-~~~~~~~~~~~~~~~~~~~~~~~
+``mongosh`` Example
+~~~~~~~~~~~~~~~~~~~
 
 The following :mongosh:`mongosh </>` methods are available for
 transactions:
diff --git a/source/includes/extracts-collation.yaml b/source/includes/extracts-collation.yaml
@@ -225,7 +225,7 @@ content: |-
       :header-rows: 1
 
       * - Commands
-        - ``mongo`` Shell Methods
+        - ``mongosh`` Methods
 
       * - :dbcommand:`create`
         - | :method:`db.createCollection()`
diff --git a/source/includes/extracts-sessions.yaml b/source/includes/extracts-sessions.yaml
@@ -115,7 +115,7 @@ content: |
    </reference/server-sessions>`, with the exception of unacknowledged
    write operations. For operations not explicitly associated with a
    session (i.e. using :method:`Mongo.startSession()`), MongoDB drivers
-   and the ``mongo`` shell creates an implicit session and associates it
+   and ``mongosh`` create an implicit session and associate it
    with the operation.
    
    If a session is idle for longer than 30 minutes, the MongoDB server
diff --git a/source/includes/steps-authenticate-as-client.yaml b/source/includes/steps-authenticate-as-client.yaml
@@ -1,4 +1,4 @@
-title: Specify your credentials when starting the ``mongo`` instance.
+title: Specify your credentials when starting ``mongosh``.
 stepnum: 1
 ref: authenticate
 action:
diff --git a/source/includes/steps-authenticate-through-ldap.yaml b/source/includes/steps-authenticate-through-ldap.yaml
@@ -1,4 +1,4 @@
-title: Authenticate the user in the ``mongo`` shell.
+title: Authenticate the user in ``mongosh``.
 stepnum: 1
 ref: authenticate
 pre: |
diff --git a/source/includes/steps-configure-ldap-mongodb.yaml b/source/includes/steps-configure-ldap-mongodb.yaml
@@ -76,7 +76,7 @@ action:
        .. include:: /includes/extracts/default-bind-ip-security-additional-config-file.rst
 
 ---
-title: Authenticate the user in the ``mongo`` shell.
+title: Authenticate the user in ``mongosh``.
 stepnum: 3
 ref: ldap-sasl-authenticate
 content: |
@@ -91,10 +91,10 @@ content: |
            name: Authenticate during Connection
            content: |
 
-              To authenticate when connecting with the ``mongo`` shell,
-              run :mongosh:`mongosh </>` with the following command-line
-              options, substituting ``<host>`` and ``<user>``, and
-              enter your password when prompted:
+              To authenticate when connecting with
+              :mongosh:`mongosh </>`, run ``mongosh`` with the following
+              command-line options, substituting ``<host>`` and
+              ``<user>``, and enter your password when prompted:
 
               .. code-block:: bash
 
diff --git a/source/includes/steps-control-access-to-mongodb-with-kerberos-authentication.yaml b/source/includes/steps-control-access-to-mongodb-with-kerberos-authentication.yaml
@@ -100,7 +100,7 @@ post: |
    ``KRB5_KTNAME`` in a environment settings file. See
    :ref:`setting-krb5_ktname` for details.
 ---
-title: Connect ``mongo`` shell to ``mongod`` and authenticate.
+title: Connect ``mongosh`` to ``mongod`` and authenticate.
 stepnum: 5
 ref: invoke-an-authenticated-mongo-shell
 pre: |
diff --git a/source/includes/steps-convert-replica-set-add-new-shard.yaml b/source/includes/steps-convert-replica-set-add-new-shard.yaml
@@ -62,7 +62,7 @@ action:
     })
 ---
 title:
-  text: "Connect a ``mongo`` shell to the ``mongos``."
+  text: "Connect ``mongosh`` to the ``mongos``."
   character: "`"
 ref: connect-mongos
 action:
diff --git a/source/includes/steps-convert-replica-set-add-shards.yaml b/source/includes/steps-convert-replica-set-add-shards.yaml
@@ -1,5 +1,5 @@
 title:
-  text: "Connect a ``mongo`` shell to the ``mongos``."
+  text: "Connect ``mongosh`` to the ``mongos``."
   character: "`"
 stepnum: 1
 ref: connect-mongos
diff --git a/source/includes/steps-csfle-shell-aws-create-key.yaml b/source/includes/steps-csfle-shell-aws-create-key.yaml
@@ -1,5 +1,5 @@
 ---
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 ref: launch-mongo-shell
 level: 4
 content: |
diff --git a/source/includes/steps-csfle-shell-aws-delete-key.yaml b/source/includes/steps-csfle-shell-aws-delete-key.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-aws-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-aws-manage-key-altname.yaml b/source/includes/steps-csfle-shell-aws-manage-key-altname.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-aws-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-azure-create-key.yaml b/source/includes/steps-csfle-shell-azure-create-key.yaml
@@ -1,5 +1,5 @@
 ---
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 ref: launch-mongo-shell
 level: 4
 content: |
diff --git a/source/includes/steps-csfle-shell-azure-delete-key.yaml b/source/includes/steps-csfle-shell-azure-delete-key.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-azure-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-azure-manage-key-altname.yaml b/source/includes/steps-csfle-shell-azure-manage-key-altname.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-azure-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-gcp-create-key.yaml b/source/includes/steps-csfle-shell-gcp-create-key.yaml
@@ -1,5 +1,5 @@
 ---
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 ref: launch-mongo-shell
 level: 4
 content: |
diff --git a/source/includes/steps-csfle-shell-gcp-delete-key.yaml b/source/includes/steps-csfle-shell-gcp-delete-key.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-gcp-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-gcp-manage-key-altname.yaml b/source/includes/steps-csfle-shell-gcp-manage-key-altname.yaml
@@ -1,6 +1,6 @@
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 1
 source:
   file: steps-csfle-shell-gcp-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-local-create-key.yaml b/source/includes/steps-csfle-shell-local-create-key.yaml
@@ -32,7 +32,7 @@ content: |
       procedure as appropriate.
 
 ---
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 ref: launch-mongo-shell
 level: 4
 content: |
diff --git a/source/includes/steps-csfle-shell-local-delete-key.yaml b/source/includes/steps-csfle-shell-local-delete-key.yaml
@@ -8,7 +8,7 @@ source:
 ---
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 2
 source:
   file: steps-csfle-shell-local-create-key.yaml
diff --git a/source/includes/steps-csfle-shell-local-manage-key-altname.yaml b/source/includes/steps-csfle-shell-local-manage-key-altname.yaml
@@ -8,7 +8,7 @@ source:
 ---
 level: 4
 ref: launch-mongo-shell
-title: "Launch the ``mongo`` Shell."
+title: "Launch ``mongosh``."
 stepnum: 2
 source:
   file: steps-csfle-shell-local-create-key.yaml
diff --git a/source/includes/steps-run-mongodb-on-osx.yaml b/source/includes/steps-run-mongodb-on-osx.yaml
@@ -111,7 +111,7 @@ action:
   code: |
      mongo
 post: |
-  .. note:: macOS Prevents ``mongo`` From Opening
+  .. note:: macOS Prevents ``mongosh`` From Opening
 
 
      .. include:: /includes/extracts/macos-prevent-launch-mongo.rst
diff --git a/source/includes/table-update-with-aggregation-availability.rst b/source/includes/table-update-with-aggregation-availability.rst
@@ -2,7 +2,7 @@
    :header-rows: 1
 
    * - Command
-     - ``mongo`` Shell Methods
+     - ``mongosh`` Methods
 
    * - :dbcommand:`findAndModify`
 
diff --git a/source/reference/command/getLog.txt b/source/reference/command/getLog.txt
@@ -112,8 +112,8 @@ escape sequences to render log output as valid JSON:
 Filtering
 ---------
 
-Within the ``mongo`` Shell
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Within ``mongosh``
+~~~~~~~~~~~~~~~~~~
 
 :dbcommand:`getLog` output can be filtered to make results more
 readable or to match on specific criteria.
@@ -136,8 +136,8 @@ the MongoDB :option:`log file <mongod --logpath>`.
    :binary:`~bin.mongod` events, and is not a replacement for the
    MongoDB :option:`log file <mongod --logpath>`.
 
-Outside the ``mongo`` Shell with ``jq``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Outside ``mongosh`` with ``jq``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. include:: /includes/fact-use-jq-with-structured-logging.rst
 
diff --git a/source/reference/glossary.txt b/source/reference/glossary.txt
@@ -872,7 +872,7 @@ Glossary
       Sharding enables horizontal scaling. See :doc:`/sharding`.
 
    shell helper
-      A method in the ``mongo`` shell that provides a more concise
+      A method in ``mongosh`` that provides a more concise
       syntax for a :doc:`database command <command>`. Shell helpers
       improve the general interactive experience. See
       :doc:`/reference/method`.
diff --git a/source/reference/indexes.txt b/source/reference/indexes.txt
@@ -10,8 +10,8 @@ Indexing Reference
    :depth: 1
    :class: singlecol
 
-Indexing Methods in the ``mongo`` Shell
----------------------------------------
+Indexing Methods in ``mongosh``
+-------------------------------
 
 .. list-table::
    :widths: 30,70
diff --git a/source/reference/method/db.collection.find.txt b/source/reference/method/db.collection.find.txt
@@ -813,8 +813,8 @@ determined by the ascending sort order on 'name'.
 
 .. _find-cursor-methods:
 
-Available ``mongo`` Shell Cursor Methods
-````````````````````````````````````````
+Available ``mongosh`` Cursor Methods
+````````````````````````````````````
 
 .. hlist::
    :columns: 2
diff --git a/source/reference/method/isInteractive.txt b/source/reference/method/isInteractive.txt
@@ -40,8 +40,8 @@ Connect :mongosh:`mongosh </>` to a deployment. Inside
 
 The method returns ``true``.
 
-Running a Javascript File inside the ``mongo`` Shell
-`````````````````````````````````````````````````````
+Running a Javascript File inside ``mongosh``
+````````````````````````````````````````````
 
 Create a JavaScript ``testExample.js`` file with the content:
 
diff --git a/source/reference/mongo.txt b/source/reference/mongo.txt
@@ -39,7 +39,7 @@ advantages over the legacy :binary:`~bin.mongo` shell, such as:
 
 - Improved logging.
 
-The ``mongosh`` currently supports a subset of the legacy
+``mongosh`` currently supports a subset of the legacy
 :binary:`~bin.mongo` shell methods. To maintain backwards
 compatibility, the methods that the new ``mongosh`` supports use the
 same syntax as the corresponding methods in the legacy
diff --git a/source/reference/replication.txt b/source/reference/replication.txt
@@ -10,8 +10,8 @@ Replication Reference
    :depth: 1
    :class: singlecol
 
-Replication Methods in the ``mongo`` Shell
-------------------------------------------
+Replication Methods in ``mongosh``
+----------------------------------
 
 .. list-table::
    :widths: 30,70
diff --git a/source/reference/security-client-side-automatic-json-schema.txt b/source/reference/security-client-side-automatic-json-schema.txt
@@ -490,7 +490,7 @@ and the 4.2 or later legacy :binary:`~bin.mongo` shell require
 specifying the automatic encryption rules as part of creating the
 database connection object:
 
-- For the MongoDB 4.2 or later shell, use the :method:`Mongo()`
+- For ``mongosh``, use the :method:`Mongo()`
   constructor to create a database connection. Specify the automatic
   encryption rules to the ``schemaMap`` key of the 
   :ref:`ClientSideFieldLevelEncryptionOptions` parameter. See
@@ -639,7 +639,7 @@ and the 4.2 or later legacy :binary:`~bin.mongo` shell require
 specifying the automatic encryption rules as part of creating the
 database connection object:
 
-- For the MongoDB 4.2 or later shell, use the :method:`Mongo()`
+- For ``mongosh``, use the :method:`Mongo()`
   constructor to create a database connection. Specify the automatic
   encryption rules to the ``schemaMap`` key of the 
   :ref:`ClientSideFieldLevelEncryptionOptions` parameter. See
diff --git a/source/reference/security.txt b/source/reference/security.txt
@@ -10,12 +10,12 @@ Security Reference
    :depth: 1
    :class: singlecol
 
-The following lists the security related methods available in the
-``mongo`` shell as well as additional :ref:`security reference material
-<security-reference-materials>`.
+The following lists the security related methods available in
+:mongosh:`mongosh </>` as well as additional
+:ref:`security reference material <security-reference-materials>`.
 
-Security Methods in the ``mongo`` Shell
----------------------------------------
+Security Methods in ``mongosh``
+-------------------------------
 
 User Management and Authentication Methods
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/source/reference/sharding.txt b/source/reference/sharding.txt
@@ -10,8 +10,8 @@ Sharding Reference
    :depth: 1
    :class: singlecol
 
-Sharding Methods in the ``mongo`` Shell
----------------------------------------
+Sharding Methods in ``mongosh``
+-------------------------------
 
 .. list-table::
    :widths: 30,70
diff --git a/source/release-notes/5.0.txt b/source/release-notes/5.0.txt
@@ -293,8 +293,8 @@ the ``"disabled"`` option.
 Shell Changes
 -------------
 
-New ``mongosh`` shell
-~~~~~~~~~~~~~~~~~~~~~
+New MongoDB Shell: ``mongosh``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The ``mongo`` shell has been deprecated in MongoDB v5.0. The
 replacement shell is :mongosh:`mongosh </>`. The legacy ``mongo`` shell
diff --git a/source/tutorial/configure-ssl-clients.txt b/source/tutorial/configure-ssl-clients.txt
diff --git a/source/tutorial/install-mongodb-on-os-x.txt b/source/tutorial/install-mongodb-on-os-x.txt
diff --git a/source/tutorial/iterate-a-cursor.txt b/source/tutorial/iterate-a-cursor.txt

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-title: Specify your credentials when starting the ``mongo`` instance.
	`1`	+title: Specify your credentials when starting ``mongosh``.
`2`	`2`	`stepnum: 1`
`3`	`3`	`ref: authenticate`
`4`	`4`	`action:`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-title: Authenticate the user in the ``mongo`` shell.
	`1`	+title: Authenticate the user in ``mongosh``.
`2`	`2`	`stepnum: 1`
`3`	`3`	`ref: authenticate`
`4`	`4`	`pre: \|`