r46823 - attempt to deal with twistedchecker

Author: glyph
Date: Thu Feb 18 02:35:16 2016
New Revision: 46823

Modified:
   branches/persistent-client-service-4735-5/twisted/application/internet.py
   branches/persistent-client-service-4735-5/twisted/application/test/test_internet.py

Log:
attempt to deal with twistedchecker

Modified: branches/persistent-client-service-4735-5/twisted/application/internet.py
==============================================================================
--- branches/persistent-client-service-4735-5/twisted/application/internet.py	(original)
+++ branches/persistent-client-service-4735-5/twisted/application/internet.py	Thu Feb 18 02:35:16 2016
@@ -432,6 +432,10 @@
     def connectionLost(self, reason):
         """
         The connection was lost.  Relay this information.
+
+        @param reason: The reason the connection was lost.
+
+        @return: the underlying protocol's result
         """
         try:
             return self._protocol.connectionLost(reason)
@@ -461,6 +465,10 @@
 
 
     def buildProtocol(self, addr):
+        """
+        Create a L{_ReconnectingProtocolProxy} with the disconnect-notification
+        callback we were called with.
+        """
         return _ReconnectingProtocolProxy(
             self._protocolFactory.buildProtocol(addr),
             self._protocolDisconnected

Modified: branches/persistent-client-service-4735-5/twisted/application/test/test_internet.py
==============================================================================
--- branches/persistent-client-service-4735-5/twisted/application/test/test_internet.py	(original)
+++ branches/persistent-client-service-4735-5/twisted/application/test/test_internet.py	Thu Feb 18 02:35:16 2016
@@ -500,6 +500,20 @@
         """
         Create a L{ClientService} along with a L{ConnectInformation} indicating
         the connections in progress on its endpoint.
+
+        @param fireImmediately: Should all of the endpoint connection attempts
+            fire synchronously?
+        @type fireImmediately: L{bool}
+
+        @param startService: Should the L{ClientService} be started before
+            being returned?
+        @type startService: L{bool}
+
+        @param kw: Arbitrary keyword arguments to be passed on to
+            L{ClientService}
+
+        @return: a 2-tuple of L{ConnectInformation} (for information about test
+            state) and L{ClientService} (the system under test)
         """
         nkw = {}
         nkw.update(clock=Clock())