SF patch #761519: Fixes for bugs 760703 and 757821
SF bug #760703: SocketHandler and LogRecord don't work well together
SF bug #757821: logging module docs

Applied Vinay Sajip's patch with a few minor fixups and a NEWS item.

Patched __init__.py - added new function
makeLogRecord (for bug report 760703).

Patched handlers.py - updated some docstrings and
deleted some old commented-out code.

Patched test_logging.py to make use of makeLogRecord.

Patched liblogging.tex to fill documentation gaps (both
760703 and bug 757821).
diff --git a/Lib/test/test_logging.py b/Lib/test/test_logging.py
index 6099562..ecf0e68 100644
--- a/Lib/test/test_logging.py
+++ b/Lib/test/test_logging.py
@@ -70,8 +70,7 @@
                 while len(chunk) < slen:
                     chunk = chunk + self.connection.recv(slen - len(chunk))
                 obj = self.unPickle(chunk)
-                record = logging.LogRecord(None, None, "", 0, "", (), None)
-                record.__dict__.update(obj)
+                record = logging.makeLogRecord(obj)
                 self.handleLogRecord(record)
             except:
                 raise