[Python-checkins] r83873 - in python/branches/release27-maint: Doc/library/functools.rst

benjamin.peterson python-checkins at python.org
Mon Aug 9 04:17:24 CEST 2010


Author: benjamin.peterson
Date: Mon Aug  9 04:17:24 2010
New Revision: 83873

Log:
Merged revisions 83872 via svnmerge from 
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r83872 | benjamin.peterson | 2010-08-08 21:13:10 -0500 (Sun, 08 Aug 2010) | 1 line
  
  use 3 space indents
........


Modified:
   python/branches/release27-maint/   (props changed)
   python/branches/release27-maint/Doc/library/functools.rst

Modified: python/branches/release27-maint/Doc/library/functools.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/functools.rst	(original)
+++ python/branches/release27-maint/Doc/library/functools.rst	Mon Aug  9 04:17:24 2010
@@ -19,23 +19,22 @@
 
 ..  function:: cmp_to_key(func)
 
-    Transform an old-style comparison function to a key-function.  Used with
-    tools that accept key functions (such as :func:`sorted`, :func:`min`,
-    :func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`,
-    :func:`itertools.groupby`).
-    This function is primarily used as a transition tool for programs
-    being converted to Py3.x where comparison functions are no longer
-    supported.
-
-    A compare function is any callable that accept two arguments, compares
-    them, and returns a negative number for less-than, zero for equality,
-    or a positive number for greater-than.  A key function is a callable
-    that accepts one argument and returns another value that indicates
-    the position in the desired collation sequence.
+   Transform an old-style comparison function to a key-function.  Used with
+   tools that accept key functions (such as :func:`sorted`, :func:`min`,
+   :func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`,
+   :func:`itertools.groupby`).  This function is primarily used as a transition
+   tool for programs being converted to Py3.x where comparison functions are no
+   longer supported.
+
+   A compare function is any callable that accept two arguments, compares them,
+   and returns a negative number for less-than, zero for equality, or a positive
+   number for greater-than.  A key function is a callable that accepts one
+   argument and returns another value that indicates the position in the desired
+   collation sequence.
 
-    Example::
+   Example::
 
-        sorted(iterable, key=cmp_to_key(locale.strcoll))  # locale-aware sort order
+       sorted(iterable, key=cmp_to_key(locale.strcoll))  # locale-aware sort order
 
    .. versionadded:: 2.7
 


More information about the Python-checkins mailing list