From: Raymond Hettinger Date: Sun, 21 Aug 2005 11:59:04 +0000 (+0000) Subject: SF bug #1121416: zip incorrectly and incompletely documented X-Git-Tag: v2.4.2c1~97 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e72393978f254ccf5e51ae8de6b99dc3568f124d;p=thirdparty%2FPython%2Fcpython.git SF bug #1121416: zip incorrectly and incompletely documented sequences ==> iterables --- diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index c0595b1bcb58..77ee972f17b0 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -1111,12 +1111,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.