DOCSP-37027: Fix build errors

docs/includes/extracts-option-requires.yaml

@@ -1,48 +1,48 @@
+ref: _option-requires-version
+content: |
+  This option is available since MongoDB {{version}} and will result in an
+  exception at execution time if specified for an older server version.
 ---
 ref: option-requires-4.2
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "4.2"
 ---
 ref: option-requires-4.4
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "4.4"
 ---
 ref: option-requires-5.0
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "5.0"
 ---
 ref: option-requires-5.3
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "5.3"
 ---
 ref: option-requires-6.0
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "6.0"
 ---
 ref: option-requires-7.0
 source:
-  ref: option-requires-version
   file: extracts-option-requires.yaml
+  ref: _option-requires-version
 replacement:
   version: "7.0"
----
-ref: option-requires-version
-content: |
-  This option is available since MongoDB {{version}} and will result in an
-  exception at execution time if specified for an older server version.
 ...
+

docs/reference.txt

@@ -12,8 +12,6 @@ API Documentation
    /reference/class/MongoDBDatabase
    /reference/class/MongoDBCollection
    /reference/class/MongoDBGridFSBucket
-   /reference/write-result-classes
    /reference/result-classes
-   /reference/enumeration-classes
    /reference/functions
    /reference/exception-classes

docs/reference/method/MongoDBClient-addSubscriber.txt

@@ -17,8 +17,8 @@ Definition
 
 .. phpmethod:: MongoDB\Client::addSubscriber()
 
-    Registers a monitoring event subscriber with this Client. The subscriber
-    will be notified of all events for this Client.
+   Registers a monitoring event subscriber with this Client. The subscriber
+   will be notified of all events for this Client.
 
    .. code-block:: php
 
@@ -50,8 +50,8 @@ notified once of each event for this Client.
 Example
 -------
 
-Create a :phpclass:`MongoDB\Driver\Monitoring\CommandSubscriber` that
-logs all events:
+Create a :php:`MongoDB\Driver\Monitoring\CommandSubscriber <manual/en/class.mongodb-driver-monitoring-commandsubscriber>`
+that logs all events:
 
 .. code-block:: php
 

docs/reference/method/MongoDBClient-removeSubscriber.txt

@@ -17,7 +17,7 @@ Definition
 
 .. phpmethod:: MongoDB\Client::removeSubscriber()
 
-    Unregisters a monitoring event subscriber with this Client.
+   Unregisters a monitoring event subscriber with this Client.
 
    .. code-block:: php
 

docs/reference/method/MongoDBCollection-bulkWrite.txt

@@ -30,12 +30,12 @@ Parameters
 ``$operations`` : array
   An array containing the write operations to perform.
   :phpmethod:`MongoDB\Collection::bulkWrite()` supports
-  :phpmethod:`deleteMany() <MongoDB\Collection::deleteMany>`,
-  :phpmethod:`deleteOne() <MongoDB\Collection::deleteOne>`,
-  :phpmethod:`insertOne() <MongoDB\Collection::insertOne>`,
-  :phpmethod:`replaceOne() <MongoDB\Collection::replaceOne>`,
-  :phpmethod:`updateMany() <MongoDB\Collection::updateMany>`, and
-  :phpmethod:`updateOne() <MongoDB\Collection::updateOne>` operations in the
+  :phpmethod:`MongoDB\Collection::deleteMany()`,
+  :phpmethod:`MongoDB\Collection::deleteOne()`,
+  :phpmethod:`MongoDB\Collection::insertOne()`,
+  :phpmethod:`MongoDB\Collection::replaceOne()`,
+  :phpmethod:`MongoDB\Collection::updateMany()`, and
+  :phpmethod:`MongoDB\Collection::updateOne()` operations in the
   following array structure:
 
   .. code-block:: php

docs/reference/method/MongoDBCollection-dropIndex.txt

@@ -29,8 +29,7 @@ Parameters
 
 ``$indexName`` : string| :phpclass:`MongoDB\Model\IndexInfo`
   The name or model object of the index to drop. View the existing indexes on
-  the collection using the :phpmethod:`listIndexes()
-  <MongoDB\Collection::listIndexes>` method.
+  the collection using the :phpmethod:`MongoDB\Collection::listIndexes()` method.
 
 ``$options`` : array
   An array specifying the desired options.

docs/reference/method/MongoDBCollection-dropIndexes.txt

@@ -27,8 +27,7 @@ Parameters
 
 ``$indexName`` : string| :phpclass:`MongoDB\Model\IndexInfo`
   The name or model object of the index to drop. View the existing indexes on
