diff -r a7406565ef1c Doc/library/functools.rst --- a/Doc/library/functools.rst Tue Jan 24 09:05:18 2012 +0100 +++ b/Doc/library/functools.rst Tue Jan 24 14:04:40 2012 +0100 @@ -1,8 +1,8 @@ -:mod:`functools` --- Higher order functions and operations on callable objects +:mod:`functools` --- Higher-order functions and operations on callable objects ============================================================================== .. module:: functools - :synopsis: Higher order functions and operations on callable objects. + :synopsis: Higher-order functions and operations on callable objects. .. moduleauthor:: Peter Harris .. moduleauthor:: Raymond Hettinger .. moduleauthor:: Nick Coghlan @@ -27,7 +27,7 @@ tool for programs being converted from Python 2 which supported the use of comparison functions. - A compare function is any callable that accept two arguments, compares them, + A comparison 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 indicating the position in the desired