On 7/31/07, Jay Loden <[EMAIL PROTECTED]> wrote: > This isn't just a problem with the socket module, so please don't think I'm > picking on it or singling it out, it's something I've seen a number of > places. e.g. from os.stat:
You picked out two specific examples as being bad, so I thought I'd go take a look at them. They don't seem nearly as bad as you make them sound. The online docs for os.stat (http://docs.python.org/lib/os-file-dir.html) seem pretty complete, including examples. The docs for the socket module (http://docs.python.org/lib/module-socket.html) are fairly large too. I mean, the traditional socket textbook is still 'Unix Network Programming, Vol. 1', which weighs in at over a thousand pages, so I'm sure more could be said in the docs, but I'm not sure exactly how much. It does point you to the platform specific docs as useful resources for platform specific behavior, but that seems reasonable too, especially considering that it lays out exactly which docs you might want to look at. I haven't tried to implement anything using these docs, so I don't know I'm not saying that the docs couldn't use improvement, I'm sure more details and more examples are always welcome. Still, these particular bits just don't seem that bad. -- Jerry -- http://mail.python.org/mailman/listinfo/python-list
