PHPLIB-234: Use "Return Values" section headings

Author: jmikola

docs/reference/method/MongoDBClient-dropDatabase.txt

@@ -29,11 +29,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBClient-method-dropDatabase-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array or object with the result document of the :manual:`dropDatabase
-      </reference/command/dropDatabase>` command. The return type will depend on
-      the ``typeMap`` option.
+An array or object with the result document of the :manual:`dropDatabase
+</reference/command/dropDatabase>` command. The return type will depend on the
+``typeMap`` option.
 
 Example
 -------

docs/reference/method/MongoDBClient-getManager.txt

@@ -23,9 +23,10 @@ Definition
 
       function getManager(): MongoDB\Manager
 
-   :returns:
+Return Values
+-------------
 
-      A :php:`MongoDB\\Driver\\Manager <class.mongodb-driver-manager>` object.
+A :php:`MongoDB\\Driver\\Manager <class.mongodb-driver-manager>` object.
 
 See Also
 --------

docs/reference/method/MongoDBClient-listDatabases.txt

@@ -29,11 +29,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBClient-method-listDatabases-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A traversable :phpclass:`MongoDB\\Model\\DatabaseInfoIterator`, which
-      contains an :phpclass:`MongoDB\\Model\\DatabaseInfo` object for each
-      database on the server.
+A traversable :phpclass:`MongoDB\\Model\\DatabaseInfoIterator`, which contains
+a :phpclass:`MongoDB\\Model\\DatabaseInfo` object for each database on the
+server.
 
 Example
 -------

docs/reference/method/MongoDBClient-selectCollection.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBClient-method-selectCollection-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\Collection` object.
+A :phpclass:`MongoDB\\Collection` object.
 
 Behavior
 --------

docs/reference/method/MongoDBClient-selectDatabase.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBClient-method-selectDatabase-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\Database` object.
+A :phpclass:`MongoDB\\Database` object.
 
 Behavior
 --------

docs/reference/method/MongoDBClient__get.txt

@@ -27,9 +27,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBClient-method-get-param.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\Database` object.
+A :phpclass:`MongoDB\\Database` object.
 
 Behavior
 --------

docs/reference/method/MongoDBCollection-aggregate.txt

@@ -30,11 +30,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-aggregate-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :php:`MongoDB\\Driver\\Cursor <class.mongodb-driver-cursor>` or
-      :php:`ArrayIterator <arrayiterator>` object. In both cases, the return
-      value will be :php:`Traversable <traversable>`.
+A :php:`MongoDB\\Driver\\Cursor <class.mongodb-driver-cursor>` or
+:php:`ArrayIterator <arrayiterator>` object. In both cases, the return value
+will be :php:`Traversable <traversable>`.
 
 .. _php-agg-method-behavior:
 

docs/reference/method/MongoDBCollection-bulkWrite.txt

@@ -29,11 +29,11 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-bulkWrite-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\BulkWriteResult` object, which encapsulates a
-      :php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>`
-      object.
+A :phpclass:`MongoDB\\BulkWriteResult` object, which encapsulates a
+:php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>` object.
 
 .. todo: add output and examples
 

docs/reference/method/MongoDBCollection-count.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-count-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      The number of documents matching the filter criteria.
+The number of documents matching the filter criteria.
 
 .. todo: add output and examples
 

docs/reference/method/MongoDBCollection-createIndex.txt

@@ -34,9 +34,10 @@ Definition
    :manual:`createIndexes </reference/command/createIndexes>` command reference
    in the MongoDB manual.
 
-   :returns:
+Return Values
+-------------
 
-      The name of the created index as a string.
+The name of the created index as a string.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-createIndexes.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-createIndexes-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      The names of the created indexes as an array of strings.
+The names of the created indexes as an array of strings.
 
 ``$indexes`` parameter
 ----------------------

docs/reference/method/MongoDBCollection-deleteMany.txt

@@ -29,11 +29,11 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-deleteMany-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\DeleteResult` object, which encapsulates a
-      :php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>`
-      object.
+A :phpclass:`MongoDB\\DeleteResult` object, which encapsulates a
+:php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>` object.
 
 Example
 -------

docs/reference/method/MongoDBCollection-deleteOne.txt

@@ -31,11 +31,11 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-deleteOne-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :phpclass:`MongoDB\\DeleteResult` object, which encapsulates a
-      :php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>`
-      object.
+A :phpclass:`MongoDB\\DeleteResult` object, which encapsulates a
+:php:`MongoDB\\Driver\\WriteResult <class.mongodb-driver-writeresult>` object.
 
 Example
 -------

docs/reference/method/MongoDBCollection-distinct.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-distinct-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array of the distinct values.
+An array of the distinct values.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-drop.txt

