mongodb · andf-mongodb · Mar 2, 2021 · Mar 1, 2021
diff --git a/source/includes/deprecation-uniqueDocs.rst b/source/includes/deprecation-uniqueDocs.rst
@@ -1,3 +1,4 @@
 .. deprecated:: 2.6
+
    Geospatial queries no longer return duplicate results. The
    :query:`$uniqueDocs` operator has no impact on results.
diff --git a/source/reference/configuration-options.txt b/source/reference/configuration-options.txt
@@ -1643,7 +1643,9 @@ Core Options
 
    *Type*: boolean
 
-   .. deprecated:: 2.6 Use :setting:`net.tls.mode: requireTLS <net.tls.mode>` instead.
+   .. deprecated:: 2.6
+
+      Use :setting:`net.tls.mode: requireTLS <net.tls.mode>` instead.
 
    Enable or disable TLS/SSL for :binary:`~bin.mongos` or :binary:`~bin.mongod`.
 
@@ -1659,7 +1661,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.mode` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.mode` instead.
 
    Enables TLS/SSL or mixed TLS/SSL used for all network connections. The
    argument to the :setting:`net.ssl.mode` setting can be one of the following:
@@ -1700,7 +1704,9 @@ Core Options
    *Type*: string
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.certificateKeyFile` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.certificateKeyFile` instead.
 
    The :file:`.pem` file that contains both the TLS/SSL certificate
    and key.
@@ -1734,7 +1740,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.certificateKeyFilePassword` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.certificateKeyFilePassword` instead.
 
    The password to de-crypt the certificate-key file (i.e.
    :setting:`~net.ssl.PEMKeyFile`). Use the
@@ -1768,7 +1776,9 @@ Core Options
    *Type*: string
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.certificateSelector` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.certificateSelector` instead.
 
    .. versionadded:: 4.0
 
@@ -1810,7 +1820,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.clusterCertificateSelector` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.clusterCertificateSelector` instead.
 
    .. versionadded:: 4.0
 
@@ -1851,7 +1863,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.clusterFile` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.clusterFile` instead.
 
    The :file:`.pem` file that contains the x.509 certificate-key
    file for :ref:`membership authentication <x509-internal-authentication>`
@@ -1887,7 +1901,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.clusterPassword` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.clusterPassword` instead.
 
    The password to de-crypt the x.509 certificate-key file specified
    with ``--sslClusterFile``. Use the :setting:`net.ssl.clusterPassword`
@@ -1921,7 +1937,9 @@ Core Options
    *Type*: string
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.CAFile` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.CAFile` instead.
 
    The :file:`.pem` file that contains the root certificate chain
    from the Certificate Authority. Specify the file name of the
@@ -1943,7 +1961,9 @@ Core Options
    *Type*: string
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.clusterCAFile` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.clusterCAFile` instead.
 
    The :file:`.pem` file that contains the root certificate chain from
    the Certificate Authority used to validate the certificate presented
@@ -1985,7 +2005,9 @@ Core Options
    *Type*: string
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.CRLFile` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.CRLFile` instead.
 
    The :file:`.pem` file that contains the Certificate Revocation
    List. Specify the file name of the :file:`.pem` file using relative or
@@ -2014,7 +2036,10 @@ Core Options
 
    *Type*: boolean
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.allowConnectionsWithoutCertificates` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.allowConnectionsWithoutCertificates`
+      instead.
 
    For clients that do not present certificates, :binary:`~bin.mongos` or :binary:`~bin.mongod` bypasses
    TLS/SSL certificate validation when establishing the connection.
@@ -2034,7 +2059,9 @@ Core Options
    *Type*: boolean
 
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.allowInvalidCertificates` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.allowInvalidCertificates` instead.
 
    Enable or disable the validation checks for TLS/SSL certificates on other
    servers in the cluster and allows the use of invalid certificates to