-  the collection using the :phpmethod:`listIndexes()
-  <MongoDB\Collection::listIndexes>` method.
+  the collection by using the :phpmethod:`MongoDB\Collection::listIndexes()` method.
 
 ``$options`` : array
   An array specifying the desired options.

docs/reference/method/MongoDBCollection-explain.txt

@@ -29,7 +29,7 @@ Definition
 Parameters
 ----------
 
-``$explainable`` : :phpclass:`MongoDB\Operation\Explainable`
+``$explainable`` : ``MongoDB\Operation\Explainable``
   The command to explain.
 
 ``$options`` : array

docs/reference/method/MongoDBCollection-findOneAndUpdate.txt

@@ -33,7 +33,7 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
+  operators. ``$update`` uses MongoDB's :manual:`update operators
   </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
   pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.

docs/reference/method/MongoDBCollection-updateMany.txt

@@ -33,9 +33,9 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
-  </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
-  pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
+  operators. ``$update`` uses MongoDB's :manual:`update operators </reference/operator/update>`.
+  Starting with MongoDB 4.2, an `aggregation pipeline
+  <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.
 
 ``$options`` : array

docs/reference/method/MongoDBCollection-updateOne.txt

@@ -35,7 +35,7 @@ Parameters
 
 ``$update`` : array|object
   Specifies the field and value combinations to update and any relevant update
-  operators. ``$update`` uses MongoDB's :method:`update operators
+  operators. ``$update`` uses MongoDB's :manual:`update operators
   </reference/operator/update>`. Starting with MongoDB 4.2, an `aggregation
   pipeline <https://mongodb.com/docs/master/reference/command/update/#update-with-an-aggregation-pipeline>`_
   can be passed as this parameter.

docs/reference/method/MongoDBDatabase-createCollection.txt

@@ -296,7 +296,7 @@ Parameters
          rules or expressions. You can specify the expressions using the same
          operators as MongoDB's
          :manual:`query operators </reference/operator/query>` with the
-         exception of :query:`$geoNear`, :query:`$near`, :query:`$nearSphere`,
+         exception of :query:`$near`, :query:`$nearSphere`,
          :query:`$text`, and :query:`$where`.
 
          .. note::

docs/reference/method/MongoDBGridFSBucket-registerGlobalStreamWrapperAlias.txt

@@ -19,7 +19,7 @@ Definition
 
    Registers an alias for the bucket, which enables files within the bucket to
    be accessed using a basic filename string (e.g.
-   `gridfs://<bucket-alias>/<filename>`).
+   ``gridfs://<bucket-alias>/<filename>``).
 
    .. code-block:: php
 
@@ -58,7 +58,7 @@ revision is read (revision ``-1``).
 In write mode, the stream context can contain the option ``gridfs['chunkSizeBytes']``.
 If omitted, the defaults are inherited from the ``Bucket`` instance option.
 
-The functions `rename` and `unlink` will rename or remove all revisions of a
+The functions ``rename`` and ``unlink`` will rename or remove all revisions of a
 filename. If the filename does not exist, these functions throw a ``FileNotFoundException``.
 
 Example

docs/reference/result-classes.txt

@@ -10,7 +10,7 @@ Result Classes
    BulkWriteResult Class </reference/class/MongoDBBulkWriteResult>
    DeleteResult Class </reference/class/MongoDBDeleteResult>
    InsertManyResult Class </reference/class/MongoDBInsertManyResult>
-   InsertOneResult Class </reference/class/MongoDInsertOneResult>
+   InsertOneResult Class </reference/class/MongoDBInsertOneResult>
    UpdateResult Class </reference/class/MongoDBUpdateResult>
    ChangeStream Class </reference/class/MongoDBChangeStream>
    MapReduceResult Class </reference/class/MongoDBMapReduceResult>

docs/tutorial/encryption.txt

@@ -19,45 +19,43 @@ To get started using in-use encryption in your project, the
 to be compiled with `libmongocrypt <https://github.com/mongodb/libmongocrypt>`_
 (enabled by default).
 
-Additionally, either `crypt_shared`_ or `mongocryptd`_ are required in order to
+Additionally, either ``crypt_shared`` or ``mongocryptd`` are required in order to
 use *automatic* client-side encryption. Neither is required for *explicit*
 encryption.
 
