Fix epytext errors, docstrings and some typos.

git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/branches/browser-like-redirect-agent-5434@38144 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb