Jonathan Ellis <[EMAIL PROTECTED]> added the comment: Here is the exact SSLObject.read documentation from 2.5 (although the bug was filed against 2.4, and 2.6 will be out soon, the docs are the same):
----- read([n]) If n is provided, read n bytes from the SSL connection, otherwise read until EOF. The return value is a string of the bytes read. ----- This is not ambiguous. Similarly, help(file.read) is not ambiguous. (The "at most" part in the first line of file.read is later explained to apply to non-blocking reads.) If you want to claim "well, it's not a file-like object" then (a) it shouldn't have file-like methods (socket-like send and recv are the obvious choices instead of write and read), (b) you need to fix your docs. But since god knows how many programs are out there expecting the semantics explained by the existing docs, I think just fixing the bug in the code is better than defining away the problem. (Obviously socket.makefile won't work on an object that doesn't implement a socket-like interface, so that's a non-option.) _______________________________________ Python tracker <[EMAIL PROTECTED]> <http://bugs.python.org/issue1291446> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
