]> granicus.if.org Git - python/commitdiff
Markup and nits.
authorRaymond Hettinger <python@rcn.com>
Fri, 21 Feb 2003 01:45:34 +0000 (01:45 +0000)
committerRaymond Hettinger <python@rcn.com>
Fri, 21 Feb 2003 01:45:34 +0000 (01:45 +0000)
Doc/lib/libitertools.tex

index 1ae4e96fbc6e77aff619ec38d37c060fef9e690a..5c6c2b728dea39b6cf440300c1f0543f4b4641f5 100644 (file)
@@ -18,14 +18,14 @@ avoid the readability and reliability problems which arise when many
 different individuals create their own slightly varying implementations,
 each with their own quirks and naming conventions.
 
-The tools are designed to combine readily with each another.  This makes
+The tools are designed to combine readily with one another.  This makes
 it easy to construct more specialized tools succinctly and efficiently
 in pure Python.
 
-For instance, SML provides a tabulation tool: \code{tabulate(\var{f})}
+For instance, SML provides a tabulation tool: \code{tabulate(f)}
 which produces a sequence \code{f(0), f(1), ...}.  This toolbox
 provides \function{imap()} and \function{count()} which can be combined
-to form \code{imap(\var{f}, count())} and produce an equivalent result.
+to form \code{imap(f, count())} and produce an equivalent result.
 
 Whether cast in pure python form or C code, tools that use iterators
 are more memory efficient (and faster) than their list based counterparts.
@@ -75,10 +75,9 @@ by functions or loops that truncate the stream.
 
   \begin{verbatim}
      def count(n=0):
-         cnt = n
          while True:
-             yield cnt
-             cnt += 1
+             yield n
+             n += 1
   \end{verbatim}
 
   Note, \function{count()} does not check for overflow and will return
@@ -208,16 +207,16 @@ by functions or loops that truncate the stream.
   \end{verbatim}
 \end{funcdesc}
 
-\begin{funcdesc}{repeat}{obj}
-  Make an iterator that returns \var{obj} over and over again.
+\begin{funcdesc}{repeat}{object}
+  Make an iterator that returns \var{object} over and over again.
   Used as argument to \function{imap()} for invariant parameters
-  to the called function.  Also used with function{izip()} to create
+  to the called function.  Also used with \function{izip()} to create
   an invariant part of a tuple record.  Equivalent to:
 
   \begin{verbatim}
-     def repeat(x):
+     def repeat(object):
          while True:
-             yield x
+             yield object
   \end{verbatim}
 \end{funcdesc}
 
@@ -226,7 +225,7 @@ by functions or loops that truncate the stream.
   obtained from the iterable.  Used instead of \function{imap()} when
   argument parameters are already grouped in tuples from a single iterable
   (the data has been ``pre-zipped'').  The difference between
-  \function{imap()} and \function{starmap} parallels the distinction
+  \function{imap()} and \function{starmap()} parallels the distinction
   between \code{function(a,b)} and \code{function(*c)}.
   Equivalent to: