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 DimitriPapadopoulosOrfanos
Recipients DimitriPapadopoulosOrfanos, docs@python
Date 2021-09-20.08:06:52
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1632125212.88.0.211688526442.issue45246@roundup.psfhosted.org>
In-reply-to
Content
The documentation of sorted() lacks any reference to the comparison mechanism between items.

Compare with the documentation of list.sort(), which starts with:
    using only < comparisons between items

This is mentioned in the "Sorting HOW TO", under "Odd and Ends":
    The sort routines are guaranteed to use __lt__() when making comparisons between two objects.

However, the "Sorting HOW TO" is "a brief sorting tutorial", not the reference documentation. This property needs to be documented in the reference documentation of sorted().
History
Date User Action Args
2021-09-20 08:06:52DimitriPapadopoulosOrfanossetrecipients: + DimitriPapadopoulosOrfanos, docs@python
2021-09-20 08:06:52DimitriPapadopoulosOrfanossetmessageid: <1632125212.88.0.211688526442.issue45246@roundup.psfhosted.org>
2021-09-20 08:06:52DimitriPapadopoulosOrfanoslinkissue45246 messages
2021-09-20 08:06:52DimitriPapadopoulosOrfanoscreate