From 1823ae7e36c595e221cf21e10cb4380f0ce4ba69 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sun, 21 Aug 2005 11:58:06 +0000 Subject: [PATCH] SF bug #1121416: zip incorrectly and incompletely documented sequences ==> iterables --- Doc/lib/libfuncs.tex | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index cf38c60cdfc..84b0ed53977 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -1149,12 +1149,12 @@ It's a function that the number of elements fit in a native C long.} \end{funcdesc} -\begin{funcdesc}{zip}{\optional{seq1, \moreargs}} +\begin{funcdesc}{zip}{\optional{iterable, \moreargs}} This function returns a list of tuples, where the \var{i}-th tuple contains - the \var{i}-th element from each of the argument sequences. + the \var{i}-th element from each of the argument sequences or iterables. The returned list is truncated in length to the length of - the shortest argument sequence. When there are multiple argument - sequences which are all of the same length, \function{zip()} is + the shortest argument sequence. When there are multiple arguments + which are all of the same length, \function{zip()} is similar to \function{map()} with an initial argument of \code{None}. With a single sequence argument, it returns a list of 1-tuples. With no arguments, it returns an empty list.