From ab425aa9d3353a15e2a673eb1af121dcde720a14 Mon Sep 17 00:00:00 2001
From: Raymond Hettinger <python@rcn.com>
Date: Tue, 26 Apr 2016 00:10:00 -0700
Subject: [PATCH] Issue #16394:  Note the tee() pure python equivalent is only
 a rough approximation.

---
 Doc/library/itertools.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index 758e49b282a..8376f1a417a 100644
--- 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)