From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 7 Jun 2024 09:53:55 +0000 (+0200) Subject: [3.12] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) (#120207) X-Git-Tag: v3.12.5~254 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=501cd99c8e54e70fad80fb3b201647b3d0860b09;p=thirdparty%2FPython%2Fcpython.git [3.12] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) (#120207) (cherry picked from commit 6646a9da26d12fc54263b22dd2916a2f710f1db7) Co-authored-by: Aditya Borikar --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 6901c021d7bd..f7fda9dcba41 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1496,7 +1496,9 @@ are always available. They are listed here in alphabetical order. returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative base of type :class:`int` or :class:`float` and a non-integral exponent, a complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value close - to ``3j``. + to ``3j``. Whereas, for a negative base of type :class:`int` or :class:`float` + with an integral exponent, a float result is delivered. For example, + ``pow(-9, 2.0)`` returns ``81.0``. For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must also be of integer type and *mod* must be nonzero. If *mod* is present and