DOCSP-19378 methods not available in mongosh (#437)

* DOCSP-19378 methods not available in mongosh

* Staging updates

* Internal review

Author: Dave

snooty.toml

@@ -118,6 +118,7 @@ toc_landing_pages = [
    "/reference/method/js-database",
    "/reference/method/js-free-monitoring",
    "/reference/method/js-native",
+   "/reference/method/js-native-legacy",
    "/reference/method/js-plan-cache",
    "/reference/method/js-replication",
    "/reference/method/js-role-management",

source/includes/fact-native-method-and-shell.rst

@@ -0,0 +1,5 @@
+The native method listed here is for the legacy :binary:`mongo` shell.
+
+To use native methods in :binary:`mongosh`, see
+:ref:`native-in-mongosh`.
+

source/reference/method/cat.txt

@@ -10,6 +10,10 @@ cat()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 Definition
 ----------
 
@@ -19,26 +23,22 @@ Definition
    output relative to the current shell session and does not impact the
    server.
 
+   .. _cat-native-options:
+
    .. list-table::
       :header-rows: 1
       :widths: 20 20 80
 
       * - Parameter
-
         - Type
-
         - Description
 
       * - ``filename``
-
         - string
-
         - The filepath to open. The filepath must be on the local file system.
 
       * - ``useBinaryMode``
-
         - boolean
-
         - *Optional.* Flag to determine whether to open
           file in binary mode or text mode.
 

source/reference/method/cd.txt

@@ -10,28 +10,29 @@ cd()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 Definition
 ----------
 
 .. method:: cd(path)
 
-
    .. list-table::
       :header-rows: 1
       :widths: 20 20 80
 
       * - Parameter
-   
         - Type
-   
         - Description
-   
+
       * - ``path``
-   
         - string
-   
-        - A path on the file system local to :binary:`~bin.mongosh` context.
+        - A path on the file system local to the :binary:`mongo` shell
+          context.
+
 
+   :method:`cd()` changes the directory context of :binary:`mongo` and
+   has no effect on the MongoDB server.
 
-   :method:`cd()` changes the directory context of
-   :binary:`~bin.mongosh` and has no effect on the MongoDB server.

source/reference/method/getHostName.txt

@@ -10,6 +10,11 @@ getHostName()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 .. method:: getHostName()
 
    :returns: The hostname of the system running :binary:`~bin.mongosh`.
+

source/reference/method/getMemInfo.txt

@@ -10,6 +10,10 @@ getMemInfo()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 .. method:: getMemInfo()
 
    Returns a document with two fields that report the amount of memory

source/reference/method/isInteractive.txt

@@ -10,6 +10,10 @@ isInteractive()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 .. method:: isInteractive()
 
    .. versionadded:: 4.2
@@ -19,7 +23,6 @@ isInteractive()
    script mode:
 
    - ``true`` if in interactive mode
-   
    - ``false`` if in script mode
 
 Examples

source/reference/method/isWindows.txt

@@ -10,6 +10,10 @@ _isWindows()
    :depth: 1
    :class: singlecol
 
+.. note::
+
+   .. include:: /includes/fact-native-method-and-shell.rst
+
 .. method:: _isWindows()
 
    :returns: boolean.

source/reference/method/js-native-legacy.txt

@@ -0,0 +1,147 @@
+.. _native-in-legacy:
+
+==================================
+Native Methods in the Legacy Shell
+==================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The methods listed in this section are for the legacy :binary:`mongo`
+shell. To use native methods in :binary:`mongosh`, see
+:ref:`native-in-mongosh`.
+
+The `mongocompat snippet
+<https://github.com/mongodb-labs/mongosh-snippets/blob/main/snippets/mongocompat/index.js>`__
+also provides access to legacy :binary:`mongo` shell APIs.
+
+.. include:: /includes/extracts/methods-toc-explanation.rst
+
+.. list-table::
+   :widths: 30,70
+   :header-rows: 1
+
+   * - Name
+     - Description
+
+   * - :doc:`/reference/method/cat`
+
+     - Returns the contents of the specified file.
+
+   * - :doc:`/reference/method/cd`
+
+     - Changes the current working directory to the specified path.
+
+   * - :method:`copyDbpath()`
+
+     - Copies a local :setting:`~storage.dbPath`. For internal use.
+
+   * - :method:`getHostName()`
+
+     - Returns the hostname of the computer running the shell.
+
+   * - :method:`getMemInfo()`
+
+     - Returns a document that reports the amount of memory used by
+       the shell.
+
+   * - :doc:`/reference/method/hostname`
+
+     - Returns the hostname of the system running the shell.
+
+   * - :doc:`/reference/method/isInteractive`
+
+     - Returns a boolean indicating whether the shell is running in
+       interactive or script mode.
+
+   * - :method:`listFiles()`
+
+     - Returns an array of documents that show the name and size of
+       each object in the directory.
+
+   * - :doc:`/reference/method/load`
+
+     - Loads and runs a JavaScript file in the shell.
+
+   * - :doc:`/reference/method/ls`
+
+     - Returns a list of the files in the current directory.
+
+   * - :method:`md5sumFile()`
+
+     - The :term:`md5` hash of the specified file.
+
+   * - :doc:`/reference/method/mkdir`
+
+     - Creates a directory in the specified path.
+
+   * - :doc:`/reference/method/pwd`
+
+     - Returns the current directory.
+
+   * - :doc:`/reference/method/quit`
+
+     - Exits the current shell session.
+
+   * - :method:`removeFile()`
+
+     - Removes the specified file from the local file system.
+
+   * - :method:`resetDbpath()`
+
+     - Removes a local :setting:`~storage.dbPath`. For internal use.
+
+   * - :doc:`/reference/method/sleep`
+
+     - Suspends :binary:`~bin.mongosh` for a period of time.
+
+   * - :method:`setVerboseShell()`
+
+     - Configures :binary:`~bin.mongosh` to report operation timing.
+
+   * - :doc:`/reference/method/version`
+
+     - Returns the current version of :binary:`~bin.mongosh` instance.
+
+   * - :method:`_isWindows()`
+
+     - Returns:
+     
+       - ``true`` if the shell runs on Windows.
+       - ``false`` if the shell runs on Unix or Linux.
+
+   * - :method:`_rand()`
+
+     - Returns a random number between ``0`` and ``1``.
+
+
+.. toctree::
+   :titlesonly: 
+   :hidden: 
+
+   /reference/method/cat
+   /reference/method/cd
+   /reference/method/copyDbpath
+   /reference/method/getHostName
+   /reference/method/getMemInfo
+   /reference/method/hostname
+   /reference/method/isInteractive
+   /reference/method/listFiles
+   /reference/method/load
+   /reference/method/ls
+   /reference/method/md5sumFile
+   /reference/method/mkdir
+   /reference/method/pwd
+   /reference/method/quit
+   /reference/method/removeFile
+   /reference/method/resetDbpath
+   /reference/method/sleep
+   /reference/method/setVerboseShell
+   /reference/method/version
+   /reference/method/isWindows
+   /reference/method/rand