Terry J. Reedy added the comment:

My suggestion from the python-ideas thread:: replace the current

"The function names are those used for special class methods; variants without 
leading and trailing __ are also provided for convenience."

with

""Many function names are those used for special methods, minus the double 
underscores.  For backward compatibility, many of these have a variant with the 
double underscores kept.  We recommend using the dunderless form.  Note that 
operator.__add__(x, y), for instance, being the same as x + y, is not the same 
as x.__add__(y)."

Possibly add ", since the first two may result in calling y.__radd__(x)".



Raymond assigned the

----------
assignee: docs@python -> rhettinger
nosy: +rhettinger

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

Reply via email to