Andrew Barnert via Python-ideas
On Sep 30, 2015, at 22:59, Akira Li <4kir4.1i@gmail.com> wrote: ...
You've got the idea: the word *iterable* may be used in the context when not all iterables are accepted.
https://mail.python.org/pipermail/python-ideas/2015-October/036692.html
This is a link to a reply where you pasted exactly the same text as in this reply—and in a third one. What is that supposed to mean?
It means exactly what it says -- literally: "the word *iterable* may be used in the context when not all iterables are accepted." and list(iterable), set(iterable), dict(iterable) are the specific examples. It is a statement of "how it *is*" and that it is acceptable in my view and there is no need to change it. Obviously, list/set/dict docs describe what subset of iterables they accept. If you agree on that then there is no disagreement. And it should answer the questions from your post. If you disagree then to ground the discussion what _specific_ places in the documentation would you like to change? ...
More concretely: the documentation for dict views goes out of its way to point out that these are not iterators, but a different kind of iterable that's more like a sequence (presumably meaning at least one of the three things above). But it does so inaccurately, by saying they are sequences, which is not true. How could it be rewritten to get that point across accurately, but still concisely and readably?
"How could it be rewritten": I remember posting the link to Python issue already http://bugs.python.org/issue25286