PHPLIB-1046: Fix snooty errors in documentation (#1010)

* Remove literal code blocks

* Fix minor errors in documentation

* Add missing code-block directives

* Fix more docs errors

* Fix wrong backticks style

Author: alcaeus

source/includes/apiargs-MongoDBDatabase-method-createCollection-option.yaml

@@ -143,8 +143,10 @@ description: |
   collection.
 
   The ``indexOptionDefaults`` option accepts a ``storageEngine`` document,
-  which should take the following form::
+  which should take the following form:
 
+  .. code-block:: none
+  
      { <storage-engine-name>: <options> }
 
   Storage engine configurations specified when creating indexes are validated
@@ -212,8 +214,10 @@ description: |
 
   Allows users to specify configuration to the storage engine on a
   per-collection basis when creating a collection. The value of the
-  ``storageEngine`` option should take the following form::
+  ``storageEngine`` option should take the following form:
 
+  .. code-block:: none
+  
      { <storage-engine-name>: <options> }
 
   Storage engine configurations specified when creating collections are

source/reference/class/MongoDBCollection.txt

@@ -23,7 +23,7 @@ Definition
    select a collection from the library's :phpclass:`MongoDB\\Client` or
    :phpclass:`MongoDB\\Database` classes. A collection may also be cloned from
    an existing :phpclass:`MongoDB\\Collection` object via the
-   :phpmethod:`withOptions() <MongoDB\\Collection::withOptions>` method.
+   :phpmethod:`withOptions() <MongoDB\\Collection::withOptions()>` method.
 
    :phpclass:`MongoDB\\Collection` supports the :php:`readConcern
    <mongodb-driver-readconcern>`, :php:`readPreference
@@ -41,17 +41,16 @@ Definition
 Type Map Limitations
 --------------------
 
-   The :manual:`aggregate </reference/command/aggregate>` (when not using a
-   cursor), :manual:`distinct </reference/command/distinct>`, and
-   :manual:`findAndModify </reference/command/findAndModify>` helpers do not
-   support a ``typeMap`` option due to a driver limitation. The
-   :phpmethod:`aggregate() <MongoDB\\Collection::aggregate>`,
-   :phpmethod:`distinct() <MongoDB\\Collection::distinct>`,
-   :phpmethod:`findOneAndReplace() <MongoDB\\Collection::findOneAndReplace>`,
-   :phpmethod:`findOneAndUpdate() <MongoDB\\Collection::findOneAndUpdate>`, and
-   :phpmethod:`findOneAndDelete() <MongoDB\\Collection::findOneAndDelete>`
-   methods return BSON documents as `stdClass` objects and BSON arrays as
-   arrays.
+The :manual:`aggregate </reference/command/aggregate>` (when not using a
+cursor), :manual:`distinct </reference/command/distinct>`, and
+:manual:`findAndModify </reference/command/findAndModify>` helpers do not
+support a ``typeMap`` option due to a driver limitation. The
+:phpmethod:`aggregate() <MongoDB\\Collection::aggregate()>`,
+:phpmethod:`distinct() <MongoDB\\Collection::distinct()>`,
+:phpmethod:`findOneAndReplace() <MongoDB\\Collection::findOneAndReplace()>`,
+:phpmethod:`findOneAndUpdate() <MongoDB\\Collection::findOneAndUpdate()>`, and
+:phpmethod:`findOneAndDelete() <MongoDB\\Collection::findOneAndDelete()>`
+methods return BSON documents as ``stdClass`` objects and BSON arrays as arrays.
 
 Methods
 -------

source/reference/class/MongoDBDatabase.txt

@@ -22,7 +22,7 @@ Definition
    :php:`MongoDB\\Driver\\Manager <class.mongodb-driver-manager>` class or
    select a database from the library's :phpclass:`MongoDB\\Client` class. A
    database may also be cloned from an existing :phpclass:`MongoDB\\Database`
-   object via the :phpmethod:`withOptions() <MongoDB\\Database::withOptions>`
+   object via the :phpmethod:`withOptions() <MongoDB\\Database::withOptions()>`
    method.
 
    :phpclass:`MongoDB\\Database` supports the :php:`readConcern

source/reference/class/MongoDBGridFSBucket.txt

@@ -25,7 +25,7 @@ Definition
    You can construct a GridFS bucket using the driver's
    :php:`Manager <class.mongodb-driver-manager>` class, or select a bucket from
    the library's :phpclass:`MongoDB\\Database` class via the
-   :phpmethod:`selectGridFSBucket() <MongoDB\\Database::selectGridFSBucket>`
+   :phpmethod:`selectGridFSBucket() <MongoDB\\Database::selectGridFSBucket()>`
    method.
 
 Methods

source/reference/method/MongoDBChangeStream-getCursorId.txt

@@ -43,7 +43,9 @@ This example reports the cursor ID for a change stream.
 
    var_dump($changeStream->getCursorId());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Driver\CursorId)#5 (1) {
      ["id"]=>

