docs: imaplib: rephrase reference to MS Windows

Author: Forest

Doc/library/imaplib.rst

@@ -373,7 +373,7 @@ An :class:`IMAP4` instance has the following methods:
 
    .. warning::
 
-      Windows' :class:`IMAP4_stream` connections have no way to accurately
+      On Windows, :class:`IMAP4_stream` connections have no way to accurately
       respect the *duration* or *interval* arguments, since Windows'
       ``select()`` only works on sockets.
 

Lib/imaplib.py

@@ -672,11 +672,11 @@ def idle(self, duration=None):
         EXISTS [b'1']
         RECENT [b'1']
 
-        Warning:  Windows IMAP4_stream connections have no way to accurately
-        respect 'duration', since Windows select() only works on sockets.
-        However, if the server regularly sends status messages during IDLE,
-        they will wake our selector and keep iteration from blocking for long.
-        Dovecot's imap_idle_notify_interval is two minutes by default.
+        Warning:  On Windows, IMAP4_stream connections have no way to
+        accurately respect 'duration', since Windows select() only works on
+        sockets. However, if the server regularly sends status messages during
+        IDLE, they will wake our selector and keep iteration from blocking for
+        long.  Dovecot's imap_idle_notify_interval is two minutes by default.
         Assuming that's typical of IMAP servers, subtracting it from the 29
         minutes needed to avoid server inactivity timeouts would make 27
         minutes a sensible value for 'duration' in this situation.
@@ -1576,11 +1576,12 @@ def burst(self, interval=0.1):
         immediately without producing anything.  Callers should consider
         this if using it in a loop.
 
-        Warning:  Windows IMAP4_stream connections have no way to accurately
-        respect the 'interval' argument, since Windows select() only works
-        on sockets.  This will cause the generator to yield endless responses
-        and block indefinitely for each one.  It is therefore advised not to
-        use burst() with an IMAP4_stream connection on Windows.
+        Warning:  On Windows, IMAP4_stream connections have no way to
+        accurately respect the 'interval' argument, since Windows select()
+        only works on sockets.  This will cause the generator to yield
+        endless responses and block indefinitely for each one.  It is
+        therefore advised not to use burst() with an IMAP4_stream
+        connection on Windows.
         """
         try:
             yield next(self)