From: Aditya Borikar <adityaborikar2@gmail.com>
Date: Fri, 7 Jun 2024 09:44:42 +0000 (-0600)
Subject: gh-110383: Clarify "non-integral" wording in pow() docs (#119688)
X-Git-Tag: v3.14.0a1~1569
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6646a9da26d12fc54263b22dd2916a2f710f1db7;p=thirdparty%2FPython%2Fcpython.git

gh-110383: Clarify "non-integral" wording in pow() docs (#119688)
---

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 4617767a71be..1d82f92ea678 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1561,7 +1561,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