source/reference/method/MongoDBClient-dropDatabase.txt

@@ -58,7 +58,9 @@ The following example drops the ``test`` database:
 
    var_dump($result);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#8 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBClient-getReadConcern.txt

@@ -41,7 +41,9 @@ Example
 
    var_dump($client->getReadConcern());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Driver\ReadConcern)#5 (1) {
      ["level"]=>

source/reference/method/MongoDBClient-getReadPreference.txt

@@ -42,7 +42,9 @@ Example
 
    var_dump($client->getReadPreference());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Driver\ReadPreference)#5 (1) {
      ["mode"]=>

source/reference/method/MongoDBClient-getTypeMap.txt

@@ -45,7 +45,9 @@ Example
 
    var_dump($client->getTypeMap());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    array(3) {
      ["root"]=>

source/reference/method/MongoDBClient-getWriteConcern.txt

@@ -42,7 +42,9 @@ Example
 
    var_dump($client->getWriteConcern());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Driver\WriteConcern)#4 (1) {
      ["j"]=>

source/reference/method/MongoDBClient-listDatabaseNames.txt

@@ -59,7 +59,9 @@ The following example lists all databases on the server:
        var_dump($databaseName);
    }
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    string(5) "local"
    string(4) "test"

source/reference/method/MongoDBClient-listDatabases.txt

@@ -58,7 +58,9 @@ The following example lists all databases on the server:
        var_dump($databaseInfo);
    }
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\DatabaseInfo)#4 (3) {
      ["name"]=>

source/reference/method/MongoDBClient-startSession.txt

@@ -53,7 +53,9 @@ The following example starts a new session:
 
    var_dump($session);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Driver\Session)#2043 (4) {
      ["logicalSessionId"]=>

source/reference/method/MongoDBClient__get.txt

@@ -17,7 +17,7 @@ Definition
 
    Selects a database on the server. This :php:`magic method <oop5.magic>` is
    an alias for the :phpmethod:`selectDatabase()
-   <MongoDB\\Client::selectDatabase>` method.
+   <MongoDB\\Client::selectDatabase()>` method.
 
    .. code-block:: php
 
@@ -37,7 +37,7 @@ Behavior
 
 The selected database inherits options such as read preference and type mapping
 from the :phpclass:`Client <MongoDB\\Client>` object. If you wish to override
-any options, use the :phpmethod:`MongoDB\\Client::selectDatabase` method.
+any options, use the :phpmethod:`MongoDB\\Client::selectDatabase()` method.
 
 .. note::
 

source/reference/method/MongoDBCollection-createIndex.txt

@@ -66,7 +66,9 @@ the ``test`` database.
 
    var_dump($indexName);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    string(19) "borough_1_cuisine_1"
 
@@ -95,7 +97,9 @@ exists.
 
    var_dump($indexName);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    string(9) "borough_1"
 

source/reference/method/MongoDBCollection-createIndexes.txt

@@ -13,7 +13,7 @@ MongoDB\\Collection::createIndexes()
 Definition
 ----------
 
-.. phpmethod:: MongoDB\\Collection::createIndexes($indexes)
+.. phpmethod:: MongoDB\\Collection::createIndexes()
 
    Create one or more indexes for the collection.
 
@@ -53,7 +53,9 @@ fields that correspond to index options accepted by :phpmethod:`createIndex()
 
 For example, the following ``$indexes`` parameter creates two indexes. The first
 is an ascending unique index on the ``username`` field and the second is a