@@ -2073,8 +2100,9 @@ Core Options
 
    *Type*: string
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.disabledProtocols` instead.
+   .. deprecated:: 4.2
 
+      Use :setting:`net.tls.disabledProtocols` instead.
 
    Prevents a MongoDB server running with TLS/SSL from accepting
    incoming connections that use a specific protocol or protocols. To
@@ -2110,7 +2138,9 @@ Core Options
 
    *Type*: boolean
 
-   .. deprecated:: 4.2 Use :setting:`net.tls.FIPSMode` instead.
+   .. deprecated:: 4.2
+
+      Use :setting:`net.tls.FIPSMode` instead.
 
    Enable or disable the use of the FIPS mode of the  TLS/SSL
    library for the :binary:`~bin.mongos` or :binary:`~bin.mongod`. Your system must have a FIPS

diff --git a/source/reference/method/db.collection.ensureIndex.txt b/source/reference/method/db.collection.ensureIndex.txt
@@ -19,7 +19,8 @@ Definition
    .. include:: /includes/fact-mongo-shell-method.rst
 
 
-   .. deprecated:: 3.0.0
+   .. deprecated:: 3.0
+
       :method:`db.collection.ensureIndex()` has been replaced by 
       :method:`db.collection.createIndex()`.
 

diff --git a/source/reference/method/db.getProfilingLevel.txt b/source/reference/method/db.getProfilingLevel.txt
@@ -16,4 +16,5 @@ db.getProfilingLevel()
    ":dbcommand:`profile`" and returns the current profiling level.
 
    .. deprecated:: 1.8.4
+
       Use :method:`db.getProfilingStatus()` for related functionality.
diff --git a/source/reference/method/db.removeUser.txt b/source/reference/method/db.removeUser.txt
@@ -11,6 +11,7 @@ db.removeUser()
    :class: singlecol
 
 .. deprecated:: 2.6
+
    Use :method:`db.dropUser()` instead
    of :method:`db.removeUser()`
 

diff --git a/source/reference/operator/aggregation/substr.txt b/source/reference/operator/aggregation/substr.txt
@@ -16,6 +16,7 @@ Definition
 .. expression:: $substr
 
    .. deprecated:: 3.4
+
       :expression:`$substr` is now an alias for
       :expression:`$substrBytes`.
 

diff --git a/source/reference/operator/query/geoWithin.txt b/source/reference/operator/query/geoWithin.txt
@@ -194,5 +194,6 @@ specify the custom MongoDB coordinate reference system. For example:
 .. query:: $within
 
    .. deprecated:: 2.4
+
       :query:`$geoWithin` replaces :query:`$within` in MongoDB
       2.4.
diff --git a/source/reference/parameters.txt b/source/reference/parameters.txt
@@ -729,7 +729,9 @@ Authentication Parameters
 
    *Default*: false
 
-   .. deprecated:: 4.2 Use :parameter:`tlsWithholdClientCertificate` instead.
+   .. deprecated:: 4.2
+
+      Use :parameter:`tlsWithholdClientCertificate` instead.
 
    |both|
 

diff --git a/source/reference/privilege-documents.txt b/source/reference/privilege-documents.txt
@@ -13,6 +13,7 @@
    :class: singlecol
 
 .. deprecated:: 2.6
+
    MongoDB 2.6 introduced a new model for user
    credentials and privileges and no longer uses privilege documents.
    See :doc:`/reference/system-users-collection`.

diff --git a/source/reference/program/mongo.txt b/source/reference/program/mongo.txt
@@ -674,7 +674,9 @@ SSL Options (Deprecated)
 .. option:: --ssl
 
 
-   .. deprecated:: 4.2 Use :option:`--tls <mongo --tls>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tls <mongo --tls>` instead.
 
    Enables connection to a :binary:`~bin.mongod` or :binary:`~bin.mongos` that has
    TLS/SSL support enabled.
@@ -687,7 +689,10 @@ SSL Options (Deprecated)
 .. option:: --sslPEMKeyFile <filename>
 
 
-   .. deprecated:: 4.2 Use :option:`--tlsCertificateKeyFile <mongo --tlsCertificateKeyFile>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsCertificateKeyFile
+      <mongo --tlsCertificateKeyFile>` instead.
 
    Specifies the :file:`.pem` file that contains both the TLS/SSL certificate
    and key. Specify the file name of the :file:`.pem` file using relative
@@ -704,7 +709,10 @@ SSL Options (Deprecated)
 .. option:: --sslPEMKeyPassword <value>
 
 
-   .. deprecated:: 4.2 Use :option:`--tlsCertificateKeyFilePassword <mongo --tlsCertificateKeyFilePassword>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsCertificateKeyFilePassword
+      <mongo --tlsCertificateKeyFilePassword>` instead.
 
    Specifies the password to de-crypt the certificate-key file (i.e.
    ``--sslPEMKeyFile``). Use the :option:`--sslPEMKeyPassword` option only if the
@@ -720,9 +728,10 @@ SSL Options (Deprecated)
 
 .. option:: --sslCAFile <filename>
 
-   .. deprecated:: 4.2 Use :option:`--tlsCAFile <mongo --tlsCAFile>` instead.
-
-
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsCAFile <mongo --tlsCAFile>` instead.
+
    Specifies the :file:`.pem` file that contains the root certificate chain
    from the Certificate Authority. Specify the file name of the
    :file:`.pem` file using relative or absolute paths.
