From fc3ba6b8fc0d9212cbae676a5c84847245767464 Mon Sep 17 00:00:00 2001
From: Raymond Hettinger <python@rcn.com>
Date: Wed, 1 Feb 2012 09:07:40 -0800
Subject: [PATCH] Add usage note

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

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index 68a6c830755..d1d1188106e 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -496,6 +496,11 @@ loops that truncate the stream.
               for i in range(times):
                   yield object
 
+   A common use for *repeat* is to supply a stream of constant values to *map*
+   or *zip*::
+
+      >>> list(map(pow, range(10), repeat(2)))
+      [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]
 
 .. function:: starmap(function, iterable)