I'm not defending the documentation, I'm merely reposting it.

The documentation for asyncore says, "The full set of methods that can 
be overridden in your subclass follows:"

The documentation for asynchat says, "To make practical use of the code 
you must subclass async_chat, providing meaningful 
collect_incoming_data() and found_terminator() methods. The 
asyncore.dispatcher methods can be used, although not all make sense in 
a message/response context."

How can we make the documentation better?  I'm too close to the 
documentation to really know how to improve it.  Ideas?