spacing

Author: rachel-mack

source/upgrade.txt

@@ -64,13 +64,13 @@ Version 5.0 Breaking Changes
 This driver version introduces the following breaking changes:
 
 - Changes the data type of the timeout duration parameter in the
-  ``SocketSettings.Builder.connectTimeout()`` and ``SocketSettings.Builder.readTimeout()``
-  methods. The data type of this parameter is now ``long`` instead of ``int``.
-  To view an
-  example that shows how to instantiate a ``SocketSettings`` instance by using
-  these methods, see the :ref:`SocketSettings Example
-  <java-socketsettings-example>` in the Specify MongoClient Settings
-  guide.
+  ``SocketSettings.Builder.connectTimeout()`` and
+  ``SocketSettings.Builder.readTimeout()`` methods. The data type of this
+  parameter is now ``long`` instead of ``int``. To view an example that shows
+  how to call ``SocketSettings`` methods, see the :ref:`SocketSettings Example
+  <java-socketsettings-example>` in the Specify MongoClient Settings guide. This
+  change breaks binary compatibility (requires recompiling) but does not require
+  code changes.
 
   - The ``getServerValue()`` method now returns a value of type ``Long`` instead of type
     ``Integer``. Similarly, the ``getLocalValue()`` method returns a value of type
@@ -125,20 +125,20 @@ This driver version introduces the following breaking changes:
 
   .. code-block:: java
 
-    ClusterSettings.builder()
-        .applyConnectionString(new ConnectionString("mongodb://127.0.0.1:27017/?replicaSet=replset"))
-        .build()
-        .getMode()
+     ClusterSettings.builder()
+         .applyConnectionString(new ConnectionString("mongodb://127.0.0.1:27017/?replicaSet=replset"))
+         .build()
+         .getMode()
 
   .. code-block:: java
 
-    ClusterSettings.builder()
-        .hosts(Collections.singletonList(
+     ClusterSettings.builder()
+         .hosts(Collections.singletonList(
                 new ServerAddress("127.0.0.1", 27017)
-        ))
-        .requiredReplicaSetName("replset")
-        .build()
-        .getMode()
+         ))
+         .requiredReplicaSetName("replset")
+         .build()
+         .getMode()
 
 - Changes how ``BsonDecimal128`` values respond to method calls, by
   responding in the same way as ``Decimal128`` values. In particular,