DOCSP-35757 v4.4 (#5970)

* DOCSP-35757 Fix :phpmethod: Build Errors (#5955)

* Empty-Commit

* <phpmethod.MongoDB\Collection::find()

* "

* *

* *

* *

* *

* *

* deleteMany()

* *

* *

* *

* updateOne()

* updateMany()

* insertMany()

* *

* deleteMany()

* getInsertedId() one and many

* *

* *

* createIndex()

* getDeletedCount()

* *

* *

Author: ianf-mongodb

snooty.toml

@@ -6,7 +6,7 @@ sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 intersphinx = [ "https://pymongo.readthedocs.io/en/stable/objects.inv",
                 "https://motor.readthedocs.io/en/stable/objects.inv",
                 "https://docs.atlas.mongodb.com/objects.inv",
-                "https://docs.mongodb.com/php-library/master/objects.inv",
+                "https://docs.mongodb.com/php-library/upcoming/objects.inv",
                 "https://docs.mongodb.com/compass/current/objects.inv",
                 "https://docs.mongodb.com/database-tools/objects.inv"
                ]

source/includes/driver-examples/driver-example-delete-result.rst

@@ -47,10 +47,10 @@
      - id: php
        content: |
          Upon successful execution, the
-         :phpmethod:`deleteMany() <phpmethod.MongoDB\\Collection::deleteMany>`
+         :phpmethod:`deleteMany() <phpmethod.MongoDB\\Collection::deleteMany()>`
          method returns an instance of
          :phpclass:`MongoDB\\DeleteResult <phpclass.MongoDB\\DeleteResult>`
-         whose :phpmethod:`getDeletedCount()<phpmethod.MongoDB\\DeleteResult::getDeletedCount>`
+         whose :phpmethod:`getDeletedCount()<phpmethod.MongoDB\\DeleteResult::getDeletedCount()>`
          method returns the number of documents that matched the filter.
 
      - id: perl

source/includes/driver-examples/driver-example-query-intro-no-perl.rst

@@ -75,7 +75,7 @@
        content: |
 
          This page provides examples of |query_operations| using the
-         :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find>`
+         :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find()>`
          method in the
          `MongoDB PHP Library <https://www.mongodb.com/docs/drivers/php-libraries/>`_.
 

source/includes/driver-examples/driver-example-query-intro.rst

@@ -67,7 +67,7 @@
      - id: php
        content: |
          This page provides examples of |query_operations| using the
-         :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find>`
+         :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find()>`
          method in the
          `MongoDB PHP Library <https://www.mongodb.com/docs/drivers/php-libraries/>`_.
 

source/tutorial/insert-documents.txt

@@ -206,7 +206,7 @@ Insert a Single Document
    .. tab::
       :tabid: php
 
-      :phpmethod:`MongoDB\\Collection::insertOne() <phpmethod.MongoDB\\Collection::insertOne>`
+      :phpmethod:`MongoDB\\Collection::insertOne() <phpmethod.MongoDB\\Collection::insertOne()>`
       inserts a *single* :ref:`document<bson-document-format>` into a
       collection.
 
@@ -342,11 +342,11 @@ Insert a Single Document
       :tabid: php
 
       Upon successful insert, the
-      :phpmethod:`insertOne() <phpmethod.MongoDB\\Collection::insertOne>`
+      :phpmethod:`insertOne() <phpmethod.MongoDB\\Collection::insertOne()>`
       method returns an instance of
       :phpclass:`MongoDB\\InsertOneResult <phpclass.MongoDB\\InsertOneResult>`
       whose
-      :phpmethod:`getInsertedId() <phpmethod.MongoDB\\InsertOneResult::getInsertedId>`
+      :phpmethod:`getInsertedId() <phpmethod.MongoDB\\InsertOneResult::getInsertedId()>`
       method returns the ``_id`` of the newly inserted document.
 
    .. tab::
@@ -506,9 +506,7 @@ upper-right to set the language of the examples on this page.
    .. tab::
       :tabid: php
 
-      .. versionadded:: 3.2
-
-      :phpmethod:`MongoDB\\Collection::insertMany() <phpmethod.MongoDB\\Collection::insertMany>`
+      :phpmethod:`MongoDB\\Collection::insertMany() <phpmethod.MongoDB\\Collection::insertMany()>`
       can insert *multiple* :ref:`documents <bson-document-format>` into a
       collection. Pass an array of documents to the method.
 
@@ -656,12 +654,12 @@ upper-right to set the language of the examples on this page.
       :tabid: php
 
       Upon successful insert, the
-      :phpmethod:`insertMany() <phpmethod.MongoDB\\Collection::insertMany>`
+      :phpmethod:`insertMany() <phpmethod.MongoDB\\Collection::insertMany()>`
       method
       returns an instance of
       :phpclass:`MongoDB\\InsertManyResult <phpclass.MongoDB\\InsertManyResult>`
       whose
-      :phpmethod:`getInsertedIds() <phpmethod.MongoDB\\InsertManyResult::getInsertedIds>`
+      :phpmethod:`getInsertedIds() <phpmethod.MongoDB\\InsertManyResult::getInsertedIds()>`
       method returns the ``_id`` of each newly inserted document.
 
       To retrieve the inserted documents, :ref:`query the collection
@@ -826,9 +824,9 @@ requested from MongoDB for write operations. For details, see
 
       .. seealso::
 
-         - :phpmethod:`MongoDB\\Collection::insertOne() <phpmethod.MongoDB\\Collection::insertOne>`
+         - :phpmethod:`MongoDB\\Collection::insertOne() <phpmethod.MongoDB\\Collection::insertOne()>`
 
-         - :phpmethod:`MongoDB\\Collection::insertMany() <phpmethod.MongoDB\\Collection::insertMany>`
+         - :phpmethod:`MongoDB\\Collection::insertMany() <phpmethod.MongoDB\\Collection::insertMany()>`
 
          - :ref:`additional-inserts`
 

source/tutorial/project-fields-from-query-results.txt

@@ -82,7 +82,7 @@ Return All Fields in Matching Documents
      - id: php
        content: |
          If you do not specify a :term:`projection` document, the
-         :phpmethod:`find() <phpmethod.MongoDB\\Collection::find>`
+         :phpmethod:`find() <phpmethod.MongoDB\\Collection::find()>`
          method returns all fields in the matching documents.
 
      - id: perl

source/tutorial/query-documents.txt

@@ -88,7 +88,7 @@ the following SQL statement:
      - id: php
        content: |
          For more information on the syntax of the method, see
-         :phpmethod:`find() <phpmethod.MongoDB\\Collection::find>`.
+         :phpmethod:`find() <phpmethod.MongoDB\\Collection::find()>`.
 
      - id: perl
        content: |
@@ -350,7 +350,7 @@ Cursor
 
      - id: php
        content: |
-         The :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find>`
+         The :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find()>`
          method returns a :doc:`cursor </tutorial/iterate-a-cursor>` to
          the matching documents. See the MongoDB PHP Library
          documentation for
@@ -531,20 +531,20 @@ Additional Methods and Options
 
          The following methods can also read documents from a collection:
 
-         - :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne>`
+         - :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne()>`
 
          - In :doc:`aggregation pipeline </core/aggregation-pipeline>`, the
            :pipeline:`$match` pipeline stage provides access to MongoDB
            queries. See the MongoDB PHP Library's
            :ref:`aggregation example <php-aggregation>`.
 
          .. note::
-            The :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne>`
+            The :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne()>`
             method also performs a read operation to return a single
             document. Internally, the
-            :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne>`
+            :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne()>`
             method is the
-            :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find>`
+            :phpmethod:`MongoDB\\Collection::find() <phpmethod.MongoDB\\Collection::find()>`
             method with a limit of 1.
 
      - id: perl

source/tutorial/remove-documents.txt

@@ -112,8 +112,8 @@ You can delete documents in MongoDB using the following methods:
          This page uses the
          following  `MongoDB PHP Library <https://docs.mongodb.com/php-library/master/>`_ methods:
 
-         - :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany>`
-         - :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne>`
+         - :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany()>`
+         - :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne()>`
 
          .. include:: /includes/driver-examples/examples-intro.rst
 
@@ -245,7 +245,7 @@ Delete All Documents
 
          To delete all documents from a collection, pass an empty
          :ref:`filter<document-query-filter>` document ``[]`` to the
-         :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany>`
+         :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany()>`
          method.
 
          .. include:: /includes/fact-delete-all-inventory.rst
@@ -415,7 +415,7 @@ Delete All Documents that Match a Condition
 
          To delete all documents that match a deletion criteria, pass a
          :ref:`filter <document-query-filter>` parameter to the
-         :phpmethod:`deleteMany() <phpmethod.MongoDB\\Collection::deleteMany>`
+         :phpmethod:`deleteMany() <phpmethod.MongoDB\\Collection::deleteMany()>`
          method.
 
          .. include:: /includes/fact-remove-condition-inv-example.rst
@@ -597,7 +597,7 @@ Delete Only One Document that Matches a Condition
          To delete at most a single document that matches a specified
          filter (even though multiple documents may match the specified
          filter) use the
-         :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne>`
+         :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne()>`
          method.
 
          .. include:: /includes/fact-remove-one-condition-inv-example.rst
@@ -819,9 +819,9 @@ requested from MongoDB for write operations. For details, see
        content: |
          .. seealso::
 
-            - :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany>`
+            - :phpmethod:`MongoDB\\Collection::deleteMany() <phpmethod.MongoDB\\Collection::deleteMany()>`
 
-            - :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne>`
+            - :phpmethod:`MongoDB\\Collection::deleteOne() <phpmethod.MongoDB\\Collection::deleteOne()>`
 
             - :ref:`additional-deletes`
 

source/tutorial/update-documents.txt

@@ -147,11 +147,11 @@ upper-right to set the language of the following examples.
       This page uses the following  `MongoDB PHP Library
       <https://docs.mongodb.com/php-library/master/>`_ methods:
 
-      - :phpmethod:`MongoDB\\Collection::updateOne() <phpmethod.MongoDB\\Collection::updateOne>`
+      - :phpmethod:`MongoDB\\Collection::updateOne() <phpmethod.MongoDB\\Collection::updateOne()>`
 
-      - :phpmethod:`MongoDB\\Collection::updateMany() <phpmethod.MongoDB\\Collection::updateMany>`
+      - :phpmethod:`MongoDB\\Collection::updateMany() <phpmethod.MongoDB\\Collection::updateMany()>`
 
-      - :phpmethod:`MongoDB\\Collection::replaceOne() <phpmethod.MongoDB\\Collection::replaceOne>`
+      - :phpmethod:`MongoDB\\Collection::replaceOne() <phpmethod.MongoDB\\Collection::replaceOne()>`
 
       |populate-inventory|
 
@@ -578,7 +578,7 @@ Update a Single Document
       :tabid: php
 
       The following example uses the :phpmethod:`updateOne()
-      <phpmethod.MongoDB\\Collection::updateOne>` method on the
+      <phpmethod.MongoDB\\Collection::updateOne()>` method on the
       ``inventory`` collection to update the *first* document where
       ``item`` equals ``"paper"``:
 
@@ -700,7 +700,7 @@ Update Multiple Documents
       :tabid: php
 
       The following example uses the :phpmethod:`updateMany()
-      <phpmethod.MongoDB\\Collection::updateMany>` method on the
+      <phpmethod.MongoDB\\Collection::updateMany()>` method on the
       ``inventory`` collection to update all documents where ``qty`` is
       less than ``50``:
 
@@ -822,7 +822,7 @@ Replace a Document
       To replace the entire content of a document except for the ``_id``
       field, pass an entirely new document as the second argument to
       :phpmethod:`replaceOne()
-      <phpmethod.MongoDB\\Collection::replaceOne>`.
+      <phpmethod.MongoDB\\Collection::replaceOne()>`.
 
       .. include:: /includes/fact-update-replace-example.rst
 
@@ -1064,11 +1064,11 @@ Upsert Option
       :tabid: php
 
       If :phpmethod:`updateOne()
-      <phpmethod.MongoDB\\Collection::updateOne>`,
+      <phpmethod.MongoDB\\Collection::updateOne()>`,
       :phpmethod:`updateMany()
-      <phpmethod.MongoDB\\Collection::updateMany>`, or
+      <phpmethod.MongoDB\\Collection::updateMany()>`, or
       :phpmethod:`replaceOne()
-      <phpmethod.MongoDB\\Collection::replaceOne>` includes ``upsert =>
+      <phpmethod.MongoDB\\Collection::replaceOne()>` includes ``upsert =>
       true`` **and** no documents match the specified filter, then the
       operation creates a new document and inserts it. If there are
       matching documents, then the operation modifies or replaces the
@@ -1261,11 +1261,11 @@ requested from MongoDB for write operations. For details, see
 
       .. seealso::
 
-         - :phpmethod:`MongoDB\\Collection::updateOne() <phpmethod.MongoDB\\Collection::updateOne>`
+         - :phpmethod:`MongoDB\\Collection::updateOne() <phpmethod.MongoDB\\Collection::updateOne()>`
 
-         - :phpmethod:`MongoDB\\Collection::updateMany() <phpmethod.MongoDB\\Collection::updateMany>`
+         - :phpmethod:`MongoDB\\Collection::updateMany() <phpmethod.MongoDB\\Collection::updateMany()>`
 
-         - :phpmethod:`MongoDB\\Collection::replaceOne() <phpmethod.MongoDB\\Collection::replaceOne>`
+         - :phpmethod:`MongoDB\\Collection::replaceOne() <phpmethod.MongoDB\\Collection::replaceOne()>`
 
          - :ref:`additional-updates`