Clarify map() behavior.

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 4fbb5e540d527dc3bd3feb3f121d6488680e73e6..7ecadad63436f4df82938a6d8a5e76526303216e 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -640,7 +640,9 @@ available.  They are listed here in alphabetical order.
    Return an iterator that applies *function* to every item of *iterable*,
    yielding the results.  If additional *iterable* arguments are passed,
    *function* must take that many arguments and is applied to the items from all
-   iterables in parallel.
+   iterables in parallel.  With multiple iterables, the iterator stops when the
+   shortest iterable is exhausted.
+
 
 .. function:: max(iterable[, args...], *[, key])