Howdy R. David,

Okay, I have put together a series of commits to address this bug. The
changes are in my personal fork of the ‘cpython’ repository, so this is
a pull request from ‘wip/issue/issue30181_parse-docstring-using-pydoc’
in that repository.

The following changes since commit 8550803dfba4cf7018ee7415593ceb34c52923e6:

  Backed out changeset f23fa1f7b68f (2017-02-10 14:19:36 +0100)

are available in the git repository at:

  https://benf_wspdigital@bitbucket.org/benf_wspdigital/cpython.git

for you to fetch changes up to c2de731582a9da1147a300a991890ff663891e75:

  Parse the test case docstring using `pydoc.splitdoc`. (2017-05-01 16:55:52 +1000)

----------------------------------------------------------------
(from the branch description for wip/issue/issue30181_parse-docstring-using-pydoc local branch)

Correct the parsing of a test case docstring.

----------------------------------------------------------------
Ben Finney (4):
      Add test cases for single-line test case docstring.
      Add test cases for stripping surrounding space for shortDescription.
      Add test cases for test case docstring with surrounding newlines.
      Parse the test case docstring using `pydoc.splitdoc`.

 Lib/unittest/case.py                       | 34 ++++++++++++------
 Lib/unittest/test/test_case.py             | 42 ++++++++++++++++++++++
 Lib/unittest/test/test_functiontestcase.py | 58 +++++++++++++++++++++++++-----
 3 files changed, 115 insertions(+), 19 deletions(-)