[Zope3-checkins] SVN: Zope3/trunk/src/zope/server/interfaces/__init__.py Improved wording in interface docstrings

[Shane Hathaway]

Log message for revision 27406:
  Improved wording in interface docstrings
  


Changed:
  U   Zope3/trunk/src/zope/server/interfaces/__init__.py


-=-
Modified: Zope3/trunk/src/zope/server/interfaces/__init__.py
===================================================================
--- Zope3/trunk/src/zope/server/interfaces/__init__.py	2004-09-02 00:48:43 UTC (rev 27405)
+++ Zope3/trunk/src/zope/server/interfaces/__init__.py	2004-09-02 05:20:28 UTC (rev 27406)
@@ -21,8 +21,8 @@
 class ISocket(Interface):
     """Represents a socket.
 
-       Note: Most of this documentation is taken from the Python Library
-             Reference.
+    Note: Most of this documentation is taken from the Python Library
+    Reference.
     """
 
     def listen(backlog):
@@ -240,10 +240,9 @@
        implement this interface or inherit its base class) is that it
        uses a mix of asynchronous and thread-based mechanism to
        serve. While the low-level socket listener uses async, the
-       actual request is executed in a thread.  This has the huge
-       advantage that if a request takes really long to process, the
-       server does not hang at that point to wait for the request to
-       finish.
+       actual request is executed in a thread.  This is important
+       because even if a request takes a long time to process, the
+       server can service other requests simultaneously.
     """
 
     channel_class = Attribute("""