Clarify expectedFailure in the unittest docs. (GH-10953)

miss-islington · gpshead · web-flow · commit f913d44eb75f · 2018-12-06T13:16:03.000-08:00
(cherry picked from commit 91f259b) Co-authored-by: Gregory P. Smith <greg@krypto.org>
diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
@@ -585,8 +585,8 @@ The following decorators implement test skipping and expected failures:
 
 .. decorator:: expectedFailure
 
-   Mark the test as an expected failure.  If the test fails when run, the test
-   is not counted as a failure.
+   Mark the test as an expected failure.  If the test fails it will be
+   considered a success.  If the test passes, it will be considered a failure.
 
 .. exception:: SkipTest(reason)
 
