Update the unittest section.
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index 6a92569..1a435ee 100644
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -651,23 +651,33 @@
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::
+* The command call, ``python -m unittest`` can now accept file paths instead
+ of module names for running specific tests (:issue:`10620`).
- with self.assertWarns(DeprecationWarning):
- legacy_function('XYZ')
+* 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:
-* 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);
+ >>> with self.assertWarns(DeprecationWarning):
+ ... legacy_function('XYZ')
- 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.
+ 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`.)