Staging
v0.8.1
https://github.com/python/cpython
Revision 6a5d3ff67644af42b1a781be2eacb2e82913441c authored by Gregory P. Smith on 15 May 2020, 21:26:00 UTC, committed by GitHub on 15 May 2020, 21:26:00 UTC
Clarify the zip built-in docstring.

This puts much simpler text up front along with an example.

As it was, the zip built-in docstring was technically correct.  But too
technical for the reader who shouldn't _need_ to know about `__next__` and
`StopIteration` as most people do not need to understand the internal
implementation details of the iterator protocol in their daily life.

This is a documentation only change, intended to be backported to 3.8; it is
only tangentially related to PEP-618 which might offer new behavior options
in the future.

Wording based a bit more on enumerate per Brandt's suggestion.

This gets rid of the legacy wording paragraph which seems too tied to
implementation details of the iterator protocol which isn't relevant here.

Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
1 parent 938717f
History
Tip revision: 6a5d3ff67644af42b1a781be2eacb2e82913441c authored by Gregory P. Smith on 15 May 2020, 21:26:00 UTC
bpo-40636: Clarify the zip built-in docstring. (GH-20118)
Tip revision: 6a5d3ff
File Mode Size
c-api
data
distributing
distutils
extending
faq
howto
includes
install
installing
library
reference
tools
tutorial
using
whatsnew
Makefile -rw-r--r-- 8.5 KB
README.rst -rw-r--r-- 4.6 KB
about.rst -rw-r--r-- 1.5 KB
bugs.rst -rw-r--r-- 4.7 KB
conf.py -rw-r--r-- 6.8 KB
contents.rst -rw-r--r-- 538 bytes
copyright.rst -rw-r--r-- 451 bytes
glossary.rst -rw-r--r-- 52.2 KB
license.rst -rw-r--r-- 45.2 KB
make.bat -rw-r--r-- 5.5 KB
myfile.bz2 -rw-r--r-- 331 bytes
requirements.txt -rw-r--r-- 128 bytes
runtime.txt -rw-r--r-- 3 bytes

README.rst

back to top