Raymond Hettinger added the comment:
The comments in the docs are necessarily terse and communicate the pattern of
pairings. It would not be an improvement to actually list out all the tuples.
Sorry if this caused you any confusion, but I prefer to leave the comments as
they are now.
New submission from Matthew Ekstrand-Abueg:
Documentation states:
# product('ABCD', 'xy') --> Ax Ay Bx By Cx Cy Dx Dy
# product(range(2), repeat=3) --> 000 001 010 011 100 101 110
But:
>>> list(itertools.product('ABCD','xy'))
[('A', 'x'), ('A', 'y'), ('B', 'x'), ('B', 'y'), ('C',