From 45c6c3eb71926981b4d63b62127284650a69b5c4 Mon Sep 17 00:00:00 2001 From: Florent Xicluna Date: Fri, 11 Nov 2011 19:55:21 +0100 Subject: Few typos in the documentation. --- Doc/library/builtins.rst | 2 +- Doc/library/imaplib.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/builtins.rst b/Doc/library/builtins.rst index d4199d2..2cca1d0 100644 --- a/Doc/library/builtins.rst +++ b/Doc/library/builtins.rst @@ -36,6 +36,6 @@ that wants to implement an :func:`open` function that wraps the built-in As an implementation detail, most modules have the name ``__builtins__`` made available as part of their globals. The value of ``__builtins__`` is normally -either this module or the value of this modules's :attr:`__dict__` attribute. +either this module or the value of this module's :attr:`__dict__` attribute. Since this is an implementation detail, it may not be used by alternate implementations of Python. diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst index 1d92fe5..3f45c95 100644 --- a/Doc/library/imaplib.rst +++ b/Doc/library/imaplib.rst @@ -109,7 +109,7 @@ The following utility functions are defined: Convert *date_time* to an IMAP4 ``INTERNALDATE`` representation. The return value is a string in the form: ``"DD-Mmm-YYYY HH:MM:SS +HHMM"`` (including double-quotes). The *date_time* argument can be a - number (int or float) represening seconds since epoch (as returned + number (int or float) representing seconds since epoch (as returned by :func:`time.time`), a 9-tuple representing local time (as returned by :func:`time.localtime`), or a double-quoted string. In the last case, it is assumed to already be in the correct format. -- cgit v0.12 From 599d76b2754f5391abb0aadae96a444065e52b5c Mon Sep 17 00:00:00 2001 From: Florent Xicluna Date: Fri, 11 Nov 2011 19:56:26 +0100 Subject: Reformat paragraphs. --- Doc/library/socketserver.rst | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/Doc/library/socketserver.rst b/Doc/library/socketserver.rst index 177c0b1..366dac4 100644 --- a/Doc/library/socketserver.rst +++ b/Doc/library/socketserver.rst @@ -39,11 +39,12 @@ process one or many requests. When inheriting from :class:`ThreadingMixIn` for threaded connection behavior, you should explicitly declare how you want your threads to behave on an abrupt -shutdown. The :class:`ThreadingMixIn` class defines an attribute +shutdown. The :class:`ThreadingMixIn` class defines an attribute *daemon_threads*, which indicates whether or not the server should wait for -thread termination. You should set the flag explicitly if you would like threads -to behave autonomously; the default is :const:`False`, meaning that Python will -not exit until all threads created by :class:`ThreadingMixIn` have exited. +thread termination. You should set the flag explicitly if you would like +threads to behave autonomously; the default is :const:`False`, meaning that +Python will not exit until all threads created by :class:`ThreadingMixIn` have +exited. Server classes have the same external methods and attributes, no matter what network protocol they use. @@ -115,8 +116,8 @@ or inappropriate for the service) is to maintain an explicit table of partially finished requests and to use :func:`select` to decide which request to work on next (or whether to handle a new incoming request). This is particularly important for stream services where each client can potentially be connected for -a long time (if threads or subprocesses cannot be used). See :mod:`asyncore` for -another way to manage this. +a long time (if threads or subprocesses cannot be used). See :mod:`asyncore` +for another way to manage this. .. XXX should data and methods be intermingled, or separate? how should the distinction between class and instance variables be drawn? @@ -192,7 +193,7 @@ The server classes support the following class variables: .. attribute:: BaseServer.allow_reuse_address - Whether the server will allow the reuse of an address. This defaults to + Whether the server will allow the reuse of an address. This defaults to :const:`False`, and can be set in subclasses to change the policy. @@ -269,7 +270,7 @@ users of the server object. .. method:: BaseServer.server_activate() Called by the server's constructor to activate the server. The default behavior - just :meth:`listen`\ s to the server's socket. May be overridden. + just :meth:`listen`\ s to the server's socket. May be overridden. .. method:: BaseServer.server_bind() @@ -280,10 +281,10 @@ users of the server object. .. method:: BaseServer.verify_request(request, client_address) - Must return a Boolean value; if the value is :const:`True`, the request will be - processed, and if it's :const:`False`, the request will be denied. This function - can be overridden to implement access controls for a server. The default - implementation always returns :const:`True`. + Must return a Boolean value; if the value is :const:`True`, the request will + be processed, and if it's :const:`False`, the request will be denied. This + function can be overridden to implement access controls for a server. The + default implementation always returns :const:`True`. RequestHandler Objects -- cgit v0.12