[Python-Dev] logging needs better documentation

[Neal D. Becker]

There is only a single example in the logging module documentation.  Please
add more examples!

I'm trying to use DatagramHandler.  The documentation on this is not
adequate.  There is a confusing mention of makeLogRecord.  No example.

I finally stumbled across this:

        data, address = sock.recvfrom (8192)
        rec = logging.makeLogRecord (pickle.loads(data[4:]))

I can't find _anywhere_ a mention that you need to leave off the first 4
bytes in order for unpickle to work.