Issue #16394: Note the tee() pure python equivalent is only a rough approximation.

rhettinger · rhettinger · commit ab425aa9d335 · 2016-04-26T00:10:00.000-07:00
diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
@@ -588,7 +588,10 @@ loops that truncate the stream.
 
 .. function:: tee(iterable, n=2)
 
-   Return *n* independent iterators from a single iterable.  Equivalent to::
+   Return *n* independent iterators from a single iterable.
+
+   The following Python code helps explain what *tee* does (although the actual
+   implementation is more complex and uses only a single underlying FIFO queue)::
 
         def tee(iterable, n=2):
             it = iter(iterable)
