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. :)