Fix docstring syntax errors

src/twisted/cred/test/test_cred.py

@@ -323,12 +323,12 @@ class CheckersMixin(object):
     and deny specified credentials.
 
     Subclasses must provide
-    - C{getCheckers} which returns a sequence of
-      L{checkers.ICredentialChecker}
-    - C{getGoodCredentials} which returns a list of 2-tuples of
-      credential to check and avaterId to expect.
-    - C{getBadCredentials} which returns a list of credentials
-      which are expected to be unauthorized.
+      - C{getCheckers} which returns a sequence of
+        L{checkers.ICredentialChecker}
+      - C{getGoodCredentials} which returns a list of 2-tuples of
+        credential to check and avaterId to expect.
+      - C{getBadCredentials} which returns a list of credentials
+        which are expected to be unauthorized.
     """
 
     @defer.inlineCallbacks

src/twisted/mail/test/test_pop3.py

@@ -2,7 +2,7 @@
 # See LICENSE for details.
 
 """
-Test cases for Ltwisted.mail.pop3} module.
+Test cases for L{twisted.mail.pop3} module.
 """
 
 

src/twisted/names/test/test_dns.py

@@ -4211,9 +4211,10 @@ def fakeToMessage(*args, **kwargs):
 
 
 
-class EDNSMessageEqualityTests(ComparisonTestsMixin, unittest.SynchronousTestCase):
+class EDNSMessageEqualityTests(ComparisonTestsMixin,
+                               unittest.SynchronousTestCase):
     """
-    Tests for equality between L(dns._EDNSMessage} instances.
+    Tests for equality between L{dns._EDNSMessage} instances.
 
     These tests will not work with L{dns.Message} because it does not use
     L{twisted.python.util.FancyEqMixin}.
@@ -4924,9 +4925,11 @@ def __repr__(self):
 
 class CompactReprTests(unittest.SynchronousTestCase):
     """
-    Tests for L[dns._compactRepr}.
+    Tests for L{dns._compactRepr}.
     """
+
     messageFactory = Foo
+
     def test_defaults(self):
         """
         L{dns._compactRepr} omits field values and sections which have the

src/twisted/python/test/test_shellcomp.py

@@ -42,13 +42,13 @@ class ZshScriptTestMixin(object):
     Integration test helper to show that C{usage.Options} classes can have zsh
     completion functions generated for them without raising errors.
 
-    In your subclasses set a class variable like so:
+    In your subclasses set a class variable like so::
 
-    #            | cmd name | Fully Qualified Python Name of Options class |
-    #
-    generateFor = [('conch',  'twisted.conch.scripts.conch.ClientOptions'),
-                   ('twistd', 'twisted.scripts.twistd.ServerOptions'),
-                   ]
+      #            | cmd name | Fully Qualified Python Name of Options class |
+      #
+      generateFor = [('conch',  'twisted.conch.scripts.conch.ClientOptions'),
+                     ('twistd', 'twisted.scripts.twistd.ServerOptions'),
+                     ]
 
     Each package that contains Twisted scripts should contain one TestCase
     subclass which also inherits from this mixin, and contains a C{generateFor}

src/twisted/python/test/test_util.py

@@ -419,7 +419,7 @@ def test_bytes(self):
 
 class PasswordTestingProcessProtocol(ProcessProtocol):
     """
-    Write the string C{"secret\n"} to a subprocess and then collect all of
+    Write the string C{"secret\\n"} to a subprocess and then collect all of
     its output and fire a Deferred with it when the process ends.
     """
     def connectionMade(self):

src/twisted/web/test/test_xml.py

@@ -817,8 +817,9 @@ class BrokenHTMLTests(TestCase):
     """
     Tests for when microdom encounters very bad HTML and C{beExtremelyLenient}
     is enabled. These tests are inspired by some HTML generated in by a mailer,
-    which breaks up very long lines by splitting them with '!\n '. The expected
-    behaviour is loosely modelled on the way Firefox treats very bad HTML.
+    which breaks up very long lines by splitting them with '!\\n '.
+    The expected behaviour is loosely modelled on the way Firefox treats very
+    bad HTML.
     """
 
     def checkParsed(self, input, expected, beExtremelyLenient=1):