DOCS-799 migrate queries and cursors with tads comments

Author: kay-kim

source/applications/read.txt

@@ -327,11 +327,23 @@ Consider the following examples that illustrate the use of the
 Cursor
 ~~~~~~
 
-:method:`find() <db.collection.find()>` returns a :term:`cursor`;
-however, in the :program:`mongo` shell, the cursor is automatically
-iterated up to 20 times to print the documents referenced by the
-cursor. To access the documents, you must explicitly handle the cursor,
-as in the following example:
+The :method:`find() <db.collection.find()>` method returns a
+:term:`cursor`; however, in the :program:`mongo` shell, if the result
+of the :method:`find() <db.collection.find()>` is not assigned to a
+variable, then the cursor is automatically iterated up to 20 times to
+print the documents referenced by the cursor, as in the following
+example:
+
+.. code-block:: javascript
+
+   db.bios.find( { _id: 1 } );
+
+This operation will iterate the cursor up to 20 times and print the
+first 20 documents referenced by the cursor.
+
+If the result of the :method:`find() <db.collection.find()>` is
+assigned to a variable, you can use the cursor method :method:`next()
+<cursor.next()>` to access the documents, as in the following example:
 
 .. code-block:: javascript
 
@@ -353,11 +365,10 @@ For more information on cursor handling, see:
 
 - :method:`cursor.forEach()`
 
-- :ref:`read-operations-cursors`
+- :ref:`cursors <read-operations-cursors>`
 
-- :ref:`js-query-cursor-methods`
+- :ref:`JavaScript cursor methods<js-query-cursor-methods>`
 
-- 
 
 Modify Cursor Behavior
 ``````````````````````
@@ -416,9 +427,8 @@ You may chain these cursor methods; however, the :method:`limit()
 
 See :ref:`JavaScript cursor methods <js-query-cursor-methods>` and your
 :doc:`driver </applications/drivers>` documentation for more
-information on cursor methods.
-
-See also :ref:`read-operations-cursor-considerations` for othe
+information on cursor methods. See :ref:`read-operations-cursors` for
+more information regarding cursors.
 
 .. _crud-read-findOne:
 .. _crud-read-find-one:

source/core/read-operations.txt

@@ -662,10 +662,22 @@ Cursors
 -------
 
 The :method:`find() <db.collection.find()>` method returns a
-:term:`cursor`; however, in the :program:`mongo` shell, the cursor is
-automatically iterated up to 20 times to print the documents referenced
-by the cursor. To access the documents, you must explicitly handle the
-cursor:
+:term:`cursor`; however, in the :program:`mongo` shell, if the result
+of the :method:`find() <db.collection.find()>` is not assigned to a
+variable, then the cursor is automatically iterated up to 20 times to
+print the documents referenced by the cursor, as in the following
+example:
+
+.. code-block:: javascript
+
+   db.inventory.find( { type: 'food' } );
+
+This operation will iterate the cursor up to 20 times and print the
+first 20 documents referenced by the cursor.
+
+If the result of the :method:`find() <db.collection.find()>` is
+assigned to a variable, you can use the cursor method :method:`next()
+<cursor.next()>` to access the documents, as in the following example:
 
 .. code-block:: javascript
 
@@ -721,15 +733,9 @@ Consider the following behaviors related to cursors:
   override this behavior, you can specify the "noTimeout" :wiki:`wire
   protocol option <Mongo Wire Protocol>` in your query; however, you
   should either close the cursor manually or exhaust the cursor. In the
-  :program:`mongo` shell, you can set the "noTimeout" option (i.e.
-  hexadecimal ``0x10`` or ``16``) as in the following example:
-
-  .. code-block:: javascript
-
-     var cursorNoTimeout = db.inventory.find().addOption( 0x10 )
-
-  See your :doc:`driver </applications/drivers>` documentation for
-  information on setting "noTimeout" option.
+  :program:`mongo` shell, you can set the "noTimeout" option. See your
+  :doc:`driver </applications/drivers>` documentation for information
+  on setting the "noTimeout" option.
 
 - Write operations may interleave during latent access to the cursor.
   This may cause a document to be returned multiple times. To handle