From f5be4e612c41c2b01cc0a71dec0f3f8ff0e6aee6 Mon Sep 17 00:00:00 2001 From: Mark Dickinson Date: Mon, 22 Feb 2010 15:40:28 +0000 Subject: [PATCH] Clarify description of three-argument pow for Decimal types: the exponent of the result is always 0. --- Doc/library/decimal.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst index b559ff5b78e..d8ce673d4c8 100644 --- a/Doc/library/decimal.rst +++ b/Doc/library/decimal.rst @@ -1321,9 +1321,12 @@ In addition to the three supplied contexts, new contexts can be created with the - at least one of ``x`` or ``y`` must be nonzero - ``modulo`` must be nonzero and have at most 'precision' digits - The result of ``Context.power(x, y, modulo)`` is identical to the result - that would be obtained by computing ``(x**y) % modulo`` with unbounded - precision, but is computed more efficiently. It is always exact. + The value resulting from ``Context.power(x, y, modulo)`` is + equal to the value that would be obtained by computing ``(x**y) + % modulo`` with unbounded precision, but is computed more + efficiently. The exponent of the result is zero, regardless of + the exponents of ``x``, ``y`` and ``modulo``. The result is + always exact. .. versionchanged:: 2.6 ``y`` may now be nonintegral in ``x**y``.