[issue45856] [doc] map() documentation ambiguous about consumption order

[Raymond Hettinger]

Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

I don't think this suggestion is helpful or necessary.   The map() docs have been around for a long time and this hasn't proven to be a point of confusion.  

The itertools docs already have a recipe demonstrating the technique of passing the same iterator multiple times with izip_longest().  That is a case where the technique is useful.  In the context of map() however this technique is rarely, if ever, used.

A last thought is that we do put in rough pure python equivalents when they help understand the function.  In this case though, the pure python code provided is likely only intelligible to someone who already understands map().

Thank you for the suggestion, but we should pass on this one.

----------
nosy: +rhettinger

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