[issue15608] Improve socketserver doc

Changes by Martin Panter : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: +Python 2.7, Python 3.6 -Python 3.4 ___ Python tracker ___ __

[issue15608] Improve socketserver doc

Roundup Robot added the comment: New changeset 9211b7e60c92 by Martin Panter in branch '2.7': Issue #15608: Improve socketserver module documentation https://hg.python.org/cpython/rev/9211b7e60c92 -- ___ Python tracker

[issue15608] Improve socketserver doc

Roundup Robot added the comment: New changeset 8b71cd67f548 by Martin Panter in branch '3.5': Issue #15608: Improve socketserver module documentation https://hg.python.org/cpython/rev/8b71cd67f548 New changeset fbb8b634fe59 by Martin Panter in branch 'default': Issue #15608: Merge socketserver d

[issue15608] Improve socketserver doc

Martin Panter added the comment: Main changes in socketserver-doc.2.patch: * Documented constructor parameters for the server classes * Indented class methods and attributes underneath class headings -- Added file: http://bugs.python.org/file37957/socketserver-doc.2.patch _

[issue15608] Improve socketserver doc

Changes by Berker Peksag : -- nosy: +berker.peksag stage: -> patch review type: -> enhancement versions: +Python 3.4, Python 3.5 -Python 3.3 ___ Python tracker ___

[issue15608] Improve socketserver doc

Martin Panter added the comment: Here is an attempt to tidy up the socketserver documentation: 1. Added headings for each concrete class and mixin 2. Listed the predefined mixin subclasses 3. Changed RequestHandler to BaseRequestHandler and added class heading 4. Included headings for UnixStream

[issue15608] Improve socketserver doc

Martin Panter added the comment: The post makes a bit more sense once you realize the dotted numbers refer to old section numbers (which have moved on now): 20.19.2 → “Server Objects” section 20.19.1 → “Server Creation Notes” Regarding point 2: Instructions for the user to make a threading or

[issue15608] Improve socketserver doc

Terry J. Reedy added the comment: BaseRequestHandler.__init__(self, request) apparently attaches request to the instance as self.request. The methods are called in this order: setup, handle, finish. If they must be confusingly documented in the opposite order, it would be good for the head en

[issue15608] Improve socketserver doc

New submission from Terry J. Reedy: On Windows, 3.3 socketserver defines 12 classes in 3 categories: servers, server mixins, and handlers. (At least, these are the one listed with dir(socketserver). Only BaseServer is indexed. I think all should be. There are also a couple of text issues. Bas