[docs] [issue18558] Iterable glossary entry needs clarification

[Raymond Hettinger]

Raymond Hettinger added the comment:

I'll follow David Murray's suggestion here.  The glossary definition of iterable is already very good, it just needs to clarify that the __getitem__() method needs to implement sequence semantics.  Anything further is beyond the scope of a glossary entry.

Also, I'll amend the docs on collections.abc.Iterable() to be more specific about what it is does and doesn't recognize.

FWIW, the topic is also discussed in other places:

* https://docs.python.org/3/library/functions.html#iter
* https://docs.python.org/3/reference/datamodel.html#object.__getitem__
* https://docs.python.org/3/reference/datamodel.html#object.__iter__

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue18558>
_______________________________________