[Python-checkins] Clarify expectedFailure in the unittest docs. (GH-10953)

[Miss Islington (bot)]

https://github.com/python/cpython/commit/f913d44eb75f930c37dc6bcc5d6579be5740ae73
commit: f913d44eb75f930c37dc6bcc5d6579be5740ae73
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-12-06T13:16:03-08:00
summary:

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

(cherry picked from commit 91f259b478ae8bfb4c73e5b5a767e4bf0ee9257f)

Co-authored-by: Gregory P. Smith <greg at krypto.org>

files:
M Doc/library/unittest.rst

diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index fb5bd2b7648e..774b0875bbf1 100644
--- 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)