https://github.com/python/cpython/commit/45d1ba7bb88276182ba6531fe403e254d04a8a98
commit: 45d1ba7bb88276182ba6531fe403e254d04a8a98
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2026-06-08T12:19:22Z
summary:

[3.13] gh-141623: operator.rst: don't use term "bitwise" (GH-141846) (GH-151080)

(cherry picked from commit bd5fa31c5ff47866f0f93ef2a674e78d56d2e44c)

Co-authored-by: Doron Behar <[email protected]>

files:
M Doc/library/operator.rst

diff --git a/Doc/library/operator.rst b/Doc/library/operator.rst
index a9a6026af406fe..9f291309a752c8 100644
--- a/Doc/library/operator.rst
+++ b/Doc/library/operator.rst
@@ -98,7 +98,7 @@ The mathematical and bitwise operations are the most numerous:
 .. function:: and_(a, b)
               __and__(a, b)
 
-   Return the bitwise and of *a* and *b*.
+   Return ``a & b``.
 
 
 .. function:: floordiv(a, b)
@@ -122,13 +122,13 @@ The mathematical and bitwise operations are the most 
numerous:
               __inv__(obj)
               __invert__(obj)
 
-   Return the bitwise inverse of the number *obj*.  This is equivalent to 
``~obj``.
+   Return ``~obj``.
 
 
 .. function:: lshift(a, b)
               __lshift__(a, b)
 
-   Return *a* shifted left by *b*.
+   Return ``a << b``.
 
 
 .. function:: mod(a, b)
@@ -140,7 +140,7 @@ The mathematical and bitwise operations are the most 
numerous:
 .. function:: mul(a, b)
               __mul__(a, b)
 
-   Return ``a * b``, for *a* and *b* numbers.
+   Return ``a * b``.
 
 
 .. function:: matmul(a, b)
@@ -160,25 +160,25 @@ The mathematical and bitwise operations are the most 
numerous:
 .. function:: or_(a, b)
               __or__(a, b)
 
-   Return the bitwise or of *a* and *b*.
+   Return ``a | b``.
 
 
 .. function:: pos(obj)
               __pos__(obj)
 
-   Return *obj* positive (``+obj``).
+   Return ``+obj``.
 
 
 .. function:: pow(a, b)
               __pow__(a, b)
 
-   Return ``a ** b``, for *a* and *b* numbers.
+   Return ``a ** b``.
 
 
 .. function:: rshift(a, b)
               __rshift__(a, b)
 
-   Return *a* shifted right by *b*.
+   Return ``a >> b``.
 
 
 .. function:: sub(a, b)
@@ -197,7 +197,7 @@ The mathematical and bitwise operations are the most 
numerous:
 .. function:: xor(a, b)
               __xor__(a, b)
 
-   Return the bitwise exclusive or of *a* and *b*.
+   Return ``a ^ b``.
 
 
 Operations which work with sequences (some of them with mappings too) include:
@@ -391,13 +391,18 @@ Python syntax and the functions in the :mod:`operator` 
module.
 
+-----------------------+-------------------------+---------------------------------------+
 | Division              | ``a // b``              | ``floordiv(a, b)``         
           |
 
+-----------------------+-------------------------+---------------------------------------+
-| Bitwise And           | ``a & b``               | ``and_(a, b)``             
           |
+| Bitwise And, or       | ``a & b``               | ``and_(a, b)``             
           |
+| Intersection          |                         |                            
           |
 
+-----------------------+-------------------------+---------------------------------------+
-| Bitwise Exclusive Or  | ``a ^ b``               | ``xor(a, b)``              
           |
+| Bitwise Exclusive Or, | ``a ^ b``               | ``xor(a, b)``              
           |
+| or Symmetric          |                         |                            
           |
+| Difference            |                         |                            
           |
 
+-----------------------+-------------------------+---------------------------------------+
-| Bitwise Inversion     | ``~ a``                 | ``invert(a)``              
           |
+| Bitwise Inversion, or | ``~ a``                 | ``invert(a)``              
           |
+| Complement            |                         |                            
           |
 
+-----------------------+-------------------------+---------------------------------------+
-| Bitwise Or            | ``a | b``               | ``or_(a, b)``              
           |
+| Bitwise Or, or        | ``a | b``               | ``or_(a, b)``              
           |
+| Union                 |                         |                            
           |
 
+-----------------------+-------------------------+---------------------------------------+
 | Exponentiation        | ``a ** b``              | ``pow(a, b)``              
           |
 
+-----------------------+-------------------------+---------------------------------------+

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to