From 6a959a1213d4bb9cde122b0450984e4936273b65 Mon Sep 17 00:00:00 2001
From: Ezio Melotti <ezio.melotti@gmail.com>
Date: Sat, 23 Feb 2013 04:53:44 +0200
Subject: #15438: add a note to math.pow() that suggests using **/pow() for
 integers.  Patch by Mark Dickinson.

---
 Doc/library/math.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Doc/library/math.rst b/Doc/library/math.rst
index 1df48fc..7c6f0b4 100644
--- a/Doc/library/math.rst
+++ b/Doc/library/math.rst
@@ -212,6 +212,10 @@ Power and logarithmic functions
    ``x`` is negative, and ``y`` is not an integer then ``pow(x, y)``
    is undefined, and raises :exc:`ValueError`.
 
+   Unlike the built-in ``**`` operator, :func:`math.pow` converts both
+   its arguments to type :class:`float`.  Use ``**`` or the built-in
+   :func:`pow` function for computing exact integer powers.
+
    .. versionchanged:: 2.6
       The outcome of ``1**nan`` and ``nan**0`` was undefined.
 
-- 
cgit v0.12