New submission from Catalin Iacob <iacobcata...@gmail.com>:

In 2.7 the Comparisons section of stdtypes.rst only talks about __cmp__ and 
never mentions the rich comparison methods:
"Instances of a class normally compare as non-equal unless the class defines 
the __cmp__() method. Refer to Basic customization) for information on the use 
of this method to effect object comparisons."

The first sentence is false, instances can also compare as equal if they define 
__eq__. And since __cmp__ is gone in Python3, I think the rich comparison 
methods should at least be mentioned, or even emphasized over __cmp__ to help 
people write more forward compatible code.

----------
assignee: docs@python
components: Documentation
messages: 152254
nosy: catalin.iacob, docs@python
priority: normal
severity: normal
status: open
title: Built-in Types Comparisons should mention rich comparison methods
type: enhancement
versions: Python 2.7

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue13905>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to