docstring updates

Author: jorisvandenbossche

pandas/core/indexes/base.py

@@ -2273,8 +2273,8 @@ def union(self, other, sort=None):
 
             .. versionchanged:: 0.24.1
 
-               Changed the default `sort` from True to None (without
-               change in behaviour).
+               Changed the default value from ``True`` to ``None``
+               (without change in behaviour).
 
         Returns
         -------
@@ -2373,7 +2373,8 @@ def intersection(self, other, sort=False):
 
             .. versionchanged:: 0.24.1
 
-               Changed the default from ``True`` to ``False``.
+               Changed the default from ``True`` to ``False``, to match
+               the behaviour of 0.23.4 and earlier.
 
         Returns
         -------
@@ -2463,8 +2464,8 @@ def difference(self, other, sort=None):
 
             .. versionchanged:: 0.24.1
 
-               Changed `True` to `None`, which matches the behavior of
-               pandas 0.23.4 and earlier.
+               Changed the default value from ``True`` to ``None``
+               (without change in behaviour).
 
         Returns
         -------
@@ -2526,8 +2527,8 @@ def symmetric_difference(self, other, result_name=None, sort=None):
 
             .. versionchanged:: 0.24.1
 
-               Changed `True` to `None`, which matches the behavior of
-               pandas 0.23.4 and earlier.
+               Changed the default value from ``True`` to ``None``
+               (without change in behaviour).
 
         Returns
         -------

pandas/core/indexes/multi.py

@@ -2902,8 +2902,8 @@ def union(self, other, sort=None):
 
             .. versionchanged:: 0.24.1
 
-               Changed the default `sort` from True to None, matching the
-               behavior of pandas 0.23.4 and earlier.
+               Changed the default value from ``True`` to ``None``
+               (without change in behaviour).
 
         Returns
         -------
@@ -2941,7 +2941,7 @@ def intersection(self, other, sort=False):
 
             .. versionchanged:: 0.24.1
 
-               Changed the default to ``False``, to match
+               Changed the default from ``True`` to ``False``, to match
                behaviour from before 0.24.0
 
         Returns
@@ -2982,6 +2982,11 @@ def difference(self, other, sort=None):
 
             .. versionadded:: 0.24.0
 
+            .. versionchanged:: 0.24.1
+
+               Changed the default value from ``True`` to ``None``
+               (without change in behaviour).
+
         Returns
         -------
         diff : MultiIndex