@@ -29,11 +29,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-drop-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array or object with the result document of the :manual:`drop
-      </reference/command/drop>` command. The return type will depend on the
-      ``typeMap`` option.
+An array or object with the result document of the :manual:`drop
+</reference/command/drop>` command. The return type will depend on the
+``typeMap`` option.
 
 Example
 -------

docs/reference/method/MongoDBCollection-dropIndex.txt

@@ -29,11 +29,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-dropIndex-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array or object with the result document of the :manual:`dropIndexes
-      </reference/command/dropIndexes>` command. The return type will depend on
-      the ``typeMap`` option.
+An array or object with the result document of the :manual:`dropIndexes
+</reference/command/dropIndexes>` command. The return type will depend on the
+``typeMap`` option.
 
 Example
 -------

docs/reference/method/MongoDBCollection-dropIndexes.txt

@@ -30,11 +30,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-dropIndex-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array or object with the result document of the :manual:`dropIndexes
-      </reference/command/dropIndexes>` command. The return type will depend on
-      the ``typeMap`` option.
+An array or object with the result document of the :manual:`dropIndexes
+</reference/command/dropIndexes>` command. The return type will depend on the
+``typeMap`` option.
 
 Example
 -------

docs/reference/method/MongoDBCollection-find.txt

@@ -29,9 +29,10 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-find-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      A :php:`MongoDB\\Driver\\Cursor <class.mongodb-driver-cursor>` object.
+A :php:`MongoDB\\Driver\\Cursor <class.mongodb-driver-cursor>` object.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-findOne.txt

@@ -29,11 +29,12 @@ Definition
 
    .. include:: /includes/apiargs/MongoDBCollection-method-findOne-option.rst
 
-   :returns:
+Return Values
+-------------
 
-      An array or object for the :term:`first document <natural order>` document
-      that matched the query, or ``null`` if no document matched the query. The
-      return type will depend on the ``typeMap`` option.
+An array or object for the :term:`first document <natural order>` document that
+matched the query, or ``null`` if no document matched the query. The return type
+will depend on the ``typeMap`` option.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-findOneAndDelete.txt

@@ -31,10 +31,11 @@ Definition
 
    .. include:: /includes/extracts/bson-deserialization-findOneAndDelete.rst
 
-   :returns:
+Return Values
+-------------
 
-      An object for the document that was deleted, or ``null`` if no document
-      matched the query.
+An object for the document that was deleted, or ``null`` if no document matched
+the query.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-findOneAndReplace.txt

@@ -31,12 +31,12 @@ Definition
 
    .. include:: /includes/extracts/bson-deserialization-findOneAndReplace.rst
 
-   :returns:
+Return Values
+-------------
 
-      An object for either the original or the replaced document, depending on
-      the specified value of the ``returnDocument`` option. By default, the
-      original document is returned. If no document matched the query, ``null``
-      is returned.
+An object for either the original or the replaced document, depending on the
+specified value of the ``returnDocument`` option. By default, the original
+document is returned. If no document matched the query, ``null`` is returned.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-findOneAndUpdate.txt

@@ -31,12 +31,12 @@ Definition
 
    .. include:: /includes/extracts/bson-deserialization-findOneAndUpdate.rst
 
-   :returns:
+Return Values
+-------------
 
-      An object for either the original or the updated document, depending on
-      the specified value of the ``returnDocument`` option. By default, the
-      original document is returned. If no document matched the query, ``null``
-      is returned.
+An object for either the original or the updated document, depending on the
+specified value of the ``returnDocument`` option. By default, the original
+document is returned. If no document matched the query, ``null`` is returned.
 
 Examples
 --------

docs/reference/method/MongoDBCollection-getCollectionName.txt

@@ -21,9 +21,10 @@ Definition
 
       function getCollectionName(): string
 
-   :returns:
+Return Values
+-------------
 
-      The name of this collection as a string.
+The name of this collection as a string.
 
 Example
 -------

docs/reference/method/MongoDBCollection-getDatabaseName.txt

@@ -21,9 +21,10 @@ Definition
 
       function getDatabaseName(): string
 
-   :returns:
+Return Values
+-------------
 
-      The name of the database containing this collection as a string.
+The name of the database containing this collection as a string.
 
 Example
 -------

docs/reference/method/MongoDBCollection-getManager.txt

@@ -23,9 +23,10 @@ Definition
 
       function getManager(): MongoDB\Manager
 
-   :returns:
+Return Values
+-------------
 
-      A :php:`MongoDB\\Driver\\Manager <class.mongodb-driver-manager>` object.
+A :php:`MongoDB\\Driver\\Manager <class.mongodb-driver-manager>` object.
 
 See Also
 --------

docs/reference/method/MongoDBCollection-getNamespace.txt

@@ -22,9 +22,10 @@ Definition
 
       function getNamespace(): string
 
-   :returns:
+Return Values
+-------------
 
-      The namespace of this collection as a string.
+The namespace of this collection as a string.
 
 Example
 -------