<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=Content-Type content="text/html; charset=iso-8859-1">
<META content="MSHTML 6.00.2800.1458" name=GENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=#ffffff>
<DIV><FONT face=Arial size=2>Hi Neal,</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2>I quite agree that the documentation for the
logging package can be improved. As others have said in response to your post,
you can definitely help by indicating more specifically where you find the
documentation lacking, with a patch if possible. For example, your initial post
about the length prefix for pickles is documented in the docstring for
SocketHandler.makePickle():</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2>"Pickles the record in binary format with a length
prefix, and returns it ready for transmission across the socket."</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2>I agree that the documentation does not mention
specifically that the length is encoded as four bytes, or that it is packed
using struct.pack(), or exactly how you unpack it. I also agree that more
examples would be helpful. I will endeavour to improve the
situation insofar as time allows. Patches and specific suggestions from
users, especially new users like you, will be a definite help to
me.</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2>Best Regards,</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial size=2>Vinay Sajip</FONT></DIV></BODY></HTML>