imaplib: comment on use of unbuffered pipes

diff --git a/Lib/imaplib.py b/Lib/imaplib.py
index 3f5f3afdda8f5e6985608fc0d45c9a341ff6c861..b006a74a8190402e94c0fc3de17871fa9c9af74d 100644 (file)
--- a/Lib/imaplib.py
+++ b/Lib/imaplib.py
@@ -1703,7 +1703,7 @@ class IMAP4_stream(IMAP4):
         self.sock = None
         self.file = None
         self.process = subprocess.Popen(self.command,
-            bufsize=0,
+            bufsize=0,  # Unbuffered stdin/stdout, for select() compatibility
             stdin=subprocess.PIPE, stdout=subprocess.PIPE,
             shell=True, close_fds=True)
         self.writefile = self.process.stdin