From: Sandro Tosi <sandro.tosi@gmail.com>
Date: Tue, 3 Jan 2012 21:35:54 +0000 (+0100)
Subject: Issue #6031: improve serve_forever() description
X-Git-Tag: v3.2.3rc1~218^2
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=753b79c0731dd867068bf31e29b28c390f5d24d3;p=python

Issue #6031: improve serve_forever() description
---

diff --git a/Doc/library/socketserver.rst b/Doc/library/socketserver.rst
index 366dac4a0b..34bcce0e44 100644
--- a/Doc/library/socketserver.rst
+++ b/Doc/library/socketserver.rst
@@ -153,13 +153,14 @@ Server Objects
 
 .. method:: BaseServer.serve_forever(poll_interval=0.5)
 
-   Handle requests until an explicit :meth:`shutdown` request.  Polls for
-   shutdown every *poll_interval* seconds.
+   Handle requests until an explicit :meth:`shutdown` request.
+   Poll for shutdown every *poll_interval* seconds. Ignores :attr:`self.timeout`.
+   If you need to do periodic tasks, do them in another thread.
 
 
 .. method:: BaseServer.shutdown()
 
-   Tells the :meth:`serve_forever` loop to stop and waits until it does.
+   Tell the :meth:`serve_forever` loop to stop and wait until it does.
 
 
 .. attribute:: BaseServer.address_family