-
-crypt_shared
-~~~~~~~~~~~~
+``crypt_shared``
+~~~~~~~~~~~~~~~~
 
 The :manual:`Automatic Encryption Shared Library </core/queryable-encryption/reference/shared-library/>`
-(crypt_shared) provides the same functionality as mongocryptd_, but does not
+(``crypt_shared``) provides the same functionality as ``mongocryptd``, but does not
 require you to spawn another process to perform automatic encryption.
 
-By default, the PHP driver attempts to load crypt_shared from the system path(s)
-and uses it automatically if found. To load crypt_shared from another location,
+By default, the PHP driver attempts to load ``crypt_shared`` from the system path(s)
+and uses it automatically if found. To load ``crypt_shared`` from another location,
 use the ``cryptSharedLibPath`` auto encryption
 :php:`driver option <manual/en/mongodb-driver-manager.construct.php#mongodb-driver-manager.construct-driveroptions>`
-when constructing a client. If the driver cannot load crypt_shared it will
-attempt to fallback to using mongocryptd by default. The
-``cryptSharedLibRequired`` option may be used to always require crypt_shared and
+when constructing a client. If the driver cannot load ``crypt_shared`` it will
+attempt to fallback to using ``mongocryptd`` by default. The
+``cryptSharedLibRequired`` option may be used to always require ``crypt_shared`` and
 fail if it cannot be loaded.
 
 For detailed installation instructions see the MongoDB documentation for the
 :manual:`Automatic Encryption Shared Library </core/queryable-encryption/reference/shared-library/>`.
 
+``mongocryptd``
+~~~~~~~~~~~~~~~
 
-mongocryptd
-~~~~~~~~~~~
-
-The mongocryptd binary is an alternative requirement for automatic client-side
+The ``mongocryptd`` binary is an alternative requirement for automatic client-side
 encryption and is included as a component in the
 :manual:`MongoDB Enterprise Server package </administration/install-enterprise/>`.
 For detailed installation instructions see the
 :manual:`MongoDB documentation on mongocryptd </core/csfle/reference/mongocryptd/>`.
 
-mongocryptd performs the following:
+``mongocryptd`` performs the following:
 
 - Parses the automatic encryption rules specified in the client configuration.
   If the ``schemaMap`` auto encryption driver option contains invalid syntax,
-  mongocryptd returns an error.
+  ``mongocryptd`` returns an error.
 
 - Uses the specified automatic encryption rules to mark fields in read and write
   operations for encryption.
@@ -67,14 +65,13 @@ mongocryptd performs the following:
   see :manual:`Supported Operations for Automatic Encryption </core/csfle/reference/supported-operations/>`.
 
 A client configured with auto encryption will automatically spawn the
-mongocryptd process from the application's ``PATH``. Applications can control
+``mongocryptd`` process from the application's ``PATH``. Applications can control
 the spawning behavior via various auto encryption
 :php:`driver options <manual/en/mongodb-driver-manager.construct.php#mongodb-driver-manager.construct-driveroptions>`.
 
-mongocryptd is only responsible for supporting automatic client-side encryption
+``mongocryptd`` is only responsible for supporting automatic client-side encryption
 and does not itself perform any encryption or decryption.
 
-
 Managing Encryption Keys
 ------------------------
 
@@ -105,7 +102,6 @@ encryption key (e.g. user-specific encryption keys) or create them dynamically.
 .. literalinclude:: /examples/encryption/create_data_key.php
    :language: php
 
-
 .. _alt_name:
 
 Referencing Encryption Keys by an Alternative Name
@@ -208,7 +204,7 @@ Explicit Encryption
 ~~~~~~~~~~~~~~~~~~~
 
 Explicit encryption is a MongoDB community feature and does not use
-crypt_shared_ or mongocryptd_. Explicit encryption is provided by the
+``crypt_shared`` or ``mongocryptd``. Explicit encryption is provided by the
 :php:`MongoDB\Driver\ClientEncryption <mongodb-driver-clientencryption>` class.
 
 .. literalinclude:: /examples/encryption/csfle-explicit_encryption.php

docs/tutorial/gridfs.txt

@@ -35,7 +35,7 @@ The bucket can be constructed with various options:
   needed. The default size is ``261120`` (i.e. 255 KiB).
 - ``readConcern``, ``readPreference`` and ``writeConcern`` options can be used
   to specify defaults for read and write operations, much like the
-  :phpclass:`MongoDB\GridFS\Collection` options.
+  :phpclass:`MongoDB\Collection` options.
 
 Uploading Files with Writable Streams
 -------------------------------------