Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!news.glorb.com!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path: <python-python-list@m.gmane.org>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.003
X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'explicitly': 0.04; 'objects,': 0.07; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'aug': 0.13; 'slightly': 0.15; 'assumptions': 0.16; 'message- id:@dough.gmane.org': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'subject: \n ': 0.16; 'wrote:': 0.17; 'certainly': 0.17; 'documented': 0.17; 'thu,': 0.17; 'examples': 0.18; '>>>': 0.18; 'code.': 0.20; 'trying': 0.21; 'thanks.': 0.21; 'visible': 0.22; 'defined': 0.22; "i'd": 0.22; 'chapter': 0.23; 'class.': 0.23; "i've": 0.23; 'header:In-Reply- To:1': 0.25; 'header:User-Agent:1': 0.26; 'question': 0.27; 'library.': 0.27; 'header:X-Complaints-To:1': 0.28; '+0100,': 0.29; 'publicly': 0.29; 'covered': 0.29; 'objects': 0.29; 'maybe': 0.29; 'classes': 0.30; 'point': 0.31; 'from:addr:yahoo.co.uk': 0.32; 'could': 0.32; 'getting': 0.33; 'anywhere': 0.33; 'skip:s 30': 0.33; 'to:addr:python-list': 0.33; "can't": 0.34; 'exist': 0.35; 'so,': 0.35; 'there': 0.35; 'received:org': 0.36; 'but': 0.36; "i'll": 0.36; 'should': 0.36; 'thank': 0.36; 'does': 0.37; 'why': 0.37; 'quite': 0.37; 'far': 0.37; 'subject:: ': 0.38; 'mark': 0.38; 'to:addr:python.org': 0.39; 'skip:" 10': 0.40; 'header:Received:5': 0.40; 'help': 0.40; 'most': 0.61; 'you.': 0.61; 'capable': 0.63; 'here': 0.65; 'taking': 0.65; 'reply': 0.66; 'confirming': 0.84; 'dennis': 0.91; 'kat': 0.91
X-Injected-Via-Gmane: http://gmane.org/
To: python-list@python.org
From: Mark Lawrence <breamoreboy@yahoo.co.uk>
Subject: Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs
Date: Thu, 09 Aug 2012 19:55:39 +0100
References: <34WdnQ8_38yFSb7NnZ2dnUVZ8qCdnZ2d@bt.com> <mailman.3104.1344534013.4697.python-list@python.org> <ZcCdnWGRFsLxnrnNnZ2dnUVZ7rCdnZ2d@bt.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Gmane-NNTP-Posting-Host: host-92-24-125-189.ppp.as43234.net
User-Agent: Mozilla/5.0 (Windows NT 6.0; rv:14.0) Gecko/20120713 Thunderbird/14.0
In-Reply-To: <ZcCdnWGRFsLxnrnNnZ2dnUVZ7rCdnZ2d@bt.com>
X-Antivirus: avast! (VPS 120809-0, 09/08/2012), Outbound message
X-Antivirus-Status: Clean
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.3105.1344538500.4697.python-list@python.org>
Lines: 60
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1344538500 news.xs4all.nl 6862 [2001:888:2000:d::a6]:46490
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:26795

On 09/08/2012 19:37, lipska the kat wrote:
> On 09/08/12 18:39, Dennis Lee Bieber wrote:
>> On Thu, 09 Aug 2012 16:15:33 +0100, lipska the kat
>> <lipskathekat@yahoo.co.uk>  declaimed the following in
>> gmane.comp.python.general:
>>
>>
>>> in the examples in this chapter we see usage examples for
>>> socketserver.BaseRequestHandler
>>>
>>     So far as I can tell, all RequestHandler objects are covered in
>> section "20.19.3 RequestHandler Objects"
>
> Yes, I know, I've read it. Thank you.
>
>>     There is no "RequestHandler" class. The section is general to all
>> RequestHandler OBJECTS (Base, Stream, and Datagram).
>
> Yes I know, I've read socketserver.py. Thank you.
> Why do I find myself getting annoyed here ?
>
> This is hard work but I'll try again.
>
> socketserver.RequestHandler is EXPLICITLY documented in section "20.19.3
> RequestHandler Objects" yet does not exist in socketserver.py
> Does this not strike you as odd. I certainly strikes me as odd. Maybe it
> should be socketserver.BaseRequestHandler that is documented here.
>
> The CLASSES socketserver.StreamRequestHandler and
> socketserver.DatagramRequestHandler are DEFINED in socketserver.py
> They are NOT Objects, they are CLASSES yet they are NOT EXPLICITLY
> documented in section 20.19.3 or any other section as far as I can tell.
>
> This is the question I was asking. I am quite capable of extracting the
> slightly obtuse documentation in the section and confirming my
> assumptions by reading the code.
>
> So, I'll try again.
>
> Is there anywhere that documents EXPLICITLY all the publicly visible
> classes in the standard library.
>
> If there is I'd be most grateful if you could point me to it as I can't
> find it
>
> If there isn't how does one go about
> contributing to the documentation.
>
> Thank you for taking the time to reply
>
> lipska
>

Dennis was only trying to help so please don't shout, thanks.

-- 
Cheers.

Mark Lawrence.