@@ -735,7 +744,10 @@ SSL Options (Deprecated)
 .. option:: --sslCertificateSelector <parameter>=<value>
 
 
-   .. deprecated:: 4.2 Use :option:`--tlsCertificateSelector <mongo --tlsCertificateSelector>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsCertificateSelector
+      <mongo --tlsCertificateSelector>` instead.
 
    .. versionadded:: 4.0
 
@@ -758,7 +770,9 @@ SSL Options (Deprecated)
 .. option:: --sslCRLFile <filename>
 
 
-   .. deprecated:: 4.2 Use :option:`--tlsCRLFile <mongo --tlsCRLFile>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsCRLFile <mongo --tlsCRLFile>` instead.
 
    Specifies the :file:`.pem` file that contains the Certificate Revocation
    List. Specify the file name of the :file:`.pem` file using relative or
@@ -777,7 +791,9 @@ SSL Options (Deprecated)
 
 .. option:: --sslFIPSMode
 
-   .. deprecated:: 4.2 Use :option:`--tlsFIPSMode <mongo --tlsFIPSMode>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsFIPSMode <mongo --tlsFIPSMode>` instead.
 
    Directs the :program:`mongo` to use the FIPS mode of the TLS/SSL  
    library. Your system must have a FIPS compliant library to use
@@ -788,8 +804,10 @@ SSL Options (Deprecated)
 
 .. option:: --sslAllowInvalidCertificates
 
-   .. deprecated:: 4.2 Use :option:`--tlsAllowInvalidCertificates <mongo --tlsAllowInvalidCertificates>` instead.
-
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsAllowInvalidCertificates
+      <mongo --tlsAllowInvalidCertificates>` instead.
 
    Bypasses the validation checks for server certificates and allows
    the use of invalid certificates to connect.
@@ -808,7 +826,10 @@ SSL Options (Deprecated)
 
 .. option:: --sslAllowInvalidHostnames
 
-   .. deprecated:: 4.2 Use :option:`--tlsAllowInvalidHostnames <mongo --tlsAllowInvalidHostnames>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsAllowInvalidHostnames
+      <mongo --tlsAllowInvalidHostnames>` instead.
 
    Disables the validation of the hostnames in TLS/SSL certificates. Allows
    :program:`mongo` to connect to MongoDB instances even if the hostname in their
@@ -820,7 +841,10 @@ SSL Options (Deprecated)
 .. option:: --sslDisabledProtocols <string>
 
 
-   .. deprecated:: 4.2 Use :option:`--tlsDisabledProtocols <mongo --tlsDisabledProtocols>` instead.
+   .. deprecated:: 4.2
+
+      Use :option:`--tlsDisabledProtocols
+      <mongo --tlsDisabledProtocols>` instead.
 
    Disables the specified TLS protocols. The option recognizes the
    following protocols: ``TLS1_0``, ``TLS1_1``, ``TLS1_2``, and
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,4 +16,5 @@ db.getProfilingLevel()
		":dbcommand:`profile`" and returns the current profiling level.

		.. deprecated:: 1.8.4

		Use :method:`db.getProfilingStatus()` for related functionality.