This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: itertools "generators"?
Type: Stage: resolved
Components: Documentation Versions: Python 3.7, Python 3.6
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: rhettinger Nosy List: Stefan Pochmann, docs@python, rhettinger
Priority: low Keywords: patch

Created on 2017-12-15 20:50 by Stefan Pochmann, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 4893 merged rhettinger, 2017-12-15 21:11
PR 4894 merged python-dev, 2017-12-15 21:28
Messages (2)
msg308425 - (view) Author: Stefan Pochmann (Stefan Pochmann) * Date: 2017-12-15 20:50
The itertools page https://docs.python.org/3.6/library/itertools.html says "Combinatoric generators:" above the table with product(), permutations(), etc. But as far as I understand, they're not generators and they don't produce generator iterators. I think the table title should be "Combinatoric iterators:" instead, in line with "Infinite Iterators:" and "Iterators terminating on the shortest input sequence:" of the two tables above it.

Reference:
https://docs.python.org/3/glossary.html#term-generator
msg308426 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2017-12-15 20:59
The term is used in the generic sense rather than the sense of an actual type.  That said, I don't mind changing "Combinatoric generators" to "Combinatoric iterators" for 3.6 and 3.7.   Otherwise, this isn't worth the backport effort.
History
Date User Action Args
2022-04-11 14:58:55adminsetgithub: 76522
2017-12-15 21:30:05rhettingersetstatus: open -> closed
resolution: fixed
stage: patch review -> resolved
2017-12-15 21:28:31python-devsetpull_requests: + pull_request4790
2017-12-15 21:11:48rhettingersetkeywords: + patch
stage: patch review
pull_requests: + pull_request4786
2017-12-15 20:59:22rhettingersetpriority: normal -> low

nosy: + rhettinger
versions: - Python 2.7, Python 3.5
messages: + msg308426

assignee: docs@python -> rhettinger
2017-12-15 20:50:25Stefan Pochmanncreate