[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Terry J. Reedy
New submission from Terry J. Reedy: https://docs.python.org/3.4/library/functools.html#functools.cmp_to_key says A key function is a callable that accepts one argument and returns another value indicating the position in the desired collation sequence. A python list poster (Veek M) 'value

[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Raymond Hettinger
Raymond Hettinger added the comment: I'll add a link to the glossary entry for key function and to the sorting howto. Also, I'll change value indicating the position to value to be used as the sort key. The form sentence being discussed should probably remain close to how it is currently

[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Terry J. Reedy
Terry J. Reedy added the comment: I agree with your comments and proposed changes and will leave this to you. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue22830 ___

[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Roundup Robot
Roundup Robot added the comment: New changeset dbe1744ec62e by Raymond Hettinger in branch '2.7': Issue 22830: Clarify docs for functools.cmp_to_key(). https://hg.python.org/cpython/rev/dbe1744ec62e -- nosy: +python-dev ___ Python tracker

[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Roundup Robot
Roundup Robot added the comment: New changeset 63274cf1b40d by Raymond Hettinger in branch '3.4': Issue 22830: Clarify docs for functools.cmp_to_key(). https://hg.python.org/cpython/rev/63274cf1b40d -- ___ Python tracker rep...@bugs.python.org

[issue22830] functools.cmp_to_key: misleading key function description

2014-11-09 Thread Raymond Hettinger
Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- resolution: - fixed status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue22830 ___