Add missing information to IRequest interface. Clarify news file language. Use decorators. Add docstrings.

git-svn-id: svn://svn.twistedmatrix.com/svn/Twisted/branches/redirectagent-final-uri-5435@37868 bbbe8e31-12d6-0310-92fd-ac37d47ddeeb