traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

bpo-30085: Improve documentation for operator (#1171) 

The dunderless functions are preferred; dunder are retained for back compatilibity.
Patch by Sanket Dasgupta.
This commit is contained in:
Sanket Dasgupta 2017-09-24 23:59:22 +05:30 committed by Terry Jan Reedy
parent 5d3e80021a
commit 5b9299d8c7
2 changed files with 6 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Doc/library/operator.rst
View File

@ -17,9 +17,10 @@
The :mod:`operator` module exports a set of efficient functions corresponding to
the intrinsic operators of Python. For example, ``operator.add(x, y)`` is
equivalent to the expression ``x+y``. The function names are those used for
special class methods; variants without leading and trailing ``__`` are also
provided for convenience.
equivalent to the expression ``x+y``. Many function names are those used for
special methods, without the double underscores. For backward compatibility,
many of these have a variant with the double underscores kept. The variants
without the double underscores are preferred for clarity.
The functions fall into categories that perform object comparisons, logical
operations, mathematical operations and sequence operations.

2
Misc/NEWS.d/next/Documentation/2017-09-14-18-44-50.bpo-30085.0J9w-u.rst Normal file
View File

@ -0,0 +1,2 @@
The operator functions without double underscores are preferred for clarity.
The one with underscores are only kept for back-compatibility.