From: Raymond Hettinger <python@rcn.com>
Date: Fri, 13 Jul 2007 12:09:41 +0000 (+0000)
Subject: Correct the docs for takewhile().  Improve the recipe for nth().  Should be backported
X-Git-Tag: v2.6a1~1575
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=928713c740c282063fc47c0c28f128f3ebd619e9;p=python

Correct the docs for takewhile().  Improve the recipe for nth().  Should be backported
---

diff --git a/Doc/lib/libitertools.tex b/Doc/lib/libitertools.tex
index e2f0f0ef9a..362c589c33 100644
--- a/Doc/lib/libitertools.tex
+++ b/Doc/lib/libitertools.tex
@@ -117,7 +117,7 @@ by functions or loops that truncate the stream.
   Make an iterator that drops elements from the iterable as long as
   the predicate is true; afterwards, returns every element.  Note,
   the iterator does not produce \emph{any} output until the predicate
-  is true, so it may have a lengthy start-up time.  Equivalent to:
+  first becomes false, so it may have a lengthy start-up time.  Equivalent to:
 
   \begin{verbatim}
      def dropwhile(predicate, iterable):
@@ -509,8 +509,8 @@ def iteritems(mapping):
     return izip(mapping.iterkeys(), mapping.itervalues())
 
 def nth(iterable, n):
-    "Returns the nth item or raise IndexError"
-    return list(islice(iterable, n, n+1))[0]
+    "Returns the nth item or raise StopIteration"
+    return islice(iterable, n, None).next()
 
 def all(seq, pred=None):
     "Returns True if pred(x) is true for every element in the iterable"