Merged revisions 78312 via svnmerge from

mdickinson · mdickinson · commit 5961b0e35fa6 · 2010-02-22T15:41:48.000Z
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r78312 | mark.dickinson | 2010-02-22 15:40:28 +0000 (Mon, 22 Feb 2010) | 1 line

  Clarify description of three-argument pow for Decimal types:  the exponent of the result is always 0.
........
diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst
@@ -1218,9 +1218,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.
 
 
    .. method:: quantize(x, y)
