[issue5097] asyncore.dispatcher_with_send undocumented

[Kandalintsev Alexandre]

Kandalintsev Alexandre <bug_hunter at messir.net> added the comment:

This is my explanation of dispatcher_with_send. As my english is far from 
perfect and I'm not expirienced writing documentation you need to review 
it and fix my mistakes.


class asyncore.dispatcher_with_send

This is class based on asyncore.dispatcher. The only difference that 
unlike dispatcher.send which is direct mean to the socket.send() send() 
of this class uses buffered io. At first all outgoing data saved to the 
buffer and later it will send when socket becomes avaliable for write. 
Thus dispatcher_with_send.send() will never return EWOULDBLOCK error. 
Also you shuldn't overrdie writable() method as in this dispatcher it 
will automatically return convient value depending weither output buffer 
empty or not.

----------
versions: +Python 2.4, Python 2.5, Python 2.6, Python 2.7, Python 3.0, Python 3.1

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue5097>
_______________________________________