-2dsphere index on the ``loc`` field with a custom name::
+2dsphere index on the ``loc`` field with a custom name:
+
+.. code-block:: none
 
    [
        [ 'key' => [ 'username' => 1 ], 'unique' => true ],
@@ -81,7 +83,9 @@ custom name.
 
    var_dump($indexNames);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    array(2) {
      [0]=>

source/reference/method/MongoDBCollection-deleteMany.txt

@@ -68,7 +68,9 @@ that have ``"ny"`` as the value for the ``state`` field:
 
    printf("Deleted %d document(s)\n", $deleteResult->getDeletedCount());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    Deleted 2 document(s)
 

source/reference/method/MongoDBCollection-deleteOne.txt

@@ -70,7 +70,9 @@ has ``"ny"`` as the value for the ``state`` field:
 
    printf("Deleted %d document(s)\n", $deleteResult->getDeletedCount());
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    Deleted 1 document(s)
 

source/reference/method/MongoDBCollection-distinct.txt

@@ -66,7 +66,9 @@ in the ``restaurants`` collection in the ``test`` database.
 
    var_dump($distinct);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    array(6) {
      [0]=>
@@ -100,7 +102,9 @@ the ``borough`` is ``Queens``:
 
    var_dump($distinct);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    array(75) {
      [0]=>

source/reference/method/MongoDBCollection-drop.txt

@@ -59,7 +59,9 @@ database:
 
    var_dump($result);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#9 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBCollection-dropIndex.txt

@@ -59,7 +59,9 @@ collection in the ``test`` database:
 
    var_dump($result);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#9 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBCollection-dropIndexes.txt

@@ -60,7 +60,9 @@ The following drops all indexes from the ``restaurants`` collection in the
 
    var_dump($result);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#9 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBCollection-explain.txt

@@ -50,18 +50,18 @@ Explainable Commands
 
 Explainable commands include, but are not limited to:
 
-   - :phpclass:`MongoDB\\Operation\\Aggregate`
-   - :phpclass:`MongoDB\\Operation\\Count`
-   - :phpclass:`MongoDB\\Operation\\DeleteMany`
-   - :phpclass:`MongoDB\\Operation\\DeleteOne`
-   - :phpclass:`MongoDB\\Operation\\Distinct`
-   - :phpclass:`MongoDB\\Operation\\Find`
-   - :phpclass:`MongoDB\\Operation\\FindOne`
-   - :phpclass:`MongoDB\\Operation\\FindOneAndDelete`
-   - :phpclass:`MongoDB\\Operation\\FindOneAndReplace`
-   - :phpclass:`MongoDB\\Operation\\FindOneAndUpdate`
-   - :phpclass:`MongoDB\\Operation\\UpdateMany`
-   - :phpclass:`MongoDB\\Operation\\UpdateOne`
+- ``MongoDB\Operation\Aggregate``
+- ``MongoDB\Operation\Count``
+- ``MongoDB\Operation\DeleteMany``
+- ``MongoDB\Operation\DeleteOne``
+- ``MongoDB\Operation\Distinct``
+- ``MongoDB\Operation\Find``
+- ``MongoDB\Operation\FindOne``
+- ``MongoDB\Operation\FindOneAndDelete``
+- ``MongoDB\Operation\FindOneAndReplace``
+- ``MongoDB\Operation\FindOneAndUpdate``
+- ``MongoDB\Operation\UpdateMany``
+- ``MongoDB\Operation\UpdateOne``
 
 Examples
 --------
@@ -84,7 +84,9 @@ This example explains a count command.
 
    var_dump($result);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#29 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBCollection-find.txt

@@ -77,7 +77,9 @@ returned. It also limits the results to 5 documents.
       var_dump($restaurant);
    };
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#10 (1) {
      ["storage":"ArrayObject":private]=>

source/reference/method/MongoDBCollection-findOne.txt

@@ -98,7 +98,9 @@ returned.
 
    var_dump($restaurant);
 
-The output would then resemble::
+The output would then resemble:
+
+.. code-block:: none
 
    object(MongoDB\Model\BSONDocument)#10 (1) {
      ["storage":"ArrayObject":private]=>