Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #26795

Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs

Show all headers | View raw

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.

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 16:15 +0100
  Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Dennis Lee Bieber <wlfraed@ix.netcom.com> - 2012-08-09 13:39 -0400
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 19:08 +0100
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 19:37 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Mark Lawrence <breamoreboy@yahoo.co.uk> - 2012-08-09 19:55 +0100
        Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 20:20 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Peter Otten <__peter__@web.de> - 2012-08-09 21:07 +0200
        Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-09 20:23 +0100
      Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Dave Angel <d@davea.name> - 2012-08-09 15:45 -0400
  Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs Terry Reedy <tjreedy@udel.edu> - 2012-08-09 15:45 -0400
    Re: socketserver.BaseRequestHandler and socketserver.StreamRequestServer docs lipska the kat <lipskathekat@yahoo.co.uk> - 2012-08-10 08:46 +0100

csiph-web