greg/cpython
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
e527ec8abe0849e784ce100f53c2736986b670ae
cpython/Python
History
Gregory P. Smith 6a5d3ff676 bpo-40636: Clarify the zip built-in docstring. (GH-20118) 
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>
2020-05-15 14:26:00 -07:00
..
clinic
bpo-39489: Remove COUNT_ALLOCS special build (GH-18259)
2020-02-03 15:17:15 +01:00
_warnings.c
bpo-40421: Add PyFrame_GetBack() function (GH-19765)
2020-04-29 03:28:46 +02:00
asdl.c
…
ast_opt.c
bpo-40334: PEP 617 implementation: New PEG parser for CPython (GH-19503)
2020-04-22 23:29:27 +01:00
ast_unparse.c
Add spaces around the ":=" operator in ast_unparse.c (GH-19568)
2020-04-18 17:17:19 +01:00
ast.c
bpo-40334: Correctly identify invalid target in assignment errors (GH-20076)
2020-05-15 02:04:52 +01:00
bltinmodule.c
bpo-40636: Clarify the zip built-in docstring. (GH-20118)
2020-05-15 14:26:00 -07:00
bootstrap_hash.c
Fix typos in comments, docs and test names (#15018)
2019-07-30 18:16:13 -04:00
ceval_gil.h
bpo-40513: Per-interpreter GIL (GH-19943)
2020-05-05 20:27:47 +02:00
ceval.c
Fix typo in code comment in main_loop label. (GH-20068)
2020-05-14 19:25:45 -07:00
codecs.c
bpo-40268: Remove a few pycore_pystate.h includes (GH-19510)
2020-04-14 17:52:15 +02:00
compile.c
bpo-40334: Don't downcast from Py_ssize_t to int (GH-19671)
2020-04-23 03:43:08 +01:00
condvar.h
Typo fix: "throuhgh" should be "through". (GH-16704)
2019-10-10 20:43:13 -07:00
context.c
bpo-40428: Remove PyTuple_ClearFreeList() function (GH-19769)
2020-04-29 02:29:20 +02:00
dtoa.c
bpo-35081: Move dtoa.h header to the internal C API (GH-18489)
2020-02-12 22:54:42 +01:00
dup2.c
bpo-32150: Expand tabs to spaces in C files. (#4583)
2017-11-28 17:56:10 +02:00
dynamic_annotations.c
bpo-32241: Add the const qualifire to declarations of umodifiable strings. (#4748)
2017-12-12 13:55:04 +02:00
dynload_aix.c
bpo-37752: Delete redundant Py_CHARMASK in normalizestring() (GH-15095)
2019-09-10 17:04:08 +01:00
dynload_dl.c
…
dynload_hpux.c
bpo-40268: Add _PyInterpreterState_GetConfig() (GH-19492)
2020-04-13 03:04:28 +02:00
dynload_shlib.c
bpo-40268: Rename _PyInterpreterState_GET_UNSAFE() (GH-19509)
2020-04-14 15:14:01 +02:00
dynload_stub.c
…
dynload_win.c
bpo-39553: Delete HAVE_SXS protected code (GH-18356)
2020-02-04 19:13:00 -08:00
errors.c
bpo-29587: _PyErr_ChainExceptions() checks exception (GH-19902)
2020-05-05 17:07:41 +02:00
fileutils.c
bpo-40268: Remove unused osdefs.h includes (GH-19532)
2020-04-15 03:24:57 +02:00
formatter_unicode.c
bpo-39943: Add the const qualifier to pointers on non-mutable PyUnicode data. (GH-19345)
2020-04-11 10:48:40 +03:00
frozen.c
bpo-36540: PEP 570 -- Implementation (GH-12701)
2019-04-29 13:36:57 +01:00
frozenmain.c
bpo-40268: Remove a few pycore_pystate.h includes (GH-19510)
2020-04-14 17:52:15 +02:00
future.c
bpo-34683: Make SyntaxError column offsets consistently 1-indexed (gh-9338)
2018-09-24 14:12:49 -07:00
getargs.c
bpo-39943: Add the const qualifier to pointers on non-mutable PyUnicode data. (GH-19345)
2020-04-11 10:48:40 +03:00
getcompiler.c
closes bpo-31696: don't mention GCC in sys.version when building with clang (#3891)
2017-10-05 21:15:14 -07:00
getcopyright.c
Bring Python into the next decade. (GH-17801)
2020-01-02 18:56:34 -08:00
getopt.c
bpo-40527: Fix command line argument parsing (GH-19955)
2020-05-06 22:22:17 +09:00
getplatform.c
bpo-32150: Expand tabs to spaces in C files. (#4583)
2017-11-28 17:56:10 +02:00
getversion.c
bpo-32150: Expand tabs to spaces in C files. (#4583)
2017-11-28 17:56:10 +02:00
graminit.c
bpo-39702: Relax grammar restrictions on decorators (PEP 614) (GH-18570)
2020-03-03 14:25:44 -08:00
hamt.c
bpo-40268: Remove unused structmember.h includes (GH-19530)
2020-04-15 02:35:41 +02:00
hashtable.c
bpo-40602: _Py_hashtable_set() reports rehash failure (GH-20077)
2020-05-14 22:44:32 +02:00
import.c
bpo-40417: Fix deprecation warning in PyImport_ReloadModule (GH-19750)
2020-05-01 16:28:06 -07:00
importdl.c
bpo-39573: Finish converting to new Py_IS_TYPE() macro (GH-18601)
2020-03-04 14:15:20 +01:00
importdl.h
…
importlib_external.h
bpo-40334: PEP 617 implementation: New PEG parser for CPython (GH-19503)
2020-04-22 23:29:27 +01:00
importlib_zipimport.h
bpo-39987: Simplify setting lineno in the compiler. (GH-19037)
2020-03-17 18:07:30 +02:00
importlib.h
bpo-40334: PEP 617 implementation: New PEG parser for CPython (GH-19503)
2020-04-22 23:29:27 +01:00
initconfig.c
bpo-40453: Add PyConfig._isolated_subinterpreter (GH-19820)
2020-05-01 11:33:44 +02:00
makeopcodetargets.py
…
marshal.c
bpo-40602: Write unit tests for _Py_hashtable_t (GH-20091)
2020-05-14 21:55:47 +02:00
modsupport.c
bpo-40170: Add _PyIndex_Check() internal function (GH-19426)
2020-04-08 02:01:56 +02:00
mysnprintf.c
bpo-39882: Add _Py_FatalErrorFormat() function (GH-19157)
2020-03-25 19:27:36 +01:00
mystrtoul.c
bpo-37752: Delete redundant Py_CHARMASK in normalizestring() (GH-15095)
2019-09-10 17:04:08 +01:00
opcode_targets.h
bpo-39320: Handle unpacking of **values in compiler (GH-18141)
2020-01-27 09:57:45 +00:00
pathconfig.c
bpo-40268: Remove unused osdefs.h includes (GH-19532)
2020-04-15 03:24:57 +02:00
peephole.c
bpo-38249: Expand Py_UNREACHABLE() to __builtin_unreachable() in the release mode. (GH-16329)
2020-03-09 20:49:52 +02:00
preconfig.c
bpo-40514: Add --with-experimental-isolated-subinterpreters (GH-19926)
2020-05-05 16:41:11 +02:00
pyarena.c
bpo-36254: Fix invalid uses of %d in format strings in C. (GH-12264)
2019-03-13 22:59:55 +02:00
pyctype.c
…
pyfpe.c
bpo-29137: Remove fpectl module (#4789)
2018-01-05 23:15:34 -08:00
pyhash.c
bpo-40602: Add _Py_HashPointerRaw() function (GH-20056)
2020-05-12 18:46:20 +02:00
pylifecycle.c
bpo-40513: Per-interpreter GIL (GH-19943)
2020-05-05 20:27:47 +02:00
pymath.c
bpo-31031: Unify duplicate bits_in_digit and bit_length (GH-2866)
2020-01-16 15:09:19 +01:00
pystate.c
bpo-40522: _PyThreadState_Swap() sets autoTSSkey (GH-19939)
2020-05-05 19:56:48 +02:00
pystrcmp.c
…
pystrhex.c
bpo-40313: speed up bytes.hex() (GH-19594)
2020-04-20 17:17:52 -07:00
pystrtod.c
bpo-35081: Move dtoa.h header to the internal C API (GH-18489)
2020-02-12 22:54:42 +01:00
Python-ast.c
bpo-40528: Improve and clear several aspects of the ASDL definition code for the AST (GH-19952)
2020-05-06 15:29:32 +01:00
pythonrun.c
bpo-40612: Fix SyntaxError edge cases in traceback formatting (GH-20072)
2020-05-14 19:22:48 -07:00
pytime.c
bpo-38249: Expand Py_UNREACHABLE() to __builtin_unreachable() in the release mode. (GH-16329)
2020-03-09 20:49:52 +02:00
README
…
strdup.c
bpo-36623: Clean parser headers and include files (GH-12253)
2019-04-13 17:05:14 +01:00
structmember.c
bpo-40268: Remove unused structmember.h includes (GH-19530)
2020-04-15 02:35:41 +02:00
symtable.c
bpo-40268: Remove unused structmember.h includes (GH-19530)
2020-04-15 02:35:41 +02:00
sysmodule.c
bpo-40421: Add PyFrame_GetBack() function (GH-19765)
2020-04-29 03:28:46 +02:00
thread_nt.h
bpo-40268: Rename _PyInterpreterState_GET_UNSAFE() (GH-19509)
2020-04-14 15:14:01 +02:00
thread_pthread.h
bpo-40268: Rename _PyInterpreterState_GET_UNSAFE() (GH-19509)
2020-04-14 15:14:01 +02:00
thread.c
bpo-40268: Remove explicit pythread.h includes (#19529)
2020-04-15 02:04:42 +02:00
traceback.c
bpo-40421: Add PyFrame_GetBack() function (GH-19765)
2020-04-29 03:28:46 +02:00
wordcode_helpers.h
bpo-31338 (#3374)
2017-09-14 18:13:16 -07:00

README 

Miscellaneous source files for the main Python shared library
Reference in New Issue View Git Blame Copy Permalink