We're starting to use the unittest module, and am
noticing some things that need documentation or doc
fixes.

TestSuite class: the run() method requires the result
object; unlike TestCase, it's not optional.

TestSuite objects "prefer" to be invoked by a test
runner (according to comments in the source); the run()
method of the TextTestRunner should be documented.  If
not, then TestSuite.__call__ needs to be changed to
make the result object optional.

I don't think the docs explain using the first line of
the docstring as the "short description" for tests.

TestLoader.loadTestFromName needs to define what a
"string specifier" is, as dis ltnNames. :)

Logged In: YES 
user_id=3066

The use of the docstring as a source for the short
description is explained in the docs for
TestCase.shortDescription().

I think I've addressed your other comments in
Doc/lib/libunittest.tex revision 1.6.

Logged In: YES 
user_id=36737

Looks good, except now you need to document makeSuite, in
particular that the 2nd string argument means "all functions
that start with this prefix are tests" :)

Logged In: YES 
user_id=3066

makeSuite() should not be documented; it was marked obsolete
in the PyUnit sourcecode before it was accepted into the
standard library.