Closes #11633 Clarify print buffering.

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index e5d4a99c95f11eac7a8eeed57a222f8bfe3409b3..ff6d1c00cde9568efa40075124e1c7e4b758fab3 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -954,7 +954,9 @@ are always available.  They are listed here in alphabetical order.
    *end*.
 
    The *file* argument must be an object with a ``write(string)`` method; if it
-   is not present or ``None``, :data:`sys.stdout` will be used.
+   is not present or ``None``, :data:`sys.stdout` will be used. Output buffering
+   is determined by *file*. Use ``sys.stdout.flush()`` to ensure immediate
+   appearance on a screen.
 
 
 .. function:: property(fget=None, fset=None, fdel=None, doc=None)