More test improvements, including a new (failing, previously missing) test case and again many docstring improvements

git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/branches/positioning-3926-2@37872 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb