[issue39374] Key in sort -> Callable Object instead of function

2020-01-25 Thread Raymond Hettinger
Change by Raymond Hettinger : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___

[issue39374] Key in sort -> Callable Object instead of function

2020-01-25 Thread Raymond Hettinger
Raymond Hettinger added the comment: New changeset 8271441d8b6e1f8eae1457c437da24e775801d9f by Raymond Hettinger (Juhana Jauhiainen) in branch 'master': bpo-39374: Updated sorting documentation (GH-18177) https://github.com/python/cpython/commit/8271441d8b6e1f8eae1457c437da24e775801d9f

[issue39374] Key in sort -> Callable Object instead of function

2020-01-24 Thread Juhana Jauhiainen
Juhana Jauhiainen added the comment: I created a pull request for this issue. It adds the description "(or other callable)" to two places in sorting documentation. "function (or other callable) to be called on each list element prior to making comparisons." and later "The value of the

[issue39374] Key in sort -> Callable Object instead of function

2020-01-24 Thread Roundup Robot
Change by Roundup Robot : -- keywords: +patch pull_requests: +17560 stage: -> patch review pull_request: https://github.com/python/cpython/pull/18177 ___ Python tracker ___

[issue39374] Key in sort -> Callable Object instead of function

2020-01-24 Thread Terry J. Reedy
Terry J. Reedy added the comment: I agree that we should keep 'function', as it is often used at least somewhat generically (as in Library Manual 'Built-in Functions' chapter). I marked this as an easy first PR. -- keywords: +easy, newcomer friendly nosy: +terry.reedy

[issue39374] Key in sort -> Callable Object instead of function

2020-01-19 Thread Raymond Hettinger
Raymond Hettinger added the comment: Go ahead and make a PR for this: function -> function (or other callable) Let's keep the word "function" because it does a much better job of communicating that an the more abstract word "callable". -- assignee: docs@python -> rhettinger

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Carlos Segura González
Carlos Segura González added the comment: The thing is that even in the "Language Reference" is not correct. In "https://docs.python.org/3/library/functions.html#sorted; it is stated "key specifies a function of one argument that is used to extract a comparison key..." I think that it is

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Karthikeyan Singaravelan
Change by Karthikeyan Singaravelan : -- nosy: +rhettinger ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Vedran Čačić
Vedran Čačić added the comment: I think that "HOW TO"s are fundamentally different from the "regular" documentation, in that they focus on explaining only the usual use cases and valuing simple explanations over the correct ones. Of course this _can_ be fixed, but I don't think that it must

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Anthony Flury
Anthony Flury added the comment: I will submit a documentation only fix for this in the next day or so. -- nosy: +anthony-flury ___ Python tracker ___

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Carlos Segura González
Change by Carlos Segura González : -- type: -> enhancement ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue39374] Key in sort -> Callable Object instead of function

2020-01-17 Thread Carlos Segura González
New submission from Carlos Segura González : In the Documentation, the "Sorting HOW TO" (https://docs.python.org/3/howto/sorting.html) states that "have a key parameter to specify a function to be called". However, it might be other callable objects. In fact, some of the examples given in the