This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author tim.peters
Recipients docs@python, mjpieters, rhettinger, steven.daprano, tim.peters
Date 2019-01-04.03:33:01
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1546572781.17.0.681999017076.issue35654@roundup.psfhosted.org>
In-reply-to
Content
Steven, thanks for noticing the docs!  I was surprised to hear it wasn't documented, but not surprised enough to check myself ;-)

This decision was suggested by me, and endorsed by Guido, when designing timsort looking ahead to Python 3, where __cmp__ was going to vanish.  The convenience of needing to add only a single method to support a custom sort order is considerable.

Since it's working as designed and dccumented, and I know for certain that code in the wild relises on it, I'm inclined to reject this report.  However, rather than add more words to `sorted()`, I'd suggest removing words from `sorted()`, pointing instead to the `.sort()` docs for all specification of `sorted()`'s sorting behavior.
History
Date User Action Args
2019-01-04 03:33:02tim.peterssetrecipients: + tim.peters, rhettinger, mjpieters, steven.daprano, docs@python
2019-01-04 03:33:01tim.peterssetmessageid: <1546572781.17.0.681999017076.issue35654@roundup.psfhosted.org>
2019-01-04 03:33:01tim.peterslinkissue35654 messages
2019-01-04 03:33:01tim.peterscreate