DOCS-11691: cursor.min/cursor.max

Author: kay-kim

source/reference/method/cursor.max.txt

@@ -67,9 +67,15 @@ Index Bounds
 ~~~~~~~~~~~~
 
 If you use :method:`~cursor.max()` with :method:`~cursor.min()` to
-specify a range, the index bounds specified in
-:method:`~cursor.min()` and :method:`~cursor.max()`
-must both refer to the keys of the same index.
+specify a range:
+
+- the index bounds specified in :method:`~cursor.min()` and
+  :method:`~cursor.max()` must both refer to the keys of the same index.
+
+- the bound specified by :method:`~cursor.max()` must be greater than
+  the bound specified by :method:`~cursor.min()`.
+
+  .. versionchanged:: 4.0
 
 ``max()`` without ``min()``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -131,6 +137,13 @@ The collection has the following indexes:
   :method:`~cursor.min()` limits the query to the documents
   that are at or above the index key bound of ``price`` equal to
   ``1.39``:
+  
+  .. note::
+  
+     .. versionchanged:: 4.0
+
+        The bound specified by :method:`~cursor.max()` must be greater
+        than the bound specified by :method:`~cursor.min()`.
 
   .. code-block:: javascript
 

source/reference/method/cursor.min.txt

@@ -68,9 +68,15 @@ Index Bounds
 ~~~~~~~~~~~~
 
 If you use :method:`~cursor.min()` with :method:`~cursor.max()` to
-specify a range, the index bounds specified in
-:method:`~cursor.min()` and :method:`~cursor.max()` must both refer
-to the keys of the same index.
+specify a range:
+
+- the index bounds specified in :method:`~cursor.min()` and
+  :method:`~cursor.max()` must both refer to the keys of the same index.
+
+- the bound specified by :method:`~cursor.max()` must be greater than
+  the bound specified by :method:`~cursor.min()`.
+
+  .. versionchanged:: 4.0
 
 ``min()`` without ``max()``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -136,6 +142,13 @@ The collection has the following indexes:
   :method:`~cursor.max()` limits the query to the documents
   that are below the index key bound of ``price`` equal to ``1.99``:
 
+  .. note::
+  
+     .. versionchanged:: 4.0
+
+        The bound specified by :method:`~cursor.max()` must be greater
+        than the bound specified by :method:`~cursor.min()`.
+
   .. code-block:: javascript
 
       db.products.find().min( { price: 1.39 } ).max( { price: 1.99 } ).hint( { price: 1 } )

source/reference/operator/meta/max.txt

@@ -57,9 +57,15 @@ index on ``_id`` may be better.
 Index Bounds
 ~~~~~~~~~~~~
 
-If you use :operator:`$max` with :operator:`$min` to specify a range,
-the index bounds specified in :operator:`$min` and :operator:`$max`
-must both refer to the keys of the same index.
+If you use :operator:`$max` with :operator:`$min` to specify a range:
+
+- the index bounds specified in :operator:`$min` and :operator:`$max`
+  must both refer to the keys of the same index.
+
+- the bound specified by :operator:`$max` must be greater than
+  the bound specified by :operator:`$min`.
+
+  .. versionchanged:: 4.0
 
 ``$max`` without ``$min``
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -116,6 +122,13 @@ Use :operator:`$max` alone or in conjunction with :operator:`$min` to
 limit results to a specific range for the *same* index, as in the
 following example:
 
+.. note::
+
+   .. versionchanged:: 4.0
+   
+      The bound specified by :operator:`$max` must be greater than the
+      bound specified by :operator:`$min`.
+
 .. code-block:: javascript
 
    db.collection.find().min( { age: 20 } ).max( { age: 25 } )

source/reference/operator/meta/min.txt

@@ -58,8 +58,14 @@ Index Bounds
 ~~~~~~~~~~~~
 
 If you use :operator:`$max` with :operator:`$min` to specify a range,
-the index bounds specified in :operator:`$min` and :operator:`$max`
-must both refer to the keys of the same index.
+
+- the index bounds specified in :operator:`$min` and :operator:`$max`
+  must both refer to the keys of the same index.
+
+- the bound specified by :operator:`$max` must be greater than
+  the bound specified by :operator:`$min`.
+
+  .. versionchanged:: 4.0
 
 ``$min`` without ``$max``
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -116,6 +122,13 @@ You can use :operator:`$min` in conjunction with :operator:`$max` to
 limit results to a specific range for the *same* index, as in the
 following example:
 
+.. note::
+
+   .. versionchanged:: 4.0
+   
+      The bound specified by :operator:`$max` must be greater than the
+      bound specified by :operator:`$min`.
+
 .. code-block:: javascript
 
    db.collection.find().min( { age: 20 } ).max( { age: 25 } )

source/release-notes/4.0-compatibility.txt

@@ -102,6 +102,16 @@ You cannot specify :option:`--noIndexBuildRetry <mongod
 :setting:`storage.indexBuildRetry` for a :binary:`~bin.mongod` instance
 that is part of a replica set.
 
+Rollback Limit
+~~~~~~~~~~~~~~
+
+MongoDB 4.0 removes the limit on the amount of data that can be
+:doc:`rolled back </core/replica-set-rollbacks>`. In previous versions,
+a :binary:`~bin.mongod` instance will not roll back more than 300
+megabytes of data and requires manual intervention if more than 300
+megabytes of data need to be rolled back.
+
+
 .. _4.0-compatibility-enabled:
 
 ``4.0`` Feature Compatibility
@@ -131,15 +141,6 @@ General
   option ``autoIndexId`` to ``false`` when creating collections in
   databases other than the ``local`` database.
 
-- MongoDB 4.0 removes the limit on the amount of data that can be
-  :doc:`rolled back </core/replica-set-rollbacks>`. In previous
-  versions, a :binary:`~bin.mongod` instance will not roll back more than
-  300 megabytes of data and requires manual intervention if more than
-  300 megabytes of data need to be rolled back.
-
-- MongoDB 4.0 removes the obsolete ``logUserIds`` parameter. Use
-  :doc:`/core/auditing` instead.
-
 - When :doc:`authentication </core/authentication>` is enabled, running
   the :dbcommand:`listDatabases` command without the
   :authaction:`listDatabases` action privilege returns a list of all
@@ -158,6 +159,16 @@ General
   :ref:`mongos <mongos>` instances. The ``transportLayer`` setting is
   automatically set to ``asio`` and cannot be modified.
 
+``cursor.min()`` and ``cursor.max()``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you use :method:`~cursor.max()` with :method:`~cursor.min()` to
+specify a range, the bound specified by :method:`~cursor.max()` must be
+greater than the bound specified by :method:`~cursor.min()`.
+
+In previous versions, the bounds could be equal but would scan no index
+entries, always resulting in an empty result set.
+
 Disable TLS 1.0
 ---------------
 
@@ -217,6 +228,13 @@ As alternatives, users can:
   If the input collection is sharded, all documents for that collection
   must be able to fit on the output collection's shard.
 
+Parameters
+~~~~~~~~~~
+
+- MongoDB removes the obsolete ``logUserIds`` parameter. Use
+  :doc:`/core/auditing` instead.
+
+
 .. _4.0-remove-isolated:
 
 ``$isolated`` Operator