adding in links for shell helpers

Author: Andrew Leung

draft/tutorial/copy-database.txt

@@ -40,27 +40,27 @@ Considerations
 - You can run :dbcommand:`copydb` or :dbcommand:`clone` commands on a
   :term:`secondary` member.
 
-- There must be enough free disk storage on the destination server for the
-  database from the source server. You can check for the size of the
-  database on the source server by issuing command:
-
-  .. code-block::
-
-     db.runCommand()
+- There must be enough free disk storage on the destination server for
+  the database from the source server. Use the ``db.stats()`` function
+  to check the size of the database on the source :program:`mongod`
+  instance. For more information on ``db.stats()`` see the
+  :doc:`database statistics </reference/database-statistics>` section.
 
 Process
 -------
 
 Copy a Database to Another Server
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use the :dbcommand:`copydb` command to transfer a database from
-one MongoDB instance to another, such as from a development instance
-to a production instance.
+Use the :dbcommand:`copydb` command to transfer a database from one
+MongoDB instance to another, such as from a development instance to a
+production instance. The :func:`db.copyDatabase()` helper in the
+:program:`mongo` shell provides a wrapper around the
+:dbcommand:`copydb`.
 
 This is useful when you want to move a database from the development
-environment to the production environment, or create a remote-branch of the database
-to archive the current database on a different server.
+environment to the production environment, or create a remote-branch
+of the database to archive the current database on a different server.
 
 To copy the database named ``test`` on server ``db0.example.net`` to
 another server ``db1.example.net`` renaming it ``records`` in the process.
@@ -83,7 +83,9 @@ Rename a Database
 Use the :dbcommand:`copydb` command to copy a database within the same
 server also renaming the database. This is useful when the contents of
 the database has changed from the initial naming of the database and a
-new name would be more appropriate.
+new name would be more appropriate. The :func:`db.copyDatabase()`
+helper in the :program:`mongo` shell provides a wrapper around the
+:dbcommand:`copydb`.
 
 To rename a database from ``test`` to ``records`` within the
 same server, ``db1.example.net``.
@@ -104,7 +106,9 @@ If the source server requires ``username`` and ``password``, you can
 include these parameters in the :dbcommand:`copydb` command. This is
 useful where you need to create offsite backups, a local development
 system which has data from the production system, or create a system
-to produce reports.
+to produce reports. The :func:`db.copyDatabase()` helper in the
+:program:`mongo` shell provides a wrapper around the
+:dbcommand:`copydb`.
 
 To copy ``test`` to ``records`` from the source server
 ``db0.example.net``, which requires ``username`` and ``password``
@@ -122,11 +126,12 @@ authentication, to ``db1.example.net`` use the following procedure.
 Clone a Database
 ~~~~~~~~~~~~~~~~
 
-The :dbcommand:`clone` command copies a database between :program:`mongod`
-instances; however, :dbcommand:`clone` preserves the database
-name on the destination server. For many operations,
+The :dbcommand:`clone` command copies a database between
+:program:`mongod` instances; however, :dbcommand:`clone` preserves the
+database name on the destination server. For many operations,
 :dbcommand:`clone` has identical functionality and a simpler syntax
-than :dbcommand:`copydb`.
+than :dbcommand:`copydb`. The :func:`db.cloneDatabase()` helper in the
+:program:`mongo` shell provides a wrapper around :dbcommand:`clone`.
 
 To clone a database from ``db0.example.net`` to ``db1.example.net``, on
 ``db1.example.net`` follow these procedures.