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

@@ -5,7 +5,7 @@ intersphinx = [
     "https://pymongo.readthedocs.io/en/stable/objects.inv",
     "https://motor.readthedocs.io/en/stable/objects.inv",
     "https://www.mongodb.com/docs/atlas/objects.inv",
-    "https://www.mongodb.com/docs/php-library/current/objects.inv",
+    "https://www.mongodb.com/docs/php-library/upcoming/objects.inv",
     "https://www.mongodb.com/docs/compass/current/objects.inv",
     "https://www.mongodb.com/docs/database-tools/objects.inv",
     "https://www.mongodb.com/docs/mongodb-shell/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/includes/driver-examples/driver-procedure-indexes-1.rst

@@ -77,7 +77,7 @@
 
          To create an index using the
          `PHP driver <https://www.mongodb.com/docs/php-library/current/>`_, use
-         :phpmethod:`MongoDB\\Collection::createIndex() <phpmethod.MongoDB\\Collection::createIndex>`.
+         :phpmethod:`MongoDB\\Collection::createIndex() <phpmethod.MongoDB\\Collection::createIndex()>`.
 
          .. code-block:: php
 

source/tutorial/insert-documents.txt

@@ -210,7 +210,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.
 
@@ -346,11 +346,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::
@@ -500,7 +500,7 @@ upper-right to set the language of the examples on this page.
    .. tab::
       :tabid: php
 
-      :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.
 
@@ -640,12 +640,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
@@ -810,9 +810,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

@@ -88,7 +88,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

@@ -92,7 +92,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: |
@@ -354,7 +354,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
@@ -533,20 +533,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 :ref:`aggregation pipeline <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

@@ -116,8 +116,8 @@ You can delete documents in MongoDB using the following methods:
          This page uses the
          following  `MongoDB PHP Library <https://www.mongodb.com/docs/php-library/current/>`_ 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
 
@@ -249,7 +249,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
@@ -419,7 +419,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
@@ -601,7 +601,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
@@ -823,9 +823,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

@@ -151,11 +151,11 @@ upper-right to set the language of the following examples.
       This page uses the following  `MongoDB PHP Library
       <https://www.mongodb.com/docs/php-library/current/>`_ 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|
 
@@ -579,7 +579,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"``:
 
@@ -695,7 +695,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``:
 
@@ -817,7 +817,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
 
@@ -1059,11 +1059,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
@@ -1256,11 +1256,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`