New submission from Rory Yorke <rory.yo...@gmail.com>:

Checked at commit 42fcad2, HEAD of main circa 8 May 2021.

cpython/Doc/library/numbers.rst says numbers.Complex subtypes "include the 
operations [...] ``+``, ``-``, ``*``, ``/``, :func:`abs`, :meth:`conjugate`, 
``==``, and ``!=``"

and for numbers.Integral: "Adds abstract methods for ``**`` and"

However, in cpython/Lib/numbers.py, the class Complex has `__pow__` and 
`__rpow__` methods, which makes sense mathematically.  The numbers.Class 
docstring is also missing a mention of `**`.

class.Integral does define a three-argument __pow__ for three-argument pow().

----------
assignee: docs@python
components: Documentation
messages: 393240
nosy: docs@python, roryyorke
priority: normal
severity: normal
status: open
title: Doc: power operator (`**`) present for numbers.Complex, not added in 
numbers.Integral
versions: Python 3.11

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

Reply via email to