Update the unittest section.

1 files changed, 27 insertions, 17 deletions

diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index 6a92569943..1a435ee268 100644
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -651,23 +651,33 @@ New, Improved, and Deprecated Modules
   as recommended in public uses of HTTPS.
   (Added by Antoine Pitrou, :issue:`9003`.)
 
-* Instances of :class:`unittest.TestCase` have two new methods
-  :meth:`~unittest.TestCase.assertWarns` and :meth:`~unittest.TestCase.assertWarnsRegexp`
-  to check that a given warning type was triggered by the code under test::
-
-      with self.assertWarns(DeprecationWarning):
-          legacy_function('XYZ')
-
-* The following :class:`unittest.TestCase` methods are now deprecated:
-   * :meth:`assert_` (use :meth:`.assertTrue` instead);
-   * :meth:`assertEquals` (use :meth:`.assertEqual` instead);
-   * :meth:`assertNotEquals` (use :meth:`.assertNotEqual` instead);
-   * :meth:`assertAlmostEquals` (use :meth:`.assertAlmostEqual` instead);
-   * :meth:`assertNotAlmostEquals` (use :meth:`.assertNotAlmostEqual` instead);
-
-  The ``TestCase.fail*`` methods deprecated in Python 3.1 will be removed in
-  Python 3.3. See also the :ref:`deprecated-aliases` section in the
-  :mod:`unittest` documentation.
+* The command call, ``python -m unittest`` can now accept file paths instead
+  of module names for running specific tests (:issue:`10620`).
+
+* The :mod:`unittest` module has two new methods,
+  :meth:`~unittest.TestCase.assertWarns` and
+  :meth:`~unittest.TestCase.assertWarnsRegex` to check that a given warning type
+  was triggered by the code under test:
+
+  >>> with self.assertWarns(DeprecationWarning):
+  ...     legacy_function('XYZ')
+
+  In addition, the naming in the module has ungone a number of clean-ups.
+  For example, :meth:`assertRegex` is the new name for :meth:`assertRegexpMatches`
+  which was misnamed because the test uses :func:`re.search`, not :func:`re.match`.
+
+  To improve consistency, some of long-standing method aliases are being
+  deprecated in favor of the preferred names:
+
+   - replace :meth:`assert_` with :meth:`.assertTrue`
+   - replace :meth:`assertEquals` with :meth:`.assertEqual`
+   - replace :meth:`assertNotEquals` with :meth:`.assertNotEqual`
+   - replace :meth:`assertAlmostEquals` with :meth:`.assertAlmostEqual`
+   - replace :meth:`assertNotAlmostEquals` with :meth:`.assertNotAlmostEqual`
+
+  Likewise, the ``TestCase.fail*`` methods deprecated in Python 3.1 are expected
+  to be removed in Python 3.3. See also the :ref:`deprecated-aliases` section in
+  the :mod:`unittest` documentation.
 
   (Contributed by Ezio Melotti; :issue:`9424`.)