r47186 - some docs cleanups

Author: hawkowl
Date: Fri Apr  8 02:27:03 2016
New Revision: 47186

Modified:
   branches/t-names-authority-py3-8259/twisted/names/authority.py
   branches/t-names-authority-py3-8259/twisted/names/secondary.py

Log:
some docs cleanups

Modified: branches/t-names-authority-py3-8259/twisted/names/authority.py
==============================================================================
--- branches/t-names-authority-py3-8259/twisted/names/authority.py	(original)
+++ branches/t-names-authority-py3-8259/twisted/names/authority.py	Fri Apr  8 02:27:03 2016
@@ -57,7 +57,8 @@
     @ivar _ADDRESS_TYPES: Record types which are useful for inclusion in the
         additional section generated during additional processing.
 
-    @ivar soa: A 2-tuple containing
+    @ivar soa: A 2-tuple containing the SOA domain name as a L{bytes} and a
+        L{dns.Record_SOA}.
     """
     # See https://twistedmatrix.com/trac/ticket/6650
     _ADDITIONAL_PROCESSING_TYPES = (dns.CNAME, dns.MX, dns.NS)

Modified: branches/t-names-authority-py3-8259/twisted/names/secondary.py
==============================================================================
--- branches/t-names-authority-py3-8259/twisted/names/secondary.py	(original)
+++ branches/t-names-authority-py3-8259/twisted/names/secondary.py	Fri Apr  8 02:27:03 2016
@@ -86,12 +86,12 @@
         be attempted.
     @type primary: C{str}
 
-    @ivar _port: The port number of the server from which zone transfers will be
-        attempted.
-    @type: C{int}
+    @ivar _port: The port number of the server from which zone transfers will
+        be attempted.
+    @type _port: C{int}
 
-    @ivar _reactor: The reactor to use to perform the zone transfers, or C{None}
-        to use the global reactor.
+    @ivar _reactor: The reactor to use to perform the zone transfers, or
+        C{None} to use the global reactor.
     """
 
     transferring = False